Linking using a CSV file

What is the purpose of the "Import/Export Links" window?
What columns do I need to specify in my CSV?
Position and size
Appearance
Tooltips
CSV Template File
How To Use the "Import/Export Links" Window
How do you change the separator in Excel?

What is the purpose of the "Import/Export Links" window?

To speed up the creation of your links and widgets, you may upload a CSV file with the required information to automatically create them in Zmags Enriched. This allows you to add previously exported links and widgets to your publication with ease.

What columns do I need to specify in my CSV?

The 'Page' and 'Type' columns are always required:

Page - The page number of the link. Can be given as a range of pages, e.g. 2-3.
Type - The type of the link; this should be set to External, Internal, or Product.

Depending on the type of link, other values may be required as well. For internal links you must specify the Destination Page. For product links you must specify Product Name. The fields that are used with different types of links are listed below:

- URL: The URL to open for external links.
- Target: The target window to open external links in.  To open an external link in a Lightbox change Target to _ZMAGS_LIGHTBOX
- Destination Page: The destination page to navigate to for internal links.
- Product Name: The name of the product for product links.
- Product ID: The product ID of the product for product links.
- Product Description: The description of the product for product links.
- Product Price: The price of the product for product links.
- Use Product Database: TRUE tells the system to lookup the product in the product database, False uses the information defined in the above product related fields

Note: Do not use CSV files which contain a mixture of product links and other links. If you need to upload both product links and links of other types via CSV, house the product links in their own CSV file and the rest in another.

Position and size

You may also specify the position and size of the link using any of the Top, Left, Width, Height properties, or more generally using the Stretch, Horizontal Alignment, and Vertical Alignment fields. And you can specify all of the other appearance properties, such as tooltip, color, opacity, etc. All the available size and positioning properties are listed below:

- Top:The top position of the link. May be specified in the standard unit used in Enriched, or as a percentage of the page height.
- Left: The left position of the link. May be specified in the standard unit used in Enriched, or as a percentage of the page width.
- Width: The width of the link. May be specified in the standard unit used in Enriched, or as a percentage of the page width.
- Height: The height of the link. May be specified in the standard unit used in Enriched, or as a percentage of the page height.
- Stretch: May be used to stretch a link across the page, horizontally, vertically or both. The value must be one of Horizontal, Vertical, Both or None.
- Horizontal Alignment: You may use this instead of specifying a Left value. The value must be one of Left, Center, Right or None.
- Vertical Alignment: You may use this instead of specifying a Top value. The value must be one of Top, Middle, Bottom or None.

Note: You must not specify ambiguous values. For example, you cannot specify both Top and Vertical Alignment other than None.

Appearance

You may also specify the properties that control the appearance of the link:

- Opacity: Whether the link is transparent of opaque or somewhere in the middle. 100 means completely opaque, 0 means completely transparent.
- Color: HTML color code for the link, specified as e.g. #ff2222.
- Effect: You can specify the effect to use for the link, as one of: Fade InOut, Pulsating, Frame, Shadow Frame or None
- External Source: External source to show in the link instead of a solid color. Must be a Media ID (can be found in the Images section in Publicator).

Tooltips

You may specify whether to use a tooltip and any content of the tooltip using these fields:

- Tooltip Type: The type of tooltip, as one one: Text or Media
- Tooltip Text: The tooltip text to show.
- Tooltip Media Source: The media to show for the tooltip. Can be a Video or Image Media ID.
- Tooltip Media Title: The title of the tooltip media.
- Tooltip Media Description: The description of the tooltip media.

CSV Template File

In the Help menu of the Link Manager (Enriched) you may download a pre-made file to populate with your own links. This file may also be downloaded from the link below:
https://publicatorcommunity.zmags.com/hc/en-us/articles/115002562003

How To Use the "Import/Export Links" Window

Once you have created a suitable CSV file, follow the steps below to add it to your publication:

1) Login to your Zmags Publicator account.
2) Click “All Publications”
3) Click the icon in the 'Enrichments' column to the right of your publication's name.
4) Once Zmags Enriched has loaded click “Window” and then “Import/Export Links”.



5) A section opens bellow navigator click the 'Select CSV file'.
6) Click 'Upload'.



7a) You are now ready to add the links to your publication. Select the page to add links to using the drop-down menu. You may place an individual link by dragging and dropping it from the Import/Export list to the page.
7b) Alternately, to add all links in the CSV to your publication at once, simply click the "Place all links" button.

How do you change the separator in Excel?

If you need information on how to change the separator that Excel uses please follow the steps below:
1) In Microsoft Windows, click the Start button, and then click Control Panel.
2) Open the Regional and Language Options dialog box.
3) Do one of the following:

      - In Windows Vista, click the Formats tab, and then click Customize this format.
      - In Windows XP, click the Regional Options tab, and then click Customize.

4) Type a new separator in the List separator box.
5) Click OK twice.

Note: After you change the list separator character for your computer, all programs use the new character as a list separator. You can change the character back to the default character by following the same procedure.