Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
iOS6 Social.Framework. Appcelerator apps is able to share content to Facebook and Twitter.
branch: master

This branch is 53 commits behind viezel:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.settings
Classes
assets
dist
documentation
example
hooks
platform
social.xcodeproj
.gitignore
.project
CHANGELOG.txt
DkNappSocial_Prefix.pch
LICENSE
LICENSE.txt
README.md
build.py
manifest
module.xcconfig
timodule.xml
titanium.xcconfig

README.md

TiSocial.Framework Module

Description

The TiSocial.Framework Module extends the Appcelerator Titanium Mobile framework with the iOS6 social.framework. This enables sharing content to Facebook, Twitter and other platforms.

The module is licensed under the MIT license.

SLComposeViewController UIActivityViewController

Referencing the module in your Titanium Mobile application

Simply add the following lines to your tiapp.xml file:

<modules>
    <module platform="iphone">dk.napp.social</module> 
</modules>

Reference

For more detailed code examples take a look into the example app

Twitter

Social.isTwitterSupported()

Returns true or false.
false if no account has been defined (true in the 6.0 simulator) or the iOS Version doesn't support the Social Framework.

Social.twitter({Object} options)

options can have the following keys:

  • text - the status message
  • image - a local/remote path to an image you want to share
  • url - a url you want to share

Each of these options is optional

Social.twitterRequest({Object} options [, {Object} requestParameter])

optionshas the following keys:

  • requestType - can be GET, POST or DELETE
  • url - the url you want to request
  • callbackEvent - optional - default: twitterRequest - how is the event called that is fired after request has succeeded?
  • accountWithIdentifier - Identifier to select which account to request twitter with.

requestParameter is optional, but is build like this:

{
    'screen_name': 'C_BHole'
}

So screen_name is the parameter name / key and C_BHole is the value of the parameter

Social.twitterAccountList()

Returns a list of twiiter accounts. use the EventListener accountList to capture this list.

Social.addEventListener("accountList", function(e){
    Ti.API.info("Accounts:");
    accounts = e.accounts; //accounts
    Ti.API.info(accounts);
});
Social.twitterAccountList();

Facebook

Social.isFacebookSupported()

Returns true or false.
false if no account has been defined (true in the 6.0 simulator) or the iOS Version doesn't support the Social Framework.

Social.facebook({Object} options)

options can have the following keys:

  • text - the status message
  • image - a local/remote path to an image you want to share
  • url - a url you want to share

Each of these options is optional

Social.facebookRequest({Object} options [, {Object} requestParameter])

options has the following keys:

  • requestType - can be GET, POST or DELETE
  • url - the url you want to request
  • appIdKey - the appid of your facebook app
  • permissionsKey - optional - a comma seperated string that contains the required permissions
  • callbackEvent - optional - default: facebookRequest - how is the event called that is fired after request has succeeded?

requestParameter is optional, but is build like this:

{
    fields: 'id,name,devices'
}

So fields is the parameter name / key and id,name,devices is the value of the parameter

Social.grantFacebookPermissions

Before you can send request to the Facebook API, you start by getting the users permissions.

var fbAccount;
Social.grantFacebookPermissions({
    appIdKey:"YOUR_FB_APP_ID",
    permissionsKey: "email" //FB docs: https://developers.facebook.com/docs/reference/login/extended-permissions/
});
Social.addEventListener("facebookAccount", function(e){ 
    fbAccount = e.account; //now you have stored the FB account. You can then request facebook using the below method 
});

Social.requestFacebookWithIdentifier({Object} options [, {Object} requestParameter])

Request Facebook with a specific account.

Social.requestFacebookWithIdentifier({
    requestType:"GET",
    accountWithIdentifier: fbAccount["identifier"], //start by granting facebook permissions 
    url:"https://graph.facebook.com/me",
    callbackEvent: "facebookProfile",
}, {
    fields: 'id,name,location'
});

Social.renewFacebookAccessToken

The accessToken will eventually be invalid, if you store the FB acccount in a App property or storage of some kind. This method can renew the accessToken, and make you able to request Facebook again. This method rely on the same facebookAccount eventlistener, as grantFacebookPermissions.

Social.renewFacebookAccessToken();

Sina Weibo

Social.isSinaWeiboSupported()

Returns true or false.
false if no account has been defined (true in the 6.0 simulator) or the iOS Version doesn't support the Social Framework.

Social.sinaweibo({Object} options)

options can have the following keys:

  • text - the status message
  • image - a local/remote path to an image you want to share
  • url - a url you want to share

Each of these options is optional

UIActivityViewController

Constants

  • ACTIVITY_FACEBOOK: UIActivityTypePostToFacebook
  • ACTIVITY_TWITTER: UIActivityTypePostToTwitter
  • ACTIVITY_WEIBO: UIActivityTypePostToWeibo
  • ACTIVITY_MESSAGE: UIActivityTypeMessage
  • ACTIVITY_MAIL: UIActivityTypeMail
  • ACTIVITY_PRINT: UIActivityTypePrint
  • ACTIVITY_COPY: UIActivityTypeCopyToPasteboard
  • ACTIVITY_ASSIGN_CONTATCT: UIActivityTypeAssignToContact
  • ACTIVITY_SAVE_CAMERA: UIActivityTypeSaveToCameraRoll
  • ACTIVITY_CUSTOM: Custom Activities

Events

  • complete: Fired when user complete using a Activity. Here, you can verify witch activity user have choiced by activity event property. When dealing with customActivities, you can get the activityName property.
  • cancelled: Fired when user not completed request.

Social.activityView()

options can have the following keys:

  • text - the status message
  • image - a local/remote path to an image you want to share
  • removeIcons - customise the dialog by removing unwanted icons.

The second argument is an array with objects. This argument is optional. Use this to create custom UIActivities. The posibilties are almost endless. have a look at: http://uiactivities.com for inspiration.

Social.activityView({
    text:"share like a king!",
    image:"pin.png",
    removeIcons:"print,sms,copy,contact,camera,mail"
},[
    {
        title:"Custom Share",
        type:"hello.world",
        image:"pin.png"
    },
    {
        title:"Open in Safari",
        type:"open.safari",
        image:"safari.png"
    }
]);

Social.activityPopover() (iPad only)

options can have the following keys:

  • text - the status message
  • image - a local/remote path to an image you want to share
  • removeIcons - customise the dialog by removing unwanted icons.
  • view - the source button

Example of usage

FollowMe Button

example/follow_on_twitter.js contains an example on how to implement a "Follow Me" button. It takes an account the os version and for iOS 5 will try to open the profile page in another application that exits on the device.

Please check the Example section in the file.

Changelog

v1.7.0

  • Added support iOS7

v1.6.2

  • Added support to verify what activity was choiced by user in complete event
  • Create constants to each default activity
  • Documentation changes

v1.6.1

  • Added userId to twitterAccountList()
  • Bugfix for Twitter iOS5 error handling.

v1.6.0

  • Added custom UIActivity. You can create your own sharing option for activityView in seconds.
  • Added grantFacebookPermissions(), renewFacebookAccessToken() and requestFacebookWithIdentifier() for giving you a greater control of when to promt the enduser with permissions.
  • Added platform property to objects returned to eventListeners. Twiiter, Facebook and activityView.

v1.5.5

  • Added Facebook accessToken output on requestFacebook().
  • Added better error handling. error eventListener return the reason as a string in e.message.

v1.5.4

  • Added twitterAccountList() and accountWithIdentifier.

v1.5.3

  • Added UIActivityViewController popOver for iPad use: activityPopover().

v1.5.2

  • Added raw data callback response for requestTwitter().

v1.5.1

  • Bugfixes.
  • Added isRequestTwitterSupported() for iOS6 check.

v1.5

  • UIActivityViewController implemented.
  • Improved image filepath finder (bundle, data, remote, url)

v1.4

  • Support for iOS5 Twiiter Framework.

v1.3

  • Different parameter setup for requestFacebook() and requestTwitter().
  • Now supporting Wall posting and more request parameter.

v1.2

  • Added support to share image from downloaded remote images in cache or documents folders.
  • Added support to share image from image urls.

v1.1

  • SLRequest methods implemented. requestFacebook() and requestTwitter().

v1.0

  • Initial Implementation of SLComposeViewController.

Author

Mads Møller
web: http://www.napp.dk
email: mm@napp.dk
twitter: @nappdev

Contributors

Christopher Beloch
twitter: @C_BHole

Jongeun Lee
twitter: @yomybaby

Daniel Tamas
twitter: @dan_tamas

Rafael Kellermann Streit
twitter: @rafaelks

License

Copyright (c) 2010-2013 Mads Møller

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Something went wrong with that request. Please try again.