Step 3: Add includes and design customizations

In step 3 of these instructions, you will add include files and make design customizations to display a header and footer on your site.

Add includes to your design

Includes are discrete assets that are pulled in to your Parse file. They allow the Parse file to remain uncluttered while providing design flexibility. Many asset types can be used as includes. Standard pages are used in this example.

Includes are created as nested assets in the Design nesters folder. Nested assets are placed in the nest_content design area. The template code is held in Standard pages.

As an example, you can nest headers and footers:

  1. Create a standard page in the Designs  Design nesters folder. Call it Header.

  2. Edit the content of the Header asset as a code component:

    1. Select Edit.

    2. Hover over the component content section, and select the settings icon. This image shows the content settings cog icon.

    3. Select Code as the component type.

    4. Select Advanced Settings.

    5. Select Raw (no formatting) from the Presentation tag drop down.

    6. Select Save.

    7. Add the following code to the component content. This code provides support for the logo image and a navigator button.

      <!-- Logo -->
      <a class="navbar-brand" href="%globals_site_url%">
      <img src="https://via.placeholder.com/75" width="75" height="75" alt="Site header logo" title="Site header logo">
      <span class="align-middle sr-only">%globals_site_name%</span>
      </a>
      <!-- Main nav toggle button -->
      <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#main-navbar" aria-controls="main-navbar" aria-expanded="false" aria-label="Toggle navigation">
      <i class="fas fa-bars"></i>
      </button>
    8. Select Save.

    This image shows the code added to a code component.
  3. Locate the <div class="container" id="navbar-toggle"> line in the parse file.

  4. Add the following design area to the Parse file after this line:

    <MySource_AREA id_name="header" design_area="nest_content" />
  5. Create a standard page in the Designs  Design nesters folder. Call it Footer.

  6. Change the component type and the formatting type, as described for Header.

  7. Add the following code to the component content:

    <footer class="pt-4 my-md-5 pt-md-5 border-top">
    <div class="container">
    <div class="row">
    <div class="col-12 col-md">
    <img class="mb-2" src="%globals_site_metadata_site-logo_asset_url%" alt="" width="24" height="24">
    <small class="d-block mb-3 text-muted">© 2022</small>
    </div>
    <div class="col-6 col-md">
    <h5>About</h5>
    </div>
    </div>
    </div>
    </footer>
    The %globals_site_metadata_site-logo_asset_url% keyword is used later to load a site logo dynamically.
  8. Check that the resulting structure looks similar to this example:

    This image shows the structure of the design part of your site when you have created the header and footer children of the Design Nesters folder.
  9. Add the following design area to the Parse file as the last entry in the <body> section:

    <MySource_AREA id_name="footer" design_area="nest_content" />

Add design customizations

To enable the nested assets' functionality, you must configure your design to use the includes within the nest content areas. To do this, you need to add a design customization.

To create a landing page design customization:

  1. Right-click on the Design asset you created and create a new child Design customization asset.

    This image shows the menu stack to create a new design customization asset. It shows the menu when you right-click on the Design asset
  2. Give it the name DESIGN - Landing Page, where DESIGN is the friendly name of your site. Keeping this friendly name within the customization name is very useful later when you are identifying which designs are applied to a given asset.

  3. Select Create.

  4. Right-click on the design customization asset and select Details.

  5. Select Edit and then select the Customize? checkboxes for both nest_content entries in the Design areas section.

  6. Select Save.

This gif shows how to enable design customizations. The cursor right-clicks on the Test site - landing page asset and selects Details. On the Details screen

Assign the nested asset to the nested content area

When you have created your design customization assets, you need to assign them to the nested content area.

To assign your nested assets to the nested content area:

  1. Right-click on the DESIGN - Landing Page customization.

  2. Select Details.

  3. Scroll down to the Design areas section, where you will see the nested asset customizations that you enabled in the last step.

    This image shows the Design Areas section of the Design asset details screen. The cursor is on the header entry of the Customised Areas list.
  4. Select Header. This will take you to the nested contents Details screen for the Header customization.

  5. Select Edit and scroll down to the Link section.

  6. Add the Header asset ID to the NESTING THE CONTENTS OF field.

  7. Select Save.

  8. Go back to the Details screen of the DESIGN - Landing Page.

  9. Go back down to the Design areas section.

  10. Select Footer to load the Footer details screen.

  11. Select Edit and scroll down to the Link section.

  12. Add the Footer asset ID to the NESTING THE CONTENTS OF field.

  13. Select Save.

Apply the design customization to the site

Now you must assign your design customization to the site asset.

  1. Right-click on the site asset and select Settings  Designs.

  2. Select Edit.

  3. Scroll to the System Defined Frontend Design section.

  4. Add the asset ID of the DESIGN - Landing Page customization asset to the Design field.

  5. Select Save.

This shows the process required to assign the design to the site. Right-click on the site

Test your changes

You can test your site in a browser in two ways:

  1. Copy the URL from the site asset and paste it into a browser.

  2. Right-click on the site asset and select Preview  In new window.

    This image shows the drop down menu that appears when you right-click on the site asset. It shows Preview selected
  3. You will see your site in the new tab.

    Screenshot of the unstyled site with a header and footer.

The footer image is not loaded yet but will be loaded dynamically in a later part. In the next part of this guide, you will style your site.