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.
Folio Author for WordPress is a plugin for WordPress that enables publishers to create HTML articles and folios for Adobe Digital Publishing Suite (DPS), directly from their WordPress instance. Using this plugin, publishers can streamline the creation and management of their content on DPS apps across multiple devices.
Installation of Folio Author is available through GitHub http://studiomercury.github.io/folio-author-plugin-for-wordpress/, where simple steps for download and installation are also provided as they are below:
Navigate to settings tab under Folio Producer in the WordPress sidebar to set up Folio Author plugin.
There are three main sections in the settings page: API Key/Secret entry, Folio Producer Account Setup and Device List.
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 Folio Author module to directly connect to the Folio Producer APIs, publishers can maintain a sync status with all article content published through WordPress. Publishing through the Folio Producer APIs will streamline the WordPress folio publishing workflow by uploading the article content directly to Folio Producer. You will also need to enter the login for the DPS account you wish to publish to, along with the corresponding password.
Note: We do not recommend using your production account for the plugin. The plugin does not let you publish a folio. We recommend creating a separate or review account to connect with the plugin. Once the folio is finalized in the review account it can be shared with the production account for publishing.
We include helpful tips on rollover to help get you acquainted with the plugin. You can turn off these tooltips by checking “disable tooltips around the plugin”
You can also enable “automatically make a TOC preview image” which generates the TOC preview image using the first image in the body content or attached featured image.
The plugin also allows you to pre-set a default template for new articles you create.
You can also select an HTMLResources.zip file that will be included with every folio rendition that gets uploaded.
The device list holds a preset list of devices. You can select devices to which you will want to publish here, or add new devices by entering name, slug, dimensions, and device type (mobile/tablet), then clicking “add device to list.” The Folio Author plugin allows you to publish to any device that supports Adobe Digital Publishing Suite.
Folio Author organizes things a bit differently than Adobe’s Online Folio Producer Tools. The biggest change is the introduction of issues. While a folio is a collection of articles, an issue is a grouping of folios. Take for example a company wanting to publish a monthly edition to iPhone, iPad and a few Android devices. An issue would be the “December 2013 Issue” of the publication and inside that issue would be folio renditions for iPhone, iPad, and other devices. Grouping folios by issue allows the grouped folio renditions to share basic metadata that DPS uses to deliver the correct rendition to the targeted device.
Articles also have a hierarchy as well. The first time you create an article it becomes the original article. Whenever you add that article to a rendition, it’s duplicated and added to your rendition, giving the ability to make changes specific that particular rendition. If you ever make a significant change to the original article, you can always push those changes to child articles living in their respective renditions. Below is an example of issue / article / rendition hierarchy.
Issue (January 2014 edition of your magazine)
Under the issues tab, you can begin to create new issues.
Under the Articles tab you can either create articles from scratch or import posts from your WordPress instance as articles. In this view, you will see a list of parent articles and also see what device renditions have been made of any given article.
Once you have Articles ready for your issue you can associate them to folio renditions in the Folios tab, under your Issue and your first folio rendition.
Once everything is ready in a folio rendition, you can push to the cloud by clicking on the “push rendition to the cloud” button that appears next to the folio rendition’s metadata.
At any time after the folio rendition appears in the cloud, you can push individual article updates or whole folio updates back to the cloud.
Mercury has provided basic templates for creating articles. You can take these samples and make them your own by copying the dps-templates into your theme folder.
Duplicate the templates-dps folder from within the plugin folder to your theme folder. From here you can edit existing templates or even add your own.
Default templates are based on Bootstrap but you can use any UI framework you’d like.
Once the plugin is installed, configured, and tested, the next step would be to make it your own. The templates provided are basic examples for creating a folio. The next step would be to copy the templates-dps folder out of the plugin folder and into your theme folder. These templates can then be made your own by editing them and changing styles.
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.