In an increasingly fast paced world, it is more important than ever to create content that can be considered 'channel neutral' and to output this content to different channels.
One of the digital channels to output to is Pugpig. To make publishing from Studio to Pugpig possible, Pugpig needs to be set up as a custom Publish Channel in Studio.
How this is done is explained in this article.
For information about Pugpig, see the Pugpig website.
To take advantage of the full Pugpig format and Pugpig functionality included with Studio, the following is required:
- Studio Server 10.10.0 or any higher version of Studio Server 10.
- Studio 11.112 or higher.
- A Web server to publish the article to from where it is pushed to Pugpig, such as Studio Server or any other place where it can be hosted and accessed publicly.
- Access to the Pugpig distribution center.
How it works
An article for Pugpig is a set of files in JSON, HTML, and PSV format.
These files are hosted on your existing content management system (CMS) and then pushed to Pugpig using the Pugpig RSS feed.
In Studio, a channel is set up which users can select when publishing an article from within the Digital editor.
Configuration steps are required in Pugpig and Studio.
- Obtaining access to the Pugpig distribution service
- Setting up a Pugpig app
- Setting up a Pugpig RSS feed
- Setting up a channel in Studio
- Setting up metadata fields
- Setting up a style
- Testing the environment
Info: Use the filer to only show information for one step.
1. Obtaining access to the Pugpig distribution service
The Pugpig distribution service is a paid platform and requires a license to access it.
This license is distributed and maintained by Pugpig. For more information visit www.pugpig.com.
2. Setting up a Pugpig app
Pushing articles from Studio to Pugpig’s distribution center requires the Pugpig app (also known as an SDK or App Container) to be set up.
This is done by the Pugpig team.
For more information, see the Pugpig Software & Service Specification.
3. Setting up a Pugpig RSS feed
When an article is published from Studio, it is first placed on a Web server from where it is then pushed to Pugpig. Pushing the article to Pugpig is done by making use of the Pugpig RSS feed. This feed needs to be set up and the resulting URL is later needed for configuring Studio.
Follow the steps for setting up a Pugpig RSS feed and note down the URL.
4. Setting up a channel in Studio
In Studio, every custom channel is configured with an 'endpoint' that Studio sends messages to when the article is published.
In the context of publishing to Pugpig, having this endpoint makes it possible for Digital articles to be pushed from Studio to Pugpig.
To set this up, follow all steps in Configuring Studio for publishing to a custom Publish Channel. For setting up the custom channel in Studio, use the following settings:
- Name: The name you want to give this channel. This name will appear in the list of Publish channels that the user can choose from.
- Target name: The name of the type of target you want to publish to. The user interface will group channels with the same Target name in the Publish dialog.
- Endpoint URL: The Pugpig RSS feed as set up earlier.
- Reference images by ID only (actual images will not be sent). Select this option when only a reference to any images in the story need to be included, not the actual images.
- Export formats. Make sure that the formats JSON, HTML and PSV are selected.
- Custom data. Not required.
- Maximum width and height for images in Assets. (See Optimizing images for publishing a Digital article in Studio) Assets images that are published to a digital channel and which have a format bigger than 2500 x 2500 pixels are automatically downsized to that format. To change this format, set a custom width and/or height.
5. Setting up metadata fields
The Pugpig publication requires various types of information such as the title, authors, page number, and so on.
This information is added as a property in the Properties dialog for the article in Studio and is mapped to the corresponding metadata field of Pugpig during the publishing process.
The metadata fields used are a combination of default metadata fields and custom metadata fields.
Default metadata fields
The following default metadata fields are mapped to fields in Pugpig:
|Studio Server field name||Field type||Pugpig metadata field / remark|
|Name||Static property||Page Title (when the Headline field is not used)|
|Used In (Issue > Name)||Static property||Edition > Title|
|Formatted (Modified On)||XMP properties||The timestamp of the last time the file was edited in Studio.|
Custom metadata fields
Pugpig requires additional information other than what is provided through the above mentioned default fields. Providing this information is done through custom metadata fields.
It is recommended to set up the custom metadata fields described below.
Note: Based on your publication the needs and fields can vary.
Step 1. Set up the following custom metadata fields as described in Adding a custom metadata property in Studio Server.
|Field name||Field display name||Field type||Pugpig metadata field / remark|
|C_HEADLINE||Headline||String||Page Title (if empty, the Name field is used)|
|C_ON_SALE_DATE||On Sale Date||Date||Issued|
Defines if the article is provided free or paid.
This setting is overridden by the subscription server.
|Defines if the article is displayed as Edit or Advert. A blank space equals Edit, and is generally selected by default.|
|C_TOC||Hide from TOC||Boolean||Hides the article from displaying in the Table of Contents. Field name is 'Hidden'. Requires a value of '1' to be sent as 'hide from TOC'.|
Sets the article as the cover. Requires a value of '1' to be sent as the cover.
Default value: 0.
|Defines if the article should appear in the preview App or is ready for 'live production'. If On Sale date and Status are both met, the issue will go live.|
|C_PP_ISSUE_ID||Issue ID||String||Feeds into the Brands subscription server.|
Step 2. Add the above created custom meta fields to the Properties dialog box as described in Adding a property to a dialog box in Studio Server.
6. Setting up a style
Creating a Digital article in Studio is done by basing it on a template. This template contains a Style that controls the look and feel of how the Story should visually display.
Each specific publication in Pugpig can utilize a dedicated style. Set this up by following the steps in Styling a Story in the Digital editor of Studio by using Styles.
Tip: WoodWing Digital Services provides a service for outsourcing the production of a digital magazine, including the creation of custom templates for your brand. For more information, see the WoodWing website.
7. Testing the environment
To test to see if the system is set up correctly, follow the steps as outlined in Publishing to Pugpig using Studio.
Using the Pugpig test app, obtained by working with Pugpig’s team, you will be able to publish stories to the Pugpig distribution center. Stories will be viewable on desktop in the distribution center or on the mobile test app. For more information on publishing with a Pugpig test app, contact Pugpig directly.