Skip to main content

How can we help?

Search

Legacy: SILK Wrapper

Updated: Production Edited:

Legacy: SILK Wrapper

The SILK Wrapper should not be used with Emphasis platforms. If you adopted Localist after October 2019 or have since upgraded to Emphasis, you should be using the Theme Editor and following our Brand Template instructions.

Template Clean Up Steps

Start by identifying the wrapper source you would like to use then follow these steps:

  1. Remove body content
  2. All content specific to the page (body) should be removed, so only the head, header and footer remain.
  3. Remove title tags - These are automatically added by Localist.
  4. Remove jQuery references - This is automatically added by Localist.
  5. Remove Google Analytics reference
  6. This is added by Localist when you specify your UA number in Global options.
  7. Make all URLs absolute
    Ensure all references to CSS, JavaScript, images, etc., use complete URLs.
    Responsive Design
    If your wrapper does not support responsive design, you must uncheck Responsive Design in Global Options.
  • Non-absolute URLs: /external/wcpages/styles/styles.css
  • Absolute URLs: https://yourdomain.com/external/wcpages/styles/styles.css

Adding Wrapper Comments

When adding comments to your wrapper file, you must adhere to the following requirements:

  • Comments must be on their own line.
  • Comments must use double dashes and not emdashes.
  • Comment names (head_tags) must remain lower case. 

Directly after the opening <head> <!-- LOCALIST COMMENT - START head_tags --> ...your styles/CSS/JavaScript/etc. will be here.

Directly before the closing </head> <!-- LOCALIST COMMENT - PLACEHOLDER localist_styles --> <!-- LOCALIST COMMENT - PLACEHOLDER localist_js --> <!-- LOCALIST COMMENT - END head_tags --> 

Directly after the opening <body> <!-- LOCALIST COMMENT - START before_grid --> ...any code related to your page's header should start after this.

Directly after the final bit of header code: <div class="content-wrapper"> <div class="wrapper"> <!-- LOCALIST COMMENT - END before_grid --> <!-- LOCALIST COMMENT - START body --> <!-- LOCALIST COMMENT - PLACEHOLDER user_menu --> <!-- LOCALIST COMMENT - PLACEHOLDER search_bar --> <!-- LOCALIST COMMENT - PLACEHOLDER top_bar --> <!-- LOCALIST COMMENT - PLACEHOLDER content --> <!-- LOCALIST COMMENT - END body --> <!-- LOCALIST COMMENT - START after_grid --> </div> </div> ...any code related to your page's footer should start after this.

Directly before the closing </body> <!-- LOCALIST COMMENT - END after_grid -->

 

Configuring a SILK Wrapper in Localist

  1. Start by logging into your Admin Dashboard
  2. Navigate to Settings > Appearance
  3. Add your wrapper URL to the SILK Wrapper URL field
    The URL must be publicly accessible.
  4. Save Changes
  5. Once you select Save Changes a "Refresh Wrapper" link will appear under the wrapper field.
  6. Select the "Refresh Wrapper" link to officially import your new branding. Localist will refresh your wrapper once every 24 hours automatically, but if you need to force an update in the future this link will do the trick.

 

- HEADS UP -

Here are some helpful troubleshooting tips to try before you reach out to the support team!

  • Styles are not displaying as expected: It’s all in the details here -- in order for Localist to display the styles in your wrapper the URLs must be absolute. If you are using SSL on your site, then the URLs must begin with https rather than http.
  • Fonts are not displaying as expected: If you have purchased a font that can only be used by your organization’s domain then you will not be able to apply it to your Localist platform unless you add your Localist domain to the font license.
  • Content is missing: All comments in your wrapper must be on their own individual lines.
    Localist won't save the wrapper URL: Likewise, all comments in your wrapper must be on their own individual lines. Also make sure the file is public and that the server hosting the wrapper is providing the file as expected.
  • I removed the SILK Wrapper but it still applied to my theme: To properly remove a SILK Wrapper, you need to 1) remove the URL 2) click "Refresh Wrapper", 3) Save Changes. If you removed the Wrapper without completing Step 2, you'll need to 1) Add the Wrapper URL back 2) Save Changes before following the instructions to properly remove your Wrapper.
Related Articles: Intro to Branding Tools | Colors, Fonts & CSS | Theme Editor

Related articles