Search…
⌃K

iPaper Links

Data

Our recommended way of supplying data for the processing of the flipbook is by adding the data as an attached file in the PDF. To reach the end goal in the fastest manner we have a sample CSV embedded in our sample PDF, if that structure is followed it requires close to no customization to get up and running. Besides CSV we currently support Excel, XML, Json and Google Merchant Feed, CSV is preferred for proof of concepts as it’s fast to reiterate on.
⚠ This documentation is intended for 3rd party PDF generation systems, to enable a fully automated PDF, Flipbook and Enrichment creation process.
If you want to explore how you can manually tag your PDF files to enable a more efficient Enrichment Automation, reach out to support or take a look here.

Sample CSV Data Structure

The current CSV data format is setup to support current and future enrichment types
Column Name
Description
Id
Id that is referenced in the {Id} below in the URL Structure
Description
Description is used for product description in shop links
HoverText
Hovertext will appear when hovering the link in the final flipbook after processing
HrefTarget
In the case a url should render as a link type it's possible to control the href target, see MDN Web Docs for reference
Name
Name of the product when rendered as a product link
Url
Target url when rendering external links
MediaUrl
Used for which content should be rendered in Image, Image Popup, Video or Video Popup enrichment types
Price
Used as product price when rendering shop links
AsPopup
Used to designate if the link should be rendered as a popup frame enrichment type
PopupFrameMaxWidth
Controls the width of the popup frame that will be opened from a popup frame enrichment type
PopupFrameMaxHeight
Controls the height of the popup frame that will be opened from a popup frame enrichment type

Enrichments

All enrichments should be drawn as hyperlinks in the PDF, where there can only be one click action on the box. The links must be written in accordance to the following specifications. The enrichment in the flipbook will be drawn at the same size of the link box in Adobe PDF. The hyperlinks for match can be placed in a non-visible layer to ensure that the links doesn’t have a negative impact on the looks of the final flipbook.

URL Structure

  • ipaper://{Behavior}/{Id}

Behaviors

  • ipaper://ExternalLink/{Id}
  • ipaper://ExternalLink/{Id}/{AppearanceName}
Creates an external link that will be opened in accordance with HrefTarget in the data file, if no value is supplied for HrefTarget it will default to _blank. The actual will be defined by the Url in the data file. In the case a AsPopup with the value true is included in the data file this will be rendered as a popup frame inside the flipbook instead of an external link.
  • ipaper://PageLink/{Id}
  • ipaper://PageLink/{Id}/{AppearanceName}
To create a link that leads to a different page in the flipbook, in the sample data file you will be able to see that the page value is set in the Url column to ensure that there is an alignment between internal an external links.

Shop

  • ipaper://Shop/{Id}
  • ipaper://Shop/{Id}/{AppearanceName}
The Id will have to match a product record in the attached datasource, if the product is found a link will be drawn and give the option to add that individual item to the shopping basket of the flipbook for later checkout. Id can consist of characters and letters.

Inline Video

  • ipaper://InlineVideo/{Id}
  • ipaper://InlineVideo/{Id}/{AppearanceName}
This renders the video from MediaUrl in the page with the size of the drawn linkbox.
  • ipaper://PopupVideo/{Id}
  • ipaper://PopupVideo/{Id}/{AppearanceName}
Opens the video from MediaUrl column in a popup in the flipbook.

Inline Image

  • ipaper://InlineImage/{Id}/
  • ipaper://InlineImage/{Id}/{AppearanceName}
Draws the image from MediaUrl column in the page with the size of the link box.
  • ipaper://PopupImage/{Id}/
  • ipaper://PopupImage/{Id}/{AppearanceName}
Opens the image from MediaUrl column in a popup

Enrichment Appearance

Appearance will be defined in the configuration set up in coordinance with Customer Care to ensure the best matching look for the individual customer. In many cases that configuration can be reused as this specification should ensure a certain flow that doesn’t need much customization.
Regarding images that is being used for enrichments it will be possible to add files in the pattern File.ext as embedded files in the PDF. Valid extensions are PNG, GIF, JPG and SVG.
In the case there are more than one appearance set up in the configuration the {AppearanceName} will have to be added to the links to ensure which appearance the individual enrichment will end up with. Besides the name being added to the links, when having multiple files for different appearances the files should be prefixed with {AppearanceName}- so the format ends up being {AppearanceName}-File.ext If only one appearance have been configured there is no need for adding it to the urls or the files as we will detect that only one set is present and use that pr. default.

Sample Enrichment Automation

In the attached sample code this configurations is being used for processing in accordance with the attached PDF. Result of the processing can be seen here: https://demopartner.ipapercms.dk/sdp/test-enrichmentautomation/
<options>
<custom-link-import-configuration>
<EnrichmentAutomation version="1">
<Properties>
<Id>{$Id}</Id>
<HoverText>{$HoverText}</HoverText>
<Description>{$Description}</Description>
<Url>{$Url}</Url>
</Properties>
<PdfResource type="iPaperLink" />
<Appearance name="Other">
<!-- PLEASE NOTE THE FILENAME IS WITHOUT THE EXTENSION -->
<Icon fileID="{PdfAttachments.File2.Id}">
<ScaleFactor>0.1</ScaleFactor>
<OffsetX>-10</OffsetX>
<OffsetY>-10</OffsetY>
<WordOrigin>TopLeft</WordOrigin>
<Origin>TopLeft</Origin>
</Icon>
</Appearance>
<Appearance>
<!-- PLEASE NOTE THE FILENAME IS WITHOUT THE EXTENSION -->
<Icon fileID="{PdfAttachments.File1.Id}">
<ScaleFactor>0.2</ScaleFactor>
<OffsetX>-10</OffsetX>
<OffsetY>-10</OffsetY>
<WordOrigin>TopLeft</WordOrigin>
<Origin>TopLeft</Origin>
</Icon>
</Appearance>
</EnrichmentAutomation>
</custom-link-import-configuration>
</options>