Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Objective-C Ruby
branch: master

README.md

ShareThis

A sharing controller that allows anyone to implement sharing into their projects easily. iOS 6 will use the new activity view controller while iOS 5 will use action sheets. Readability, Pocket, and Instapaper are added also for read-later services to share with articles.

iOS 6+:

iOS 5:

Installation Instruction:

In AppDelegate.m:

Import ShareThis.h

import "ShareThis.h"

In application:didFinishLaunchingWithOptions add:

[ShareThis startSessionWithFacebookURLSchemeSuffix:pocketAPI:readabilityKey:readabilitySecret:];

Make sure that the url scheme that you enter is all lower-case. Set to nil or empty string if not planning on using the same Facebook App ID on multiple apps. Pocket and Readability parameters are also optional. If given a nil, those sharing options will not be available.

In applicationDidBecomeActive add:

[[NSNotificationCenter defaultCenter] postNotificationName:AppDidBecomeActiveNotificationName object:nil];

In applicationWillTerminate add:

[[NSNotificationCenter defaultCenter] postNotificationName:AppWillTerminateNotificationName object:nil];

Add in method application:openURL:sourceApplication:annotation

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation { return [ShareThis handleFacebookOpenUrl:url]; }

In app's .plist file add:

Key:FacebookAppID 
Value:Your Facebook app ID

Key:URL types --> Item 0 --> URL Schemes --> Item 0 
Value:"fb"+value of your Facebook app ID+url scheme (make sure url scheme is lower-case)

Using ShareThis:

To share with a specific service:

[ShareThis shareURL:title:image:withService:onViewController:];

Remember that to use Pocket and Readability, you must pass in the api key when starting ShareThis session in application:didFinishLaunchingWithOptions.

To show a share option:

[ShareThis showShareOptionsToShareUrl:title:image:onViewController:];

To show a share option for a type of content:

[ShareThis showShareOptionsToShareUrl:title:image:onViewController:forTypeOfContent:];

STContentTypeArticle will include the read later services while STContentTypeVideo will not.

License

ShareThis is available under the MIT license. See the LICENSE file for more info.

Something went wrong with that request. Please try again.