Settings

The Settings global blueprint is used throughout the backend and frontend to configure options throughout the theme. All settings are defined in the settings.yaml blueprint file

Settings Tab

This tab allows you to do the following

  • Set a Homepage from the Pages entry type

  • Set The Website Name

    • Used in the meta tags throughout the pages

  • Set a Favicon

  • Set a Site Logo

    • Displayed in the Navbar

  • Enable the Shop

    • If disabled, the Shop navigation item will be hidden.

    • Will also disable the products builder blocks

    • Will also disable the Currency, Stripe, and Shipping tabs on the page

  • Enable Events

    • If disabled, the Event navigation item will be hidden.

    • Will also disable the events builder blocks

  • Enable the Blog

    • If disabled, the Blog navigation item will be hidden.

    • Will also disable the posts builder blocks

  • Enable Search

    • If disabled the search blocks and backend navigation items will be hidden.

Note: if any of the switches are turned off on this page, you'll need to refresh the backend to see the changes.

Search Tab

This tab is used to configure search settings. The following is configurable:

  • Default Search Page (Required)

  • Enable Global Search (in Navbar)

  • Global Items to Search For

    • Lets you specify which items you want searchable throughout the site.

By default, search is disabled since you have to create a Search Page for it.

Global Elements Tab

This tab configures the global elements <nav> and <footer>. The following options are available

  • Navbar Position: Adjust make the navbar stick to the top or scroll with content

  • Show Advanced Options

    • CSS Classes: Add CSS Classes to the navbar

    • ID/Anchor: Add an unique ID to the navbar

    • Container Style: Choose between Fluid and Normal bootstrap containers

  • Show Advanced Options

    • CSS Classes: Add CSS Classes to the footer

    • ID/Anchor: Add an unique ID to the footer

    • Container Style: Choose between Fluid and Normal bootstrap containers

Why the "Advanced Options" switch?

The philosophy behind the theme is to give the client options to change content throughout the site. Since this is something that isn't relevant to the client but relevant to the developer, The options would be needed to be hidden from the client by default.

This prevents changing the settings by the client accidentally.

Global Code Tab

This tab is used to place code snippets in their respective areas of the site.

Currency Tab

Used in the Shop, this tab is used to select the currency used in the shop. The currency code is used for Stripe Checkout to determine the current currency you want to charge people with.

The Currency Symbol and Currency Symbol Placement options are cosmetics for the frontend of the site. They are not used in Stripe in any way.

Stripe Tab

This section contains placements for your Stripe keys and a Checkout Success page. The Shop does not work unless you set everything on this page.

Adding your Stripe Webhook Secret

The webhook secret is used to sign requests. The shop will not work without it. For step-by-step instructions on how to get it, click here.

Shipping

This section allows you to setup shipping on your site. It is also used in Stripe Checkout. Here's an explanation of each field below

Countries to ship to

A list of country codes you would like to ship to. (Ex. US for United States, CA for Canada, etc.) Find a country code

Shipping Methods

Allows you to add your own shipping methods that include price, and the min and max nubmer of days the package would arrive

Mail Notifications Tab

This tab data is used to send you email notifications when a Form has been submitted, or when a Product has been ordered. They are required when the Stripe Keys are set.

Forms Tab

This tab is used for reCAPTCHA keys. reCAPTCHA helps limit spam from forms in the backend. Only v2 is supported. You can get your keys here

Last updated