cordova-plugin-social-message

    0.4.0 • Public • Published

    Social Message Plugin for Apache Cordova npm version

    Cordova Plugin to utilise native share features. Developed for Apache Cordova CLI >= 3.0.0. Share text, images and urls to Facebook, Twitter and more.

    Install

    Latest published version on npm (with Cordova CLI >= 5.0.0)

    cordova plugin add cordova-plugin-social-message
    

    Latest version from GitHub

    cordova plugin add https://github.com/leecrossley/cordova-plugin-social-message.git
    

    Usage

    You do not need to reference any JavaScript, the Cordova plugin architecture will add a socialmessage object to your root automatically when you build.

    Ensure you use the plugin after your deviceready event has been fired.

    Share some text

    Pass a message object with a "text" property as an argument to the send function:

    var message = {
        text: "This is a test message"
    };
    window.socialmessage.send(message);
    

    This example will allow the message to be shared with all built in activity types.

    Specify activity types (iOS only)

    To specify activity types to include as options for the user, add an "activityTypes" array to your message:

    var message = {
        text: "This is a test message",
        activityTypes: ["PostToFacebook", "PostToTwitter"]
    };
    window.socialmessage.send(message);
    

    This example will only allow the user to post the message to Facebook or Twitter.

    A complete list of activity types can be found here. You should omit the "UIActivityType" prefix when adding to your array.

    NB: Some activity types will only show as an option when they have accounts configured in the iOS settings on the device (e.g. Facebook and Twitter). This is different from having the apps installed.

    Share a message with a subject

    To add a subject to your message, use the "subject" property (used with activity types such as Mail):

    var message = {
        subject: "Test Subject",
        text: "This is a test message",
        activityTypes: ["Mail"]
    };
    window.socialmessage.send(message);
    

    Share a message with a url

    To add a link to your message, use the "url" property:

    var message = {
        text: "Link test",
        url: "http://ilee.co.uk"
    };
    window.socialmessage.send(message);
    

    Share a message with an image

    To add an image to your message, use the "image" property:

    var message = {
        text: "Image test",
        image: "http://cordova.apache.org/images/cordova_bot.png"
    };
    window.socialmessage.send(message);
    

    Platforms

    iOS and Android.

    Android quirk

    Facebook does not permit you to share pre-filled text on Android, however images and urls will work.

    License

    MIT License

    Install

    npm i cordova-plugin-social-message

    DownloadsWeekly Downloads

    3

    Version

    0.4.0

    License

    MIT

    Last publish

    Collaborators

    • leecrossley