Adding article components to an existing article in Content Station 10 - configuration
Once the article is created, users can add or remove article components manually when needed. Adding an article component is done by choosing it from a list.
Figure: Adding an article component in the Print editor of Content Station 10.
The following can be configured:
- Which article components are available in the list 1
- Which paragraph style should be applied to the text when a component is added 1
- If an article component can be added only once or multiple times
1 Requires Content Station 10.16 or higher.
Configuration is done on Enterprise Server and can be made to work across all Brands and/or to work across specific Brands.
The method of configuring article components has changed since Content Station 10.16 with the introduction of the Management console.
The steps described here assumes that you are using Content Station 10.16 or higher. For information about the method for Content Station 10.15 or lower, see the bottom of this article.
About the Management console
Info: This feature requires Content Station 10.16 or higher.
The Management console is made available through the Content Station 10 Server plug-in. It is assumed here that this plug-in is fully installed and working.
Accessing the Management console
Log in to Enterprise Server using an admin account, open the Integrations page and click the Content Station 10 icon. The Management console is shown.
It currently only contains the option to manage article components.
The Article components page
The Article components page contains a list of the Brands that are available in Enterprise and the article components that have been configured for each Brand (if any).
Note: When loading the page for the first time, the information for the components section is loaded from the componentDefs.xml file.
Show me the location of this file
<Enterprise Server path>/config
This data is subsequently stored in the Enterprise database. Any changes made on the page are therefore also stored in the database and will not be reflected in the componentDefs.xml file.
Configuring the available article components
For each Brand you can configure which article components appear in the list when a user clicks the option to add a component.
Each Brand by default makes use of the components of the Global Brand unless specific components are assigned to it.
Use one of the following methods:
- Create a component manually by clicking 'Add a new component' or 'Add new' in a Brand.
- Copy all components from another Brand by accessing a Brand to which no components have been added yet and clicking 'Copy from another Brand'
- Copy components to another Brand by selecting one or more components in a Brand and clicking 'Copy to...' .
Select a component and click Delete.
Click on a name to edit it.
Click a component, hold it, and move it to the new position.
Setting the paragraph style
Each component will typically display text in a specific style.
Example: The text in a header component will look different than the text in a sub-header or body component.
For each component you can define which paragraph style should be automatically applied to the text when the component is added. This makes sure that:
- The correct styling is used
- Users do not have to assign the paragraph style manually
Add the paragraph style to a component by clicking the Paragraph style field and typing the name of the style.
Note: The spelling of the name should be identical to the name as it exists in the article (apart from the use of upper and lower cases: this is not checked).
Tip: Include the group name when the style is placed in a style group: My Style Group/style name.
Controlling how many times a component can be added
Some components should only exist once in an article while other components typically occur multiple times.
Example: An article typically has one header component and multiple body and graphic components.
To control this, enable or disable the option 'Allow more than once'. When enabled, the component will remain available in the list for a user to add; when disabled the component will not appear in the list when it is already available in the article (for example after adding it).
Configuration for Content Station 10.15 or lower
Configuring article components in Content Station 10.15 or lower is done in the componentDefs.xml file on Enterprise Server.
Step 1. Access the componentDefs.xml file.
<Enterprise Server path>/config
The article components are defined between the
<components> </components> tags.
The following syntax is used:
<component name="name" default="true" parastyle="" allowmultipleinstances="true"/>
nameis the name of the component. Make sure that it corresponds with the name of the components that are set up in other areas of Enterprise, such as in Smart Connection for InDesign and InCopy.
- default is not used in Content Station 10.
- parastyle is not used in Content Station 10.
allowmultipleinstancesdefines if the component can be used more than once. Possible values: "true" and "false".
Note: When this value is set to "false", the component is removed from the Components list in Content Station as soon as the component is part of the article. This is the case when the component is already part of the article component, or when it is manually added by the user.
Example: You might want to set this option to 'true' for graphic components while setting it to 'false' for the header component.
Step 2. Configure the required components as necessary.
Configuration for all Brands versus configuration for specific Brands
<components> </components> tags are themselves placed between the
<brand> </brand> tags. These carry an ID by which you can define to which Brands the settings apply.
When only one Brand is defined, the ID is set to "default" and all settings are used across all Brands:
To make the settings specific to a Brand, we can replace "default" by the Brand ID:
Step 1. Open a Web browser and log in to Enterprise Server.
Step 2. In the Maintenance menu or on the Home page, click Brands. A page showing a list of all Brands appears.
Step 3. Click on the Brand for which you need the ID.
The Brand Maintenance page appears. The Brand ID is shown at the end of the URL in the address bar of the browser.
Example: Here, the Brand ID is 1:
We also have to add the following line of code to make sure that the default settings for the Brand are overridden:
Note: When this line of code is not provided or is set to 'true', the settings for the default Brand are used.
Typically, you would have settings set up for a default Brand, plus additional settings for each specific Brand.
Example: Here, settings for a default Brand is set up and one additional group of settings for Brand with ID '1'.
- 21 February 2017: Added information about configuring article components using the Management console.