Getting Started
General Information
Thank you for purchasing our theme. We are happy that you are one of our customers and we assure you that you will not be disappointed as well. We do our best to produce high quality themes with great functionality, premium designs and human readable code. Before you get started, we highly encourage you to get familiar with this documentation file. Spending half an hour reading the manual may save lots of your time and help you to avoid questions with obvious answers.
We also recommend checking our video tutorials and articles pages.
Please Note! Our support covers installation procedure, assistance for theme features and any issues you may encounter when using the theme. Unfortunately, we cannot provide support for customization or 3rd party plugins. If you need help with the customization of your theme, you should enlist the help of a developer.
IMPORTANT! Please be aware that we do not include theme related .PSD files in the theme package, because it might significantly increase the size of a downloadable archive.
Bundled Plugins
The theme package contains a number of bundled plugins. Please click here to view the list of plugins that come included into the theme.
If a new version of a bundled plugin is available, it will be included in the next theme release.
Bundled plugins are fully functional without the activation using a registration license key. In case you are willing to receive automatic updates and support from the plugin team, you will need to purchase the plugin separately. Only the direct buyers get the plugin license key.
WordPress Information
To use this theme you must have WordPress engine installed. We assume you have a working version of WordPress downloaded at WordPress.org already up and running.
How to install WordPress - A tutorial on how to install WordPress on your hosted domain.
We also encourage you to actively use the links below. These useful resources cover most of general WordPress questions you may have:
- WordPress FAQ - Information and resources about WordPress including history, features, semantics, glossary and information to help you determine whether or not WordPress is the blogging tool for you.
- WordPress Lessons - Great source of knowledge for WordPress beginners.
- PHP Function References - Detailed information on WordPress PHP functions and usage examples.
Installation Information
Theme Requirements
To use this theme you must be running WordPress 5.0 or higher, PHP 5.6.20 or higher (for WooCommerce plug-in PHP 7.0+). If you use hosting with limited resources (for example GoDaddy and other lowcost shared hosting providers), you may experience issues with one-click demo data installation feature.
We recommend you to contact your web hosting service provider to make sure that your server PHP configuration limits are as follows:
- max_execution_time 600
- memory_limit (up to) 256M
- 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 256M 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 plugins.
IMPORTANT! To avoid any errors that might come up during the installation we recommend to have memory limit set up to 512M.
Here is the list of other recommended web hosting services:
- 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 theme files. After unzipping the archive, you will see the following files:
If you try to install the wrong files, you will get missing style.css file error. This is the most common error that means you are trying to install an incorrect package.
To install "Room Blog" theme, you must have WordPress installed. For information regarding WordPress platform installation, please check the WordPress Codex or check this great video tutorial.
Update WordPress: To ensure a positive user experience, we highly recommend updating your WordPress to the latest stable version. This will help utilizing all of the latest features of WordPress.
If you have questions regarding theme installation, we recommend reading a detailed instruction below.
You can install the theme in two ways:
-
via FTP:
- Log into your web server with FTP client software.
- Unzip room.zip file and ONLY use the extracted /room theme folder.
- Upload the extracted /room theme folder into /wp-content/themes folder.
- Activate the newly installed theme. Go to Appearance > Themes and activate it.
- via WordPress:
- Login to admin panel.
- Go to Appearance - Themes and click on the Add New button.
- Choose Upload theme option. Click on Browse... (Choose file in Safari/Chrome), select "room.zip" and click Install Now button.
- After the successful installation, click on Activate or go to Appearance - Themes and click on Activate to activate the newly installed theme.
- After the theme is activated, you will be prompted to install recommended plugins.
All these plugins are included into the theme archive, or can be installed from the WordPress.org repository.
The theme can function without any of these plugins. But if you want your website look precisely as the demo page, you have to install all recommended plugins and import demo content. This is a good idea if you are building your website from scratch.
However, if you have an existing website, you should be very careful with plugin installation and importing dummy data: this may affect the website content and structure. Please read the Demo Content article for details. - Attention! If you want to make changes in theme’s templates or functions, we recommend activating a child theme before dummy data installation, otherwise the Theme Options will be lost. Please see the Child Theme section for more information.
Plugins Installation
In order to make the theme look exactly as the demo page, you need to install recommended plugins. Click on Begin installing plugins link.
You will be redirected to plugins installation page. Check all listed plugins, select Install option and click on Apply button. Installation may take a few minutes, please be patient and do not refresh the page.
After the installation you will get a notification informing that plugins were installed successfully.
Gutenberg Compatibility
Our theme is compatible with Gutenberg page builder. You can create new pages using this editor.
All existing demo pages are built through WPBakery Page Builder and should be customized via WPBakery Page Builder ONLY.
IMPORTANT: It is possible to switch between the page builders. Please use One page builder for creating/customizing One particular page/post.
Child Theme
Child theme is for developers willing to make changes to core functions and code. If you are not planning to dig that deep, you can just skip this chapter.
IMPORTANT: If you want to make changes in theme templates or functions, we recommend that you install the child theme and apply changes there. To learn more about the purpose and basis of creation of child theme, please visit WordPress Codex.
Attention! When activating a child theme or switching back to the parent theme, the theme options will be lost. We recommend activating a child theme before dummy data installation.
In the theme package you will see materials for the child theme. It’s located in "room-child.zip" archive. You can install the child theme just like you installed the main theme (see above, in the section "Installation").
A few recommendations on how to use a Child Theme from AxiomThemes:
- Almost all files from the main theme can be replaced in a child theme. It doesn’t concern only .php-files with templates and basic logic, but also both .js, .css files from respective folders and files with images, icons etc.
- If you want to change some of the theme-related functions or to add new ones, copy/add all the required functions into 'functions.php' in the folder "room-child", and add all the required functions into it. If our
theme contains functions with such names, they will be replaced with yours, if not – your functions will
complete our theme logics.
IMPORTANT: If you want to replace some functions from other files (except functions.php), e.g. from _wp_utils.php or _utils.php, we do not recommend you to copy respective files into the child theme, but you should create the respective functions in functions.php in the child theme. This should be done, so that when updating the theme, new functions from these files are available for use.
As for other files - put out the templates from the folder 'templates', images from the folder 'images' etc. - to make changes copy theme into the folder 'child theme' and make changes there.
Demo Content
Our themes have simple One click dummy data import tool. It's very easy to use and you can get a precise copy of our demo website in just 1 click.
Before installing demo data, please make sure you have installed all the required plugins, please refer to Plugins installation section of this document for details.
To import demo content into a WordPress site, please follow these steps:
- Log in to your site as an administrator.
- If you see a message prompting to install required Plugin Room Utilities and WPBakery Page Builder plugins, click on "Begin installing plugins" and install them on the corresponding page.
IMPORTANT: The recommended plugins (MailChimp for WP and Instagram Feed) are not mandatory for installation of demo content but highly recommended. - Go to Appearance -> Install Dummy Data:
- On the page that showed up please set the required parameters.
- Only pages, forms and sliders - Allows you to select the content you need to be imported for a definite page, slider, etc. It is recommended when the site is already built.
- Whole demo-site content - Allows you to import whole demo content. It is recommended for new installations of WordPress.
IMPORTANT: When installing whole demo-data ALL EXISTING CONTENTS of your website will be deleted and replaced with the new data! We highly recommend that you install demo data only on blank WordPress install.
- Click on "Install Demo Data" button.
IMPORTANT: Please wait while demo data is being copied from our server to your site. It may take a while and depends significantly upon Internet connection speed between your website and our server. Please wait patiently and do not refresh/leave the page.
- After the data is successfully imported, you will see the following message:
In case "Demo Data" installation stuck and you see "Error load data from the file ... " error message, you can manually install it by downloading the demo.zip archive from our server. Extract the archive to demo/ folder and upload this demo/ folder to wp-content/themes/room directory.
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 provider to make sure that your server configuration meets the Theme Requirements.
Theme Update
IMPORTANT: Before you go ahead with the update, please check theme changelog and make sure you backup your old theme folder. Download it to your computer locally.
It is a good practice to backup both your files and database regularly and especially before making some serious updates.
Update Option 1. Update using WordPress uploader
- Log into your account, find the theme and download “Installable WordPress file”.
- Log into your WordPress website and go to Appearance -> Themes.
- Activate a different theme. Delete the previous version of Room Blog and re-upload the new WordPress Installable files that you have downloaded during the 1st step.
- Once it is uploaded, activate the theme.
- Update the included plugins if you see a notification message letting you know the plugins have a new version.
- Navigate to WP Dashboard > Plugins > Installed Plugins.
- Update ThemeREX Utilities plugin. You can click on "Update" button (if available in a particular theme) or deactivate and delete this plugin. Then follow the prompt to install it again. This will load a new plugin version on the site.
- Deactivate and delete the rest plugin(s) of old version.
- Go to Appearance > Install Plugins and install the plugin(s) like it was described in the Plugins Installation section of this documentation.
Update Option 2. Update using FTP client.
- Log into your account and get the last version of the theme as described above.
- Connect to your server using desktop client software (we recommend CyberDuck and Filezilla).
- Change directory to /wp-content/themes.
- Remove existing folder with old theme files.
- Unpack theme installable files you have downloaded and upload to the theme folder.
- Update the included plugins if you see a notification message letting you know the plugins have a new version as described above.
Quick Start
After the theme activation and demo content import, we are ready to get started with basic theme settings like site title, tagline, logo, favicon etc.
To change your site title and tagline, go to Settings -> General. Please note, these parameters are important for search engines.
Another great idea may be setting custom permalinks structure to make them more SEO friendly and human-readable. Go to Settings -> Permalinks and make changes according to the example below.
"Customize" Settings
Now let's navigate to Appearance > Customize - the feature which makes theme customization extremely user-friendly and straight-forward, allowing the admin to manage the feel and look of the blog website easily from one place.
IMPORTANT: This is a "OnePage" theme. All the customizations are applied to the Home page only. The rest of the posts and pages such as "Home 2", "Home 3", "Home 4", "Home 5" etc. are just examples (variations) of how the single page/post can look like.
We have integrated many additional options to the default WordPress "Customize" menu, which allows you to flexibly control the appearance and behavior of the whole website as well as of the individual page types.
Moreover, you can see the changes of the frontend right after the alterations - when the needed parameter is selected, without switching from admin to frontend each time. It saves much of your time and lets you customize your website just in several clicks. When you are through with the changes, you should click on "Save and Publish" button at the top. There are quite a lot of parameters here, but luckily the majority of them have default values that suit most of the users. Let's take a closer look at them:
General
In this section you can customize the general website look using the following settings.

Responsive Layouts
Using this setting you can decide if you want to have responsive layouts, adjusted for each screen size and device or to keep the main layout for all of them.
- Yes - To have responsive layouts. The website will be adjusted for each screen size.
- No - To keep the main layout intact for all screen sizes. The users will scroll the page to see the content.
Responsive Menu
In this field you should fill in the window width when responsive menu will be enabled.
On the image below, this parameter is 960 px (by default), so even if you have responsive layouts set to "No", you will get responsive menu when resizing the browser window.
Alternatively, you can select 480 in case you want to have a navigation bar on the small screen devices only.
Add SEO meta
By choosing "Yes" metadata (Google reach snippets, Facebook meta tags, etc.) will be added to a single post. Choose "No" if you are using any of the SEO plugins.
Image dimensions
Choose the necessary image dimensions: Original or Retina.
Quality for cropped images
Choose the necessary quality for cropped images.
Show page preloader
This setting allows you to upload an image that will act as your main preloader image.
Title, Tagline & Site icon
Settings of this group are responsible for the website icon, tagline and title display:
Site Title
The text entered into this field will be displayed as the logo (if the image logo is not uploaded) and as the website title in your browser tab.
Tagline
The text entered into this field will be displayed as the website slogan under the logo.
Site Icon
You can upload/remove your site icon here (must be 512x512px).
Favicon
You can upload/remove your favicon here.
Background
These settings allow you to add the background image behind the content body, when "Boxed" body style is enabled and to manage its position:
Just click on Select image button to upload the image from the Media Library or your computer. Right after this step, additional options appear, such as "Preset", "Image Position", "Image Size", "Background color" and a few other.
Color Scheme
The next section of settings allows you to manage the color scheme of your website. Let's consider these parameters.
Color Settings
Here you can select Simple or Advanced option of your color scheme customization.
Color Scheme
Select one of two predefined color schemes: Default or Dark. Check the screenshots below.
Links
Set the necessary color for your links and accented areas.
Links Hover
Set the necessary hover color for your links and accented areas.
For Advanced UsersIn case the capabilities of "Simple" color scheme are not enough you can go with the "Advanced" one and completely change your website's look.
Header
This option allows you to add the header background image to your website top panel.
Current Header/Previously uploaded
Shows current and previous headers.
Header Style
Pick the necessary style.
IMPORTANT: The current header is created via the Global Customize settings (Appearance > Customize). To change the header area in available styles you should navigate to the .../wp-content/themes/room/templates folder and edit the corresponding template file like header-1.php or header-2.php.
Header widgets
Add the necessary widgets to the header. Don't forget to check/uncheck the "Header fullwide" option, which stretches the header's widget area to an entire window width. You can customize the widgets in Appearance > Widgets section.
Logo
Logo image is uploaded or selected from the Media Library. Logo 1 option is responsible for displaying the logo image for the header 1 style, logo 2 - in for the header 2 style.
Logo for Retina
Upload special size logo image to make it look better on the Retina displays.
Logo Hight
Adjust your logo's height.
Widgets
These settings allow you to manage Sidebar and Footer widgets just as you used to do in Appearance > Widgets in WordPress admin panel:
Here you can manage standard sidebars (widget sets) included in the theme:
- Sidebar - By default, it is displayed vertically to the left or right from the main content.
- Header - By default, it is displayed at the header of the page.
- Above Page - By default, it is displayed in the area above the page.
- Footer - By default, it is displayed at the footer of the page.
If you expand one of these widget sets, you will be able to:
- Add a widget: just click on "Add a widget" button to see the available widgets, then press on the one you want to use:
- Reorder the position of widgets using 3 icons:
- Move - allows you to move the widget to another sidebar.
- Down - the widget will be moved down.
- Up - the widget will be moved upwards.
After you reorder the position of widgets in the sidebar, please click on "Done" button at the bottom.
You will be able to assign any of these widget sets to the sidebar of Homepage, Blog archive pages, Search results pages, Single post pages and Single pages in the corresponding menu items of Appearance > Customize.
Moreover, you get a few Custom Widget sets that can be managed in Appearance > Widgets:
More widget areas are available in the Theme Options section on a particular page.
You can assign any Custom widget (Widget area) to the page in the Theme Options section on a particular page.
On Appearance > Widgets page you will see Available Widgets section which also includes MailChimp SignUp form. In order to add the widget to the Sidebar, just drag and drop it to the needed position, add the content and Save it.
Custom widgets
- ThemeREX - About Me: Displays the photo and description of the website admin:
- ThemeREX - Advertisement block: Used to insert advertising banners - images with links or arbitrary HTML-blocks. IMPORTANT: Be careful to use extraneous HTML-code not to disrupt the design of the page.
- ThemeREX - Recent News: Displays the most recent news in many styles.
- ThemeREX - Recent Posts: Displays the most recent posts. Unlike the standard widget, it can display a post featured image, author name, comments, post counters and post category if you enable these options.
- ThemeREX - Most Popular & Commented: Displays the most visited, most commented and most liked articles.
- ThemeREX - Slider: Displays the slides via Swiper Slider. The content of the slides is taken from the single posts.
- ThemeREX - Socials: Shows the links to social network profiles. The widgets for social media icons are added in Appearace - Customize - Socials.
- ThemeREX - Calendar: A standard WP Calendar showing the current date and the days with available daily archives (posts).
- ThemeREX - Categories list: Displays the list of available categories.
-
ThemeREX - Twitter: This widget shows the last Tweets from your Twitter-feed using the API 1.1 (entered into force in June 2013)
For its work, this version of the widget requires creating "Twitter Application" and obtaining the appropriate codes. Due to the fact that Twitter from June 2013 switched to the new API 1.1 and discontinued support of out-of-date API 1.0, now to get information out of this social network, you must create an account on the resource https://dev.twitter.com/apps. Then, click the "Create a new application", fill in the required fields and generate "Access token" and "Access token secret". As a result, you will get four important core values to work with Twitter API 1.1:- Consumer key
- Consumer secret
- Access token
- Access token secret
-
ThemeREX Socials Instagram Feed: This widget requires ThemeREX Socials plug-in to be active. The widget shows the latest photos from your Instagram account or demo photos in a form of a feed on your WordPress website. You can connect to your Instagram account in the Appearance (WP Dashboard) > ThemeREX Socials section (you need a valid Instagram Access Token).
Demo mode means that the images will be taken from your demo folder (/wp-content/uploads/).
Alternatively, you can use photos from Instagram without connecting to your account: by using a hashtag#... or by specifying an Instagram username (WITHOUT a hash symbol). - MailChimp SignUp form: Allows you to add subscribers to your MailChimp lists. MailChimp for WP plugin should be installed to use this widget.
In order to configure your Mailchimp widget, please follow these steps:- Navigate to MC4WP - MailChimp in your WordPress admin and enter your MailChimp API key. To do that you should be registered at MailChimp website:
- Open MC4WP - Forms and fill in Form mark-up. You can see the code for the demo form on the screenshot below:
- Widget's backend:
<label>Subscribe for ltest stories and promotions.</label> <div class="mc4wp_wrap"> <input type="email" id="mc4wp_email" name="EMAIL" placeholder="" required> <input type="submit" value="subscribe"> </div>
Once all these steps are done, you will get the following block in one of your sidebars, where the users can sign up for a newsletter:
- Navigate to MC4WP - MailChimp in your WordPress admin and enter your MailChimp API key. To do that you should be registered at MailChimp website:
WooCommerce
Settings of this group allow managing the overall look of the WooCommerce elements (works only if the WooCommerce plugin 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. "Products per row" and "Rows per page" options work only if the "Shop mode" (Appearance > Customize > Shop) is set to "Thumbnails".
Additional CSS
Settings of this group allow you to specify additional custom styles.

Content
You can customize behavior of the content area in this section.
Body Style
Body Style options allow you to choose the way the page is displayed selecting the width for the website body content:
- Boxed - page body is located in the zone of limited screen width, and you can see the background image behind it.
- Wide - page body occupies the entire screen width (background image is not seen behind it), and the content is placed in the area of limited width, in the center of the screen.
- fullwide - page body occupies entire screen width (background image is not seen behind it), contents is stretched to the entire screen with small indents off the window edges.
Left/Right menu items and links
This setting allows you to place the necessary text besides the slider and make it actevi by linking it up. Check the screenshot below.

"Expand Content" setting allows you to expand the pages content, if the sidebar is hidden.
Homepage
Settings of this section allow you to manage homepage style and its' widgets. You can customize the widgets in Appearance > Widgets section.
Blog style:
- Excerpt - Posts will contain the featured image, a small excerpt from the post content and "Continue Reading" button.
- Grid /2 columns/ - The first post will look the same as in the "Excerpt" style, the rest posts will be displayed in 2 columns.
Header Widgets
Select the necessary widgets that will be displayed in the header.
Sidebar Widgets/Sidebar position
Here you can choose the sidebar widgets and it's position:
Widgets-related settings
These settings allow specifying widgets set for any widget area. Check the Widgets section for more information.
Blog Archive
This section allows you to control the layout and style of your blog archive pages such as a blog stream page and category pages.
Please check our article or visit this video tutorial for more information on how to customize the Posts pages.
The setting for the blog pages are similar to the Homepage ones we have described earlier. So here we will briefly describe them.
Blog style
Select the necessary post style for your blog archive pages.

Posts content
Select the way to display your posts' content.
Animation for posts
Select the necessary animation style for your posts to show up.
Pagination style
Select a proper order for your posts to appear on the page.
Header widgets
Select the widget set to display in the header.
Sidebar widgets/position
Select the widget set and it's position for your Blog archive pages.
Widgets-related settings
These settings allow specifying widgets set for any widget area. Check the Widgets section for more information.
Shop Page
Here you can adjust the overall Shop page behavior:
This is how the default Shop page looks like with current settings. Shop mode is set to "Thumbnails".
Shop Mode
This setting allows you to customize the products sorting. Shop mode is set to "List".

Expand content
In case there is no sidebar on the page content will occupy the sidebar's area.
Header widgets
Select the widget set to display in the header.
Sidebar widgets/position
Select the widget set and it's position for your shop-related pages.
Widgets-related settings
These settings allow specifying widgets set for any widget area. Check the Widgets section for more information.
Pages
This section covers the information about Pages in your website: included page templates, how to edit existing pages, add new ones.
Page templates
Please navigate to Pages in your WordPress admin panel, click on "Add new" button to create new pages:
On the right you will see Page Attributes - Template section. It allows you to select the page style:
- Default - used to create a standard content page (a sidebar is added to the page in Customize - Homepage). You can also add/remove the sidebar in the Theme Options > Widgets settings on a particular page.
- Homepage Style "Excerpt" - used to create a blog page with "Excerpt" style: a small passage of text and "Learn More" button.
- Homepage Style "Grid" - used to create a blog page with "Grid" style.
- 404 Page - to create "404 Not found" page opened if a user tries to open the page which does not exist.
- Page style "About me" - Using this page template you can create a personal page of the blogger, just write several words about yourself, add a contact form, select your photograph in "Featured image" section and you will get the page of the following design:
In order to choose some static content page for your Homepage, please navigate to Settings > Reading and locate "Homepage displays", select Static page, and choose pages for your Homepage and Posts page. (Please do not forget to add your new Blog page to the navigation bar in Appearance > Menus). On the same page in admin you can enter the number of posts to be displayed on the blog archive pages:
After you save the changes, your Homepage will display "About me" page and your posts will be shown on "Blog style "Excerpt" page.
Please Note! The current homepages are created via the Global Customize settings (Appearance > Customize).
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, 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.
Slider
By default our theme supports a simple Swiper posts slider. Built-in theme's slider allows you to display Featured images from the posts of any category. You can add a slider to the page using slider shortcode. The settings of this shortcode allow you to select a category, and specify the number of the posts to be displayed.
The slider can be added through the "Widgets" section as well as through the WPBakery Page Builder. Using Widgets allows you to place the slider not only in the header of the page (might vary, and depends on how many default sidebars locations are available for each particular theme), where it usually supposed to be.
Configure a slider through pages' widgets settings by following the steps below:
- Navigate to the Appearance > Widgets menu item in the WP dashboard side menu.
- Locate the ThemeREX-Slider widget and drag and drop it to any of the available widget sets. Once it's done specify the necessary parameters and click on "Save" button. See the example below.
- Navigate to the page you want your slider to appear on and enable the necessary widget area. For example, let's activate Slider in the "Header Widgets" section (Theme Options > Header tab).
- Once it's finished click "Update" and "Preview Changes" buttons to see how it will look on the front-end.


Post Formats
The theme uses standard WordPress post formats, for you to run the blog using various visual representations of a post.
- Standard – The default post format: you can add a featured image to the post or leave your post without it.
- Post without image – The default post format with no image in it.
- Aside – A note like post, usually styled without title.
- Gallery – A gallery of images.
- Link– A link to another site.
- Quote – A quotation.
- Status – Twitter like short status update.
- Video – A post containing video.
- Sound Cloud Audio – An audio file.
- Chat – The chat looking post style.
Find all the post types on the screenshot below.

Shortcodes
Shortcodes is a handy feature in WordPress that allows you to do some pretty incredible things by just inserting a shortcode into a page or post. Using Shortcodes is very straight-forward, just insert one where you want the relevant content to show up.
The theme comes with a number of shortcodes allowing you to add the info in a simple way. Moreover, you can use WPBakery Page Builder to add new elements to the page. More information on how to use WPBakery Page Builder properly can be found here:
Below is a list of the shortcodes included into the theme.
Accordion
Creates blocks of the "accordion" type. Only one of the blocks can be open at a time.
Example:

[vc_tta_accordion active_section="1"][vc_tta_section title="Section 1" tab_id="1502260664972-ab5f52f2-ec9f"][vc_column_text]Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.[/vc_column_text][/vc_tta_section][vc_tta_section title="Section 2" tab_id="1502260664984-fa868c6d-36b9"][vc_column_text]Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.[/vc_column_text][/vc_tta_section][vc_tta_section title="Section 3" tab_id="1502260810636-7337b286-9837"][vc_column_text]Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.[/vc_column_text][/vc_tta_section][/vc_tta_accordion]
Call to action
Displays a call to action block.
Examples:

[vc_cta h2="Heading" h4="Subheading" add_button="bottom" btn_title="Read More" btn_link="url:http%3A%2F%2Fwordpress.tst%2Fproduct%2Fsmall-coffee-table%2F|||"]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_cta]
FAQ
Creates blocks of type "toggles" in different styles. Comparing to the "accordion" you can close all the blocks or open more than one.
Example:

[vc_toggle title="Toggle title 1" open="true"]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_toggle]
[vc_toggle title="Toggle title 2"]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_toggle]
[vc_toggle title="Toggle title 3"]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit..[/vc_toggle]
Flickr Widget
This shortcode displays images from your Flickr account. Do not forget to specify the necessary "Flickr ID".
Example:

[vc_flickr count="9"]
Google Maps
Displays Google map using an iframe code you specified. Visit Google maps to create your map first.
Step by step:
- Find the location you need.
- Click the cog symbol in the lower right corner and select "Share or embed map".
- On modal window select "Embed map".
- Copy iframe code and paste it).
Example:

[vc_gmaps link="#E-8_JTNDaWZyYW1lJTIwc3JjJTNEJTIyaHR0cHMlM0ElMkYlMkZ3d3cuZ29vZ2xlLmNvbSUyRm1hcHMlMkZlbWJlZCUzRnBiJTNEJTIxMW0xOCUyMTFtMTIlMjExbTMlMjExZDYzMDQuODI5OTg2MTMxMjcxJTIxMmQtMTIyLjQ3NDY5NjgwMzMwOTIlMjEzZDM3LjgwMzc0NzUyMTYwNDQzJTIxMm0zJTIxMWYwJTIxMmYwJTIxM2YwJTIxM20yJTIxMWkxMDI0JTIxMmk3NjglMjE0ZjEzLjElMjEzbTMlMjExbTIlMjExczB4ODA4NTg2ZTYzMDI2MTVhMSUyNTNBMHg4NmJkMTMwMjUxNzU3YzAwJTIxMnNTdG9yZXklMkJBdmUlMjUyQyUyQlNhbiUyQkZyYW5jaXNjbyUyNTJDJTJCQ0ElMkI5NDEyOSUyMTVlMCUyMTNtMiUyMTFzZW4lMjEyc3VzJTIxNHYxNDM1ODI2NDMyMDUxJTIyJTIwd2lkdGglM0QlMjI2MDAlMjIlMjBoZWlnaHQlM0QlMjI0NTAlMjIlMjBmcmFtZWJvcmRlciUzRCUyMjAlMjIlMjBzdHlsZSUzRCUyMmJvcmRlciUzQTAlMjIlMjBhbGxvd2Z1bGxzY3JlZW4lM0UlM0MlMkZpZnJhbWUlM0U=" title="Google Map"]
Icon
This shortcode displays icon(s). You can expand the list of available icons by adding new ones from the fontello website. Watch this video guide for more information.
Example:

[vc_icon icon_fontawesome="fa fa-star"]
Message box
Creates different types of messages.
Examples:

[vc_message]
<h4>Information message goes here</h4>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_message][vc_message message_box_color="warning" icon_fontawesome="fa fa-exclamation-circle"]
<h4>Warning message goes here</h4>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_message][vc_message message_box_color="success" icon_fontawesome="fa fa-check"]
<h4>Success message goes here</h4>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_message][vc_message message_box_color="danger" icon_fontawesome="fa fa-exclamation-triangle"]
<h4>Error message goes here</h4>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_message]
Progress bar
Shows the levels of your abilities in many different styles.
Example:

[vc_progress_bar options="striped,animated"]
Recent News
This shortcode displays the most recent news.
Example:

[trx_recent_news style="news-portfolio" widget_title="Recent News" category="8"]
Single image
Inserts an image into the text. You can specify the size, allignment and display style of the image.
Example:

[vc_single_image image="823" img_size="medium" style="vc_box_outline_circle_2"]
Tabs
Creates blocks with tabs.
Examples:

[vc_tta_tabs]
[vc_tta_section title="Tab 1" tab_id="1502264990816-958effa9-4eb5"][vc_column_text]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_column_text][/vc_tta_section]
[vc_tta_section title="Tab 2" tab_id="1502264990830-c7ad1386-da3d"][vc_column_text]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_column_text][/vc_tta_section]
[vc_tta_section title="Tab 3" tab_id="1502265022460-401fbaa7-a89c"][vc_column_text]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit.[/vc_column_text][/vc_tta_section]
[/vc_tta_tabs]
Widget About Me
This shortcode displays an "About Me" widget with some personal information.
Example:

[trx_widget_aboutme title="About Me" avatar="932" username="Rosie Simmons" description="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras quis mattis tortor, id sagittis lorem. Morbi tristique, quam vel semper varius, orci quam lacinia enim, in pretium metus dolor a justo. Maecenas interdum eros purus, a rhoncus nibh sollicitudin vel. Nulla ac ultricies elit."]
Widget Advertisement
This shortcode displays widget with a banner image or any HTML/javascript code.
Example:

[trx_widget_advert title="" image="818" link="#"]
Widget Calendar
This shortcode displays a widget calendar.
Example:

[trx_widget_calendar title="Calendar"]
Widget Popular Posts
This shortcode displays popular posts.
Example:

[trx_widget_popular_posts title="Popular Posts" title_popular="Most popular" title_commented="Most commented" title_liked="Most liked" show_image="1" show_author="1" show_date="1" show_counters="1" show_categories="1"]
Widget Recent Posts
This shortcode displays the most recent posts. You can set additional options on the "Details" tab in the WPBakery Page Builder's Posts Settings window.
Example:

[trx_widget_recent_posts title="Recent Post" show_image="1" show_author="1" show_date="1" show_counters="1" show_categories="1"]
Widget Slider
This shortcode allows displaying default Swiper Slider. In the WPBakery Page Builder's settings you can manage the slider's settings by specifying a category to get the posts from, number of posts, slider's height and other options.
Example (Swiper Slider):

[trx_widget_slider title="Swiper Slider" height="450" category="7"]
Widget Twitter Feed
This shortcode displays posts from your twitter account. Please be aware that as the matter of security reasons we provide the shortcode without the twitter tokens and consumer keys. Please use your own "Token keys" to make it display your twitter feed properly.
Example:
[trx_widget_twitter title="Twitter" follow="1" username="" consumer_key="" consumer_secret="" token_key="" token_secret=""]
Plugins
In this section you can find information about additional plugins included to this theme.
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. More information on how to use this plugin can be found here.
You can also check their documentation.
Find a default shortcode below:
[contact-form-7 id="1019" title="Contact form 1"]

Attention! According to General Data Protection Regulation, you need to make your forms compliant. Some prebuilt 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:
- Use [acceptance acceptance-...]...[/acceptance] tag. Treat the code and the screenshot below just as an example:
-
Use the WP GDPR Compliance plugin. Navigate to Tools (WP Dashboard) > WP GDPR Compliance, enable a GDPR form tag integration for a particular form and save the changes. You can specify and activate the Privacy Policy page in the Tools (WP Dashboard) > WP GDPR Compliance > Settings tab.
Elegro Crypto Payment
Elegro Gateway provides facilities for smooth, safe and instant cryptocurrency payments with automated exchange to EUR/USD or any other fiat currency at direct exchange rates. Payment processing fees are reasonable and calculated depending on business risk levels. Your customers can make purchases on any device and without any fees for elegro-inspired payments.
Check this link for more information.
MailChimp
This plugin helps you add subscribers to your MailChimp lists using various methods. You can create good looking opt-in forms or integrate with any other form on your site, like your comment form or WooCommerce checkout.
More information on how to properly use this plugin can be found here.
Some of the backend settings you can find in the WP dashboard menu > MC4WP > Forms.
Mark-up code
<label>Subscribe for ltest stories and promotions.</label>
<div class="mc4wp_wrap">
<input type="email" id="mc4wp_email" name="EMAIL" placeholder="" required>
<input type="submit" value="subscribe">
</div>
With the shortcode below you can display the newsletter sign-up form on any page you want.
[mc4wp_form id="963"]

In order to configure your MailChimp, please enter your MailChimp API key. To do that you should be registered at MailChimp website:
WPBakery Page Builder
To make your customization even easier we have added the WPBakery Page Builder to this theme. Before you start, please check these WPBakery Page Builder related tutorials. They will give you a basic understanding of how to build a page properly.
WooCommerce
Woocommerce is an industry leader e-commerce plugin for WordPress. Another good news is that 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 plugin 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.
- Documentation - official plugin documentation.
- Free and Premium extensions - powerful toolbox bringing more features to your shop
- iOS app for Woocommerce - this application gives you full control over your shop.
A few words should be also said about how to set a page set created with WooCommerce. After you created these pages using the plugin, please open the menu "Pages" and set the display parameters for each of the pages.
Please remember that amongst all pages of the WooCommerce set the page "Shop" has a priority status. It is a sort of a 'blog stream page' for the list of your products and categories. That is why you can set your store's display by changing parameters of the page "Shop" in menu "Pages" (main theme color, availability and position of sidebars etc.).
Products list:

Product page:

Cart page:

WP GDPR Compliance
The WP GDPR Compliance plugin allows you to make your website GDPR-compliant. It currently supports Contact Form 7 (>= 4.6), Gravity Forms (>= 1.9), WooCommerce (>= 2.5.0) and WordPress Comments.
Using the WP GDPR Compliance plugin does NOT guarantee complete compliance to General Data Protection Regulation.
Check the links below for more information about this plugin:
IMPORTANT: According to General Data Protection Regulation, you need to make your forms compliant. Some prebuilt forms, that come with this theme, already have the corresponding "I agree..." checkboxes. For newly created forms, navigate to Tools (WP Dashboard) > WP GDPR Compliance, enable a GDPR form tag integration for a particular form and save the changes. You can specify and activate the Privacy Policy page in the Tools (WP Dashboard) > WP GDPR Compliance > Settings tab.
Theme Translation
We recommend using Poedit software for translation-related purposes. To translate the theme to your language, please follow these steps:
- Download and install Poedit software.
- Navigate to the theme/.../languages/ folder and locate .pot file. Copy it to your desktop for editing.
- 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."
- 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.
- 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.
- 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.
- 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.
-
Our theme is using ThemeREX Utilities plug-in, so some translation should be done in language files of this plug-in in the .../wp-content/plugins/trx_utils/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.
In case you still have questions on how to use Poedit, please check the following resources:
Sources and Credits
This section discloses the sources of various files used within the theme and describes their function.
- Fonts:
- Google fonts.
- Fontello (non standard, icons set).
All non-standard fonts are from Google Web Fonts and Fontello icons set
We have used pictures from:
http://www.bigstockphoto.com/
IMPORTANT! Please be advised that all clipart images included in this theme are the copyrighted to their respective owners and are not available for download with this theme.
Clipart images can not be used without express permission from the owner and/or need to be purchased separately.
We can provide you with the list of image ids used in the theme, just contact our support team.
Socials
You can add links to social media icons here. If you leave these fields empty, icons will not be shown. Social icons will be displayed in the top right corner of the header:
In the Share section you can specify URLs to share posts in social networks (if you leave the field empty - there will be no sharing).