We can provide you with basic information regarding the Template Editor. However, we cannot provide any assistance for the use of RTML or writing/debugging/using any custom templates for your store. Instructions for the correct use of RTML or information regarding how to read existing templates is not available.
The RTML Template Editor can be found by clicking on the Templates button on the Editor Toolbar in the Advanced Editor mode.
Note: If you are using a custom template, the name of the custom template will appear on the Templates button rather than the word Templates.
From there, you have to either copy an existing template or create a new one with a unique name using the Copy Template or New Template buttons.
Once you have done this and given your new or copied template a name (which must consist of only letters, numbers, and hyphens), you will be on the Template Editing screen.
There will be several button bars on this page. The top button bar will be the standard Advanced Editor toolbar.
The second button bar will be the Template Editing toolbar. This toolbar will only show active buttons for the commands that can be used at that time. Buttons that are inactive are grayed out.
The template code itself will appear as hyperlinked text. You have to select elements within your template to be able to do anything with them.
Initially, only the New button will be active. You can use this button to create an RTML element that you can edit or later insert into your template. When you create a new element, it appears underneath the current template in an area called the Stack, which has its own button bar.
The Edit button only becomes active when you have selected an element in the template or in the Stack. Clicking on that button allows you to edit any attributes associated with that element.
The Cut button cuts the selected element and places it (and any elements nested within it) on the Stack.
The Copy button copies the selected element and places the copy on the Stack.
The Paste After button is only highlighted when you have selected an RTML element in the template. This button will take whatever element is at the top of the Stack and paste it into your template after the currently selected element at the same indentation level as that element.
The Paste Within button works the same as the Paste After button, except that the element at the top of the Stack is inserted into your template within the currently selected element (one indentation level in).
The Replace button swaps the currently selected element with the element at the top of the Stack.
The Expand button shows the full attributes of the currently selected element within the the template. It becomes a Contract button when you click on it. In this way, it's like a toggle between showing the full attributes of the RTML element and not showing the full attributes.
The Stack has a button bar of its own.
The To Top button moves the currently selected element in the Stack to the top of the Stack.
The Delete button removes the currently selected element in the Stack completely.
The Clear button completely clears the Stack of all elements.
There is no Undo feature in template editing. If you make a change to a template or delete something from your Stack or clear your Stack, there is nothing that can be done to undo that change except to manually change your template back to the way it was or manually recreate the deleted/cleared elements.
Further documentation or assistance regarding RTML, the Template Editor, or custom templates is not available. We will be unable to provide any other information regarding the use of RTML or instruction for reading templates and creating your own templates.
See Also: