DPS social sharing is no longer supported for iOS 6

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:

  1. If you plan to enable Facebook, register your app with Facebook. When you do so, a Facebook App ID is generated.
  2. If you have not already done so, create a web page for your publication. The URL for this page is called the "Publication URL."
  3. 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.
  4. 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.
  5. 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.
  6. 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.

  1. If you are not signed in, click Login in the title bar, and sign in using the publisher's Facebook account. Or, create a Facebook account. For information about which Facebook account to use, contact Facebook.

  2. Click Apps in the title bar, click Allow (if acceptable), and click Create New App.

  3. For App Display Name, specify the name of your app. Leave the App Namespace blank, and click Continue.

    The DPS Tips app is an example. Specify the appropriate data for your app.

    Create new app

    Facebook sometimes asks you for additional information to verify your account. If you provide the necessary information, the Apps page appears.

    Facebook developers

    Notice the App ID value. Use this value to enter in the Facebook App ID field of DPS App Builder.

  4. If you have multiple apps, select the app and choose Edit Settings.

  5. Fill out the Basic Info section as desired. You can leave settings blank.

  6. 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.
    Select how your app integrates with Facebook

    This example shows the App Store ID of the DPS Tips app. I copied and pasted the numeric string from the Site URL into the iPad App Store ID field.

  7. Click Save Changes. If you get one or more error messages, select Save Changes a second time after a few moments to allow your app data to be retrieved.

  8. Click Advanced in the upper-left panel. Under Authentication, select "Native/Desktop" for App Type.

    Select Native/Desktop for App Type
  9. Specify a Privacy Policy URL. Facebook requires you to specify a web page that describes privacy policy information.

  10. Click Save Changes.

Twitter guidance

It's unnecessary to do anything on the Twitter site to enable Twitter for DPS social sharing.

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.

Additional Facebook configuration information

Display a different thumbnail image

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.

Implement Single Sign-On (SSO)

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.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy