13 December 2013
To follow along with this tutorial you will need:
Required Adobe products
Additional required other products
Note: If you have questions about this article, use the comments feature at the bottom of the article. Please don’t contact technical support with questions about Adobe Developer Connection articles.
DPS Bridge is a free module for the Drupal 7 open source content management system. Once enabled, DPS Bridge gives publishers the ability to export Drupal article content for inclusion in Adobe Digital Publishing Suite Folios. Adobe DPS Enterprise publishers can use DPS Bridge to upload Drupal article content directly to the Adobe Folio Producer site and can continually check to make sure articles are in sync with the latest changes.
Detailed installation instructions are included in the DPS Bridge Readme.
Before installing DPS Bridge, first make sure that the following Drupal modules have been installed and enabled:
Download the latest version of the DPS Bridge module [coming soon].
After installing the DPS Bridge module, enable it by going to the Adobe section on the module configuration page.
Note: In the module description you will see a list of dependencies. Make sure that each dependent module has been enabled.
Note: Please disable the Overlay module as it will interfere with functions in the DPS Bridge module.
Next, go to the structure menu, and under Blocks look for “Adobe Folio Creator.” Click configure and under the Administration theme, choose “Content” from the dropdown menu. After saving the block you will notice three buttons – Folio Article Selection | Folio Management View | Adobe DPS Folio Module Config. If you want to restrict these buttons from appearing on all pages, you can restrict their display in the block settings.
DPS Bridge has three main functions – 1) Article Selection 2) Folio Management 3) Module Configuration. By default, only admin users can access these module functions. To enable additional user roles and permissions, go to the People menu and under Permissions locate “Drupal to Adobe DPS.” From this menu you can enable different module permissions for various user classes.
Navigate to http://[yourservername]/fpconfig to setup the DPS Bridge module.
There are three main sections in the module configuration page: API Key/Secret entry, Folio Producer account setup and Publication Stylesheet management.
If you are a DPS Enterprise licensed publisher you can contact your Adobe representative to request a unique Folio Producer API Key and Secret. By enabling the DPS Bridge module to directly connect to the Folio Producer APIs, publishers can maintain a sync status with all article content published through Drupal. Publishing through the Folio Producer APIs will streamline the Drupal folio publishing workflow by uploading the article content directly to Folio Producer (requires no interaction with Adobe InDesign). The module will also automatically generate a Cover article and Table of Contents article if desired.
As rendition mapping to various Android based devices can be a little tricky, we have found that most publishers producing Folios for multiple markplaces tend to silo content into different accounts. By publishing Folios into marketplace specific accounts, publishers can have full control over which Folios will end up on specfic devices. Having this level of control also allows the publisher to make marketplace adjustments, such as replacing advertisements.
Publishing to each marketplace is optional and is not required. For each marketplace that you wish to target you can enter in the associated Adobe ID and password. Alongside the username and password, you can also define which dimensions you would like to allow a user to select when publishing to a specific marketplace. For example, if you are publishing Folios to Apple but currently only have an iPad app available, you may restrict content from being created at the iPhone dimensions (1136 x 640, 960 x 640 & 480 x 320).
Currently, Publication Stylesheet templates are managed at the module configuration level. Stylesheets added to this list will be available to select when building a new Drupal Folio. As all HTML articles within Drupal need to conform to a specific DPS Folio article schema we have written an export translation that will map all Drupal Node elements to their appropriate corresponding fields with the DPS article schema. To ensure that all mapped elements are styled, we settled on building style translations based off of two popular responsive CSS frameworks – Foundation and Bootstrap. Stylesheet templates based off of one of these two frameworks will likely work with minor tweaks.
When adding a new Stylesheet to the listing of available publication stylesheets, the DPS Bridge module will ask you if the styles that you are about to upload are a derivitive of Bootstrap or Foundation. Choosing the appropriate framework here ensures that all Drupal node elements will be translated correctly.
The "Test Connection" button in the DPS Bridge module configuration page is used to ensure that Drupal can connect to Adobe DPS Folio Producer using the supplied API Key, Secret, and Adobe ID. A successful connection will display the message in the figure below.
A failed connection will display the message below.
Navigate to http://[yourservername]/fpselect to begin selecting content for inclusion in a DPS Folio.
Video: Article Selection
By default the DPS Bridge module will show a listing of all published and unpublished Drupal article nodes. To create a set of search and filter fields watch the video below:
Video: Article Selection: View Filters
Tip: For quick access to any of the DPS Bridge module pages, make sure to add the individual pages to the Admin shortcut menu bar.
Navigate to http://[yourservername]/fpmanage to begin managing DPS Folios.
The Folio Status page displays a listing of all Folios created in Drupal. While other Folios created outside of Drupal may exist for a particular publication account they will not be displayed in this list as Drupal would have no internal reference to the content. If you have multiple Adobe IDs configured for Amazon, Apple, and Google, the Folio Status page will list provide a complete list of all Folios pretaining to these accounts.
For publishers already familiar with DPS, the initial fields viewed here should look familiar. Folio Name, Publication Name, Folio Number, Description, Publication Date and Viewer Version all map to corresponding fields in Adobe Folio Producer. The Status field is used to indicate if the Folio has been uploaded to Folio Producer. Folios with the status “Not Uploaded” exist in Drupal only and are not yet available in Adobe Folio Producer. Folios uploaded from Drupal to Folio Producer are a static copy of all articles at the time of upload. The Sync Status field in Drupal offers an at-a-glance indication of whether or not the Folio contains any articles that have been modified in Drupal post-upload.
If you are a DPS Professional licensed publisher you will not have access to obtain API Keys that would allow for automatic uploading of Drupal content to Folio Producer. Fear not, as there is still a way for you to use the DPS Bridge module. Follow the steps in the video below:
Video: Export to HTML Stacks
Creating a hybrid publication that contains a mixture of Drupal HTML articles alongside InDesign created content is an attractive option for publishers that wish to insert PDF or InDesign based advertisements. A hybrid publication may also be necessary in the case of highly designed feature articles that cannot be achieved through HTML and CSS.
InDesign based content that is added to a Drupal managed Folio will appear in the Folio details page as a locked item. The placement and order of the locked article can be managed within Drupal, but all metadata and content will need to be modified via the InDesign Folio Builder panel, or the Folio Producer web site.
Video: Hybrid publishing
Watch the video below to see how a user can download, alter, and then upload a new version of a publication stylesheet.
Video: Editing stylesheets
Folio Producer API Keys are available to DPS Enterprise customers upon request. Contact your Adobe or DPS Partner representative for more information.
If you'd like to learn more about DPSBridge and how DPCI can help you get up and running, please contact Natasha Davis at (800) 818-2905.
Comments are currently closed as we migrate to a new commenting system. In the interim, please provide any feedback using our feedback form. Thank you for your patience.