NewsBlur/media/ios/ShareKit/Configuration/DefaultSHKConfigurator.m
2012-07-13 00:39:26 -07:00

278 lines
9.4 KiB
Objective-C
Executable file

//
// DefaultSHKConfigurationDelegate.m
// ShareKit
//
// Created by Edward Dale on 10/16/10.
//
// 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.
//
//
#import "DefaultSHKConfigurator.h"
@implementation DefaultSHKConfigurator
/*
App Description
---------------
These values are used by any service that shows 'shared from XYZ'
*/
- (NSString*)appName {
return @"My App Name";
}
- (NSString*)appURL {
return @"http://example.com";
}
/*
API Keys
--------
This is the longest step to getting set up, it involves filling in API keys for the supported services.
It should be pretty painless though and should hopefully take no more than a few minutes.
Each key below as a link to a page where you can generate an api key. Fill in the key for each service below.
A note on services you don't need:
If, for example, your app only shares URLs then you probably won't need image services like Flickr.
In these cases it is safe to leave an API key blank.
However, it is STRONGLY recommended that you do your best to support all services for the types of sharing you support.
The core principle behind ShareKit is to leave the service choices up to the user. Thus, you should not remove any services,
leaving that decision up to the user.
*/
// Delicious - https://developer.apps.yahoo.com/dashboard/createKey.html
- (NSString*)deliciousConsumerKey {
return @"";
}
- (NSString*)deliciousSecretKey {
return @"";
}
// Facebook - https://developers.facebook.com/apps
// SHKFacebookAppID is the Application ID provided by Facebook
// SHKFacebookLocalAppID is used if you need to differentiate between several iOS apps running against a single Facebook app. Useful, if you have full and lite versions of the same app,
// and wish sharing from both will appear on facebook as sharing from one main app. You have to add different suffix to each version. Do not forget to fill both suffixes on facebook developer ("URL Scheme Suffix"). Leave it blank unless you are sure of what you are doing.
// The CFBundleURLSchemes in your App-Info.plist should be "fb" + the concatenation of these two IDs.
// Example:
// SHKFacebookAppID = 555
// SHKFacebookLocalAppID = lite
//
// Your CFBundleURLSchemes entry: fb555lite
- (NSString*)facebookAppId {
return @"";
}
- (NSString*)facebookLocalAppId {
return @"";
}
// Read It Later - http://readitlaterlist.com/api/signup/
- (NSString*)readItLaterKey {
return @"";
}
// Twitter - http://dev.twitter.com/apps/new
/*
Important Twitter settings to get right:
Differences between OAuth and xAuth
--
There are two types of authentication provided for Twitter, OAuth and xAuth. OAuth is the default and will
present a web view to log the user in. xAuth presents a native entry form but requires Twitter to add xAuth to your app (you have to request it from them).
If your app has been approved for xAuth, set SHKTwitterUseXAuth to 1.
Callback URL (important to get right for OAuth users)
--
1. Open your application settings at http://dev.twitter.com/apps/
2. 'Application Type' should be set to BROWSER (not client)
3. 'Callback URL' should match whatever you enter in SHKTwitterCallbackUrl. The callback url doesn't have to be an actual existing url. The user will never get to it because ShareKit intercepts it before the user is redirected. It just needs to match.
*/
- (NSString*)twitterConsumerKey {
return @"";
}
- (NSString*)twitterSecret {
return @"";
}
// You need to set this if using OAuth, see note above (xAuth users can skip it)
- (NSString*)twitterCallbackUrl {
return @"";
}
// To use xAuth, set to 1
- (NSNumber*)twitterUseXAuth {
return [NSNumber numberWithInt:0];
}
// Enter your app's twitter account if you'd like to ask the user to follow it when logging in. (Only for xAuth)
- (NSString*)twitterUsername {
return @"";
}
// Evernote - http://www.evernote.com/about/developer/api/
/* You need to set to sandbox until you get approved by evernote
// Sandbox
#define SHKEvernoteUserStoreURL @"https://sandbox.evernote.com/edam/user"
#define SHKEvernoteNetStoreURLBase @"http://sandbox.evernote.com/edam/note/"
// Or production
#define SHKEvernoteUserStoreURL @"https://www.evernote.com/edam/user"
#define SHKEvernoteNetStoreURLBase @"http://www.evernote.com/edam/note/"
*/
- (NSString*)evernoteUserStoreURL {
return @"";
}
- (NSString*)evernoteNetStoreURLBase {
return @"";
}
- (NSString*)evernoteConsumerKey {
return @"";
}
- (NSString*)evernoteSecret {
return @"";
}
// Flickr - http://www.flickr.com/services/apps/create/
/*
1 - This requires the CFNetwork.framework
2 - One needs to setup the flickr app as a "web service" on the flickr authentication flow settings, and enter in your app's custom callback URL scheme.
3 - make sure you define and create the same URL scheme in your apps info.plist. It can be as simple as yourapp://flickr */
- (NSString*)flickrConsumerKey {
return @"";
}
- (NSString*)flickrSecretKey {
return @"";
}
// The user defined callback url
- (NSString*)flickrCallbackUrl{
return @"app://flickr";
}
// Bit.ly (for shortening URLs on Twitter) - http://bit.ly/account/register - after signup: http://bit.ly/a/your_api_key
- (NSString*)bitLyLogin {
return @"";
}
- (NSString*)bitLyKey {
return @"";
}
/*
UI Configuration : Basic
------------------------
These provide controls for basic UI settings. For more advanced configuration see below.
*/
// Toolbars
- (NSString*)barStyle {
return @"UIBarStyleDefault";// See: http://developer.apple.com/iphone/library/documentation/UIKit/Reference/UIKitDataTypesReference/Reference/reference.html#//apple_ref/c/econst/UIBarStyleDefault
}
- (UIColor*)barTintForView:(UIViewController*)vc {
return nil;
}
// Forms
- (NSNumber*)formFontColorRed {
return [NSNumber numberWithInt:-1];// Value between 0-255, set all to -1 for default
}
- (NSNumber*)formFontColorGreen {
return [NSNumber numberWithInt:-1];// Value between 0-255, set all to -1 for default
}
- (NSNumber*)formFontColorBlue {
return [NSNumber numberWithInt:-1];// Value between 0-255, set all to -1 for default
}
- (NSNumber*)formBgColorRed {
return [NSNumber numberWithInt:-1];// Value between 0-255, set all to -1 for default
}
- (NSNumber*)formBgColorGreen {
return [NSNumber numberWithInt:-1];// Value between 0-255, set all to -1 for default
}
- (NSNumber*)formBgColorBlue {
return [NSNumber numberWithInt:-1];// Value between 0-255, set all to -1 for default
}
// iPad views
- (NSString*)modalPresentationStyle {
return @"UIModalPresentationFormSheet";// See: http://developer.apple.com/iphone/library/documentation/UIKit/Reference/UIViewController_Class/Reference/Reference.html#//apple_ref/occ/instp/UIViewController/modalPresentationStyle
}
- (NSString*)modalTransitionStyle {
return @"UIModalTransitionStyleCoverVertical";// See: http://developer.apple.com/iphone/library/documentation/UIKit/Reference/UIViewController_Class/Reference/Reference.html#//apple_ref/occ/instp/UIViewController/modalTransitionStyle
}
// ShareMenu Ordering
- (NSNumber*)shareMenuAlphabeticalOrder {
return [NSNumber numberWithInt:0];// Setting this to 1 will show list in Alphabetical Order, setting to 0 will follow the order in SHKShares.plist
}
// Append 'Shared With 'Signature to Email (and related forms)
- (NSNumber*)sharedWithSignature {
return [NSNumber numberWithInt:0];
}
// Name of the plist file that defines the class names of the sharers to use. Usually should not be changed, but
// this allows you to subclass a sharer and have the subclass be used.
- (NSString*)sharersPlistName {
return @"SHKSharers.plist";
}
/*
UI Configuration : Advanced
---------------------------
If you'd like to do more advanced customization of the ShareKit UI, like background images and more,
check out http://getsharekit.com/customize
*/
// turn on to use placeholders in edit fields instead of labels to the left for input fields.
- (NSNumber*)usePlaceholders {
return [NSNumber numberWithBool:false];
}
/*
Advanced Configuration
----------------------
These settings can be left as is. This only need to be changed for uber custom installs.
*/
- (NSNumber*)maxFavCount {
return [NSNumber numberWithInt:3];
}
- (NSString*)favsPrefixKey {
return @"SHK_FAVS_";
}
- (NSString*)authPrefix {
return @"SHK_AUTH_";
}
- (NSNumber*)allowOffline {
return [NSNumber numberWithBool:true];
}
- (NSNumber*)allowAutoShare {
return [NSNumber numberWithBool:true];
}
/*
Debugging settings
------------------
see DefaultSHKConfigurator.h
*/
@end