CMS Scripts & Styles

How does Scripts & Styles work?

When you create a customised script or style sheet in CMS, the system automatically adds them to the correct system folder. All files are minimised once you click Save to reduce load times.

The system retains historical versions of the files along with an audit trail of the date, time, and the user who made the changes. If the current version is not behaving as expected, then roll back to a previous one.

To view the scripts and styles that exist in your CMS, navigate to Advanced Content → Scripts & Styles.

Add a script or style in CMS

To best explain the functionality, we will make a simple change to the background colour of our Store Locator page.

1. In your CMS, Go to Advanced Content → Scripts & Styles.
   
   
   
2. Select Style Sheets. All existing style sheets are displayed.
   
   
3. Click Add Script/Style at the top right corner.
   
   
4. In Add Script/Style, select Style Sheet.
   
   
   
5. In File Name, enter an appropriate name that follows the naming conventions of our site.
   
   
6. Click the Add button. The system will open a blank editing window.
   
   
7. Start typing in your custom style sheet. A list of suggestions will display. Or you can paste text from a file you already created elsewhere.
   
   
   
   
8. When you have finished, click Save.
   
   
9. Click Cancel to exit out of the script editor.

Apply a script or style to a page/template

Now we will apply that style sheet to our Store Locator page (or the Page that you have chosen).

1.  In your CMS, select Content → Pages & Templates
   
   
2. At the top right of the screen, use the Search to find Store Locator. NOTE - Your page name may be different.
   
   
   
3. Click Edit for the page/template name.
   
   
4. Once in the page, click Add Widget.
   
   
   
5. In the search field, start typing 'Scripts & Styles' — the system will auto-fill the results.
   
   
   
6. Select 'Scripts & Styles' and click .  
   
   
7. The Scripts & Styles Widget automatically opens. In Description, enter a meaningful description for the use of this style. This will display next to the style name when it is in use.
   
   
8. Add a Layer if required.  (See help on adding layers.)
   
   
9. From the Scripts & Styles dropdown list, select the style you created and click Add.
   
   
   
   
10. Click Edit if you want to make some last minute changes to the Style Sheet, otherwise, to apply the script or style, toggle ON Enable widget on Save, then click Save.
    
    The CMS will now show you have applied that Script & Style. 
    
    
    
11. If the Page Preview setting is on, click Publish (top right of the screen).
    
    
12. Go to your site and open the Store Locator page (or the page to which you made changes).

Reverting to an earlier version of a script or style

CMS maintains a file history of each script and style. The file history contains information on earlier versions, including the date and time the version was saved and who the user was. If you are not happy with the current version, you can revert to an earlier one.

1. In the CMS, navigate to Advanced Content → Scripts & Styles.
   
   
2. Depending on whether you want to access the file history of a javascript or style sheet file, click on the Javascript or Style Sheets tab.
   
   
3. Click the Edit button for to the script or style.
   
   
4. In the 'Edit' page, hover on Options and click File History.
   
   
5. Any earlier versions will be listed. Click on the earlier version you wish to revert to.
   
   
6. Click on the Restore this version button.
   
   
7. Click Save. The earlier version will be copied and  saved as the latest version.

Deleting a script or style

1. In the CMS, navigate to Advanced Content → Scripts & Styles.
   
   
2. Depending on whether you want to delete a javascript or style sheet file, click on the Javascript or Style Sheets tab.
   
   
   
   
3. Notice that System files have limited functions to users. For example, the 'theme.css' file allows you to view its contents only and cannot be edited or deleted. User-created files will have both 'Edit' and 'Option' buttons.
   
   
4. To delete the file, hover over its Options button and click Delete.
   
   
5. In the 'Delete widget' box, if you are sure you want to delete this file, click OK otherwise, click Cancel.

Checking where a script or style is currently used

1. In the CMS, navigate to Advanced Content → Scripts & Styles.
   
   
2. Depending on whether you want to check a javascript or style sheet file, click on the Javascript or Style Sheets tab.
   
   
3. Find the file name, hover over its Options button and click Where It's Used.
   

Additional Information

Related help

• Page:
  Style Sheet Editor
• Page:
  Scripts & Styles
• Page:
  .css Variables for Scripts & Styles .css editor
• Page:
  Scripts & Styles Widget