Once Content Templater is installed, you will be able to access it via the
Regular Labs - Content Templater menu link under
Components. This brings you to the component view, which lists all the templates you created.
To create a content template, simply create a new item. You will be presented with the template edit screen:
The first thing you want to do is give it a
You also find a
Description field on the right, which you can optionally use to add a more detailed note to describe what you're using the template for. You can also assign templates to simple Categories.
Under the main
Template tab, you will be greeted by a familiar interface: it features the same exact options of the article edit view, divided into tabs.
You can use the editor area to make a text snippet - which can be any content you want, formatted however you want, with any styling or code. And you can also make your template automatically set/change any settings and other fields too!
Once you're happy with your template, simply save it, and you're done.
If you want to make a simple text snippet, then you can simply place your desired content into the editor field, and ignore the other fields.
This can be any content you want, formatted however you want, with any styling or code. You can also make entire page layouts, which you can then later import in your article with one click!
By default, the content of the template will be inserted in the editor at the place where your cursor is. It will not replace the rest of the text that's already in the editor.
If you do want it to remove whatever content is in the editor, and replace it entirely with the content of the template, then you need to switch on the
Override Content option you see in the sidebar when creating/editing the Template.
Settings & Other Fields
Content Templater goes much further than just the content! In addition to the text part, you can also make your template do a lot more.
With the Free version of Content Templater, you can set any of the Article Details, like the Title, Alias, Category, Status, Access, Language, Tags...
With the Pro version, you can literally set any available option in the article edit form: this also include the Images and Links, the article Options, Publishing settings, and even Custom Fields.
For instance, you can set a Template to pre-fill the
Tags field with
Now if you create a new article, and then choose this template, the
Tags field will be automatically set to
Custom Fields PRO
With the Pro version of Content Templater, you can also set values for any Joomla Custom Field.
In the "Fields" tab, you will be able to select any Joomla Custom Field you want from a dropdown list, and then enter the desired value.
You can set an unlimited amount of Field Name/Value pairs. Simply click the
+ button to add more, or the
- button to remove a previously inserted field.
Remember that for "select" fields (like lists, checkboxes and radio buttons), the value you have to set is the option value, not the option text. If you're using Articles Field, the option value is the ID of the desired article.
And if you want to set multiple values for "select" fields, you can simply separate them by comma. For example, inserting
apples,bananas in the template, will pre-fill the field in the article with both the options
In the "Fields" tab you also have the ability to set values for extra fields that are not part of the content settings or the Joomla Custom Fields - so for example fields of other components or 3rd party CCK extensions.
To do so, choose the 'Custom' type from the dropdown list. You can then enter the field name and the desired value like normal.
The field name should match the field name you find in the HTML output of the form.
Content Templater also has support for the settings of some 3rd party extensions. If you have K2 or ZOO installed, with the Pro Version of Content Templater you will also be able to set their respective Category.
In addition, when filling fields, Content Templater will simply go through all the fields that are set in the template and set that field if it is available in the edit form - regardless of the type of content.
This means that fields such as Article Details (Title, Alias, Status, Access, Language, Tags...), Publishing settings and, of course, Custom Fields, will also be working for any other core or 3rd party extension, if those fields are used in their edit forms too.
Similarly to the behavior with the text, by default Content Templater won't replace a field that has already been filled with a value. It will only set the fields that are not already set in the article (or that are still set to their default value).
For example, if your article already had the
Tags field manually set to
Dogs, and then choose the template, then by default Content Templater will not change that
Tags field to
Cats, as it is already filled in.
If you do want the template to override all the settings of the article, even those already filled in with something else, then you need to switch on the
Override Settings option you see in the sidebar when creating/editing the Template.
Empty settings, or settings set to "Ignore", will be ignored. To force an empty value (for instance to empty the alias field), you can enter
-empty- as the value of the field.
Note: If you're inserting the Content Template from the frontend, keep in mind that frontend edit forms may have less fields available than the administrator edit forms. Content Templater can only set the values of fields available in the edit form