3. Edit Article-Templates (List View)

3. Edit Article-Templates (List View)
Prev	Chapter 11. Templates	Next

To select an existing article-template for editing, please click on the entry “Edit article-templates” in the menu “Templates” and open the list view “Edit article-templates”. The list view “Edit article-templates” shows a list of all article-templates.

Users with the roles of "Administrator" and "Superuser" have the right to edit article-templates.

ConPresso provides the article-template "Placeholder Demo" by default. This template demonstrates the use of all placeholders available in ConPresso. For more information on the different types of placeholders please refer to Section 1, “The Template System”.

“Name”

The column “Name”displays the name of the article-template. You can choose this name freely when you are creating an article-template and you can change it anytime afterwards.

“Manage”

The column “Manage” contains the buttons “Edit article-template”, “Edit placeholder settings”, “Copy article-template” and “Delete article-template ”.

Click on the button Edit article-template to open the view described in Section 3.1, “Edit Article-Template”. In this view you can edit the code of an article-template.

Click on the button “Edit placeholder settings” to open the view described in the section called “Edit Placeholder Settings”. In this view you can edit the sorting of placeholders as well as their settings.

Click on the button Copy article-template to open the view Section 3.3, “Copy Article-Template”.

Click on the buttonDelete article-template to delete an article-template.

	Note
	You can only delete an article-template, if it is no longer used in any article or article-version.

“Author”

The column “Author” shows the name of the user who has created the article-template.

“Last modified”

This column displays the time and date when the article-template was last edited.

“Info”

The tooltip of the symbol “Info” displays information on template sections not containing any formatting code. This code is required if the template is to be used.

3.1. Edit Article-Template

To select an existing article-template for editing, please click on the entry “Edit article-templates” in the menu “Templates” and open the list view “Edit article-templates”.

Select the article-template you want to edit by clicking on the button Edit article-template in the column “Manage” and the row of the article-template. This will open the view “Edit article-template” which contains the same fields as the view “Create article-template”: “Name”, “Rubric page”, “Article page” and “Javascript/PHP”.

	Note
	For more information on the structure and sections of article-templates please read Section 1, “The Template System” and Section 2, “Create Article Template”.

“Name”	Here you can edit the name of the article-template.
“Rubric page”	Please edit the template code for the rubric output-page here. Click on the link “Manage” below the preview window to open the the section called “Template-Editor”.
“Article page”	Please edit the template code for the article output-page here. Click on the link “Manage” below the preview window to open the the section called “Template-Editor”.
“Javascript/PHP”	Please edit the template code for content output in external projects here. Click on the link “Manage” below the preview window to open the the section called “Template-Editor”.

	Note
	A current browser version with javascript enabled is required for the template-editor to work properly. See also Section 1, “System Requirements”.

Template-Editor

Use the ConPresso template-editor to create the formatting code that is required for the output of ConPresso articles on rubric and article pages or on external pages.

The most important task of the template-editor consists in providing a comfortable way of entering placeholders. For that purpose, the template-editor has a text entry field for entering the HTML formatting code as well as various input tools for generating placeholders.

Open the template-editor in one of the views described in Section 2, “Create Article Template” and Section 3, “Edit Article-Templates (List View)” by clicking on the link “Manage” below the preview window.

	Note
	A current browser version with javascript enabled is required for the template-editor to work properly. See also Section 1, “System Requirements”. If you are using a browser that does not have the necessary editor component, you can enter the formatting code directly into the text entry field.

The menu bar of the template-editor contains the following buttons:

	Click on the button New to delete the complete content of the text entry field.
	Click on the button Save to save the formatting code. The editor window will close and the formatting code will be shown in the preview window described in Section 2, “Create Article Template” and Section 3.1, “Edit Article-Template”, .

You are probably familiar with the other editing functions of the template-editor as they are very similar to those of word processing programs. They work just like that in the template-editor.

	Click on the button Cut to cut out the formatting code you have selected.
	Click on the button Copy to copy the formatting code you have selected.
	Click on the button Paste to paste the formatting code from the clipboard.
	Click on the button Select all to select the complete content of the text entry field.
	Click on the button Undo to undo a previous action.
	Click on the button Redo to redo a previous action.

	Note
	Some of these functions are not available with some browsers for security reasons.

The following dropdown menus mainly assist you with entering placeholders into the formatting code of an article-template. In addition to that, you can use them to embed images and files into the formatting code once you have uploaded them into the system.

To create a template you can use any HTML code cut&pasted from any common HTML editor.

The dropdown menus provide the following options:

“General Placeholders”

Use the dropdown menu “General Placeholders” to insert the placeholders described in Section 1.5, “Image Placeholder (Placeholder of the Type "Image")”, Section 1.6, “File Placeholder (Placeholder of the Type "File")”, Section 1.7, “Simple Text Placeholder (Placeholder of the Type "Text")”, Section 1.8, “HTML Placeholder (Placeholder of the Type "HTML")” and Section 1.9, “Link Placeholder (Placeholder of the Type "URL")”. To insert a placeholder please select the placeholder type first and then click on “insert”. This will open a window prompting you to enter a name for this new placeholder. Confirm your entry by clicking on “OK” and ConPresso will insert the new placeholder into the formatting code.

ConPresso will display the options available for the type of placeholder you have selected. To add an option please position the cursor at the right place, that is behind the placeholder's name, select the option and click on “add”. ConPresso will then add this option to the placeholder.

“Value Placeholders”

Use the dropdown menu “Value Placeholders” to insert one of the placeholders described in Section 1.10, “Value Placeholders”. These placeholders are available by default, therefore you can insert them without having to enter a name for them.

ConPresso will display the options available for the value placeholder you have selected. To add an option please position the cursor at the right place, that is behind the placeholder's name, select the option and click on “add”. ConPresso will then add this option to the placeholder.

“Conditional Placeholders”

Use the dropdown menu “Conditional Placeholders” to insert the placeholders described in Section 1.11, “Conditional Placeholders (ifSet/ifNotSet)”. Please choose either “ifSet” or “ifNotSet” from the menu and click on “insert”.

For more information on placeholder types and their options please refer to Section 1, “The Template System”.

Each placeholder and every image or file can be used more than once in an article-template.

	Note
	Please note that the template-editor is not a WYSIWYG-editor. You have to enter the proper HTML formatting code for every image, file and text element into the text entry field.

	Tip
	Generally it is expedient (and saves a lot of time) if you just choose one of ConPresso's default templates, copy and edit it according to your own wishes.

3.2. Edit Placeholder

In ConPresso article-templates control the way an article-input layout is arranged and sorted. In a second step you can therefore edit the sorting and input-options of placeholders you have added by using the the section called “Template-Editor”. This is done in the views “Edit placeholder” and the section called “Edit Placeholder Settings”.

To edit a placeholder please open the view “Edit article-template” by clicking on the entry “Edit article-template” in the menu “Templates” first. In that view, click on the button “Edit placeholder” in the column “Manage” and the row of the article-template whose placeholders you want to edit.

The view “Edit placeholder” displays the placeholders with editable input-options contained in that article-template. Conditional placeholders (see Section 1.11, “Conditional Placeholders (ifSet/ifNotSet)”) and value placeholders are not listed because their input-options cannot be edited.

“Sorting”

Here you can influence the placeholders' sorting of the article input-layout. This sorting works independently of the article output as that is controlled by the template itself.

To change the placeholders' input-sorting just click on the up and down symbols beside them and move them to the respective direction.

“Placeholder name”

The column “Placeholder name” displays the names of the platzholders.

“Manage”

Click on the first button in the column “Manage” open the view Edit placeholder settings. (See the section called “Edit Placeholder Settings”).

Note

To create a new placeholder please open the the section called “Template-Editor”.

You cannot edit the settings of value placeholders.

“Description”

If you have entered a description for a placeholder it will be displayed in the column “Description”. Use descriptions to make editing or creating an article easier for users.

Edit Placeholder Settings

In the view “Edit placeholder settings” you can configure placeholder settings related to their input.

Open the view “Edit placeholder settings” by clicking on the button Edit placeholder settings in the column “Manage” of the view “Edit placeholder” (see Section 3.2, “Edit Placeholder”).

The settings available for all placeholder types are “Name”, “Type”, “Description” and “Don't query”. Placeholders of the type "URL" additionally have the option “Link type” and placeholders of the type "Text" have the additional option “short text”.

“Name”

This field displays the name of the selected placeholder. You cannot edit the name in this view but you can choose it freely and change it when you are creating or editing the article-template with the the section called “Template-Editor”.

“Type”

This field displays the type of the selected placeholder. You cannot change the placeholder type in this view. But you can choose and change it when you are creating or editing the article-template with the the section called “Template-Editor”.

“Description”

You can add a description to a placeholder to give some input assistance and help to content-editing users.

This description will be displayed above the input-section when a user is creating or editing an article. In case of a placeholder of the type "text" the description might be "Please enter your HTML text here and click on the link "Edit" below!". The description for an image placeholder might be "Please select an image!" You can also use the description give users an example of what to enter, like "Please enter a career status here, e.g. 'experienced > 5 years'."

“Don't query”

If you do not want a placeholder to be queried please check the box “Don't query”.

“Short text”

Check the box “Short text” to generate a single-line text entry-field for a text placeholder instead of a multi-line one.

“Link type”

“User can enter URL”	Choose this option to allow users to enter a link to any URL.
“URL to article page”	Choose this option to allow users to generate a link to the article output-page. Use this option only with placeholders that are located on the rubric output-page. Links of this type often have a link text like "More" or "More information".
“URL to rubric page”	Choose this option to allow users to generate a link to the rubric output-page where the article teaser is located. Use this option with placeholders that are located on the article output-page (or on an external page).
“"Go back" Link (Javascript)”	Choose this option to allow users to generate a "Go back" link that uses Javascript to go back to the previous page listed in the browser's history.

With the exception of the URL link, users can only edit the link text and select the type of target.

	Note
	As conditional placeholders (see Section 1.11, “Conditional Placeholders (ifSet/ifNotSet)”) and value placeholders (see Section 1.10, “Value Placeholders”) do not have any input-related options their settings cannot be edited.

Please click on the button “Save” to save the settings of the placeholder.

3.3. Copy Article-Template

From experience we know that a new article-template often only varies in detail from another, already existing article-template. In that case it is much easier to generate a copy than to create the new article-template from scratch.

To copy an article-template please open the view described in Section 3, “Edit Article-Templates (List View)” and click on the button Copy article-template in the column “Manage”. To open the view “Edit article-template” please click on the entry “Edit article-templates” in the menu “Templates”.

The view “Copy article-template” contains the fields wobei die “Name”, “Rubric page”, “Article page” and “Include”. These fields are filled with the values of the original article-template.

The text “Copy of” is added to the name of the original article-template. Now you can modify the article-template according to your wishes, please proceed as described in Section 3.1, “Edit Article-Template”. Don not forget to enter a new name for this article-template and click on the button “Save” to save your changes.

	Note
	Please remember to allow the use of this article-template in the rubrics you want it to be used in. This is done in Section 2.1, “Edit Rubric Settings”.

3.4. Delete Article-Template

To delete an article-template please open the view described in Section 3, “Edit Article-Templates (List View)”, click on the button Delete article-template in the column “Manage” and confirm your action when prompted.

You cannot delete an article-template that is used by an article or article-version saved in ConPresso. If a template is still in use, ConPresso will display the deactivated Delete article-template button.

	Caution
	Deleting an article-template cannot be undone!

Prev	Up	Next
2. Create Article Template	Home	Chapter 12. Users