This article about enabling Facebook for social sharing is no longer relevant. Social sharing is no longer supported on iOS 6 devices. On iOS 7 devices, Facebook is supported automatically.
Overview of social sharing in DPS
If you create a custom multi-issue viewer app, you can enable social sharing. Your customers can choose an option in your viewer to share the article through Facebook, Twitter, email, or copy and paste. This message includes either a link to the publication URL or to the article, depending on whether you protected the article. Anyone who clicks the article link can view the article contents in a desktop web browser or on the iPad. This article is for the v25 viewer version.
For more information about the social sharing workflow, see Using social media.
Workflow for setting up social sharing
To enable social sharing in your app, do the following:
- If you plan to enable Facebook, register your app with Facebook. When you do so, a Facebook App ID is generated.
- If you have not already done so, create a web page for your publication. The URL for this page is called the "Publication URL."
- Create a 1024 x 768 folio in which the shared articles use any image format. With v23, PDF articles are uploaded to the Web Viewer server using PNG image format. Create other folio renditions as required. If you create renditions, use the same Article Name values, so that the shared articles map properly to the appropriate article. Also, make sure that your renditions are set up properly.
- Use the Folio Producer Editor to indicate which articles are protected. When you publish or update the folio, the contents of unprotected articles are uploaded to a website on an Adobe server.
- Use the Account Administration tool to enable social sharing. You can also use the tool to limit the number of unprotected articles customers can read and set up paywall information. You can also set the limit of articles that can be viewed in Web Viewer for the app.
- Use DPS App Builder (previously called Viewer Builder) to create a custom viewer app with the appropriate settings. Select the social sharing options you want to enable. Also, specify the Publication URL and Facebook settings, if you enable Facebook.
Register your app with Facebook
It's possible that the instructions and screen shots in this document are not accurate, as Facebook updates its developer site regularly. Make the necessary adjustments.
For App Display Name, specify the name of your app. Leave the App Namespace blank, and click Continue.
Facebook sometimes asks you for additional information to verify your account. If you provide the necessary information, the Apps page appears.
Fill out the Website and Native iOS App sections at the bottom of the page.
- For Website, specify the iTunes link to the app in the Site URL field. This link shows up under “via [app name]” when users share an article.
- Under Native iOS App, specify the iOS Bundle ID (required). Enter it as it appears when you select the app in iTunes Connect or view the app in the Manage page of the DPS App Builder. The iOS Bundle ID usually has a reverse domain name, such as "com.bringhurst.dpstips." In addition, specify the iPad App Store ID. You can obtain this number from the Apple ID field in iTunes Connect or from the numbers at the end of the Site URL.
- Under Native iOS App, Adobe recommends that you set Configured for iOS SSO to Enabled (see "Additional Information" below).
- Under Native iOS App, Adobe recommends that you enable iOS Native Deep Linking so that the link bypasses the landing page on the iOS device. Deep linking is supported only in v22 viewer apps or later.
Change "Protected" settings for articles
Use the Folio Producer Editor to indicate which articles are protected. When users share an unprotected article, the link to the article itself is used. When users share a protected article, the link to the Publication URL is used.
When you publish or update the folio, the contents of unprotected articles are uploaded to a website on an Adobe server. Then, they are displayed in the Web Viewer. See Folio Producer Editor.
Limit article viewing and set up paywall
Use the Account Administration tool to enable social sharing. You can also use the tool to limit the number of articles that can be viewed and set up paywall information. See Account Administration tool.
Build a custom viewer with social media enabled
Once you register your app with Facebook, create or update your app to work with v19 or later. You can enable Facebook sharing only with multi-issue viewer apps, not with single issue viewers.
Select Enable Facebook Sharing. Specify the Facebook App ID (see step 4 above to get this value). For Share URL, specify the URL of your publication, such as http://www.mymagazine.com.
For details, see Create a custom viewer app for the iPad.
Additional Facebook configuration information
In the Share URL you specify for your app, Facebook selects an image thumbnail to display. You can edit metadata to control which image is selected. For more information, see the Facebook Object Debugger page.
Single-Sign-On (SSO) lets users sign into your app using their Facebook identity. If they are already signed into the Facebook iOS app on their device, they do not have to type a user name and password. For more information, see this Facebook developer page.