Scriptlet Management

Although you can edit the content of scriptlets using the on screen editor, for other management tasks and for advanced features you need to use the scriptlet management pages in the merchant administration.  They can be accessed at any time by choosing Website > Content and Layout on the menu bar:

From the management screen, you can add, copy, edit, and delete scriptlets.  You may notice that you cannot delete the default scriptlets that we have provided.  If you edit one of the default scriptlets, you are actually modifying your own custom scriptlet using the same name.  If you delete your scriptlet, the original default scriptlet will return.

Scriptlets are partially identified by their type.  This determines the selector that the scriptlet will appear in when viewing the on screen editor.  Layout scriptlets will not appear in the sidebar selector, and vice versa.

Editing a Scriptlet

When you edit a scriptlet from this page, you have options beyond those offered in the on screen editor.  You can edit the name and description of the scriptlet.  But of more interest may be the ”r;Header” field.

Any text you enter here will be output in the HEAD portion of the HTML page where the scriptlet is placed.  This can be helpful if, for example, you need to output javascript with your scriptlet.

Layout Scriptlets

Layout scriptlets have all of the features of the other scriptlets, but they also support additional tags that tell AbleCommerce where the page sections should be displayed.  A layout scriptlet can contain the following identifiers:

[[layout:header]]

[[layout:sidebar]]

[[layout:content]]

[[layout:sidebar2]]

[[layout:footer]]

Wherever these identifiers appear, the currently selected scriptlet for the page will be displayed instead.  Do not use an identifier more than once.  If an identifier is not used in the layout scriptlet, the selection in the on screen editor will be ignored.

Scriptlet Storage

The scriptlets for your store are not stored in the database.  Instead, they are saved as files in the App_Data\Scriptlets folder as shown in the figure to the right.

Scriptlets you create are stored in the ”r;Custom” folder.  Scriptlets we provide are found in the ”r;Default” folder.  You should not modify scriptlets in the default folder as they may be overwritten during upgrades.

You can modify the files directly in these folders if you wish.  Scriptlets are regular HTML files, so they can be opened with your favorite editor.

These scriptlet files are cached in server memory to speed up the page processing.