Give us feedback
sample-social-sharing
Mobile icon

Sample Social Sharing

Stable version 1.0.3 (Compatible with OutSystems 11)
Uploaded on 4 Mar by 
0.0
 (0 ratings)
sample-social-sharing

Sample Social Sharing

Documentation
1.0.3

Description

  • Works on Android, version 2.3.3 and higher till 6.0 (For Version 7 and 8 still in progress)
  • Works on iOS6 and up.
  • Works on Windows Phone 8 since v4.0 of this plugin.
  • Share text, a link, images (or other files like pdf). A Subject is also supported when the receiving app supports it.


Supported platforms

  • Android
  • iOS
  • WP8


Highlights

  • isAvailable : isAvailable(callback)
  • SocialSharing : It accepts an options object and callbacks. socialsharing(options, callback)
  • Options :
    • message - String // Not supported on some apps (Facebook, Instagram)
    • subject – String // For Email
    • files – [] // An array of filenames either locally or remotely (Dynamic And Customize)
    • url - String
    • chooserTitle - String // Android only, you can override the default share sheet title.
    • appPackageName - String // Android only, you can provide id of the App you want to share with
  • Callback : Return button index clicked.


Usage on iOS and Android

You can share text, a subject (in case the user selects the email application), (any type and location of) file (like an image), and a link. However, what exactly gets shared, depends on the application the user chooses to complete the action. A few examples:

  • Mail: message, subject, file.
  • Twitter: message, image (other filetypes are not supported), link (which is automatically shortened if the Twitter client deems it necessary).
  • Google+ / Hangouts (Android only): message, subject, link
  • facebook
  • Instagram
  • Whatsapp
  • SMS

If Facebook, Twitter, Instagram, WhatsApp, SMS or Email is not available, the errorCallback is called with the text 'not available'.

You can still use the older SHARE method as well

  • Twitter
  • Facebook
  • Instagram
  • Whatsapp
  • Mail
  • SMS


NOTE:

For Whatsapp

  • On iOS when sharing an image and text, only the image is shared.
  • On Android you can only send a 'text' and 'url' directly to someone, so files are ignored.

For SMS

  • On Android, SMS via Hangouts may not behave correctly.

For Twitter

  • A lot of apps support sharing multiple files, but Twitter just doesn't accept more that one file.