Appcelerator Social Share Module

This module brings Social Share functionaliy into the mobile apps for titanium app developers.

Getting Started

Set the <module> element in tiapp.xml, such as this:

<modules>
<module platform="ios">appcelerator.socialshare</module>
</modules>

To access this module from JavaScript, you would do the following:

var socialshare = require("appcelerator.socialshare");

The socialshare variable is a reference to the Module object.

Follow basic steps to share using activity item provider:

Use createActivityItemProvider to create item provider

const itemProvider = socialshare.createActivityItemProvider({
    contentType: socialshare.Content_Type_String,
      placeHolder: 'placeholder'
});

Set fetchItem for itemProvider status

itemProvider.fetchItem = function () {
    return 'This is Text To Share';
};

Set activityType for itemProvider status

itemProvider.activityType = socialshare.Activity_Type_Message;

Set activityType for itemProvider status

itemProvider.activityType = socialshare.Activity_Type_Message;

create customActivity using createCustomActivity if custom activity is required

const customActivity = socialshare.createCustomActivity({
category: socialshare.Activity_Category_Share,
    title: 'url share',
});

call shareWithItems for share the content status

socialshare.shareWithItems({
    activityItems: [ itemProvider ],
    activities: [ customActivity ],
    completionWithItemsHandler: function (e) {
        if (e.errorCode !== null || e.errorDomain !== null || e.errorDescription !== null) {
            alert('Error Occured: ' + e.errorDescription);
            return;
        }
    }
});

Follow basic steps to share using activity item source:

Use createActivityItemSource to create item source

const itemSource = socialshare.createActivityItemSource({
    contentType: socialshare.Content_Type_String
});

Set fetchItem for itemSource status

itemSource.fetchItem = function () {
    return 'This is Text To Share';
};

Set fetchPlaceholderItem for itemSource status

itemSource.fetchPlaceholderItem = function () {
    return 'This is Text To Share';
};

create customActivity using createCustomActivity if custom activity is required

const customActivity = socialshare.createCustomActivity({
category: socialshare.Activity_Category_Share,
    title: 'url share',
});

call shareWithItems for share the content status

socialshare.shareWithItems({
    activityItems: [ itemSource ],
    activities: [ customActivity ],
    completionWithItemsHandler: function (e) {
        if (e.errorCode !== null || e.errorDomain !== null || e.errorDescription !== null) {
            alert('Error Occured: ' + e.errorDescription);
            return;
        }
    }
});

Example

Please see the example/ folder.

Building

Simply run appc run -p ios --build-only which will compile and package your module.

Copy the module zip file into the root folder of your Titanium application or in the Titanium system folder (e.g. /Library/Application Support/Titanium).

Author

Axway

tidev / appcelerator.social-share

readme