Settings
Configure what's under the hood of your website.
The Favicon, custom code, web services and some advanced settings can be added in the Settings panel of YOOtheme Pro. Most of these setting need to be configured only once. There is also an About section with the Changelog of YOOtheme Pro.
Favicon
Add the regular browser Favicon and the Apple touch icon to the website.
| Option | Description |
|---|---|
| Favicon PNG | Select your favicon.png. It appears in the browser's address bar, tab and bookmarks. The recommended size is 96x96 pixels. |
| Favicon SVG | Select an optional favicon.svg. Modern browsers will use it instead of the PNG image. Use CSS to toggle the SVG color scheme for light/dark mode. |
| Touch Icon | Select your apple-touch-icon.png. It appears when the website is added to the home screen on iOS devices. The recommended size is 180x180 pixels. |
CSS
Add custom CSS or Less to your site. All Less theme variables and mixins are available. The <style> tag is not needed.
Important Please be careful with incorrect Less code. Syntax errors may cause the Style Customizer to stop working.
Scripts
The scripts panel shows the list of all scripts added to your site. Click on a script to open its options. To add a new script, click the Add Script button and choose custom script or one of the prebuilt scripts.
Custom scripts can be added either to the head or body of the website. The <script> tag is mandatory.
If the consent manager is enabled, users can accept or reject scripts before they are loaded. Simply set the category that must be accepted before the script is loaded. Functional scripts are always loaded. Optionally, allow this service to be individually accepted by setting a unique name for the service, e.g. my-service.
Note If a script requires consent from multiple categories, select the functional category and add the data-category attribute with a space-separated list of the required categories to the <script> tag, e.g. <script data-category="statistics marketing"> .
YOOtheme Pro provides prebuilt scripts for popular services to easily integrate them into the site. If the consent manager is enabled, their services are shown in the corresponding categories and can be accepted or denied individually.
| Script | Category | Description |
|---|---|---|
| OpenStreetMap | Preferences | Load OpenStreetMap for the Map element. The map shows a placeholder if consent is required. |
| Google Maps | Preferences | Load Google Maps for the Map element. The map shows a placeholder if consent is required. |
| YouTube | Preferences | The Video element shows a placeholder if consent is required. |
| Google Tag Manager | Functional, Statistics, Marketing | Load Google Analytics and Google Advertising. |
Consent Manager
YOOtheme Pro comes with a built-in consent management solution that is GDPR- and CCPA-compliant. Choose an opt-in (GDPR) or opt-out (CCPA) compliance type to enable the consent manager. With opt-in, scripts and cookies are disabled by default and only load once the user gives explicit consent. With opt-out, cookies are loaded by default until the user revokes their consent. To allow visitors to re-open the consent manager and change their cookie preferences, add a link with the URL #consent-settings, for example in the footer of the site and on the privacy policy page.
Define the scripts in the Scripts panel and assign them to one of the dedicated consent categories: functional, preferences, statistics or marketing. Optionally, allow a service to be individually accepted. Functional scripts are always loaded, while users can allow or deny the other categories and single services to protect their privacy until consent is given.
Note The functional cookie group includes cookies often referred to as essential or necessary. Preference cookies may also be referred to as functional, statistics cookies as analytics or performance, and marketing cookies as targeting or advertising.
Show a link to the privacy policy in the cookie banner and consent manager.
Select the layout for the cookie banner. Choose between a floating card, a notification, or as a full-width section at the top or bottom of the site. The cookie banner has additional style and layout options.
Define the layout for the consent manager modal. Show consent categories and their services in a list, collapse single services with toggles or collapse all categories using an accordion. The consent manager modal has additional style and layout options.
If consent isn't given for embedded content from YouTube, OpenStreetMap or Google Maps, YOOtheme Pro automatically shows a placeholder image instead. Videos and maps will only load on click. And before that, no external requests will be sent to their servers, and no JavaScript will be loaded.
Note YOOtheme Pro integrates of the official WordPress Consent API. This means that third-party plugins like WooCommerce register and respect user consent out of the box with no manual setup.
Note To override the text in the consent manager, simply create language overrides.
API Key
Enter the API key for your website.
Minimum Stability
Select the Minimum Stability for YOOtheme Pro updates on your site.
Advanced
Configure some advanced settings.
| Option | Description |
|---|---|
| Filter | By default, the WordPress wpauto filter wraps text paragraphs with <p> tags even in the text editor. This can be disabled for the_content and the_excerpt. Disable conversion of Emoji characters to images. |
| System Assets | Load jQuery to write custom code based on the jQuery JavaScript library. |
| Search Filter | Only search the selected post types. |
| Search Redirect | Redirect the search to the search page or the post type archive. Only post types with an archive can be redirected to the archive page. |
| Next-gen Images | Serve optimized image formats with better compression and quality than JPEG and PNG. |
| Syntax Highlighting | Enable automatic syntax highlighting for any code block on your website. Use GitHub for light and Monokai for dark backgrounds. |
| Theme Settings | Export all theme settings and import them into another installation. This doesn't include content from the layout, style and element libraries or the template builder. |
Note AVIF images are only generated in PHP 8.1 and later, and the GD extension must be compiled with AVIF support.
Note IPTC Photo Metadata can only be preserved for JPEG images. If needed, disable both next-gen images options. Mind that this will slow down loading times.
External Services
Provide API keys to integrate web services into your website.
| Option | Description |
|---|---|
| Google Maps | Enter your Google Maps API key to use Google Maps instead of OpenStreetMap. It also enables additional options to style the colors of your maps. |
| Mailchimp API Token | Enter your Mailchimp API key to use it with the Newsletter element. |
| Campaign Monitor API Token | Enter your Campaign Monitor API key to use it with the Newsletter element. |
System Check
This panel displays critical issues, improvements and recommendations for YOOtheme Pro. Refer to this panel in case of any issues with YOOtheme Pro.
About
This panel shows the YOOtheme Pro version currently used on this site. A What's New modal and a changelog are also provided. Refer to this section after an update to see what has changed and what is new.
