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
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
Footer
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