User Tools

Site Tools


Sidebar

admin_menu:design:page_attachments:start

This is an old revision of the document!


Page Attachments

<tip c n>Note: This page needs to be updated, the screenshots may not reflect how things look in the admin panel in the latest release.</tip>

Working With Template Set(s)

See: Working With Template Set(s)

Note that the attachments listed on this page are only pulled from the template set(s) currently working with.

Template(s) to Page Attachments

This section will list every page in the system, and show the current template file attachment set. Click the Edit button on any row to edit the template attachment(s) for that page.

Page Column

This column displays the page ID and page name.

Default Template Attached column

This column displays the main template attached for that page. This is the template that is used if there is no language-specific or category-specific template attachment specific for the language/category currently being used/viewed, in other words this is the "catch all" template attachment if no other template attachments for that particular page apply.

Next to the template file, in [brackets] it will list every template set that the template was found in (within the currently set template sets being worked with of course). For convenience, you can click on any of the listed template sets to go directly to the page to edit the contents of that template in that template set. The template sets listed are done so in the order that the system would naturally be "looking" for them, so the first template set listed would be the one that the template is used from1).

<tip c n>Note: An attachment setting only specifies the "local" template file that will be used as the template to display that page, the actual template set is not specified in the attachment setting. That is why it lists all of the template sets that each template file is found in.</tip>

Attachment File column

The attachment file, is the file that a page's template attachments are saved in. It will be a PHP file, that works sort of like the config.php file, except that the files are updated by the admin panel2).

In this column, it first lists the template set folder that the attachment file settings were "pulled" from for the info displayed on this page. Next it shows the filename, with the beginning of the file's location truncated for brevity. If you hover over the truncated file name, it will show the file's full path, relative to the template set folder.

Template(s) to Addon Page Attachments

If you currently have any addons that have their own pages, such as the Storefront Addon, this section will list all of the template attachments for those addon pages.

Click the Edit button next to any of the addon pages to edit that page's template attachments.

Addon column

This column lists the addon's name, as it is listed under Addons > Manage Addons.

Page column

This is the page index, this together with the addon name is how a page is identified in the system. It will look something like "page_name". If it is not clear what a particular page is used for by the page index, consult the addon's documentation or ask the addon's author.

Default Template Attached column (in addon page attachments)

Attachment File column (in addon page attachments)

Additional Storefront Template Options For Your Storefront Clients

You can provide a choice of storefront templates to choose from for your storefront clients by assigning multiple templates to the storefront home page as described above. The name of the template choice on the client side will be the actual name of the template file you assign.

1)
Assuming that template set is active
2)
No manual editing of attachment files is ever needed, however if you prefer to manually edit them you can.
admin_menu/design/page_attachments/start.1267487289.txt.gz · Last modified: 2014/09/25 16:55 (external edit)