Set up a DPS app for social networking

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.

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.

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.

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

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.

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.

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.

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.