General Information

Thank you for purchasing our block theme. We are happy that you are one of our customers and we assure you will not be disappointed. We do our best to produce top notch themes with great functionality, premium designs, and clear code.

License

With ThemeForest regular license you are licensed to use this theme to create one single End Product (the final website customized with your content) for yourself or for one client.

What is allowed with the single regular license:

1. You can create 1 website (on a single domain) for yourself or for your client. You can then transfer that website to your client for any fee. In that case, the license is also transferred to your client.
2. You can install the theme on your test/development server for testing/development purposes (this installation should not be available to the public).
   As soon as the project is ready for moving to another domain (create the backup to be on the safe side), please disconnect the license and activate the theme on another domain.
   Development installation will still be functional except for importing/exporting demo data.
3. You can have ONE active theme installation at a time. You can move the license to a different domain by "disconnecting the license" from the active theme installation and then re-entering the purchase key/token on a different WordPress installation.
   For Envato Elements, if you want to activate another theme or install the same theme on a new domain, please generate a new token (1 token = 1 domain).
   The number of theme activations (with ONE purchase key or ONE Envato Elements token) is LIMITED!
4. You can modify or manipulate the theme, you can combine it with other works to create the End Product.
5. The theme updates for the single End Product (website) are free.

What is not allowed:

1. With a single regular license you are not allowed to create multiple websites. For multiple websites you will need multiple regular licenses.
2. To resell the same website (Single End Product) to another clients. You will need to purchase an extended license for this.

For more information regarding license regulations and policies, see the links below:

• License FAQ
• Licenses overview
• Regular license details
• Extended license details

XD Files & Images

IMPORTANT! We do not include theme-related .XD files into the theme package, because it significantly increases the theme archive size. If you need those files, feel free to submit a support request.

Nevertheless, you can request the .XD files by contacting our support department.

By getting this WordPress Theme you get all the images FOR FREE. Moreover, you can use them on ANY OF YOUR PROJECTS!

Bundled Plug-ins

The theme package contains a number of bundled plug-ins. Please click here to view the list of plug-ins that come included into the theme.

If a new version of a bundled plug-in is available, it will be included in the next theme release. You can also request it by submitting a support ticket.

Bundled plug-ins are fully functional without the activation using a registration license key. In case you are willing to receive automatic updates and support from the plug-in team, you will need to purchase the plug-in separately. Only the direct buyers get the plug-in license key.

Help and Support

Support Policy

In order to receive a technical support assistance, you need to have a valid purchase code. To get the code, please navigate to your ThemeForest "Downloads" page and click on the theme download link. Check this guide for more details.

PLEASE NOTE! As authors of this theme we do provide support only for the theme-related features.

We do not provide support for additional customization, 3rd party plug-ins integration or any other compatibility issues that might arise. Nevertheless, there is an exception that is only applied to the plug-in(s) we have developed and integrated ourselves.

If you have any questions that are beyond the scope of this help file, feel free to contact us. We will respond as soon as possible (within 24 – 48 hours, usually faster). We are open from 10am to 7pm (CET), from Monday till Friday.

Please be aware that some questions are posted on our website in "Common Questions" section. So, before submitting a new ticket, please try searching our website for an answer, as well as checking our Video Tutorials and Articles. Our website has its own inner search and also has been indexed by Google, so if you can not find your answer with our website search, it is worth typing it into Google too. Please make sure you have looked at all the available resources before submitting a support request.

Third-party Extensions

Unfortunately, we do not provide support for third-party extensions. Please contact the author of the extension if needed. If you feel that you might have troubles with installing an extension, we advise you to order a professional installation service.

Articles & Video Tutorials

For more information regarding the theme's functionality, we suggest checking our Video Tutorials and Articles.

The most popular video tutorials:

Installation

WordPress Information

To install this theme you must have a working version of WordPress already installed. Below are some useful links regarding WordPress information.

• WordPress FAQ - General information about WordPress.
• WordPress Lessons - A great knowledge-base for WordPress beginners.
• PHP Function References - Detailed information on WordPress PHP functions and a lot of usage examples.

Theme Requirements

To use this theme you must be running at least WordPress 6.0, PHP 7.4 or higher.
External plug-ins may require additional limitations, like WooCommerce - WordPress 6.5+, etc.
If you use a hosting service with limited resources (e.g. GoDaddy!), you may experience issues with the "one-click" demo data installation.

We recommend that you contact your web hosting service provider to make sure that your server PHP configuration limits are as follows:

• max_execution_time 600
• memory_limit 128M
• post_max_size 32M
• upload_max_filesize 32M

If you are running unmanaged dedicated server or VPS, you should check your php.ini file. Alternatively, you can edit .htaccess file in the root of your website and add the following values:

• php_value max_execution_time 600
• php_value memory_limit 128M
• php_value post_max_size 32M
• php_value upload_max_filesize 32M

Setting these values will ensure you will not get error messages during the installation. To safeguard your website, please use secure passwords and the latest version of WordPress and plug-ins.

Here is the list of web hosting service providers we recommend:

• Bluehost (Exclusive Offer for our Customers: -70% OFF)
• SiteGround
• InMotion Hosting

Theme Installation

Unpacking the theme

Before installing the theme, please make sure you unpacked the archive and extracted the theme files. Some of the folders names may slightly vary. Treat the screenshot below as an example only.

The main package contains archives with the main theme, child theme, documentation and bundled plug-ins.

If you try to install the wrong files, you will get the missing style.css error. This is the most common error that means you are trying to install an incorrect package.

In order to install the theme, you need to have a working version of WordPress installed on your server first. Check out this guide for detailed information on how to install WordPress. We also highly recommend updating your WordPress to the latest stable version.

Below you can find a video tutorial on how to install the theme.

There are 2 ways to install the theme:

• via FTP:
  1. Log into your web server with FTP client software.
  2. Unzip the truth.zip file and ONLY use the extracted /truth theme folder.
  3. Upload the extracted truth theme folder into /wp-content/themes.
  4. Navigate to the Appearance > Themes tab and activate the theme.
• via WordPress admin panel:
  1. Log into the WordPress admin panel.
  2. Navigate to Appearance > Themes and click on Add New and Upload Theme.
  3. Select the truth.zip folder and click Install Now button.
  4. After the successful installation, click on Activate or navigate to the Appearance > Themes and click on Activate button to activate the newly installed theme.
  5. Install and activate ThemeREX Addons plug-in.
  6. Enter your Purchase Code or Envato Elements Token and some personal information. Theme activation allows you to get access to plug-ins, demo content, support and updates.
     
     To get the purchase code, please navigate to your ThemeForest "Downloads" page and click on the theme download link. Check this guide for more details.
     
     In case you have downloaded the theme from Envato Elements, please view our guide to find out how to generate Envato Elements token. IMPORTANT! The number of theme activations (with purchase code/Envato Elements token) is LIMITED! For Envato Elements, if you want to activate another theme, please generate a new token (1 token = 1 domain). Anyway, you are allowed to activate your theme locally or on the dev server and then move the theme to the main domain. Please feel free to contact our support department if any issues arise.
  7. Make sure the required Advanced Theme Add-ons are active. You can find the description of each add-on here.

You can also watch our video tutorial on how to install a WordPress theme.

Attention! If you want to make changes in theme’s templates or functions, we strongly recommend activating a child theme before demo data installation. Please see the Child Theme section for more information.

The theme license allows you to install the theme on ONE domain only! In order to connect the license to a different domain, first click "Disconnect domain" (Theme Panel > Theme Dashboard > General) and then re-enter the purchase key/token on a different WordPress installation. For Envato Elements, if you want to activate another theme or install the same theme on a new domain, please generate a new token (1 token = 1 domain). If you have any questions, please contact our support department.

Attention! Before any manipulations that will require re-entering the purchase key/Elements token even on the same domain (e.g: WordPress reinstallation or cleaning the database), please FIRST disconnect the domain!

Plug-ins Installation

Below is the list of the plug-ins that come included into the theme.
Some of these plug-ins can also be installed from the WordPress.org repository.

• AI Engine
• Contact Form 7
• Kadence Blocks (free version)
• ThemeREX Addons (required)
• ThemeREX Updater
• WooCommerce

You can find a detailed overview of each plug-in in the Plug-ins section of this documentation file.

To make the theme look exactly as on the demo page, you would need to install the recommended plug-ins:

1. After the installation/activation of ThemeREX Addons plug-in and theme activation, you will see a prompt with a list of plug-ins to install. Click on the Begin installing plugins link or go to Appearance > Install Plugins.
   
   
2. Check the plug-ins you want to install, select the Install option and click Apply. Installation may take a few minutes, please be patient and do not refresh the page.
   
   
3. Now, activate the plug-ins. Go to Appearance > Install Plugins, check all the listed plug-ins, choose Activate option and click Apply.

In case you are running a shared hosting with limited resources (e.g. GoDaddy), we do recommend enabling only the essential plug-ins (e.g. ThemeREX Addons) and disable the rest. Otherwise, it may significantly increase the memory consumption, which might lead to unwanted issues.

PLEASE NOTE! The installation and activation of bundled plug-ins run automatically. Anyway, if you have any issues, please extract plugins.zip archive (from the theme package) and proceed with the plug-ins installation manually.

Child Theme

If you want to make changes to the theme's files and functions, we strongly recommend installing a child theme. This ensures that your theme customizations stay in place after the theme update. If you are not planning to change the core theme files, you are free to skip this chapter.

IMPORTANT! Install the child theme before importing the demo data. Otherwise, all of your theme options will be reset.

A child theme is installed the same way you install a parent theme. Locate the truth-child.zip file in the theme package and upload it via the WordPress admin panel. Alternatively, you can unzip it and upload via FTP (see main theme installation chapter).

Using a Child Theme

Your child theme has its own functions.php file. Use it to copy modified functions from the parent theme's functions.php, or register new functions.

You can copy all files from the parent theme into the child theme except files located in the following folders:

• /includes
• /plugins
• /theme-options
• /theme-specifics

In the /front-page folder, you can copy all files except front-page.options.php.

If the file you want to edit is in one of these folders, you need to copy the required function from that file, and register it in the child theme's functions.php.

The rest of the files can be copied and edited directly in the child theme folder.

When copying parent theme files into the child theme, preserve the original folder structure. Create respective folders and make sure that the file path is the same as in the parent theme.

Demo Content

Our theme includes a simple One-click demo data installation, which allows your site to look exactly as on the theme demo.

Before installing demo data, please make sure you have activated your theme copy (entered the purchase code or Envato Elements token in the WP Dashboard > Theme Panel > Theme Dashboard > General tab) and installed all the required plug-ins. Check the Plug-ins installation section for more information about the required plug-ins.

In case you do not have your Purchase Code, please navigate to your ThemeForest "Downloads" page and click on the theme download link. Check this guide for more details.

To generate Envato Elements token, follow the link from your WP admin panel. Please view this guide for more information.

IMPORTANT! Our theme supports RTL text direction (compatibility, without rtl-demo content)! Please FIRST choose the correct language in your WordPress settings (Dashboard > Settings > General > Site Language), then proceed with the demo data installation.

Our theme contains RTL styles. The page content should be manually adjusted for RTL text-direction using the page builder's settings (e.g. changing the alignment of icons, etc).

In order to import the demo content go to Theme Panel (WP Dashboard) > Theme Dashboard > Demo Data.

On the page that showed up set the required parameters.

Partial Import

When choosing the partial demo data import, the new content will be added to your existing data.

Although this will not overwrite your existing content, we still recommend backing up your website before doing this.

Note, that the pages are imported without the original images. Instead, the image placeholders are used. This is done to keep your existing content intact.

Import separate pages means that you receive the page structured like on our demo, just set of blocks that requires further customization: you should replace demo categories/post ids with your own ones.

Full Import

When choosing this option, all the existing content of your website will be lost and replaced with the new data. We recommend using this option for new WordPress installations only.

Use the full import option if you want to have an exact copy of the theme demo. It enables you to import all media files, pages, theme options, and plug-in settings.

Some plug-ins increase the memory consumption. For example, BuddyPress and bbPress (not included into the theme's package) require additional 60-80Mb. If you are having trouble installing the demo data, deactivate massive plug-ins and try again.

In case demo data installation is stuck and you see "Error load data from the file ... " error message, you can manually install it by downloading the default.zip archive with demo data from our server. The archive should be unzipped. Then create demo/ folder in wp-content/themes/truth/ directory and copy /default folder to wp-content/themes/truth/demo.

Treat the screenshot below as an example only. The list of folders inside a theme package may vary.

If the issue persists, please contact your hosting service provider to make sure that your server configuration meets the Theme Requirements. Otherwise, please refer your request to our support department.

Installation FAQs

Theme Update

This step is required if you received a notification that a new version of the theme is available. You can see this information in Changelog section at the bottom of the item's details page.

Before you go ahead with the update make sure to backup your old theme's folder. Download it to your computer locally.

Update Option 1. Update using the ThemeREX Updater plug-in

1. Please make sure the ThemeREX Updater plug-in is installed and activated. This plug-in is provided with the theme.
2. Optional! If you have activated your theme copy (entered the purchase code or Envato Elements token in the Theme Panel (WP Dashboard) > Theme Dashboard > General tab) you can omit this step.
   Otherwise, navigate to Appearance > ThemeREX Updater and enter your purchase code to get the latest versions of bundled plug-ins and theme updates through the WordPress admin panel. To get the code, please navigate to your ThemeForest "Downloads" page and click on the theme download link. Check this guide for more details.
   Please note, this section requires a purchase code ONLY! Envato Elements token will not work here!
3. We recommend you to check the "Create backups" option (Appearance > ThemeREX Updater tab) to allow the system create backups for plug-ins versions and the theme automatically.
4. Proceed to WP Dashboard > Updates and check if any updates are available.
5. Choose the options for an update (plug-in, theme, etc.) and click on Update button.
6. You can restore the backups created by the system in WP Dashboard > Updates or in Appearance > ThemeREX Updater (if the "Create backups" option was checked before the update).

Update Option 2. Update using WordPress uploader

1. Log into your ThemeForest account and navigate to Downloads tab. Find the theme and download Installable WordPress file only.
   
2. Log into your WordPress website and go to Appearance > Themes.
3. Activate a default WordPress theme. Delete the older version of your theme and re-upload the new WordPress Installable files that you have downloaded from ThemeForest during the 1st step.
4. Once it is uploaded, activate the theme.
   
   IMPORTANT! If you're using a child theme, do not activate the newly uploaded parent theme. Activate your old child theme instead. Otherwise, all the child theme customizations will be lost.
5. Update (if necessary!) the included plug-ins, if you see a notification message prompting about a newer version.
   • Navigate to WP Dashboard > Plugins > Installed Plugins.
   • Update ThemeREX Addons plug-in. You can click on "Update" button (if available in a particular theme) or deactivate and delete this plug-in. Then follow the prompt to install it again. This will load a new plug-in version on the site.
   • Deactivate and delete the rest plug-in(s) of old version.
   • Go to Appearance > Install Plugins and install the plug-in(s) like it was described in the Plugins Installation section of this documentation.

Update Option 3. Update using FTP client

1. Log into your ThemeForest account and get the last version of the theme as described above.
2. Connect to your server using desktop client software (we recommend Filezilla and CyberDuck).
3. Change directory to /wp-content/themes.
4. Remove/rename existing folder with old theme files.
5. Unpack theme installable files downloaded from ThemeForest and upload them to the themes folder.
6. Update (if necessary!) the included plug-ins in the way described above, if you see a notification message prompting about a newer version.

Theme Customizer

Now let's navigate to Appearance (WP Dashboard) > Customize to flexibly control the appearance and behavior of the whole website as well as individual types of posts, pages and categories.

IMPORTANT! Please be aware that our theme provides a special inheritance hierarchy system for "Theme Options" settings. It means that individual settings of each page may override global settings made with Customizer Panel.
Settings of "Blog", "WooCommerce" and other groups may also override default/general settings available through Customizer.

Moreover, you can see the changes of the front-end right after the alterations - when the needed parameter is selected, without switching from admin to front-end each time. When you are done with the changes, you should click on Publish button at the top of the Customizer's side menu.

IMPORTANT! Please be aware that all the Customizer's settings are also available for editing through Theme Panel (WordPress Dashboard Menu) > Theme Options section.

Logo & Site Identity

Settings of this group are responsible for managing site identity features. This is the initial place where you should upload your logo.

Site Title

The text entered into this field appears as the logo title (if the image logo is not uploaded and "Use Site Name as Logo" option is enabled) and as the website's title in your browser tab.

Tagline

The text entered into this field appears as the website slogan under the logo. By default, the tagline is used if no image logo is selected and "Use Site Name as Logo" option is enabled.

Site Icon (Favicon)

The site icon (favicon) is used as a browser and app icon for your site. Icons must be square, and at least 512 pixels wide and tall.

Logo-related settings

These settings allow managing your logo images (main, for mobile header and mobile menu), as well as their Retina versions (if "Allow retina display logo" option is checked). As a rule, the retina logo should be twice as big as the regular logo in order to be displayed properly.
Here you can also zoom the logo. 1 - original size. Please note, that the maximum size of the logo depends on the actual size of the image. This option works if max height of the logo is set in em in "Logo" block ("TRX Addons Layouts" group).

"Use Site Name as Logo" option displays the site title and tagline as a text logo if no image is selected.

Uploading Logo via Layouts/Template Parts

The logo uploaded in the Customizer can be overwritten by the logo image selected in the Header layout/template part. This allows you to upload a different logo image for each page.

1. Check what header style is selected in the Appearance > Customize > Header > Header style.
   (You can choose a different header style for a particular page in its Theme Options.)
2. Open this header layout/template part.
   
   If your header is created as a layout, navigate to the WP Dashboard > Theme Layouts > All Layouts. If your header is created as a template part, proceed to WP Dashboard > Appearance > Editor > Patterns > Header.
3. Locate the "Logo" block ("TRX Addons Layouts" group) and proceed to block's settings panel.
4. Upload a new logo in the panel > General tab and save the changes.

General

Settings of this group are responsible for managing an overall look of the site.

Layout settings:

Here you can choose the body style, page margins, the page width (site content + sidebar) in pixels as well as apply a background image and page extra spaces for "Boxed" body style.

• Boxed - the page's body is in the area of limited screen width, and the background image is visible.
• Wide - the page's body occupies an entire screen width (background image is behind it and is not visible), and the content occupies the fixed width area in the center of the screen.

Navigation settings

These settings allow adding additional elements to the Mobile Menu.

• Search field in the Mobile menu - adds a search field to the bottom of the Mobile menu.
• Social icons in the Mobile menu - adds social icons to the bottom of the Mobile menu. The social icons inherit the links (URLs) to your social profiles specified in the Theme Panel (WP Dashboard) > ThemeREX Addons > Socials tab.

Sidebar-related settings

• Sidebar position - moves sidebar to the right or left hand side of the page, or hides it.
  
  Additional options for "Left/Right" sidebar position:
  
  
  • Sidebar style - choose whether to use a default sidebar or a custom one.
    
    For "Default" sidebar style:
    
    
    • Sidebar widgets - specify which widget set to show in the sidebar area. The widgets are available in Appearance (WP Dashboard) > Widgets.
    For "Custom" sidebar style:
    
    
    • Select custom layout - select already built sidebars, created through layouts or template parts.
      
      In order to create new sidebars or customize the existing ones:
      
      For layouts, proceed to the WP Dashboard > Theme Layouts tab (available only if the ThemeREX Addons plug-in is active). Check the Layouts section for more information. For template parts, navigate to WP Dashboard > Appearance > Editor > Patterns > Sidebar. Please click here for more information.
  • Sidebar width - specify the width of the sidebar (in pixels).
  • Sidebar gap - specify the gap between content and sidebar (in pixels).
• Content width - choose the content width if the sidebar is hidden.

Design & Effects-related settings

Here you can select a border radius for the form fields and buttons (in pixels).

Miscellaneous setting

This setting is responsible for specifying SEO-related parameters.

Text with Privacy Policy link

Specify some text for the checkbox in a registration form ("Login Link" block, "TRX Addons Layouts" group). This text will be displayed before the Privacy Policy link.

In order to add/customize the Privacy Policy link, navigate to Settings (WP Dashboard) > Privacy and specify the page that will be used as a Privacy Policy one. If you do not want to display "For further details on handling user data, see our Privacy Policy" text, just leave this setting empty.

PLEASE NOTE! In case you are planning to use default forms without consent checkboxes, just leave the "Text with Privacy Policy link" option empty!

Header

Settings of this group allow you to manage an overall look and behavior of the header elements.

You can set up header settings for a specific page in the Theme Options > Header section of that page.

Style-related settings

These settings allow managing a header style ("Default" or "Custom"). For custom header style you can specify a custom header from layouts (available only if the ThemeREX Addons plug-in is active) or template parts.

Available Custom Header Layouts:

1. Header – Style 1 Sticky Menu

Please also see header-related layouts section of this documentation file. All elements of pre-built custom header layouts can be edited in the Dashboard > Layouts tab, using a user-friendly Site Editor. Check the Layouts section for more information.

Available Custom Header Template Parts:

1. Header for FSE

In order to manage pre-built Header Template Parts, please proceed to WP Dashboard > Appearance > Editor > Patterns > Header.

Sticky Menu

If you want to enhance your header with "Sticky Menu" behavior and your header is created using row blocks (Kadence Blocks plug-in is required), please navigate to Row > Advanced tab and insert additional CSS classes .sc_layouts_row_fixed and .sc_layouts_row_fixed_always. More additional CSS classes can be found here.

Available Default Header Style:

The header area in "Default" style is "Header for FSE" template part and can be managed in WP Dashboard > Appearance > Editor > Patterns > Header.

Header Background Image-related settings (for custom header layouts)

These settings allow selecting a header background image or background video for custom header styles, created as layouts.

Header FAQs

Where can I change the header style for my website?

Go to Appearance > Customize > Header and adjust the Header Style setting.

Where to customize a header style?

Check which header style you are currently using in Appearance > Customize > Header > Header Style. "Default" header style is "Header for FSE" template part and can be managed in WP Dashboard > Appearance > Editor > Patterns > Header.

For"Custom" header style

1. Check which custom header layout you are currently using in Appearance > Customize > Header in the Select custom layout option.
2. In order to open the needed header:
   
   For layouts, proceed to the WP Dashboard > Theme Layouts tab. Check the Layouts section for more information. If you do not see the Layouts menu item - activate the ThemeREX Addons plug-in first. For template parts, navigate to WP Dashboard > Appearance > Editor > Patterns > Header. Please click here for more information.
3. Make the required changes and save it.

Where to change the header logo?

By default, the header logo settings can be adjusted in Appearance > Customize > Logo & Site Identity.

However, you can specify the logo in your header Layout/Template Part using the Logo block (TRX Addons Layouts group). IMPORTANT! The logo, specified in your header Layout/Template Part, overwrites the logo set in the Customizer.

How to enable/disable sticky header?

A sticky header is a type of header that stays at the top of your page while scrolling. You can enable or disable the sticky header behavior by following these steps:

1. Open the header layout or template part you are currently using.
2. Locate the row that contains the menu element (or any other row that should have the sticky behavior) and open the block's settings panel (Kadence Blocks plug-in is required):
3. Go to the Row > Advanced tab and add/remove additional CSS classes .sc_layouts_row_fixed and .sc_layouts_row_fixed_always (depending on whether you want to enable or disable the sticky menu). More additional CSS classes can be found here.
4. Save the changes.

How can I add a mobile header?

There is 1 way to add a mobile header:

• via header layouts or template parts.
  You can hide/show the header elements for definite screen resolutions under the "Visibility Settings" tab for row/section or under the "Hide on Devices" for some other blocks.

Footer

Setting of this group is responsible for choosing the style of the footer area.

Style-related settings

These settings allow choosing a footer style: "Default" or "Custom". Custom footer styles include footer layouts (available only if the ThemeREX Addons plug-in is active) and footer template parts.

Available Custom Footer Layouts:

1. Footer – Style 1
2. Footer – Style 2
3. Footer – Style 3
4. Footer – Style 4

Please also see footer-related layouts section of this documentation file. All elements of custom footer layouts can be edited in Dashboard - Layouts tab, using a user-friendly Site Editor. Check the Layouts section for more information.

Available Custom Footer Template Parts:

1. Footer for FSE

In order to manage pre-built Footer Template Parts, please proceed to WP Dashboard > Appearance > Editor > Patterns > Footer.

Available Default Footer Style :

The footer area in "Default" style is "Footer for FSE" template part and can be managed in WP Dashboard > Appearance > Editor > Patterns > Footer.

Menus

Settings of this group are responsible for managing Menus. Each menu location is available for filling with any of the predefined menu sets.

Menus are also available for editing through the "Appearance > Menus" options.

Below are predefined Menu locations:

• Main Menu - displays the main menu.
• Mobile Menu - displays the menu on mobile devices.
• Footer Menu - displays the menu in the footer area.

Predefined Menu sets:

Within custom header & footer layouts/template parts, you can add menus using the Menu block (TRX Addons Layouts group).

We have added the following custom CSS class to make the menu look like on our demo:

• .submenu_with_blogger_left_filters - adds grey background gradient behind the filters tabs (for Main Menu).

You can enable or disable the CSS Classes option in the Screen Options in the top right corner of the WordPress admin.

Widgets

Widgets are the blocks of content that can be placed into specifically designed widget areas.

You can find the list of available widgets and widget areas under Appearance (WP Dashboard) > Widgets. Here it is possible to create additional widget sets, that can be assigned to available default widget areas. This is useful when you have different widget sets for different pages.

IMPORTANT! Our theme supports both Classic Widgets Editor and New Block Widgets Editor (WordPress 5.8+). You can easily switch between the editors using the "Disable new Widgets Block Editor" option in Theme Panel (WP Dashboard) > ThemeREX Addons > General section.

By default our theme supports 1 widget area:

• Sidebar

You can add widgets into widget areas by simply dragging and dropping.

But in order to see them on your website, you need to make sure you have a particular widget set assigned to a particular default widget area. You can assign widget sets either for the whole website (in Appearance > Customize), or for a specific page (single Page > Theme Options > Content).

IMPORTANT! The Sidebar widgets are available for "Default" sidebar style ONLY!
In order to manage custom sidebar, proceed to Dashboard > Layouts tab for layouts or to WP Dashboard > Appearance > Editor > Patterns for template parts. Update the corresponding sidebar styles.

Widget Sets Assignment for the Whole Site

Body widgets (for sidebar) are accessible in Appearance > Customize > General section.
The sidebar widgets work for Default Sidebar Style only! Otherwise, navigate to the WP Dashboard > Theme Layouts tab or to WP Dashboard > Appearance > Editor > Patterns to manage the sidebar layout/template part.

Footer widgets are just an additional widgets set, designed to be displayed in the footer area. You can output these widgets in the corresponding footer layout or footer template part.

Widget Sets Assignment for a Specific Page

If you want to specify a widget set for a separate page, open that page in your WordPress admin and in the Theme Options section choose the required widgets. The widgets assigned in Theme Options would be applicable only for that particular page.

Customizing Widget Sets that are already enabled on a Specific Page

Depending on the selected page that is available for editing with Customizer's tools, you can notice a different kind of widgets sets included to a particular page. The same can be done through Appearance (WP Dashboard) > Widgets.

Below are options responsible for managing widgets/blocks.

• Add a Widget (for Classic Widgets Editor) or Add a Block (for New Block Widgets Editor): just click on "Add a Widget/Block" button to see the available widgets, then choose the one you want to use: Click on the block itself to open its settings (for New Block Widgets Editor):
• Reorder the position of widgets using three icons:
  
  
  • Move - moves the widget to another sidebar.
  • Down - moves the widget down.
  • Up - moves the widget upwards.

After you reorder the position of the widgets/blocks in the sidebar, save your changes.

See the example of how the Sidebar Widgets Set may look like ("Default" sidebar style):

Custom Widgets

Moreover, our theme provides a few Custom Widgets that are available in Appearance > Widgets section (for New Block Widgets Editor - under "Widgets" group).

• ThemeREX About Me: Displays a photo and description of the website's owner or any other person. If you leave the options empty they will inherit data from the following options on the admin's profile page: "Profile Picture" (for photo), "Username" (for name) and "Biographical Info" (for description). You can hide any option by inserting # sign in the corresponding field in the widget's settings.
• ThemeREX Audio Player: Shows an audio player to play an audio file uploaded locally (from your Media library) or an external one (through embed html code). The system ignores the "Audio caption" and "Author name" options, if the embed code is used.
• ThemeREX Banner: Displays a regular banner image linked or not as well as any object inserted using html code (banner, iFrame for video, audio, etc.).
• ThemeREX Blogger: Shows posts, pages or custom post types from a specified category or group. By default, the widget outputs single posts.
  You can create additional layouts to output the posts in WP Dashboard > Theme Layouts using Blog layout's type (Item Options section). Please see Creating Layouts section of this documentation file for more information.
• ThemeREX Calendar: Displays a regular WP calendar. This widget allows you to choose the way of shortening the weekday names: to one (first) letter or to three letters.
• ThemeREX Categories list: Shows a list of post or products categories/tags/formats, layouts or CPT groups. By default, it inserts post categories. In this case the images are inherited from Posts (WP Dashboard) > Categories > single category (if this function is available for a particular theme).
• ThemeREX Layouts: Displays already built custom layout from the Theme Layouts (WP Dashboard) > All Layouts menu.
• ThemeREX Posts by Rating: Displays the most rated posts (extended) with images and post meta.
• ThemeREX Product Filters: Displays advanced search form for products. This widget requires the WooCommerce plug-in to be active. Please note, that the widget in "Inline" style works on all pages. The rest available styles work on shop list page only!
• ThemeREX Recent Posts: Displays the most recent posts.
• ThemeREX Slider: Displays the slides via Posts (Swiper) Slider.
• ThemeREX Socials: Shows the links to social network profiles. The social icons inherit the links (URLs) to your social profiles specified in the Theme Panel (WP Dashboard) > ThemeREX Addons > Socials tab.
• ThemeREX Twitter: Shows latest tweets from Twitter account.
• ThemeREX Video List: Shows a video list with videos from posts of "Video" post format type. A url or embed code for the video should be specified in the single post's settings, Item Options > Video > Video List section.
• ThemeREX Video Player: Displays a video player. The widget supports direct links from Youtube, Vimeo or locally downloaded video files. You can also insert a video through html code from any video hosting platform.
• ThemeREX WooCommerce Title: Displays a page title, breadcrumbs and a description of a products category on shop-related pages (shop list pages and single products). This widget works if a header layout does NOT contain the page title and breadcrumbs. The description inherits content from the back-end settings of a definite products category. The description becomes visible on product category pages ONLY! This widget requires the WooCommerce plug-in to be active.

PLEASE NOTE! Please be aware that this theme does not provide any examples of custom sidebar layouts. Feel free to create your own ones, using a user-friendly Site Editor. Check the Layouts section for more information.

Homepage Settings

Settings of this group are responsible for selecting the way to display the homepage (front page), as a blog stream or a static one and specifying the pages to be set as a static homepage and as posts page.

IMPORTANT! Please be aware that these settings are also available for editing through Settings > Reading section.

Blog

These settings are responsible for customizing blog-related pages.

IMPORTANT! The layouts and structures of your blog archive pages as well as the single posts can be easily managed in WP Dashboard > Appearance > Editor > Templates.

Blog > Posts page

Settings of this group allow you to manage an overall look and behavior of posts pages.

These settings are applied to all types of blog pages, including Posts pages defined in the WordPress settings (Posts), as well as pages created via the Blog Archive template (unless no custom settings are specified in the Theme Options panel of a particular page/post).

Please check our article or visit this video tutorial for more information on how to add/customize the Posts pages.

Posts page settings

• Open video in the popup on a blog archive - open the video from posts in the popup window (if plugin "ThemeREX Addons" is installed) or play the video instead the cover image on a blog stream page.

Header-related settings

These settings allow selecting a header style. For custom header style you can specify a custom header from layouts (available only if the ThemeREX Addons plug-in is active) or template parts. The header area in "Default" style is "Header for FSE" template part.

Sidebar-related settings

• Sidebar position - moves sidebar to the right or left hand side of the page, or hides it. The Inherit option inherits the value specified in the Appearance > Customize > General panel.
  
  Additional options for "Left/Right" sidebar position:
  
  
  • Sidebar style - choose whether to use the default sidebar or custom sidebars: layouts (available only if the ThemeREX Addons plug-in is active) and template parts.
    
    For "Default" sidebar style:
    
    
    • Sidebar widgets - specify which widget set to show in the sidebar area. The widgets are available in Appearance (WP Dashboard) > Widgets.
    For "Custom" sidebar style:
    
    
    • Select custom layout - select already built sidebars, created through layouts or template parts.
      
      In order to create new sidebars or customize the existing ones:
      
      For layouts, proceed to the WP Dashboard > Theme Layouts tab (available only if the ThemeREX Addons plug-in is active). Check the Layouts section for more information. For template parts, navigate to WP Dashboard > Appearance > Editor > Patterns > Sidebar. Please click here for more information.
• Content width - choose the content width if the sidebar is hidden.

Blog > Category/Tag/Search

Here you can set the overall view of single category/tag/search posts page.

Header-related settings

These settings allow selecting a header style. For custom header style you can specify the custom header from layouts (available only if the ThemeREX Addons plug-in is active) or template parts. The header area in "Default" style is "Header for FSE" template part.

Sidebar-related settings

• Sidebar position - moves sidebar to the right or left hand side of the page, or hides it. The Inherit option inherits the value specified in the Appearance > Customize > Blog > Posts page panel.
  
  Additional options for "Left/Right" sidebar position:
  
  
  • Sidebar style - choose whether to use the default sidebar or custom sidebars: layouts (available only if the ThemeREX Addons plug-in is active) and template parts.
    
    For "Default" sidebar style:
    
    
    • Sidebar widgets - specify which widget set to show in the sidebar area. The widgets are available in Appearance (WP Dashboard) > Widgets.
    For "Custom" sidebar style:
    
    
    • Select custom layout - select already built sidebars, created through layouts or template parts.
      
      In order to create new sidebars or customize the existing ones:
      
      For layouts, proceed to the WP Dashboard > Theme Layouts tab (available only if the ThemeREX Addons plug-in is active). Check the Layouts section for more information. For template parts, navigate to WP Dashboard > Appearance > Editor > Patterns > Sidebar. Please click here for more information.
• Content width - choose the content width if the sidebar is hidden.

Blog > Single posts

Settings of this group are responsible for managing an overall look and behavior of single posts' pages.

Header-related settings

These settings allow selecting a header style. For custom header style you can specify a custom header from layouts (available only if the ThemeREX Addons plug-in is active) or template parts. The header area in "Default" style is "Header for FSE" template part.

Footer-related settings

These settings are responsible for selecting a footer style. The footer area in "Default" style is "Footer for FSE" template part. For "Custom" footer style "Select custom layout" option is available. You can manage these custom footers in the WP Dashboard > Theme Layouts tab, if your footer was created as a layout (available only if the ThemeREX Addons plug-in is active) or in WP Dashboard > Appearance > Editor > Patterns > Footer, if your footer is a template part. The Inherit option inherits the value specified in the Appearance > Customize > Footer panel.

Sidebar-related settings

• Sidebar position - moves sidebar to the right or left hand side of the page, or hides it. The Inherit option inherits the value specified in the Appearance > Customize > Blog > Posts page panel.
  
  Additional options for "Left/Right" sidebar position:
  
  
  • Sidebar style - choose whether to use the default sidebar or custom sidebars: layouts (available only if the ThemeREX Addons plug-in is active) and template parts.
    
    For "Default" sidebar style:
    
    
    • Sidebar widgets - specify which widget set to show in the sidebar area. The widgets are available in Appearance (WP Dashboard) > Widgets.
    For "Custom" sidebar style:
    
    
    • Select custom layout - select already built sidebars, created through layouts or template parts.
      
      In order to create new sidebars or customize the existing ones:
      
      For layouts, proceed to the WP Dashboard > Theme Layouts tab (available only if the ThemeREX Addons plug-in is active). Check the Layouts section for more information. For template parts, navigate to WP Dashboard > Appearance > Editor > Patterns > Sidebar. Please click here for more information.
• Content width - choose the content width if the sidebar is hidden.

Additional settings

• Share links position - specify the position of social media sharing buttons on single posts (left/bottom);
• Show author info - show/hide the author bio section;

Post comments-related settings

• Show comments button - enables comments block;
  
  
  • Comments block - specify the initial state of the comments block: fully displayed or hidden under a button;

Related Posts settings

Here you can enable related posts on a single post's page below content area ("Show related posts" option).

Shop

Here you can manage an overall look and behavior of shop-related pages (works only if the WooCommerce plug-in is installed).

Header-related settings

These settings allow selecting a header style. "Default" style is "Header for FSE" template part. For custom header style you can specify a custom header from layouts (available only if the ThemeREX Addons plug-in is active) or template parts.

Sidebar-related settings

These settings are responsible for specifying sidebar style and the position of the sidebar area on Shop List page and single product posts.

• Sidebar position - moves sidebar to the right or left hand side of the page, or hides it.
  
  Additional options for "Left/Right" sidebar position:
  
  
  • Sidebar style - choose whether to use a default sidebar or custom sidebars: layouts (available only if the ThemeREX Addons plug-in is active) and template parts.
    
    For "Default" sidebar style:
    
    
    • Sidebar widgets - specify which widget set to show in the sidebar area. The widgets are available in Appearance (WP Dashboard) > Widgets.
    For "Custom" sidebar style:
    
    
    • Select custom layout - select already built sidebars, created through layouts or template parts.
      
      In order to create new sidebars or customize the existing ones:
      
      For layouts, proceed to the WP Dashboard > Theme Layouts tab (available only if the ThemeREX Addons plug-in is active). Check the Layouts section for more information. For template parts, navigate to WP Dashboard > Appearance > Editor > Patterns > Sidebar. Please click here for more information.
• Content width - select the content width if the sidebar is hidden.

Single Product settings

• Show related products - enable/disable "Related Products" section on a single product page.
  
  
  • Related products - specify the quantity of related products to be displayed on a single product page.
  • Related columns - specify the columns quantity to divide the related products in on a single product page.

Footer-related settings

These settings allow specifying a footer style.

"Default" style is "Footer for FSE" template part.

For "Custom" footer style "Select custom layout" option is available. You can manage these footers in the WP Dashboard > Theme Layouts tab, if your footer was created as a layout (available only if the ThemeREX Addons plug-in is active) or in WP Dashboard > Appearance > Editor > Patterns, if your footer is a template part.

This is how the default Shop page looks like with the current settings.

IMPORTANT! In order to customize the structure of your product list page, product categories pages as well as the single products, please navigate to WP Dashboard > Appearance > Editor > Templates and update the corresponding template to your needs.

WooCommerce

Settings of this group allow managing the overall look of the WooCommerce elements (works only if the WooCommerce plug-in is installed). The single products can be added/customized in WordPress Dashboard Menu > Products.

The quantity of products displayed on shop page is inherited from the Appearance > Customize > WooCommerce > Product Catalog section.

Typography

Here you can upload fonts and adjust font settings for specific typography elements.

Check this article or video tutorial for more information on how to add new Google Fonts and Custom Fonts.

The theme enables you to use both Google Fonts and custom fonts in your design. You can load up to 5 different font families, including different styles and weights for each typeface.

IMPORTANT! To manage fonts quantity available for upload, edit 'max_load_fonts' => 5 variable in theme-specific/theme.setup.php file.

Colors

The theme allows you to assign color schemes to specific parts of your website. This is useful for highlighting certain areas and giving them a distinctive look.

The theme supports 2 color schemes - default (light) and dark.

Check this video tutorial for more information on how to customize color schemes.

IMPORTANT! Due to specifics of CSS rules, you are unable to assign a light color scheme to any website part, if the dark color scheme is enabled.

Here are the website parts to which you can assign color schemes:

• Show Helpers - enables a colored border arround a block in the Customizer with an element's name and color scheme applied to this particular element. The helper can be useful for editing the theme's color schemes. It helps you understand the colors of what elements you are customizing.
• Site Color Scheme - defines the main color scheme of your website. If no other part of website has a color scheme specified explicitly, affects the whole website. Otherwise, affects the body background color, body typography and pretty much anything that is located below the header and above the footer areas (except sidebar).
• Header Color Scheme - modifies the color scheme of the header.
• Sidebar Color Scheme - affects the color of the sidebar. The Inherit option inherits the value specified in the Site Color Scheme setting.
• Footer Color Scheme - specifies the color of your footer.
• Shop Footer Color Scheme - specifies the color of your footer on shop-related pages.
• Color scheme switcher - add a button with a color scheme switcher to the right bottom corner of the page.
  • Invert logo - inverts logo colors for the dark scheme (works only with the frontend color scheme switcher).

IMPORTANT! The color scheme switcher works only if the colors are set through the theme styles (are inherited from Appearance > Customize > Colors settings) and NOT through any page builder.

For the light grey background you can use additional CSS class .alter_bg to inherit the color from "Alter > Background color".
For the dark background use .extra_bg CSS class to inherit the color from "Extra > Background color".

You can also assign color schemes for individual pages in the Theme Options > Colors panel of those pages.

Color Scheme Editor

Here you can customize the color schemes of your website.

Three additional buttons are available:

• Reset - removes the current changes, made after your last saving.
• Copy - creates a new color scheme by duplicating the default one. Thus, it is possible to set different color schemes for particular pages and their parts.
• Delete - removes the current color scheme. You can delete only newly created color schemes. All default ones will remain.

Select the color scheme you want to customize and choose one of 2 modes (editor types) - simple or advanced.

In a simple mode, you can customize the accent colors (link colors) of a theme. If you want to dig deeper, switch to the advanced mode. You can entirely change the theme colors.

Both modes contain the following groups of settings:

MAIN

The main color group of a website. Here you can find the following elements:

• Background color - the main background color of a website; (for advanced mode only)
• Border color - color used for elements with a border and for content delimiters; (for advanced mode only)
• Text - color for the main body text; (for advanced mode only)
• Text dark - color mainly applied for headings and page/post titles; (for advanced mode only)
• Text light - color used for additional meta elements, such as post author, date, comments, etc. (for advanced mode only)
• Link - the main accent color of a website. The color can be used as links color, a background color for buttons and the color for minor elements, like list item markers, etc. By default, this setting sets the Link hover color for the Alter color group.
• Link hover - the hover color of the elements with the main accent color and the hover color for links. It can also be used as the main accent color for the Alter color group.
• Accent 2 - the second accent color;
• Accent 2 hover - the hover color of the elements with second accent colors;
• Accent 3 - the third accent color;
• Accent 3 hover - the hover color of the elements with third accent colors;

ALTER

Alter means alternative color group, mostly applied for sidebar and footer, if a color scheme is assigned to them and it coincides with the site color scheme (NOT inherited). This group of colors can also be applied to page widgets or blocks that are output on some background by default (the background is NOT added through the page builders). Alter colors include the same elements as the Main color group, plus two additional hover colors for border and background.

EXTRA

An additional color group for extra elements such as dropdowns, price blocks, table headers, blockquotes, etc.
As a rule, the text and background colors from the Extra group should contrast against the respective colors from the Main color group.

INVERSE (for advanced mode only)

Inverse elements are the elements that use the theme accent color (usually the main one) ("Link", "Accent 2", "Accent 3" options) as a background color. In this way, they get distinctive look and stand out from the rest of the content. You can apply these settings for buttons, blockquotes, dropdowns, etc.

• Border color;
• Border hover;
• Text color - the main body text color;
• Text dark - used for headings or other elements that need a darker color;
• Text light - used for meta elements that provide additional information;
• Link color - since the main accent color (i.e. the link color) sets the background color, you need to specify a different link color;
• Link hover - the hover color of the link;

INPUT (for advanced mode only)

Colors for form fields: input fields, text areas, select fields, etc.

• Background - background color of an input field;
• Background hover - background color when an input field is active;
• Border color;
• Border hover - border color when a field is active;
• Text - a regular text color;
• Text dark - the color of the text when a field is active (as you type in);
• Text light - used for the placeholder text when a field is not active, before you type in;

In case the changes of the color schemes are not applied, please enable Debug mode (in Theme Panel > ThemeREX Addons > General tab) and save ThemeREX Addons settings.

Additional CSS

Settings of this group allow you to specify additional custom styles.

Homepages

This section covers the information about Pages in your website: included page templates, how to edit existing pages and add new ones.

You can import required pages, along with the page settings, using the Importer tool. Learn more about it in the Demo Content chapter.

New Page Creation

To create a new page navigate to "Pages" dashboard menu item in your WordPress admin panel and click on Add new button.

Page Templates

Choose either "Blog Archive" (blog page) or "Default Template" (regular page) option in the Summary > Template sidebar. Check Posts pages article to find out more information on how to customize them.

Site Editor-related tutorials

Usually, the page consists of blocks, including navigation menus, header, content, and site footer. All blocks that are available in the WordPress Block editor can be used in the Site Editor. Before you start, please check the following tutorials:

1. Official Site Editor page
2. Official Documentation for Templates
3. Official Documentation for Template Parts
4. Official Documentation for Blocks
5. Official Documentation for Theme Blocks

Custom Page Settings

Each page has a Theme Options panel, where you can specify custom page parameters.

In Theme Options, you can assign a different header/footer style, sidebar widgets set, as well as many other options for each individual page.

These settings are applied to the page you are editing, and will overwrite the global settings specified in the Customizer.

Options Presets Group

Here you can save the page settings (for header, content, footer, etc.) as a preset template and duplicate these settings on a new page without checking the required options in each section of Theme Options panel (Content/Header/Footer/Colors). All you need to do is to apply the already created preset template on a new page by using control icons ("Apply selected preset"/"Create a new preset"/"Delete selected preset"). The tooltips for the icons will help you.

You can enable or disable the Theme Options panel in the Preferences > Panels in the top right corner of the WordPress admin.

Assigning a Page as a Homepage

Once you finished with building your page, assign it as a Homepage:

1. Navigate to Settings > Reading menu item in the WordPress dashboard menu.
2. In Your homepage displays section select A static page (select below) option and choose the necessary page from the Homepage drop-down list.
3. Save the changes.

Alternatively, you can assign a page as a homepage in Appearance > Customize > Homepage Settings.

PLEASE NOTE! Default skin comes with the following Homepages.

Home 1

Below you can find the screenshots of "Home 1" front-end with hotspots describing where you can customize content for a particular section and the "Theme Options" settings.

Please use default navigator (list view) to customize the page blocks easily.

In case you don't want to use the color scheme switcher on your website, you can set or manage the background color/image for the page blocks in the Row/Section settings panel (Kadence Blocks plug-in is required).

The main additional CSS classes used in the theme are described in the Custom CSS Classes chapter of this documentation file.

Theme Options settings (Home 1):

Home 2

This is how the second homepage looks like.

Theme Options settings (Home 2):

About Pages

Here we will describe how the team section is created. The team members are inserted to the page using "Widget: About Me" block ("TRX Addons Widgets" group). You can manage the image as well as the personal information in the block's settings.

The social icons inherit the links (URLs) to your social profiles specified in the Theme Panel (WP Dashboard) > ThemeREX Addons > Socials tab.

Custom CSS Classes

PLEASE NOTE! We have used additional CSS classes to make the page blocks look like on our demo.

• .gutenberg-sidebar - stylizes a section with a sidebar on demo homepages.
• .alter_bg - the background color for the row is inherited from "Alter > Background color" option in Appearance > Customize > Colors. Please see Home 2 for more information.
• .extra_bg - the background color for the row is inherited from "Extra > Background color" option in Appearance > Customize > Colors. Please see Home 2 for more information.
• .custom-p - modifies the font size (3.57rem), line height (0.8em) and resets the bottom margin for default Paragraph block, like on demo About 1 page.
• .scheme_dark - makes the page elements inherit the colors from dark color scheme.

Responsive classes:

• .blogger_content_1, .blogger_content_2, .blogger_content_3 and .blogger_content_4 - control the output of Blogger block on homepages on different screen sizes.
• .blogger_ratio_1, .blogger_ratio_2, .blogger_ratio_3, .blogger_ratio_4, .blogger_ratio_5, .blogger_ratio_6, .blogger_ratio_7, .blogger_ratio_8, .blogger_ratio_9 and .blogger_ratio_10 - regulate the top paddings for smooth browsing (for Blogger block).
  .blogger_ratio_11 - stylizes the Blogger block for smooth browsing. Please see Home 1 for more information.
• .blogger_title_1, .blogger_title_2, .blogger_title_3, .blogger_title_4, .blogger_title_5, .blogger_title_6, .blogger_title_7, .blogger_title_8, .blogger_title_9 and .blogger_title_10 - stylize the output of posts titles and posts categories (for Blogger block) for smooth browsing, like on demo Home 1 page.

Layouts

Introduction to Layouts

Layouts is a tool that lets you create custom headers, footers, and other website sections, and is based on the Site Editor.

Layouts are available after you activate the ThemeREX Addons plug-in. After the activation, a new menu item appears in your WordPress admin panel.

Your theme comes with a number of pre-built Layouts. If you've imported the full content, they will be available for you from the start. Otherwise, you would need to generate them in Theme Panel > ThemeREX Addons > Theme Specific > Create Layouts.

Creating Layouts

In order to create a layout, navigate to Theme Theme Layouts (WP Dashboard) > Add New.

Layouts are built in a similar way you build regular pages with Site Editor. The difference is that Layouts expand the default list of blocks by adding layout-specific blocks and provide you with additional row and section settings.

When creating a Layout, first you need to specify the correct Layout type in the Item Options panel:

1. Header - the layout is applied only to output in the header area. It appears in the list of available headers in Appearance > Customize > Header > Header Style > Custom.
2. Footer - the layout is applied only to output in the footer area. It appears in the list of available footers in Appearance > Customize > Footer > Footer Style > Custom.
   
   

   You can also choose a different Header/Footer Layout for a specific page. Simply open that page in the WordPress admin, and in the Theme Options > Header/Footer panel edit the Header Style and Footer Style settings.

3. Submenu - the layout is used to create custom dropdown menu without installing Uber Menu/Mega Menu plug-ins. You can apply the submenu layout in the Appearance > Menus > Layout of submenu (optional) field.
   "Layout of submenu" field appears only when at least one submenu layout is created.
   Please view this article for more information about submenu layouts.
4. Sidebar - the layout is applied only to output in the sidebar area. It helps create custom sidebars using Site Editor. Thus, you are not limited to standard blocks and can use any elements available in the page builder. It appears in the list of available sidebars in the Appearance > Customize > General/Blog/Shop sections or in page > Theme Options > Content > Sidebar Style > Custom.
5. Blog - custom style or template to output posts elements in "Blogger" block ("TRX Addons Blocks" group), thus creating page blocks with unique overall look. Use it in combination with "Blog Item Parts" block ("TRX Addons Layouts" group), that lets you insert any post parts (featured image, title, meta data, content, custom fields) to page in any combination and in any quantity.
6. Custom - the standard layout fragment that can be added into a web page using a Layouts block ("TRX Addons Layouts" group).

Custom Layouts can be especially useful when you need to use the same section in different places on your website. Instead of building it from scratch on every new page, you can save it as a custom Layout and insert to the page, using a "Layouts" block ("TRX Addons Layouts" group).

In order to add a custom Layout to a web page:

1. In the left panel with Site Editor blocks open "TRX Addons Layouts" group, click on the "Layouts" block.
2. Choose the desired custom Layout from the dropdown list ("Type" option should be set to "Default").

Blog Layout is just a scheme showing the position of post elements like featured image, post title, meta data, excerpt, etc. Use Blog Item Parts block ("TRX Addons Layouts" group) to output each element, like in the example below.

You can apply the blog layouts to:

• Blogger block - open a page/post, in the Site Editor blocks panel navigate to ""TRX Addons Blocks" group" and insert "Blogger" block to the content area, in the "Layout" field select your blog layout.

Creating a Mobile Header in Layouts

Layouts is a preferred way of creating a mobile header since it gives you flexibility and control over your elements. Creating a mobile header is similar to creating a standard header, except there are several features you should know about in order to use Layouts more efficiently.

You can hide/show the header blocks for definite screen resolutions under the "Visibility Settings" tab for row/section (Kadence Blocks plug-in is required) or under the "Hide on Devices" for some other blocks:

Here’s a full list of available resolutions:

• Desktop – larger than 1680px;
• Notebook – from 1168px to 1679px;
• Tablet – from 768px to 1167px;
• Mobile – lesser than 767px;

Layouts Blocks

Layout-specific blocks are additional blocks available for editing/creating layouts. They are especially useful for building headers and footers. You can find layout-specific blocks under the "TRX Addons Layouts" group in the Site Editor panel.

Blog Item Parts

Inserts any post parts (featured image, title, meta data, content, custom fields) to your custom page fragment. This block outputs 1 post part at a time. If you want to create a page section with unique structure, just use as many "Blog Item Parts" blocks as you need and output post parts in any combination and in any quantity.

Cart

Displays a shopping cart icon (in case the WooCommerce plug-in is active). When clicked, the icon triggers a window with additional shopping details.

For narrow and normal row types (using additional CSS classes), the cart displays the number of products in the cart, the sum total, and an icon label. The compact row type has a shopping cart with a product counter badge only.

Container

Inserts a special container that allows embedding several blocks into 1 layout.

Featured Image

Should be used for headers only. Displays a featured image of the current post/page. Often used in combination with the Title and Breadcrumbs block.

The block has to contain at least one element, otherwise the featured image would be hidden.

Iconed Text

Inserts an icon and two text lines. It is possible to add a URL to the icon.

Layouts

Inserts content in different ways, depending on the type of the layout:

• Default - displays one of the custom layouts available in WP Dashboard > Theme Layouts post type. Please click here to view the list of available custom layouts.
• Popup - creates popup notifications that appear whenever a user clicks on a link or a button.
• Panel - creates a panel with some content/menu that appears whenever a user clicks on a link or a button.

Select which type of the layout to use in the layouts block's general settings.

The algorithm of building a popup notification or panel:

1. Create a custom layout with required content that will be displayed in the popup window or a panel. If you want to use simple text/image or shortcode (like grid gallery, mailchimp form, etc.), just omit this step.
2. In the left panel with Site Editor blocks open "TRX Addons Layouts" group, click on the "Layouts" block. Select the desired block's type (popup/panel) and custom Layout from the dropdown list (Layout field) or enter simple text/shortcode in the Content field (if "Layout" option is set to "Use content").
3. In the block's settings under the General tab, Popup (panel) ID field, assign the ID to your popup/panel, e.g. example_popup.
4. Use this popup/panel ID, preceded by a pound sign (#), as an address for the link or button that should trigger the popup/panel.

The background color for the panels is inherited from the layout's color scheme, specified in a particular header layout.

Login Link

Displays a login/logout link with an icon.

The text for the checkbox "I agree..." (registration form) is set in Appearance > Customize > General > Text with Privacy Policy link.
In order to add/customize the Privacy Policy link, navigate to Settings (WP Dashboard) > Privacy and specify the page that will be used as a Privacy Policy one.

PLEASE NOTE! In case you are planning to use the registration form without consent checkbox, just leave the "Text with Privacy Policy link" option empty in the Appearance > Customize > General section!

Logo

Inserts a logo (any image). In case there is no logo (both in layouts and in the Customizer), the theme displays the website title and description specified in Appearance > Customize > Logo & Site Identity.

Uploading Logo

The algorithm of our actions would be as follows:

1. Select the Layout where you want to place a new logo by going to Theme Layouts (WP Dashboard) > All Layouts.
2. Locate the Logo block (TRX Addons Layouts group) and proceed to block's settings panel.
3. Upload a new logo in the panel > General tab and save the changes.

IMPORTANT! Logo is available for editing for each particular layout. If no logo is selected in the Logo block ("TRX Addons Layouts" group), the initial logo from the Appearance > Customize > Logo & Site Identity will be used.

Menu

Displays one of available menus. Specify a preferred menu in the Menu field by its name, like on the screenshot below.

The Layout parameter allows selecting the Menu Layout:

• Default - standard menu with links.

Direction of the menu items: Horizontal or Vertical.

Specify default behavior for a responsive menu in the General tab:

• Mobile button - choose whether to replace the menu with a menu button when switching to the mobile version.
• Add to the mobile menu - use this menu as a mobile menu only.
• Hide on mobile devices - whether to hide or display this menu on mobile devices.

Single Post Meta

Displays elements from meta data of the current post (categories, post author, post date, post counters, share links, edit link).

Search Form

Adds a search button/input field. There are 3 styles available:

• Normal - a standard search field.
• Expand - displays a search button that expands a search field on click.
• Fullscreen - displays a search button that expands the search field to the entire screen.

Title and Breadcrumbs

Displays a title and breadcrumbs of the currently opened page/post.

Widgets

Displays one of the available widget sets (sidebars from Appearance > Widgets).

Row & Section (Column) Settings

Layouts have an extended number of settings for Row and Section blocks via adding custom CSS classes (if Kadence Blocks plug-in is active).

Choose which row or section (column) you want to edit, use the navigator (List View) if needed, go to the row/section settings panel > Advanced tab and insert the required CSS class.

CSS Classes for Additional Row Settings:

• Row type - defines a row type. It accepts the following values:
  1. Narrow Row - .sc_layouts_row_type_narrow - the smallest type of row. The blocks feature a small font size and small icons. The Iconed Text block places text in 1 line (even for two-line option).
  2. Compact Row - .sc_layouts_row_type_compact - a smaller variation of the normal row type. The blocks have a standard font size and small icons. The Iconed Text block puts text in 1 line (even for the two-line option).
  3. Normal Row - .sc_layouts_row_type_normal - a row of a normal height. The blocks inserted into this type of row have a standard font size, and medium-sized icons. The Iconed Text block features text divided into 2 lines.
• Fix this row when scroll - .sc_layouts_row_fixed combined with .sc_layouts_row_fixed_always - 'fix' the row to the top of the page (or to the last 'fixed row'). Useful for creating sticky navigation.
  To avoid "Sticky Menu" behavior remove this CSS class.
• Hide this row on unfix - .sc_layouts_row_hide_unfixed - hides the row until scrolling down.

CSS Classes for Additional Section (Column) Settings

• Section (Column) alignment - choose the alignment of the elements inside a section (column): Left, Center or Right.
  
  
  • Left section (column) alignment - .sc_layouts_column_align_left;
  • Center section (column) alignment - .sc_layouts_column_align_center;
  • Right section (column) alignment - .sc_layouts_column_align_right;

PLEASE NOTE! These section (column) and row settings are applicable to layout-specific blocks only.

Default Layouts

In this section you can find the examples of layouts that come with Default Skin. If you have imported the full demo content, they will be available for you from the start. Otherwise, you would need to generate them in Theme Panel > ThemeREX Addons > Theme Specific > Create Layouts. Feel free to create your own layouts.

You can view the list of available Layouts in Theme Layouts (WP Dashboard) > All Layouts.

All layouts are divided into six types. For more information on how to add each type of layouts to the page, please view Creating Layouts section of this documentation file.

1. Header Layouts - displays layouts in the header area.
2. Footer Layouts - inserts layouts in the footer area.
3. Submenu Layouts - displays submenu layouts. Thus, it is possible to create custom dropdown menu via Site Editor without installing Uber Menu/Mega Menu plug-ins.
4. Sidebar Layouts - displays layouts in the sidebar area.
5. Blog Layouts - creates a template to output the post parts in "Blogger" block ("TRX Addons Blocks" group).
6. Custom Layouts - pastes layouts in any area of the website, except header and footer.

Important! Please be aware that this theme does not provide any examples of sidebar and blog layouts. Feel free to create your own ones.

Header Layouts

The header menu can be customized in Appearance > Menus > Edit Menus or Appearance > Customize > Menus.

In case no logo is selected in the "Logo" block ("TRX Addons Layouts" group), the initial logo from the Appearance > Customize > Logo & Site Identity will be used.

In case you don't want to use the color scheme switcher on your website, you can set or manage the background color/image for the page blocks in the Row/Section settings panel (Kadence Blocks plug-in is required).

• Header – Style 1

  Sticky Menu The social icons on mobile menu inherit the links (URLs) to your social profiles specified in the Theme Panel (WP Dashboard) > ThemeREX Addons > Socials tab.
  
  The main additional CSS classes, we have used to stylize the header sections/rows, are described in the Row & Section (Column) Settings chapter of this documentation file.
  
  A burger menu icon triggers a panel with some additional information. In order to customize the content for the panel, please navigate to WP Dashboard > Theme Layouts tab and edit the corresponding custom layout.
  Please view the description of "Layouts" block to find out how to build a popup notification or panels.

Footer Layouts

The footer menu can be customized in Appearance > Menus > Edit Menus or Appearance > Customize > Menus.

In case no logo is selected in the "Logo" block, the initial logo from the Appearance > Customize > Logo & Site Identity will be used.

In order to make the current year change automatically in the copyright area, just paste {Y} or {{Y}} instead of the year (for Paragraph block inserted to the layout).

The social icons inherit the links (URLs) to your social profiles specified in the Theme Panel (WP Dashboard) > ThemeREX Addons > Socials tab.

The background color for the footer areas is inherited from "Dark" color scheme specified in WP Dashboard > Appearance > Customize > Colors.

In case you don't want to use the color scheme switcher on your website, you can also set the background color/image for the page blocks in the Row/Section settings panel (Kadence Blocks plug-in is required).

• Footer – Style 1

  

• Footer – Style 2

  

• Footer – Style 3

  

• Footer – Style 4

  The Blogger block outputs single posts from WP Dashboard > Posts > All Posts.
  
  "Info over image" option (Blogger > Details) stretches the featured image of a post to the block's height and places the post title with post meta over the image. This option works for posts of Image post format ONLY!

Submenu Layouts

You can apply a submenu layout in the Appearance > Menus > Layout of submenu (optional) field.
"Layout of submenu" field appears only when at least one submenu layout is created.
Please view this article for more information about submenu layouts.

The Blogger block (TRX Addons Blocks group) outputs single posts from WP Dashboard > Posts > All Posts.

• Submenu Categories (boxed)

  

• Submenu Design (boxed)

  
  Additional CSS class .submenu_with_blogger_left_filters adds grey background gradient behind the filters tabs.

Custom Layouts

Pre-built custom layouts are designed to be displayed in a panel. Please view the description of "Layouts" block for more information about the panels.

Panels

The background color for the panels is inherited from the layout's color scheme, specified in a particular header layout.

The example below is displayed in a panel.

• Panel #1

  The Blogger block outputs single posts from WP Dashboard > Posts > All Posts.
  
  The social icons inherit the links (URLs) to your social profiles specified in the Theme Panel (WP Dashboard) > ThemeREX Addons > Socials tab.
  
  In order to make the current year change automatically in the copyright area, just paste {Y} or {{Y}} instead of the year (for Paragraph block inserted to the layout).

Custom Blocks

Blocks in WordPress let you add different kinds of functionality to your website without writing a single line of code.

Our theme comes with a number of custom blocks allowing you to add information in a simple way.

Custom blocks (with icon functionality) support icons from standard Fontello icons set. You can expand the list of available icons by adding new ones from the fontello website. In order to add new icons proceed to wp-content/themes/truth/skins/default/css/font-icons/config.json. Watch this video guide for more information.
Please note, the location of config.json file and website page builder with available set of blocks in your theme may vary from the video provided!

All custom Blocks are divided into the following groups of elements in the Site Editor:

"TRX Addons Blocks" group

TRX Addons Widgets group

TRX Addons Layouts group

"TRX Addons Blocks" group

Action

This block inserts "Call to action" or columns layout. Add as many Action Items as you want.

Example:

AI Helper Chat

This block inserts ChatGPT into your web page, allowing your visitor to communicate with OpenAI via live chat (ask questions and get answers on any topics) directly from your website. The AI Helper add-on is required. The chat works if a real Open AI, Open AI Assistants, Flowise AI, or Google AI (Gemini) token is set in Theme Panel (WP Dashboard) > ThemeREX Addons > AI Helper section. It's a PAID service!

Enhance the chat by adding a list of suggested topics or questions that your visitors can use in their requests and/or chat history. Please view the description of the AI Helper Chat Topics" and AI Helper Chat History" blocks for more information.

In the global "ThemeREX Addons > AI Helper" settings you can also specify the limitations for your visitors: the number of requests per 1 hour for all visitors, the number of allowed requests from 1 visitor in 1 hour, and max. tokens per 1 request. These limits are available for regular users (free chatting) and for registered users with paid subscriptions ("Premium Mode"). Please do not forget to enable premium mode in the block's settings for registered users.

The "Model" option displays available models that are enabled in the global "ThemeREX Addons > AI Helper" settings under the "Open AI API", "Flowise AI API", and "Google AI (Gemini) API" tabs.

Example:

AI Helper Chat History

You can extend the functionality of the "AI Helper Chat" block by inserting a complete chat history of a current user. The information displayed by this block is only accessible to the logged-in users! When you click on a topic, the list of the messages will be replaced with a list of messages from the selected chat.

Please do not forget to specify the ID of the chat ("AI Helper Chat" block) you want to output the chat history from.

Example:

AI Helper Chat Topics

This block extends the functionality of the "AI Helper Chat" block by letting you create a list of suggested topics or questions for a chat beforehand. The visitors of your website can just choose a question, click on it, and proceed with communicating via live chat with Open AI. If no topics are specified in the block's settings, the latest chat requests will be displayed.

Before you start, please enter the ID of the "AI Helper Chat" block for which you want the topics to be used as prompts (AI Helper Chat > ID & Class > Element ID). Then copy this ID into the "AI Helper Chat Topics" block's settings into the General > Chat ID field.

Please treat the .gif below as an example only. The styles of the elements may vary from the ones provided with the theme.

Example:

AI Helper Image Generator

The "AI Helper Image Generator" block displays an image generator form on your web page. This block requires the AI Helper add-on to be active. The form works if a real Open AI, Stable Diffusion, and/or Stability AI token is set in Theme Panel (WP Dashboard) > ThemeREX Addons > AI Helper section. It's a PAID service!

The "Default model" option outputs a list of available Open AI, Stable Diffusion, and Stability AI models for generating images. You can activate the models by filling them into the list in the general "ThemeREX Addons > AI Helper" settings under the "Open AI API", "Stable Diffusion API", or "Stability AI API" tabs.

In the global "ThemeREX Addons > AI Helper" settings you can also specify the limitations for your visitors: the number of generated images per 1 hour and the number of allowed requests from 1 visitor during 1 hour. You can set limits for regular users (free image generation) and for registered users with paid subscriptions separately ("Premium Mode"). Please do not forget to enable premium mode in the block's settings of image generation forms for registered users.

Once these limits are exceeded, the images from the "Demo images" section of this block will be used (from your /wp-content/uploads/ folder).

Example:

AI Helper Text Generator

This block inserts a text generator form into your web page. Thus, your visitor can generate text (post, essay, story, poem, etc.), headings, and manipulate the text (make it longer/shorter, summarize, explain, translate, spell check, and much more). The AI Helper add-on is required. The form works if a real Open AI, Open AI Assistants, Flowise AI, or Google AI (Gemini) token is set in Theme Panel (WP Dashboard) > ThemeREX Addons > AI Helper section. It's a PAID service!

In the global "ThemeREX Addons > AI Helper" settings you can also specify the limitations for your visitors: the number of requests per 1 hour for all visitors, the number of allowed requests from 1 visitor in 1 hour, and max. tokens per 1 request. You can also set these limits separately for free and paid generation. Please do not forget to enable premium mode in the block's settings for registered users.

Example:

Anchor

The "Anchor" block inserts an anchor element that lets you link to specific parts of your page (or to other pages).

If you want to add smooth navigation between your anchors, check the Scroll to Anchor box in Theme Panel > ThemeREX Addons > Shortcodes > Anchor section.

Blogger

This block displays posts, pages or custom post types from a specified category or group. Just specify the post type to show the posts from in the Blogger > General > Post Type field in the block's settings panel. By default, the block outputs single posts.

You can create additional layouts to output the posts in the WP Dashboard > Theme Layouts using Blog layout's type (Item Options section). Please see Creating Layouts section of this documentation file for more information.

Example:

If you want to select more than one category from the drop down list, just hold "Shift" button and continue picking out.

You can edit the post excerpt text by opening the corresponding blog post, and adjusting text in the Excerpt field.

Enable the Excerpt field in the Preferences > Panels panel in the top right corner of the post.

IMPORTANT! The layout of the block depends on the combination of 2 main options: "Layout" and "Template". Please feel free to play around with these options.

Buttons

This block displays buttons. The settings for a single button are available through "Single Button" items.

Examples:

Content Area

This block limits content width inside the fullwide rows. Just set the necessary parameters in the block's settings panel.

"Push & Pull" settings let page blocks overlap each other, the following parameters are available:

• "Push block up"/"Pull next block up" options - move blocks by setting the negative margins, all nearby blocks shift accordingly.
• "The X-axis shift"/"The Y-axis shift" options - change position of the selected block only, the rest blocks on the page remain unmoved.

In the example below we inserted a paragraph and a Button block inside a content area with a limited width.

Example:

Price

This block inserts a price table divided by blocks (Price Items).

Example:

Socials

This block displays social icons. You can specify the necessary links (URLs) to your social profiles in the Socials Item's settings under the General tab as well as expand the list of available icons by adding new ones from the fontello website. In order to add new icons proceed to wp-content/themes/truth/skins/default/css/font-icons/config.json. Watch this video guide for more information.

PLEASE NOTE! Please note, the location of config.json file and website page builder with available set of widgets/shortcodes/blocks in your theme may vary from the video provided!

If empty, the social icons will inherit the links (URLs) to your social profiles specified in the Theme Panel > ThemeREX Addons > Socials tab.

Example:

Table

This block inserts a regular table, created using any table-generator, like http://www.impressivewebs.com/html-table-code-generator/.

Example:

Title

This block inserts a regular title with subtitle, some description and a button.

Example:

TRX Addons Widgets group

Widget: About Me

This block displays an "About Me" section with some personal information of the website's owner or any other person. If you leave the options empty they will inherit data from the following options on the admin's profile page: "Profile Picture" (for photo), "Username" (for name) and "Biographical Info" (for description). You can hide any option by inserting # sign in the corresponding field in the block's settings.

The block is designed to be used in a sidebar.

Example:

Widget: Audio Player

This block inserts an Audio Player section with single audio items. You can use a locally uploaded audio file (from your Media library) or an external one (through embed html code). The system ignores the "Audio caption" and "Author name" options, if the embed code is used.

Example:

Widget: Banner

This block displays a regular banner image linked or not as well as any object inserted using html code (banner, iFrame for video, audio, etc.).

Example:

Widget: Calendar

This block displays a regular WP calendar. You can choose the way of shortening the weekday names: to one (first) letter or to three letters.

Example:

Widget: Categories List

This block displays a list of post or products categories/tags/formats, layouts or CPT groups. By default, it inserts post categories. You can choose the post type to show the categories/tags/groups from in the General > Post type field.

Example:

In case you want to display thumbs with the titles, you should check "Large Image" or "Small Image" attribute options and enable these attributes for the needed category/group of posts/post types in Theme Panel (WP Dashboard) > ThemeREX Addons > Extended Taxonomy tab. Then navigate to a particular category/group of posts/post types in WP Dashboard and upload the images (if this option is available for a definite group of posts).

Widget: Recent Posts

This block displays the most recent posts. You can set additional options under the "General" tab in the block's settings panel. This block is designed to be used in a sidebar or in a column.

Example:

Widget: Slider

This block lets you insert Swiper Slider (Posts Slider).

Example (Swiper Slider):

The Swiper Slider lets you display your posts, pages, or custom post types in a form of a slider. Enhance the slider by adding preview image thumbnails using Slider Controller, and navigation arrows using the Slider Controls or via the Slider block's settings under General tab.

You can also create custom slides:

Slider Controller + Slider Controls

Slider Controller displays image thumbnails and navigation arrows for the Swiper Slider engine in the Widget: Slider block.

Slider Controls adds navigation pointers for the Swiper Slider engine in the Widget: Slider block.

Make sure to enter the ID of the "Widget: Slider" block you want to control. Enter the ID first into the "Widget: Slider" block settings (under the ID & Class tab), and then copy it into the Slider Controller/Slider Controls settings into the General > Slave slider ID field.

Example:

Widget: Socials

This block displays social icons of the social networks you are subscribed to. Please specify the necessary links (URLs) to your social profiles in the Theme Panel > ThemeREX Addons > Socials tab.

Example:

Widget: Twitter Feed

This block inserts posts from your twitter account. Please use your own Twitter API keys to make the widget display your twitter feed properly. The theme supports Twitter API v.2.

Widget: Video Player

This block displays a video file. The block supports direct links from Youtube, Vimeo or locally downloaded video files. You can also insert a video through html code from any video hosting platform.

Example:

Widget: Video List

This block shows a list of videos:

• taken from posts of "Video" post format type. A url or embed code for the video should be specified in the single post's settings, Item Options > Video > Video List section.

Example:

TRX Addons Layouts group

Layouts

Inserts content in different ways, depending on the type of the layout:

• Default - displays one of the custom layouts available in WP Dashboard > Theme Layouts post type. Please click here to view the list of available custom layouts.
• Popup - creates popup notifications that appear whenever a user clicks on a link or a button.
• Panel - creates a panel with some content/menu that appears whenever a user clicks on a link or a button.

Select which type of the layout to use in the layouts block's general settings.

The algorithm of building a popup notification or panel:

1. Create a custom layout with required content that will be displayed in the popup window or a panel. If you want to use simple text/image or shortcode (like grid gallery, mailchimp form, etc.), just omit this step.
2. In the left panel with Site Editor blocks open "TRX Addons Layouts" group, click on the "Layouts" block. Select the desired block's type (popup/panel) and custom Layout from the dropdown list (Layout field) or enter simple text/shortcode in the Content field (if "Layout" option is set to "Use content").
3. In the block's settings under the General tab, Popup (panel) ID field, assign the ID to your popup/panel, e.g. example_popup.
4. Use this popup/panel ID, preceded by a pound sign (#), as an address for the link or button that should trigger the popup/panel.

The background color for the panels is inherited from the layout's color scheme, specified in a particular header layout.

Example (Default layout on custom background):

Example (Popup layout):

Example (Panel layout):

The rest blocks from this group are described in the Layouts Blocks section of this documentation file.

ThemeREX Addons

As a free addition to this theme, we have included a unique ThemeREX Addons plug-in. Once activated, it allows expanding the options of the theme noticeably. These add-ons allow you to use custom widget sets and custom blocks, show custom post types, set links to your social profiles as well as some advanced theme-specific settings.

After plug-in's installation, the "ThemeREX Addons" menu item should appear in the "Theme Panel" tab in WordPress dashboard menu panel.

Below is a brief description of all the available settings.

General

Settings of this tab define the general behavior of your theme.

General Settings

• Debug Mode - Enable debug functions and theme profiler output.
  
  IMPORTANT! There is a separate file for each script snippet .js and style-related .css data. For better theme performance the system automatically re-compiles/re-merges these files into a single .js/.css related one after every "Save Options" button click in Customizer (Appearance > Customize) and ThemeREX Addons settings (Theme Panel > ThemeREX Addons).
  In case the "Debug Mode" is on, the theme does not run the re-compile/re-merge mode, so every file loads separately. That is why we do recommend turning this mode on only if you need to edit/customize the source script and style-related files. Please do not edit the following (re-merged) files: trx_addons.css, trx_addons.js, __colors.css, __style.css, __scripts.js.
• Disable new Widgets Block Editor - Disable new Widgets Block Editor, if after the update to WordPress 5.8+, you are having trouble with editing widgets or working in Customizer. New Widgets Block Editor is used in WordPress 5.8+ instead of the classic widgets panel.
• Image dimensions - Choose which dimensions will be used for the uploaded images: "Original" or "Retina ready" (twice enlarged).
  If the "Retina" option is enabled, twice enlarged images will be loaded on devices with retina displays and regular images will be used for non-retina screens. The system automatically creates retina versions for all sets of thumbnails. This will significantly enlarge your disc space. It doesn't work for previously uploaded images. In this case, you can install and launch any plug-in, like regenerate thumbnails, after switching this option.
• Quality for cropped images - Specify a range of quality (1-100) to save cropped images.
  
  
  PLEASE NOTE If you change the image quality, do not forget to regenerate the thumbnails again.
  
  
• Big images threshold - If the original image width or height is above the threshold, it will be scaled down. The threshold is used as max width and max height. If 0 - turn off image size check.
• Animate inner links - This setting adds a "smooth scroll" effect to the inner page links.
• Open external links in a new window - If checked, this setting adds parameter target="_blank" to all external links.
• Popup Engine - Choose one of two scripts to display your popup images.

404 Page

• 404 Page - Choose a page to take content from for redirect if the requested URL is not found (404 error). If no page is selected, the default 404 page that comes with the theme will be used.

Preloader Settings

• Show page preloader - Select or upload a page preloader image for your site.
  
  
  • Page preloader bg color - Specify the background color for the page preloader. If empty - no preloader is used.
  • Page preloader image - Select or upload the page preloader image. If empty - no preloader is used. This option is available for the "Custom" preloader style only.

Scroll Helpers Settings

• Progress bar of reading the article - Enable/disable the progress bar of reading the article.
• Add "Scroll to Top" - Add the "Scroll to Top" button when the page is scrolled.
• Hide fixed rows - Hide fixed rows when the page is scrolled down and show them on scroll up.
• Enable smooth scroll - Allow smooth scrolling of site pages with the mouse wheel.
• Enable infinite scroll in Media Library - Allow infinite scroll in Media Library or load the next part of images on the button click (by default).

Menu & Search Settings

Menu

• Collapse menu - Whether you need to group menu items or not, if they don't fit in one line.
• Icon - Select the icon of the menu item with collapsed elements.
• Stretch a submenu with layouts - Stretch a submenu with layouts (only the first level) to the content width.
• Breadcrumbs nestings - Specify the necessary nesting level for breadcrumbs.

Search Enhance

• Search for terms - if enabled, makes standard WordPress search, "Search Form" block from "TRX Addons Layouts" group (for pages) and "ThemeREX Products Filter" widget (for sidebars) support search keywords among all registered taxonomies (categories, tags, product attributes, etc.). The taxonomy searches will significantly slow down the results page.

Performance

Settings of this tab allow you to improve page loading speed.

Optimization Settings

• Optimize CSS and JS loading - Disable CSS and JS files from loading if they are not used on the current page.
  
  
  • No - Load all CSS and JS files (optimization disabled);
  • Soft - Load CSS and JS files from the theme and ThemeREX Addons plug-in on the pages where they are used. The loading of styles and scripts of external plug-ins is regulated by the rules of those plug-ins.
  • Full - Load CSS and JS files on the pages where they are used (for theme styles, ThemeREX Addons plug-in, and all supported plug-ins).
• Disable Emoji - Remove Emojis scripts and styles if you don't use them.
• Move javascripts to the footer - This setting moves all tags "script" to the footer to increase page loading speed.
• Exclude javascripts from moving to the footer - Specify the URL fragments of the scripts you want to exclude from moving to the footer (if there are any problems with them). The system scripts (jquery, modernizr, Elementor, etc.) are included in this list by default.
• Load javascripts asynchronously - This setting adds the attribute "defer" to all tags "script" in the front end.
• Exclude javascripts from asynchronous loading - Specify the URL fragments of the scripts you want to exclude from asynchronous loading (if there are any problems with them). The system scripts (jquery, modernizr, Elementor, etc.) are included in this list by default.

Lazy Loading Settings

• Enable media lazy loading - Enable image, video, audio and iframe lazy loading. This function allows a browser to defer loading offscreen images and iframes until users scroll down to them.
  
  
  • Number of images excluded from lazy loading on pages - Specify the number of images NOT to preload with lazy loading on pages.
  • Number of images excluded from lazy loading on posts - Select the number of images NOT to preload with lazy loading on single posts.

Cache Manager Settings

Cache Manager

• Cache handler - Select a cache storage location.
  
  
  • Files - data is stored as separate files in the /uploads/trx_addons/cache folder.
  • Database - data is stored in the WordPress cache in your database.
• Disable CSS and JS cache - Prevent the browser from caching CSS and JS files in debug mode.
• Remove parameter "ver=" from URL - This setting removes parameter "ver=" from URLs of the styles and scripts to enable caching these files.
• Views counter via AJAX - This setting allows managing the views counter. We recommend leaving it intact.

Layouts

• Use layout caching - Use caching of custom layouts (significantly reduces page loading time and the number of database requests, but increases the size of the database). If enabled, we recommend using "Files" as a cache storage location.
  
  
  • Select the types of layouts to caching - Use caching only for the specified types of layouts.
  • Cache only on the popular pages - Cache the layouts only for the most visited pages.

Menu

• Use menu caching - The menu caching option is responsible for increasing the overall theme's performance.

API

This section contains settings for correct connecting to your profile on Facebook.

Facebook Settings

Here, you can specify Facebook App ID.

AI Helper (available if AI Helper Add-on is active)

These are the basic settings for AI Helper. Here, you can insert your own Open AI, Stable Diffusion, and Stability AI tokens, choose the models for generating images here as well as specify the limitations for your customers to generate images/text from your website or for chat requests (if you have inserted the corresponding blocks into your web page). It's a PAID service!

Links for generating tokens:

• Open AI - https://beta.openai.com/account/api-keys;
• Stable Diffusion - https://stablediffusionapi.com/settings/api;
• Stability AI - https://platform.stability.ai/account/keys;
• Google AI (Gemini) - https://makersuite.google.com/app/apikey;

Common Settings

Here you can enable/disable AI Assistant in your Dashboard, extend support for using AI Assistant, and choose default text model for text generations.

AI Assistant

• Allow AI Assistant - Enable an intelligent assistant in the admin area (in the right bottom corner) that can display and change some global theme settings (website title, tagline, logo; colors of a defined color scheme, etc.), as well as answer questions related to the theme customization. The assistant functions when you have paid support, which initially lasts for 6 months from the theme purchase. To continue using AI Assistant, you will need to extend the support period through a paid service.
• Extend support - Add a new support key to extend the support period for using AI Assistant.

Common settings

• Default text model - Select a text model to use as a default one for AI actions such as translation, process selected text, etc. If the list of models is empty - it means that you have not connected any API for text generation. You need to specify an access token for at least one of the supported APIs - Open AI (preferably), Google AI, or Flowise AI.

Open AI API Settings

Below you can find settings of the AI Helper for Open AI API.

• Open AI token - Specify a real token to use the OpenAI API functionality. Please follow this link to generate your token from your account, if needed.
  
  The rest settings appear if the AI token is entered.
  
  
  • Proxy URL - Type in an address of the proxy-server (if need).
  • Proxy Auth - Specify the login and password to access the proxy-server (if needed). Use the format: login:password.
  • Temperature - Select a temperature to use with OpenAI API queries. It describes the level of randomness. O - less random, 2 - creative, but more random.
  • List of available chat/image models - Add the required models for chats and generating images. Specify IDs and names (titles) for each new model.

Open AI Assistants Settings

A list of assistants created in the GPT4 Plus user account and available for use as an embedded chatbot and/or model in the AI Chat block.

Please check our video tutorial.

Stable Diffusion API Settings

If the Open AI models for generating images are not enough for you, you can use Stable Diffusion image generation models. Just enter your own Stable Diffusion token and set the available parameters. By default, we have activated 10+ models, though you can easily add new ones. The number of activated models is unlimited.

• Stable Diffusion token - Specify a real token to use the Stable Diffusion API. You can generate a token in your account using the link.
  
  The rest settings appear if the Stable Diffusion token is entered.
  
  
  • Use API server - Choose the server to access the API - stablediffusionapi.com (legacy) or modelslab.com (new).
  • Default SD model endpoint - Select an enpoint for accessing the default StableDiffusion model on the ModelsLab API server.
  • Guidance scale - This is a scale for classifier-free guidance.
  • Interference steps - Specify the number of denoising steps. Available values: 21, 31, 41, 51.
  • Autoload a list of models - Choose between the automatically loading model list from the API or maintaining a manual model list.
  • List of available models - Add the required models for generating images. Specify IDs and names (titles) for each new model. A complete list of available models (with their IDs and titles) can be found at https://stablediffusionapi.com/models.

This list with Stable Diffusion models will appear in the "AI Helper Image Generator" block ("TRX Addons Blocks" group) and in the WordPress Media Library Selector popup.

Feel free to check out our video tutorial concerning the Stable Diffusion API integration:

Stability AI API Settings

Our theme also supports Stability AI API for generating images.

• Stability AI token - Specify your token to use the Stability AI API. You can generate a token in your account using the link.
  
  The rest settings appear if the Stability AI token is specified.
  
  
  • Prompt weight - A weight of the text prompt.
  • Cfg scale - How strictly the diffusion process adheres to the prompt text (higher values keep your image closer to your prompt).
  • Diffusion steps - Specify the number of diffusion steps to run.
  • Autoload a list of models - If enabled, the system automatically loads the model list from the API. If disabled, the system maintains a manual model list.
  • List of available models - Add the required models for generating images. Specify IDs and names (titles) for each new model. A complete list of available models (with their IDs and titles) can be found at https://platform.stability.ai/pricing.

Flowise AI Settings

Settings of the AI Helper for Flowise AI API:

• Flowise AI API key - Specify your token to use the Flowise AI API. You can get a key in the Flowise Dashboard - API keys.
  
  The rest settings appear if the Flowise AI token is specified.
  
  
  • Flowise AI host URL - Type in the address of the server on which Flowise AI is deployed.
  • List of available chat flows - Set an ID and a title for each new chat flow. You can use these chats as models for the "AI Helper Chat" block.

Google AI (Gemini) Settings

Available settings for Google AI (Gemini):

• Google AI API key - Specify your token to use the Google AI API. You can generate a token in your account using the link.
  
  The rest settings appear if the Google AI token is specified.
  
  
  • Proxy URL - Specify the address of the proxy-server (if need).
  • Proxy Auth - Insert the login and password to access the proxy-server (if needed). Use the format: login:password.
  • Autoload a list of models - Choose between automatically loading the model list from the API or maintaining a manual model list.
  • List of available models - Specify an ID and a title for each new chat model.

Take a look at our video tutorial for step-by-step guidance on integrating Google's Gemini AI API with your WordPress site.

Embed External Chatbots Settings

Specify a scope and HTML code for each new embedding. In the "URL contain" field, you can list the parts of the address (each part separated by a comma or on a new line), if any match the current page, this block will be displayed. In the "HTML code" field, paste the code snippet you received when you created/exported the chatbot in your Flowise AI, VoiceFlow, etc. personal account. You can also use [trx_sc_chat type='popup' ...] shortcode to insert "AI Helper Chat".

Shortcode "Image Generator" Settings

The "AI Helper" add-on allows you to display an image generator form on your web page, using the "AI Helper Image Generator" block ("TRX Addons Blocks" group).

Common settings

• API order - As our theme supports Open AI, Stable Diffusion, and Stability AI models for generating images, you can turn on/off the available APIs and drag and drop them to specify the sequence.
• Translate prompt - Always translate the prompt into English. Most models are trained on English language datasets and therefore produce the most relevant results only if the prompt is formulated in English. If you have specified a token for the OpenAI API (see section above) - we can automatically translate prompts into English to improve image generation.

Limits for a Free Mode

• Use limits - If enabled, use limits (per hour and visitor) when generating images for free. These limits are for regular users who are not logged in or registered.
  
  
  • Images per 1 hour - The number of images all visitors can generate in 1 hour.
  • Requests from 1 visitor - The number of allowed requests from 1 visitor during 1 hour.
  • Limits reached alert - Adjust a message that the visitor will see when the limit of requests or generated images is exceeded. If Premium Mode is used, be sure to provide a link to the paid access page here.

Limits for a Premium Mode

This section is for those who want to create a paid image generation service. Here you can set the limits for paid usage. The options below can be applied to the "AI Helper Image Generator" block ("TRX Addons Blocks" group) with the "Premium Mode" option enabled.

Ensure restricted access to pages with this widget by providing a link to the paid access page in the alert message from the "Limits for a Free Mode" section.

• Use limits - If enabled, use limits for visitors when generating images. These limits are for paid image generation.
  
  
  • General limits - When an access sharing plug-in is not used. In this case, you can restrict the page with an image generation form by a password. No registration for users is required.
    
    
    • Images per 1 hour - The number of images all visitors can generate in 1 hour.
    • Requests from 1 visitor - The number of allowed requests from 1 visitor during 1 hour.
  • Limits for logged-in users - If a page with a premium image generation form is restricted by an external plug-in ("Default" limit) or an external plug-in separates access levels, like "Paid Memberships Pro" (not provided with the theme).
    
    
    • User levels with limits - The number of images a user can generate during a definite period (hour, day, week, month, or year) depending on the subscription level.
      Default level - A limit for regular registered users, if the page with a premium image generation form is restricted by an external plug-in (not provided with the theme). This limit will be applied to every logged-in user separately.
      Other levels - For more flexible settings, use special plug-ins to divide access levels, like "Paid Memberships Pro" (not provided with the theme).
  • For all limits
    
    
    • Limits reached alert - Adjust a message that the visitor will see when the limit of requests or generated images is exceeded.

Shortcode "Text Generator"/"AI Chat" Settings

You can insert a text generator form and AI chat right into your web page, using "AI Helper Text Generator" and "AI Helper Chat" blocks ("TRX Addons Blocks" group). Thus, your visitor can generate text and headings, manipulate the text, as well as communicate with OpenAI via live chat (ask questions and get answers on any topics) directly from your website.

Common settings

• API order - As our theme supports several APIs, you can turn on/off and drag and drop them to specify the sequence.
• Temperature - Choose a temperature to use with queries. It describes the level of randomness. O - less random, 2 - creative, but more random.
• System Prompt - Type in the system instructions for the AI Helper in the post editor. Serve as a guide for choosing the style of communication on the part of the AI.

Limits for a Free Mode

• Use limits - If enabled, use limits (per request, per hour, and per visitor) when generating text or chatting.
• Max. tokens per 1 request - The number of tokens used per request to the API.
• Requests per 1 hour - The number of requests processed for all visitors during 1 hour.
• Requests from 1 visitor - The number of allowed requests from 1 visitor during 1 hour.
• Limits reached alert - Type in a message that the visitor will see when the limit of requests is exceeded. If Premium Mode is used, be sure to provide a link to the paid access page here.

Limits for a Premium Mode

This section is for those who want to create a paid text generation service or paid chat. Here you can set the limits for paid usage. The options below can be applied to the "AI Helper Text Generator" and "AI Helper Chat" Gutenberg blocks or Elementor widgets ("ThemeREX Addons Elements" group) with the "Premium Mode" option enabled.

Ensure restricted access to pages with these widgets by providing a link to the paid access page in the alert message from the "Limits for a Free Mode" section.

• Use limits - If enabled, use limits for visitors when generating text or chatting. These limits are for paid service.
  
  
  • General limits - When an access sharing plug-in is not used. In this case, you can restrict the page with a text generation form or a chat with a password. No registration for users is required.
    
    
    • Max. tokens per 1 request - The number of tokens used per request to the API.
    • Requests per 1 hour - The number of requests processed for all visitors during 1 hour.
    • Requests from 1 visitor - The number of allowed requests from 1 visitor during 1 hour.
  • Limits for logged-in users - If a page with a premium text generation form or a chat is restricted by an external plug-in ("Default" limit) or an external plug-in separates access levels, like "Paid Memberships Pro" (not provided with the theme).
    
    
    • User levels with limits - The number of requests a user can generate during a definite period (hour, day, week, month, or year) depending on the subscription level.
      Default level - A limit for regular registered users, if the page with a premium text generation form or a chat is restricted by an external plug-in (not provided with the theme). This limit will be applied to every logged-in user separately.
      Other levels - For more flexible settings, use special plug-ins to divide access levels, like "Paid Memberships Pro" (not provided with the theme).
  • For all limits
    
    
    • Limits reached alert - Adjust a message that the visitor will see when the limit of requests is exceeded.

PLEASE NOTE! More information about the "AI Helper" Add-on is available here.

Users

Here you can specify the parameters of the User's Login and Registration.

• Login via AJAX - Define whether to use AJAX Login or a direct link on the WP Login Page.
• Login via social profiles - Add the necessary code snippet/shortcode from the Social Login Plugin.
• Notify about new registration - Define the person who receives a registration notification message.
• Double opt-in registration - Send confirmation E-mail with new registration data to the site admin e-mail and/or to a new user's e-mail. The link to confirm the registration expires within 24 hours. Once the link is followed a new user will be registered.

Socials

Here you can specify all the necessary links (URLs) to your social profiles. Just paste the permanent URL addresses into the needed fields and click "Save."

Social Profiles Settings

Select an icon/image, specify social network's title and provide the URL to your profile. Just paste the permanent URL addresses into the needed fields and click "Save."

The icons are used from the standard Fontello icons set. You can expand the list of available icons by adding new ones from the fontello website. To add new icons proceed to wp-content/themes/truth/skins/default/css/font-icons/config.json. Watch this video guide for more information.

PLEASE NOTE! The location of the config.json file and website page builder with the available set of widgets/shortcodes/blocks in your theme may vary from the video provided!

Share Posts Settings

Specify URLs to share your posts in the social networks. If empty - no share post in this social network is used.

You can use the following macros to include post's parts into the URL:

• {link} - post's URL;
• {title} - title of the post;
• {descr} - excerpt of the post;
• {image} - post's featured image URL;
• {id} - post's ID;

Add Open Graph tags - Enable/disable Open Graph tags. They are responsible for the information (picture, title, description) that appears on the wall of the user, when he clicks on the "Share" icon inn your blog. They are used by many popular social networks such as Facebook.

Banners Settings

These settings allow you to enable banners on single posts and specify parameters for banners.

PLEASE NOTE!"Banner code" option allows using html code only!

Reviews

Here you can enable the reviews section for posts/pages/post types and specify rating settings.
The quantity of accessible post types varies depending on the installed plug-ins.

Once you have enabled the reviews section globally, you should enable reviews on a single post/page. Please open a post/page and check the "Enable review" option in the Item Options > Review section.

If you want to display a rating above the comment form, please navigate to a particular post/page in the WP Dashboard and allow comments section, like in the screenshot below:

Shortcodes

Here you can define whether you want to use the Anchor block or not, specify hover effects for form fields.

Extended Taxonomy

Here you can enable some extended taxonomy attributes for a particular group/category of posts. You can output the large/small image using the "Widget: Categories List" block (TRX Addons Widgets group).
The taxonomy list may vary depending on the plug-ins installed.

Navigate to a particular category/group of posts in WP Dashboard and set the required attributes.

Theme Specific

The settings of this section override the default theme's grid classes, page wrap class, and recreate layouts. We recommend leaving these settings intact.

Theme Elements Settings

Create Layouts setting is responsible for recreating the set of predefined layouts. It might become useful in case there are no layouts available after theme installation.

Theme Wrappers Settings

Columns Grid

• Column's wrap class - Specify theme specific class for the column's wrap. If empty - use plug-in's internal grid.
• Column's wrap class for fluid columns - Insert theme specific class for the fluid column's wrap. If empty - use plug-in's internal grid.
• Single column class - For example: column-$1_$2, where $1 - column width, $2 - total number of columns: column-1_4, column-2_3, etc. If empty - use plug-in's internal grid.

Page wrappers

• Page wrap class - Specify theme specific class for the whole page wrapper (contains all page components).

Advanced Theme Add-ons

Advanced theme add-ons enhance the functionality of a WordPress theme. They come prepacked with the theme and require a ThemeREX Addons plug-in to be active.

Once you have activated your theme (entered your purchase code), please navigate to the Theme Panel (WP Dashboard) > Theme Dashboard > Addons tab and make sure that all advanced add-ons, provided with the theme, are active. Now you can proceed with demo data installation and further theme customization. Here you can activate/deactivate, download or update add-ons if needed.

PLEASE NOTE! The following advanced theme add-ons come with the theme.

AI Helper Add-on

We have integrated Open AI content generation functionality into our themes. It means that you can use ChatGPT right through your WordPress dashboard and save your time while creating content for pages, posts and generate images right through the WordPress Media Library Selector popup. Moreover, you can let your visitors generate images/text or communicate with OpenAI via live chat (ask questions and get answers on any topics) directly from your website (if you have inserted the corresponding blocks into your web page). This add-on is still in development. New features will come soon.

Before you start, please navigate to Theme Panel (WP Dashboard) > ThemeREX Addons and find the "AI Helper" section. Here, you can insert your own Open AI, Stable Diffusion, Stability AI, Flowise AI, and/or Google AI (Gemini) tokens, choose the models for generating images here as well as specify the limitations for your customers to generate images/text from your website or for chat requests and much more. It's a PAID service! Please click here to find the description of the global AI Helper settings.

Links for generating tokens:

• Open AI - https://beta.openai.com/account/api-keys;
• Stable Diffusion - https://stablediffusionapi.com/settings/api;
• Stability AI - https://platform.stability.ai/account/keys;
• Google AI (Gemini) - https://makersuite.google.com/app/apikey;

Currently, Open AI Helper can:

1. Create content for a post or page. It can generate post content, titles, and excerpts, as well as help you correct text fragments: make them longer, or shorter, summarize, translate, explain, and much more.
   
   If you want to make the process of assembling content more efficient, open your post or a page and find the "TRX Addons AI Helper" tab in the right panel. Enjoy using Open AI technologies. Please view our video tutorial for more information about generating/customizing content with AI Helper.
   
   
2. Generate images right in the WordPress Media Library Selector popup and create variations of generated images with the ability to upload them to your WordPress Media Library.
   
   This functionality is implemented into Gutenberg page builder. Just click on the "choose/upload image" button anywhere on the page's back end where you want to insert an image and in the newly opened WordPress Media Library Selector popup switch to the "AI Image Generator" tab. Now, specify the search parameters and generate the images. The "AI Image Generator" tab appears only if the Open AI, Stable Diffusion, and/or Stability AI token is entered in the general "ThemeREX Addons > AI Helper" settings!
   
   You can activate the models by filling them into the list in the general "ThemeREX Addons > AI Helper" settings under the "Open AI API", "Stable Diffusion API", or "Stability AI API" tabs.
   
   Generated images can have a size of 256x256, 512x512, or 1024x1024 pixels. Smaller images can be generated faster.
3. Display the AI image generator form on your web page.
   
   To insert an image generator to your page, open a page/post using Gutenberg page builder, and find the "AI Helper Image Generator" block under the "TRX Addons Blocks" group. Adjust the block to your needs and save your changes. You will get the following form on your front end. In the global "ThemeREX Addons > AI Helper > SC Image Generator" settings you can also specify the limitations for your visitors: the number of generated images per 1 hour and the number of allowed requests from 1 visitor during 1 hour. You can set limits for regular users (free image generation) and for registered users with paid subscriptions separately ("Premium Mode"). Please do not forget to enable premium mode in the block's settings.
4. Insert the AI text generator form into your web page.
   
   If you want your visitors to have the possibility to generate text (post, essay, story, poem, etc.) and headings, manipulate the text (make it longer/shorter, summarize, explain, translate, spell check, and much more) through your web page, open a page/post using Gutenberg page builder and find the "AI Helper Text Generator" block under the "TRX Addons Blocks" group. Place this block on your page, set it up to your needs, and save your changes. You can get something like this: In the global "ThemeREX Addons > AI Helper > SC Text Generator" settings you can also specify the limitations for your visitors: the number of requests per 1 hour for all visitors, the number of allowed requests from 1 visitor in 1 hour, and max. tokens per 1 request. You can also set these limits separately for free and paid generation.
5. Add an AI-powered live chat to your website.
   
   Insert "AI Helper Chat" Gutenberg block ("TRX Addons Blocks" group) to your web page and let your visitors interact with OpenAI. Chat example: In the global "ThemeREX Addons > AI Helper > SC AI Chat" settings you can also specify the limitations for your visitors: the number of requests per 1 hour for all visitors, the number of allowed requests from 1 visitor in 1 hour, and max. tokens per 1 request. These limits are available for regular users (free chatting) and for registered users with paid subscriptions ("Premium Mode"). Please do not forget to enable premium mode in the block's settings.
6. Use AI Assistant in the admin area (in the right bottom corner) to display and change some global theme settings (website title, tagline, logo; colors of a defined color scheme; etc.), as well as answer questions related to the theme customization. The assistant functions when you have paid support, which initially lasts for 6 months from the theme purchase. To continue using AI Assistant, you will need to extend the support period through a paid service and enter your new support key in "ThemeREX Addons > AI Helper > Common Settings".

Plug-ins

This section contains a brief description, as well as references, of some plug-ins available with this theme.

AI Engine

This plug-in allows you to create a chatbot like ChatGPT (or any other), generate content and images, let you organize everything in templates, quickly suggest titles and excerpts, track your OpenAI usage stats, and much more! It can also significantly help you with translation, correction, SEO, suggestion, WooCommerce product fields, etc.

Currently, the AI Engine plug-in supports ChatGPT, GPT-3, GPT-4, and GPT-4 32k models.

Please view the links below for more information about the AI Engine plug-in:

1. Official plug-in page
2. Official WordPress plug-in page
3. Official plug-in documentation
4. Our video review

Contact Form 7

Contact Form 7 can manage multiple contact forms, plus you can customize the form and the mail contents flexibly with simple markup. The form supports Ajax-powered submitting, CAPTCHA, Akismet spam filtering and so on.
Check this link for more information. More guides are available here (video tutorial) and here.

The theme comes with a pre-built contact form that can be customized in Contact (WP Dashboard) > Contact Forms.

[contact-form-7 id="88" title="Contact form 1"]

PLEASE NOTE! According to General Data Protection Regulation, you need to make your forms compliant. Some pre-built forms, that come with this theme, already have the corresponding "I agree..." checkboxes.

For newly created forms you should add the consent checkboxes in ONE of the following ways:

1. Use [acceptance acceptance-...] or [checkbox...] tag, like in the example below:
2. Use the Cookie Information plug-in (formerly WP GDPR Compliance) (not provided with the theme).

Kadence Blocks (free version)

This Gutenberg addon expands the functionality of the Site Editor. This plug-in provides you with a suite of professional page building content blocks (with row and column layouts) and customization tools like responsive margins/paddings for content sections, backgrounds, overlays with gradients, vertical-align and much more. Please click here for more information about the plug-in. The official documentation can be found here.

Custom Blocks:

• Row Layout
• Advanced Gallery
• Form
• Advanced Heading
• Advanced Button
• Tabs
• Accordion
• Testimonials
• Icon
• Spacer/Divider
• Info Box
• Icon List

Please follow this link to view the official tutorial.

ThemeREX Updater

This is our self-made plug-in that allows you to update the main theme as well as the bundled plug-ins through the WordPress admin panel. Once any plug-ins or theme updates are available for download, you will receive a corresponding notice in WP Dashboard > Updates. Please view the Theme Update chapter of this documentation file for more information.

WooCommerce

WooCommerce is an industry leader e-commerce plug-in for WordPress. Our theme is fully compatible with this great tool, allowing you to turn your website into sales machine in just a few clicks. You simply need to install this plug-in and allow it to create a set of pages to display categories, products etc. Then you need to add a set of products.

We highly encourage you to read the great documentation files WooCommerce offers. These manuals help to create effective and reliable on line stores providing more features than you can imagine. Here is a list of really useful links helping you create and polish your shop.

1. Documentation - official plug-in documentation.
2. Free and Premium extensions - powerful toolbox bringing more features to your shop.
3. iOS app for WooCommerce - this application gives you full control over your shop.

Theme Translation

We recommend using Poedit software for translation-related purposes.

To translate the theme to your language, please follow these steps:

1. Download and install Poedit software.
2. Navigate to the theme/skins/default/languages/ folder and locate .pot file. Copy it to your desktop for editing.
3. Double click on the .pot file. In the Poedit window click on the "Create New Translation" button, choose the necessary language of the translation from the dropdown list and click "OK."
4. Now select the constant text string you need to translate from the "Source text - English" field and type in the necessary translation into the "Translation" field.
   You can translate as much as you want, just go through the file and click on each string in "Poedit" and add your translation.
5. Next, you have to save the changes to your .po file using the naming convention based on the language code (e.g. pt for Portuguese) followed by the country code (for instance _BR for Brazil). To do that click on the "sheet" icon (you can also use hotkeys CMD + Shift + S in OS X or Win+S in Windows) and type in the name according to the screenshot below.
   The first lower-case letters define the language, whereas the second upper-case letter defines the country. In most cases, the language and country are the same, like “de_DE” for Germany.
   However, there is a difference for languages like English or Portuguese, which are spoken in several countries natively. In this case, the difference is in the first and second letter pairs; for the UK, the code would be en_GB, whereas the en_US stands for the USA. If you are not familiar with the codes for your native language and country, then visit the GNU website. See Language Codes and Country Codes for the lists of codes.
   
   PLEASE NOTE! If you use the wrong naming convention WordPress can not process your translation.
6. When saving your .po file, Poedit automatically creates a new .mo file, with the same naming convention. According to the example above, the file would be called pt_BR.mo.
7. Upload the .po and .mo files you just created to the .../languages folder. Make sure these files are in the same directory as the default.pot one.
8. Our theme is using ThemeREX Addons plug-in, so some translation should be done in language files of this plug-in in the .../wp-content/plugins/trx_addons/languages directory. There is also a trx_addons.pot file in this directory.
   Generate the .po and .mo files according to your language. See the file names on the example below:
   trx_addons-pt_BR.po, trx_addons-pt_BR.mo.
   Make sure that the language of your files is the same as in your WordPress admin panel > Settings > General Settings section.

For more information on how to use Poedit, please check the following resources:

• Editing language files with POEdit

Sources and Credits

In this section you can find additional information regarding fonts, clipart, .XD files used in this theme.

• Fonts:
  
  
  1. Default Skin: "'Lora', 'serif'"; "'Karla', 'sans-serif'";
     
  2. You can also check the truth/skins/default/skin-setup.php file for more detailed information on this matter.
  3. Please note! To manage fonts quantity available for upload edit 'max_load_fonts' => 5 variable in the theme-specific/theme.setup.php file.
• Icons:
  1. Fontello icons set. You can expand the list of available icons by adding new ones from the fontello website. In order to add new icons proceed to wp-content/themes/truth/skins/default/css/font-icons/config.json. Watch this video guide for more information.
     Please note, the location of config.json file and website page builder with available set of widgets/shortcodes/blocks in your theme may vary from the video provided!
  2. You can specify the type of icons (font icons/images/SVG) you want to use in the theme-specific/theme.setup.php file.
• Clipart:
  
  
  1. Images were taken from https://unsplash.com/ and https://www.pexels.com/.
  2. IMPORTANT! By getting this WordPress Theme you get all the images FOR FREE. Moreover, you can use them on ANY OF YOUR PROJECTS!
• XD Files:
  
  IMPORTANT! Please note that we do not include theme related .XD files into the theme package, because it might significantly increase the size of a downloadable archive. In case you need these files you can always request them by contacting our support department as well.

Page Speed Optimization

This chapter is for those who whould like to speed up their websites and care about the page loading speed. There are a lot of different ways to make your website work faster, but we will focus on caching plug-ins we have used on our demos, though they are not provided with the theme.

A lot of users access the website at the same time. This makes the server work slowly and takes more time to load the web page for each user. Caching is the way to store the current version of your web page on the server and prevent from sending requests to the server for each user each time.

Below you can find short description of the caching plug-ins we have used on our demo (Default Skin) as well as their main settings. Please feel free to play around with the plug-ins' settings yourself in order to receive the better result.

Autoclear Autoptimize Cache

"Autoclear Autoptimize Cache" (not provided with the theme) is a companion plug-in for Autoptimize. It provides a way to set the maximum allowable cache file size for your site. If that size is exceeded, the plug-in automatically clears your Autoptimize cache and allows it to rebuild itself. Please click here for more informaion.

To set the allowable cache file size, navigate to WP Dashboard > Settings > Autoptimize Cache Settings section.

Autoptimize

This plug-in (not provided with the theme) allows you to optimize your WordPress site. It can aggregate, minify and cache scripts and styles, injects CSS in the page head by default but can also inline critical CSS and defer the aggregated full CSS, moves and defers scripts to the footer and minifies HTML. You can optimize and lazy-load images (with support for WebP and AVIF formats), optimize Google Fonts, async non-aggregated JavaScript, remove WordPress core emoji cruft and much more. Please click here for more information about the plug-in. The official plug-in page is here.

Please navigate to Settings (WP Dashboard) > Autoptimize and customize the plug-in's settings.

WP Rocket

This is a paid caching plug-in (not provided with the theme) that allows you to improve the speed of your WordPress site, SEO rankings and conversions. No coding is required. Please click here for more information about the plug-in. The official documentation is available here.

WP Rocket plug-in improves the web page loading time right upon activation.

PLEASE NOTE! There is no unique recommended configuration of the plug-in's settings, suitable for every website. The same settings can work differently on different websites. By default, some settings may be activated or disabled, depending on your individual WordPress setup and hosting.

Below you can find the examples of plug-in's configuration used on our Default demo skin. Please feel free to find out your own optimal combination of the settings. Read the official guide and watch the video: How to Find the Best Settings for your Site.

Please navigate to Settings (WP Dashboard) > WP Rocket and customize plug-in's settings.

PLEASE NOTE! We do not recommend using File Optimization.

Some official video tutorials are available right through WP admin panel: Settings (WP Dashboard) > WP Rocket > Tutorials.

Website Customization

Custom Websites are usually the most important part of an online marketing campaign. A properly built custom website can help you get the most results from your marketing efforts. Our team can do it for you.

Please, find some of our offers below:

Theme installation

Get the theme installed on your website with all the dummy content.

BUY THIS OPTION

Ready-To-Use Website

The theme setup including data and images replacement for 6 pages.

BUY THIS OPTION

Must have plugins

Installation and configuration of the plugins for SEO, security, and cache.

BUY THIS OPTION

You can check the full list of offers here.

Thank you for purchasing our theme. We are happy that you are one of our customers.
If you come up with any theme-related questions that are beyond the scope of this help file, feel free to contact us. We will respond as soon as possible (within 24 – 48 hours, usually faster). We are open from 10am to 7pm (CET), from Monday till Friday.