Theme Requirements

To use this theme you must be running WordPress 5.0 or higher, PHP 5.6.20 or higher (for Booked and WooCommerce plug-ins 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:

• SiteGround
• Bluehost
• InMotion Hosting

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 styles.css file error. This is the most common error meaning you are trying to install incorrect package.

To install "HotCoffee" theme you need to have a working version of WordPress already installed. For information in regards to installing the WordPress platform please see the WordPress Codex or check this great video tutorial.

Update WordPress: To ensure a positive user experience, we highly recommend you to update your WordPress to the latest stable version. This will help to ensure that you are able to utilize all of the latest features of WordPress.

You can install the theme in two ways:

• via FTP:
  1. Log into your web server with FTP client software
  2. Unzip the hot-coffee.zip file and ONLY use the extracted /hot-coffee theme folder
  3. Upload the extracted /hot-coffee theme folder into /wp-content/themes folder
  4. Activate the newly installed theme. Go to Appearance > Themes and activate it.
• via WordPress:
  1. Login to admin panel.
  2. Go to Appearance - Themes and click on the Add New button.
  3. Choose Upload theme option. Click on Browse...(Choose file in Safari/Chrome), select the "hot-coffee.zip" and click Install Now button.
  4. After successful installation click on Activate or go to Appearance - Themes and click on Activate to activate the newly installed theme.
  5. After the theme's activation you will be prompted to install recommended plugins: Booked, Contact Form 7, Essential Grid, MailChimp for WP, Revolution Slider, WP GDPR Compliance, WPBakery PageBuilder and WooCommerce.
     
     
     
     All these plugins are included into the theme's archive or optionally 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 on 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 demo data - this may affect your site content and structure. Please read the Demo Content article for details.
  6. A new menu item Appearance > Theme Options will appear.
  7. Attention! If you want to make changes in theme’s templates or functions, we recommend activating a child theme before demo data installation, otherwise the Theme Options will be lost. Please see the Child Theme section for more information.

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 easily skip this chapter.

IMPORTANT: If you want to make changes in theme’s templates or functions, we recommend that you install child theme and make changes there. To learn more about the purpose and basis of creation of child theme, visit WordPress Codex.

In the theme pack you will see materials for the child theme. It’s located in the "hot-coffee-child.zip" archive. You can install the child theme the same way as you install the main theme (see above in the section "Installation").

A few recommendations on how to use Child Theme from ThemeREX:

• Almost all files from the main theme can be replaced in the theme. It doesn’t concern only .php-files with templates and basic logics, 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 "hot-coffee-child" folder. If our theme contains functions with such names, they will be replaced with yours, if not – your functions will complete our theme’s 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 strongly do not recommend you 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 - putout 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.
• Attention! When activating a child theme or switching back to the parent theme, the theme options will be lost (That was the requirement of the ThemeForest team).
  
  We recommend activating a child theme before demo data installation. Alternatively, you can disable options reset. In order to do this, please open wp-content/themes/hot-coffee/includes/theme.options.php file and look for the code like this:
  
  // Clear all saved Theme Options on first theme run
add_action('after_switch_theme', 'hotcoffee_options_reset'); You need to comment the function:
  
  // Clear all saved Theme Options on first theme run
//add_action('after_switch_theme', 'hotcoffee_options_reset'); Save the file and upload it to the server.

Plugins Installation

In order to make the theme look exactly as at demo page you need to install recommended plugins. Click on Begin installing plugins link. Please be aware that additional tags plugin is required for this theme to work properly.

You will be redirected to plugins installation page. Check all listed plugins, select Install option and click on Apply button. Installation may take few minutes, please be patient and do not refresh the page.

After installation you will see this 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.

Demo Content

Our themes have simple One click demo data import tool. It's very easy to use, and you can get precise copy of our demo website in just 1 click, really.

Before installing demo data make sure you have installed all required plugins, please refer to Plugins installation section of this document for details.

To import demo content into a WordPress site follow these steps:

1. Log in to your site as an administrator.
2. If you see a message prompting to install Hot Coffee Utilities plugin - click on "Begin installing plugins" and install it on the corresponding page.
   IMPORTANT: The rest of recommended plugins (for example, Revolution Slider, WPBakery Page Builder, etc.) are not mandatory for installation of demo content.
   
   
   
   
3. Go to Appearance > Theme Options > Install Demo Data:
   
   
   
   
4. 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.
   
   
5. 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.
   
   
6. After the data is successfully imported you will see the "Congratulations" message:
   
   
   
   In 99.9% it works fine, but if something went wrong and data was not imported, please repeat the procedure described above. The system will find the last item imported successfully and you will be able to continue the import.
   
   If you are making the install on your local machine, please check your internet connection and firewall settings, this may affect data transfer.
   
   In case "Demo Data" installation stuck, 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/hot-coffee directory. If the issue persists, please contact your hosting provider to make sure that your server configuration meets the Theme Requirements. Otherwise, please contact our support team at https://themerex.net/support/. Our tech support operators will assist you.

Home 1

The picture below demonstrates the page style we are aiming at:

The algorithm of our actions would be as follows:

1. Select Pages > Add New and create a new page.
2. Specify a name for it (e.g. Home 1).
3. Open Post Options > Theme Options > Customization > Header section and disable the following options.




4. Now let's add a slider. To do this go to the Post Options > Theme Options > Customization > Slider tab and enable "Show Slider" option. Then select the necessary "Slider Engine" and the slider itself in the "Revolution Slider: Select slider" field.
   Please be aware that to enable the one particular slider on the necessary page (or set of pages) you need to disable the slider in Global Theme Options first and only then enable it for each and every page (or set of pages) in its "Post Options" settings.




5. In the Sidebars tab choose "Hide" for the "Show main sidebar" option.




6. Once it's done go to the Blog amp; Single > Single page section and disable all the parameters like it is shown on the screenshot below.

Now the page is ready for further customization with WPBakery Page Builder. 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.

1. Official WPBakery Page Builder FAQ page.


2. Getting Started With WPBakery Page Builder Guide.


3. WPBakery Page Builder: A Guide To Drag & Drop Page Building.


4. How to Add Row and Column with WPBakery Page Builder.


5. How to Add Row or Column Background with WPBakery Page Builder.


6. How to Create Empty Space Between Elements with Custom Height.

The whole page is build with the following elements: Rows, Block containers, Content blocks, Gaps, Columns and Blogger shortcode. On the screenshots below you can see which backend section corresponds to a frontend section.

Here is how it looks on the frontend:

And here is how it looks in the WPBakery Page Builder's backend editor:

The background color/image for the page blocks can be customized in the Row Settings > Design Options tab in the WPBakery backend editor.

If you are wondering what the raw Homepage code looks like, here it is:

                                    [vc_row full_width="stretch_row" content_placement="middle"][vc_column][trx_title type="2" align="center" animation="fadeInUp" top="tiny" bottom="small"]Welcome to our coffee house[/trx_title][trx_section align="center" animation="fadeInUp" width="80%" bottom="huge"][vc_column_text]From a cultural standpoint, coffeehouses largely serve as centers of social interaction: the coffeehouse provides patrons with a place to congregate, talk, read, write, entertain one another, or pass the time,
                                    whether individually or in small groups.[/vc_column_text][trx_button size="large" link="#" top="medium" bottom="small"]make a reservation[/trx_button][/trx_section][/vc_column][/vc_row][vc_row full_width="stretch_row_content_no_spaces" css=".vc_custom_1455542959565{background-image: url(/wp-content/uploads/2016/02/bg_home_paralax.jpg?id=651) !important;background-position: center !important;background-repeat: no-repeat !important;background-size: cover !important;}"][vc_column][trx_parallax bg_image="661" bg_image_x="50" bg_overlay="0" bg_texture="0"][trx_content top="huge" bottom="null"][trx_columns margins="" bottom="huge"][trx_column_item][/trx_column_item][trx_column_item][trx_section color="#423930" animation="fadeInUp" bottom="huge"][trx_title type="4" style="big" top="huge" bottom="null"]the
                                    experience[/trx_title][trx_title type="2" style="style" top="null" bottom="tiny"]sweet delight[/trx_title][vc_column_text css=".vc_custom_1455040756358{margin-bottom: 0.5rem !important;}"]The coffee is brewed by first roasting the green coffee beans over hot coals in a brazier. Once the beans are roasted each participant is given an opportunity to sample the aromatic smoke by wafting it towards them. This is followed by the grinding.[/vc_column_text][trx_button style="style" top="small" bottom="small"]Read more...[/trx_button][/trx_section][/trx_column_item][/trx_columns][/trx_content][trx_content top="huge" bottom="huge"][/trx_content][/trx_parallax][/vc_column][/vc_row][vc_row][vc_column][vc_empty_space height="12px"][trx_section align="center" animation="fadeInUp" width="80%"][trx_title type="2" align="center" top="huge" bottom="small"]coffee menu[/trx_title][vc_column_text]%u201CI%u2019m looking to nature for my inspiration. Letting the natural produce speak. There%u2019s so much out there, so much elegance and beauty.%u201D - PETER GILMORE[/vc_column_text][trx_button size="medium" link="http://hotcoffee.dv.themerex.net/menu/" top="medium" bottom="large"]view full menu[/trx_button][/trx_section][/vc_column][/vc_row][vc_row full_width="stretch_row" css=".vc_custom_1455545189644{background-image: url(/wp-content/uploads/2016/01/bg_04.jpg?id=275) !important;background-position: center !important;background-repeat: no-repeat !important;background-size: cover !important;}"][vc_column][vc_empty_space height="10px"][trx_services style="services-3" cat="0" columns="3" count="9" top="huge" bottom="huge" animation="fadeInUp"][/trx_services][vc_empty_space height="10px"][trx_section top="huge"][/trx_section][vc_empty_space height="10px"][trx_section top="huge"][/trx_section][vc_empty_space height="10px"][/vc_column][/vc_row][vc_row full_width="stretch_row_content_no_spaces"][vc_column][rev_slider_vc alias="second"][/vc_column][/vc_row][vc_row full_width="stretch_row_content_no_spaces"][vc_column][trx_parallax bg_image="688"][trx_section top="large"][/trx_section][vc_empty_space height="10px"][trx_block align="center" animation="fadeInUp" top="huge" bottom="huge"][trx_image url="305" icon="none" top="huge" bottom="huge"][/trx_block][vc_empty_space height="10px"][trx_section top="large"][/trx_section][/trx_parallax][/vc_column][/vc_row][vc_row full_width="stretch_row"][vc_column][vc_empty_space height="10px"][trx_title type="2" align="center" animation="fadeInUp" top="huge" bottom="large"]Most read articles[/trx_title][vc_empty_space height="10px"][trx_blogger style="short_4" columns="4" rating="no" info="" descr="0" cat="57" count="4" offset="0" order="desc" scroll="no" animation="fadeInUp" top="tiny" bottom="small"][/vc_column][/vc_row]
                                

Once you finished with building your page you would need to assign it as Homepage. To do this:

1. Select the menu item Settings - Readings
   
   
   
   
2. In the Homepage displays section select "A static page (select below)" option, in the "Front page:" dropdown list choose the page you have already created.

Feel free to make your own variations of the Homepage we have described above.

Built-in Theme Slider (Swiper)

Built-in theme slider allows you to display Featured images from the posts of this category. You can select a category and specify the number of the posts displayed. This is a rather simple solution that can be optionally used, though we prefer using revolution slider.

Revolution Slider

Our theme is fully compatible with an extremely powerful Revolution Slider plugin.

After the demo content installation Revolution Slider item will show up in theme's menu (otherwise you'd need to install this plugin manually and create the necessary slides on your own).
To set it up, please proceed to the Appearance > Theme Options > Customization > Slider section and enable Show Slider option. Choose the Layer Slider (Revolution) in the Slider Engine field and specify name of the slider in the Revolution Slider: Select slider field as it is shown on the screenshot below.

Here's how your slider might look like.

Please check the following links for more information regarding the Revolution Slider functionality:

• Slider usage Example and how-tos
• Support center + FAQs and Documentation

Please follow this link for more information on how to create layers.

Slider 2

Button code:

Blog Items

Now you can create blog posts.

• Go to Posts under the WordPress menu and then click Add New.
• Put your Title as usual.
• Put Content if needed.
• Select one or more categories to the Categories.
• Select desired Post Format.
  1. Standard - just set the featured image or without featured image.
  2. Gallery - add a gallery in the post with standard means of WordPress (with Add Media button located above the editor). In the theme settings you can specify whether you want to replace the original gallery with the built-in theme slider.
  3. Video - Add the YouTube or Vimeo video in the post with the shortcode [video]
  4. Audio - Add the Audio in the post with the shortcode [audio]
  5. Link - Add a link to the body of the post.
  6. Quote - Add text of the quotes (IMPORTANT: select it and mark as "Blockquote"), and after it - a link to the original source.
  7. Image - Add an image to the body of the post.
  8. Status - Add a one-row message to the body of the post.
  9. Aside - Add a short message to the body of the post.
  10. Chat - Normally it contains a block of messages - correspondence of two or more people. For pretty formatting you can use the shortcode [trx_chat].
• For every post item it is necessary to upload an image and to set it as featured. Click Set featured image on the right in the Featured Image section:
  
  
• Click Select Files button and select image to upload (the full size image). WordPress will crop the image, depending on which portfolio template you will use.
• After image was uploaded you need to set this image as featured. Click Set featured image.
  
  
  
  
• IMPORTANT: In the Post Options section you can flexibly customize the appearance and behaviour of each of the post: select or hide the slider above the post, select and set sidebars and their position (or hide the unnecessary ones), set up the display of different parts of the page and the post (information about the author, related posts, a comment block and many more). There are default settings for each post that are specified in the category to which the post belongs. If the settings are not specified in the category, then they are inherited from the overlying category. If there is no settings specified in any of the parental categories, the settings indicated in Appearance > Theme Options - Blog will be used.
• Publish this post.

Customization

In this section you can customize your theme:

All the options in this partition are divided into sections:

Body style

• Body style - The way of the page is displayed:
  1. boxed - page body is located in the zone of limited screen width, behind which the background image is seen (set in the fields below).
  2. wide - page body occupies entire screen width (background image is not seen behind it), and contents is placed in the area of limited width by screen center.
• Page paddings - This option adds an extra paddings above and below a page's content.
• Select theme skin - Allows you to select the necessary skin.
• Color scheme - Select predefined color scheme.
• Fill body - This option allows you to fill background of the page with solid color. You can also leave it transparent.
• Use custom background - Whether to use video as the background.
  IMPORTANT: Smooth video playback requires good memory and processor power of visitors' computers. On slower computers delays and interruptions may occur.
  • Background color - The background color for all pages of the theme (only if Body style = boxed).
  • Background predefined pattern - One of the built-in theme images filling the background as tile (repeated both vertically and horizontally). Only if Body style = boxed.
  • Background custom pattern - Here you can upload your own image filling the background as tile (repeated both vertically and horizontally). Only if Body style = boxed.
  • Background predefined image - One of the built-in theme image used as a background (not repeated). Only if Body style = boxed.
  • Background custom image - Here you can upload your own image to be used as a background (not repeated). Only if Body style = boxed.
  • Background custom image position - Here you can select the position of the uploaded image. Only if Body style = boxed.
  • Load background image - Whether to load bg images by default or only for the Boxed body style version.
• Show video background - Whether to use video as the background.
  IMPORTANT: Smooth video playback requires good memory and processor power of visitors' computers. On slower computers delays and interruptions may occur.
  • Youtube code for video bg - Code of the videos from Youtube that will be used as a background.
  • Local video for video bg - Select video from your site library that will be used as a background.
  • Use overlay for video bg - Enable overlay texture for the video background.

Header

• Top panel style - This option allows you to select one of the available headers' styles.
• Top panel position - Select one of the top panel's positions.
• Top panel color scheme - Select one of the predefined color schemes for your top panel.
• Show top panel image - Whether to show post/page/category panel image.
• Top panel image - This setting allows you to set background image for the top panel.
• Show Page title - Whether to show the page's title.
• Show Breadcrumbs - Whether to show path to the current post, page or category.
• Breadcrumbs max nesting - The maximum of nested categories in the breadcrumbs.
• Select main menu - Select one of the available menus.
• Main menu attachment - Whether to attach main menu to the top of the page or let it go up & down along with the page's content while scrolling.
• Main menu slider - Allows you to use the slider's background for the main menu items.
• Submenu show animation - Animation effect for the submenu to show.
• Submenu hide animation - Animation effect for the submenu to hide.
• Main menu responsive - Responsive version will be activated, if window's width is less than the inserted value.
• Submenu width - Dropdown's menu width.
• Show user menu area - Whether to show the user menu.
  
  
  • Select user menu - Select user menu for the current page.
  • Show language selector - Whether to show or hide the language selector.
  • Show Login/Logout buttons - Shows the Login & Logout buttons.
    
    
    
    The text for the checkbox "I agree..." (registration form) is set in Appearance > Theme Options > Customization > Other > 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.
    
    NOTICE! 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 > Theme Options > Customization > Other section!
  • Show bookmarks - Adds a "Star" bookmark button to the top of the user menu.
  • Show Social icons - Shows social icons in the user menu area. The social icons inherit the links (URLs) to your social profiles specified in the Appearance > Theme Options > Socials tab.
• TOC Position - Table of content position. Our theme allows you to create a table of content menu for single page websites. You can set TOC Fixed | Float | Hide.
  • Add "Home" into TOC - Automatically add "Home" item into table of contents - return to home page of the site. This is a recommended option for multipage websites that have single page looking landing pages.
  • Add "To Top" into TOC - Automatically add "To Top" item into table of contents - scroll to the top of the page
• Favicon - Represents your website's favicon (16x16px).
• Logo image/for Retina - Your main/Retina logo image.
• Logo image (fixed header) - Logo image for the fixed header ("Fixed" menu option should be enabled).
• Logo text - Logo text displays right next to the logo image.
• Logo height - Main logo height (in pixels).
• Logo top offset - Top offset for the main logo (in pixels) in the header (main menu) area.

Slider

And here you are setting the type and behaviour of the slider.

• Show Slider - Do you want to display a slider at the top of all pages? IMPORTANT: If you want to display the slider only on selected pages (for example, only on Homepage) - set this field to "No", and in the settings of the page in which you want to display a slider, instead of the default "Inherit" select "Yes".
  • Slider Display - How should the slider be displayed: Boxed | Fullwide | Fullscreen.
  • Height (in pixels) - The slider's height.
  • Slider Engine - Choose type of the slider engine.
    • Layer Slider (Revolution)
      • Revolution Slider: Select slider - Choose the necessary slider to display.
    • Posts Slider (Swiper)
      • Posts Slider: Category to show - Here you can select the category of posts which will be used to design the slider.
      • Posts Slider: Number posts or comma separated posts list - How many recent posts from the category will be used for to design a slider (select one number) or a make a comma-separated list of ID's of the posts you need.
      • Posts Slider: Posts order by - (string). The way to sort posts:
        • date - posts ordering by publish date
        • alpha - posts ordering alphabetically
        • views - posts ordering by views count
        • comments - posts ordering by comments number
        • author_rating - posts ordering by review's author marks
        • users_rating - posts ordering by review's readers marks
        • random - posts ordering is random
      • Posts Slider: Posts order - (string). The order to sort posts: asc|desc.
      • Posts Slider: Slide change interval - Set the necessary time frame for the slides to be changed (in ms).
      • Posts Slider: Pagination - Select none, dots or titles pagination style.
      • Posts Slider: Show infobox - Do you want to show post title, reviews rating and description on slides in swiper-slider.
      • Posts Slider: Show post's category - Do you want to show post's category on slides in swiper-slider.
      • Posts Slider: Show post's reviews rating - Do you want to show post's reviews rating on slides in swiper-slider.
      • Posts Slider: Show post's description - The maximum length (number of characters) of description displayed on the information bar for each slide. If it's 0, the description is not shown.

Sidebars

By default, theme provides some standard positions for sidebars (widget sets). Please see Widgets section for more information.

In this section you can add and remove additional sidebars. You will be able to configure the widgets for the newly created sidebars in the Appearance > Widgets menu.

In the settings of each category, post or page, you can assign any of the created widget sets to any of the available sidebars!

• Custom sidebars - Here you can add any sidebar you want.
• Show main sidebar - Select if you want to show main sidebar and select color scheme White | Light | Dark.
  • Color scheme - This option allows you to apply one of the predefined color scheme to the main sidebar.
  • Select main sidebar - Allows you to select a stack of widgets to display in the Main sidebar on the blog stream page.

Footer

• Show footer sidebar - Enable/Disable Footer sidebar and set color scheme. You can customize the sidebar in Appearance > Widgets section.
  • Color scheme - Pick the needed color scheme for the footer.
  • Select footer sidebar - Pick sidebar you want to display in the footer.
  • Footer sidebar columns - Set the number of columns you want to display in the footer.
• Show Testimonials in footer - Enable/Disable Footer sidebar and set color scheme. You can manage the single testimonials in the Testimonials (WP Dashboard) > All Testimonials post type section.
  • Color scheme - Pick the needed color scheme for the testimonials area.
  • Testimonials count - How many testimonials need to be displayed.
• Show Twitter in footer - Whether to show or hide twitter block in the footer's area.
  • Color scheme - Pick the needed color scheme for the twitter block.
  • Twitter count - How many tweets need to be displayed.
• Show Google map - Do you want to display the map on every page?
  IMPORTANT: Make sure there is a valid API key in the "Google API key" field in the Appearance > Theme Options > Service tab.
  If you want to display the Google map on selected pages only(for example, only on the page "Contacts"), set this field to "No", and in the exact page settings where you want to display a Google map, instead of the default "Inherit" select "Yes".
  • Map height - Set the necessary map's height.
  • Address to show on map - Paste the address to show in the center of the map. For example: 1, Central Road, Chicago.
  • Latitude and Longitude to show on map - Describe coordinates to show in the center of the map. If you use coordinates - address is ignored.
  • Title to show on map - Enter needed title to show on map.
  • Description to show on map - Enter the necessary description to show on map.
  • Google map initial zoom - Initial zoom of the map. Can be set from 1 to 20.
  • Google map style - The map's style.
  • Google map marker - Here you can upload an image for the map-marker (PNG format).
• Show Contacts in footer - Whether to show or hide contact information in footer (above the copyright area).
  
  
  • Color scheme - Pick the needed color scheme for the contacts area.
  • Logo image for footer/for Retina - Add your logo/Retina image to the footer section.
  • Logo height - Set the necessary height for the logo image.
  The social icons inherit the links (URLs) to your social profiles specified in the Appearance > Theme Options > Socials tab.
  
  The contact information can be customized in Appearance > Theme Options > Contact Info.
  
  
• Show Copyright area in footer - Shows block with copyright information, footer menu and social icons.
  • Color scheme - Pick the needed color scheme for the copyright area.
  • Select footer menu - Select the footer menu (available if the "Show Copyright area in footer" option is set to "Text and menu").
  • Footer copyright text - Copyright text that will be displayed in the footer area. In order to make the current year change automatically, just paste {Y} instead of the year.
  The social icons inherit the links (URLs) to your social profiles specified in the Appearance > Theme Options > Socials tab (for "Text and Social Icons" copyright style only!).

Other

• Show Theme customizer - Whether to show theme customizer in the right panel.
  • Theme customizer panel demo time - Time range for the panel to show up.
• Extended CSS animations - Additional animation effects.
• Allow CSS animations on mobile - This setting is responsible for extended css animation effect on mobile devices.
• Remember visitor's settings - Allows you to save the settings that were made by the visitor.
• Responsive Layouts - Whether to apply responsive layouts for mobile devices screens.
• Show page preloader - Choose the necessary image to act as your page preloader.
• Text with Privacy Policy link - Specify the text for the checkbox in a default form (built using trx_contact_form shortcode) and in registration form (Appearance > Theme Options > Customization > Header > Show Login/Logout buttons). This text will be displayed before the Privacy Policy link.
  
  
  
  In order to add/custimoze the Privacy Policy link, navigate to Settings (WP Dashboard) > Privacy and specify the page that will be used as a Privacy Policy one.
  
  
  
  NOTICE! In case you are planning to use default forms without consent checkboxes, just leave the "Text with Privacy Policy link" option empty!
• Characters subset - This setting allows you to specify an additional Google Fonts parameters.
• Use custom CSS/HTML/JS - This setting allows you to embed your custom code.
  • Google tags manager or Google analitics code - Paste your GTM code here. You can find it in your Google account.
  • Google remarketing code - Paste your Google remarketing code here.
  • Your custom HTML/JS code - Paste your custom html or js code here.
  • Your custom CSS code - Paste your custom styles here.

Blog and Single

This section will let you to flexibly set up the appearance and behaviour of the blog stream page and single pages.

IMPORTANT: You can override any settings of this section in the settings of the category (they will work with all posts of current category and sub-categories contained in it), as well as to set them individually for each page and the post (in Post Options section then creating / editing a post (page).

Usually when creating/editing categories and/or posts you do not need to configure each of them! It would be very tedious. It is enough to once configure the display parameters of separate pages and blog in Appearance > Theme Options - Blog and not to change the settings within categories (posts, pages) (in all fields leave the default value - "Inherit").

And only in those categories (posts, pages) that should not look like others, you can change these settings.

Blog Stream page parameters

Below is a set of parameters that affects the display of the blog stream page:

• Blog style - Display style of blog stream page:
  • Blog Excerpt - show large image and only a brief summary of the post (Excerpt) or the part before tag "Read more"
  • Classic (2,3,4 columns) - display posts located in columns as small pictures with description underneath. All pictures are cropped by the height till the same size.
  • Masonry (2,3,4 columns) - display positions arranged in columns as small pictures with description underneath. All pictures are scaled proportionally.
  • Portfolio (2,3,4 columns) - displays post as pictures with different hover effects. This description shows up when you hover over the image. All pictures are cropped to the same size.
• Article style - you can select boxed or stretch article style.
• Dedicated location - Position of "selected" content (created with the shortcode [trx_section dedicated="on"]) or featured image in respect to the page's text:
  • As in the post defined - "dedicated" content or featured image is located the way it's specified in the post settings or in the parameter align of the shortcode [trx_section], that created this "dedicated" content.
  • Above the text of the post - "dedicated" content or featured image is located above the text of the post, regardless of what is specified in the post settings.
  • To the left the text of the post - "dedicated" content or featured image is located to the left of the text of the post, regardless of what is specified in the post settings.
  • To the right the text of the post - "dedicated" content or featured image is located to the right of the text of the post, regardless of what is specified in the post settings.
  • Alternates for each post -position of "dedicated" content or featured image is selected alternately for each next post - top, left, right, etc., regardless of what is specified in the settings of the post.
  IMPORTANT: Used only if the "Blog style" is equal to "Excerpt"
• Blog posts sorted by - (string). The way to sort posts:
  • date - posts ordering by publish date
  • alpha - posts ordering alphabetically
  • views - posts ordering by views count
  • comments - posts ordering by comments number
  • author_rating - posts ordering by review's author marks
  • users_rating - posts ordering by review's readers marks
  • random - posts ordering is random
• Blog posts order - (string). The order to sort posts: asc|desc.
• Blog posts per page - The number of posts per page (overrides the same setting from Settings - Reading).
• Excerpt maxlength for streampage - How many characters from post excerpt will be displayed in blog streampage (only for Blog style = Excerpt). 0 - don't trim excerpt.

Single post (page) parameters

Below is a set of parameters that affects the display of the single posts (pages):

• Single page style - page display style:
  • Portfolio item - Used to display posts "Portfolio". Top of the page displays Featured image of this post and the arrows indicating previous / next post in this category. Beneath the images there are the title and the post's text, as well as other additional information - author, tags, meters, related posts, etc.
  • Single standard - Standard display of contents. Featured image or "dedicated" content is displayed above the content, to the left or right from it, depending on the corresponding setting in "Post Options".
• Alter thumb size (WxH) - This option allows you to select thumb size for the alternative portfolio layout.
• Show featured image before post - Whether you need to show the image attached to the post (featured image) at the top of the post.
• Show post title - Whether to display the header area of ​​a single post (page)
• Show post title on links, chat, quote, status - Whether to display the header area of ​​a single post (page) on post formats "Quote", "Link", "Aside", "Chat"
• Show post info - Whether to display the info area (date, author, categories list) of ​​a single post (page)
• Show text before "Read more" tag - Whether to display the text of the post, located before tag "Read more"
• Show post author details - Enable/Disable "Post author" section in single post
• Show post tags - Enable/Disable "Post tags" section in single post
• Show related posts - Enable/Disable "Related posts" section in single post.
  • Related posts number - How many related posts will be shown on single post page.
  • Related posts columns - How many columns will be used to display related posts.
  • Related posts sorted by - (string). The way to sort posts:
    • date - posts ordering by publish date
    • alpha - posts ordering alphabetically
    • views - posts ordering by views count
    • comments - posts ordering by comments number
    • author_rating - posts ordering by review's author marks
    • users_rating - posts ordering by review's readers marks
    • random - posts ordering is random
  • Related posts order - (string). The order to sort posts: asc|desc.
• Show comments - Enable/Disable "Comments" section in single post

Other parameters

• Exclude categories - In this list, you can mark the categories that should not be displayed in a blog stream page and in the list of categories (Widget Categories). This may be, for example, some service category.
• Blog pagination - Display type of additional portions of posts on blog stream page: standard block with page numbers, the button "View more" or "Infinite scroll" for dynamic-loading for the next batch of articles (without reloading the page).
• Blog counters - Which counters to display on blog stream page, in the widget and a shortcode: post review counter or comments counter .
• Post's category announce - Which category display in announce block (over posts thumb) - original or closest parental.
• Show post date after - How many days after the publication of the post to display the date of its publication in the usual way. Until that time, instead of the date, it will display how many minutes (hours, days) have passed since the publication.

Reviews

The section "Reviews" provides the settings for the reviews posts:

• Show reviews block - Do you want to display a block with reviews rating and summary on single page and average reviews rating after post's title in stream pages
• Max reviews level - Maximum level for reviews marks: 5 stars, 10 stars or 100%.
• Show rating as - You can select between text and stars rating system.
• Reviews criteria levels - A word description of levels of evaluation for the "Reviews" (five words separated by commas).
• Show first reviews - What reviews will be displayed first: by author or by readers. Also this type of reviews will display under post's title.
• Hide second reviews - Do you want to hide second reviews tab in widgets and single posts?
• What visitors can vote - What type of visitors can vote: all or only registered.
• Reviews criteria - Add the required number of evaluation criteria for the posts with Reviews. These criteria will be applied to all posts. You can override them in any category - the new list of criteria will apply to all posts in this category and its sub-categories.

Media

Settings for additional processing of media content on the website: audio, video and galleries:

• Image Dimensions - What dimensions will be used to display images on the pages: "Original" - precise dimensions of the image block are used; "Retina Ready" - the image twice bigger fits into the original block (for accurate display on Retina).
• Quality for cropped images - This setting allows you to set the necessary quality for the cropped images.
• Substitute standard WordPress gallery - Whether you need to replace the original WordPress gallery in the body of the post with our slider?
• Show gallery instead featured image - Show slider with gallery instead featured image on blog streampage and in the related posts section for the gallery posts
• Max images number in the slider - Maximum images number from gallery into slider. For example: gallery contain 50 images, but on the streampage you can see only 5 images in the slider. This setting speed up the page loading (for the page with many sliders or many images in the each slider).
• Popup engine to zoom images - Pick the engine to display popups.
• Substitute audio tags - Whether you need to substitute tag <audio> in the post body with special iframe (used for audio files from the server soundclouds)
• Substitute video tags - Whether you need to substitute tag <video> in the post body with special iframe (used for audio files from the server youtube and vimeo)
• Use Media Element script for audio and video tags - Do you want to design tags <audio> and <video> with the popular script Media Elements?

Socials

In this section, you can add any number of social networks, indicate their URL's (URL's of your profiles on these networks) and select icons for them. Icons of the networks you have added will be displayed in the widget "Social". Here you can also choose the social networks, whose icons will be displayed on the page of the post for sharing in the social networks.

• Social networks - Popular social networks URL. Only icons with filled URL are displayed in widget "Social".
• Show social share buttons - Whether to display the block with buttons of social networks for sharing on the post page.
  • Show share counters - this option enables share counters after social buttons.
  • Share block caption - add custom caption to share buttons block.
  • Share buttons - Share URLs of popular social networks. If URL not filled - used internal theme URLs (if exists). IMPORTANT: You can easily add your own social networks - simply copy the icon of the social network you need into the folder "/images/social", then add a new field and enter there the URL for sharing the text in this social network.
• Twitter API keys - In this section, you must specify a username and keys received when registering your application on https://apps.twitter.com. IMPORTANT: These data is required for Twitter Widget and the output of Twitter feeds on footer of the page.
• Login via Socials - This setting is responsible for the social login functionality. Paste the necessary shortcode generated by one of these plugins (depends on which one you are going to use) to enable such functionality.
  For example, you might want to try installing the Social Login 3rd party plugin. Recommendation: Please be aware that not every 3rd party plugin might be 100% compatible with our theme.

Contact info

In this section you can set the following settings:

• Contacts in the header - String with the contacts in the top left corner.
• Open hours in the header - String with the working hours.
• Some words about company - This setting allows you to add some custom text.
• Contact form email - E-mail to send messages using contact form and form of registration of new users. If this field is empty, use admin e-mail from WordPress settings.
• Company address (part 1) - The first part of the address: house number and street
• Company address (part 2) - The second part of the address: city, postal code and country
• Phone - Comma separated phone numbers.
• Fax - Comma separated fax numbers.
• Contact form message - Message's maxlength in the contact form shortcode.
• Comments form message - Message's maxlength in the comment form.
• Mail function - What function you want to use for sending mail: the built-in WordPress wp_mail() or standard PHP mail() function? Attention! Some plugins may not work with one of them and you always have the ability to switch to alternative.

Search

In this section you can configure the mechanism of incremental search. In the header of the website, the button opens the fields for incremental search. As you're entering text below this box, the list of posts that match the query will be displayed:

• Show search field - Show search field in top area and side-menus.
  • Enable AJAX search - Use incremental search (as I'm entering text) or standard search (by pressing Enter or button "Search").
  • Min search string length - Minimum number of characters after entering which the search begins.
  • Delay before search (in ms) - Pause after the last keystroke (in milliseconds, 1000ms = 1s) before starting the search.
  • Search area - Check the types of posts, among which to search. It is allowed to mark multiple types at a time.
  • Posts number in output -The number of posts displayed in search results.
  • Show post's image - Show featured image in the search results.
  • Show post's date - Show the date of publication of the post in the search results.
  • Show post's author - Show the author of the post in the search results.
  • Show post's counters -Show post counts (number of views, likes or comments) in search results.

WooCommerce

The section "WooCommerce" provides the settings for the WooCommerce posts:

• Shop list style - Default list style for the shop products stream pages: "thumbs" (only thumbs with titles) or "list" (thumbs, titles and short description).
• Show style buttons - show sorting buttons allowing to switch between display styles.
• Shop columns - Columns quantity to show the products in.
• Show currency selector - Whether to show or hide currency selector.
• Show cart button - Whether to show or hide cart button.
• Crop product's thumbnail - Whether you need to cut pictures of products in the store by the height when listing products as stream tape, or Whether you need to resize them, preserving their proportions.

Service

In this section you can set the following settings:

• Use AJAX post views counter - What type of counter should I use to count the number of page views: AJAX is applied if your site uses content caching system (in this case extra requests to the server are being generated). If you do not use caching - this option should be disabled.
• Frontend editor - This option allows posts' authors edit their posts right in the frontend mode.
• Additional filters in the admin panel - Whether to use extra filters for Post Format and Tags in admin panel when viewing the list of the blog posts.
• Show overridden options for taxonomies - Shows an extra column with already overridden options in categories list.
• Show overridden options for posts and pages - Shows an extra column with already overridden options in posts and pages lists.
• Enable demo data installer - If disabled you won't see "Import demo data" link in your admin panel. We recommend to disable it after site setup to avoid accidental data rewriting
• Demo Data Installer Timeout - Time range for the files import procedure.
• Enable Emailer in admin panel (menu Appearance) - Do you want to show "Emailer" item in the menu "Appearance" in the admin panel. This program allows massive email distribution by the list of arbitrary addresses or groups of addresses accumulated by shortcode [trx_emailer].
• Debug mode - In the debug mode we are using unpacked scripts and styles, else - using minified scripts and styles (if present).
• Google API Key - Paste the necessary Google API Key to generate a Google Map. More information on how to generate an API key properly can be found here.

trx_accordion

Creates blocks of the "accordion" type. Only one of the blocks can be open at a time.

Parameters:

• initial - (number). The number of the initially open block (from 1 to the number of blocks). Attention: if you want to make all accordion items to be closed initially, just write parameter initial greater, than items count!
• style - (number). Accordion style from 1 to 3
• large - (string). Use enlarged headings for elements: on|off
• counter - (string). Number elements of headings: on|off
• shadow - (string). Display shadow under the block Accordion: on|off
• id - unique id for element. Allow to address this element form javascript or CSS
• class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
• css - add custom css styles
• animation - select one of available animation effects for this shortcode
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_accordion_item

Creates one item for the "accordion" block. Used only within the shortcode [trx_accordion].

Parameters:

• title - (string). Applied only for the shortcode [trx_accordion_item]. Contains title for the current element.
• id - unique id for element. Allows you to address this element form javascript or CSS
• css - add custom css styles.
• class - class name for element. Allows set up additional decorations for element in CSS stylesheets.

trx_anchor

Creates anchor for the "one page" navigation. If the page contains one or more anchors, this automatically creates a table of contents (TOC), that may be displayed on the right edge of the window. The position of the TOC may be fixed or floating.

Parameters:

• title - (string). Contains short title displayed in the TOC (under the icon).
• description - (string). Contains description displayed in the TOC (at the left of the icon).
• icon - (string). Icon displayed in the TOC for addressing this section.
• URL - (string). add an URL linked to anchor item.
• separator - (boolean). Enable/disable separator, disabled by default.
• id - (string) Unique id for element. Allow to address this element from TOC.

Examples:

trx_audio

Inserts an audio file.

Parameters:

• Title - audio file title
• author - audio file author
• image - add or upload image associated with the audio file
• align - Choose shortcode alignment
• frame - Enable/disable frame. Enabled by default
• url or src or mp3 or wav - (string). URL of an audio file
• controls - (number). Whether to display the playback controls. The value can be on or off.
• autoplay - (number). Allows autostart playback. The value can be on or off.
• width - (number). The audio container's width (in percent or pixels).
• height - (number). The audio container's height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
• css - add custom css styles.
• animation - add one of available animation effects.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_br

Inserts forced newline. Can be used where you can not use html-code. Also used to disable the flow around objects.

Parameters:

• clear - (string). Disables flowing around objects created with any shortcode with parameter align="left|right|both" or means of CSS. The value can be "both" or "left" or "right".

trx_blogger

Well, we have arrived at the punch line of our collection - shortcode "Blogger". On one hand, it is rather simple - it just displays the specified number of posts from a given category. But just look how it works! It can do this in many different ways and styles. And by skillfully combining them you can easily create such blocks as Announce, ad units, interviews and much more. We think you had a chance to make sure of that by the example of creating of many different home pages.

Let's examine its parameters more carefully:

• style - (string). Block display style:
  • regular
  • date
  • image_large or image_medium or image_small or image_tiny
  • accordion_1 or accordion_2
  • list
  • excerpt
  • related
  • classic1 or classic2 or classic3 or classic4
  • portfolio1 or portfolio2 or portfolio3 or portfolio4
  • masonry2 or masonry3 or masonry4
• filters - this option enables categories or tag filters
• hover - (string). Hover effect (only if style=portfolio1|2|3|4):
  • shift
  • dir
  • book
  • cube
  • circle effect1 ... circle effect20 (space separated!)
  • square effect1 ... square effect15 (space separated!)
• hover_dir - (string). Hover effect direction (only if style=portfolio1|2|3|4 and hover=circle...|square...):
  • left_to_right
  • right_to_left
  • top_to_bottom
  • bottom_to_top
  • from_left_and_right
  • from_top_and_bottom
  • scale_up
  • scale_down
  • scale_up_down
• post_type - Select a post type to work with. Posts are selected by default, you can also choose pages, products, events and announcements.
• ids - (numbers). Comma-separated ID posts to be displayed.
• cat - (number or string). ID or slug of the category, which puts out the most recent (or the first) posts added (unless ids parameter is specified). It is allowed to specify several ID's (or slugs) separated with commas.
• count - (number). The number of posts queried from the category.
• visible - (number). The number of posts displayed at once. The remaining posts will either scroll or be located in the following strings (depending on the style)
• offset - (number). How many posts to skip before starting output.
• orderby - (string). The way to sort posts:
  • date - posts ordering by publish date
  • alpha - posts ordering alphabetically
  • views - posts ordering by views count
  • comments - posts ordering by comments number
  • author_rating - posts ordering by review's author marks
  • users_rating - posts ordering by review's readers marks
  • random - posts ordering is random
• order - (string). The order to sort posts: asc|desc.
• descr - (number). The maximum length post description (excerpt). If 0 - description not showed.
• readmore - (string). Show (on) or not (off) link "»" (read more) at the end of the post.
• rating - (string). Show (on) or not (off) rating stars under the post title.
• dir - (string). The direction of the output of the posts: horizontal | vertical
• scroll - (string). Whether to create a scrolling section to display all selected posts: on|off or yes|no. IMPORTANT: Scrolling is created only if count > visible
• controls - (string). The presence of a scroll controls: on|off or yes|no
• info - (string). Whether to display the section with tags and buttons "More", "Connents", "Likes", etc. The value can be on or off.
• date_format - (string). Format to display the posts date. For example, if we want display (on style="date") time at the top, and date below, it would be date_format="H:i+F d".
• location - (string). Position of "dedicated" content or featured image. Used only for style="excerpt". The value can be center, left, right, alter or default. See detailed description in section "Blog" (parameter "Dedicated location")
• width - (number). Section width (in percent or pixels).
• height - (number). Section height (in pixels).
• id - unique id for element. Allow to address this element form javascript or CSS
• class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Example:

trx_button

Creates different types of buttons and inputs.

Parameters:

• type - (string). The button type. It can take one of the following values: square|round. If this parameter is not specified - it gets 'square'
• style - (string). The button style. It can take one of the following values: global|light|dark. If this parameter is not specified - it gets 'global'
• size - (string). The button size. It can take one of the following values: mini|medium|big|huge|banner. If this parameter is not specified - it gets 'medium'
• fullsize - (string). Indicates that the button should extend over the entire width available. It can take one of the following values: on|off. If this parameter is not specified - it gets 'off'
• icon - (string). The button icon. It can take icon name from 'fontello' set. You can select a required icon with the shortcode builder or learn about a complete list of available icons by opening the page "/css/fontello/demo.html" inside the theme folder.
• color - (string). The button color. It can take color name (up to 140 names: red, green, blue, yellow, etc.) or color code (#ff0000 for example)
• link - (string). The URL where the link from the button leads to.
• target - (string). The window where the link leads to. If this parameter is not specified - URL will open in the same window.
• rel - (string). Add the "rel" attribute to the link.
• align - (string). The way to align the button left|right|center.
• popup - (string). Whether you need to open the contents in the popup window. In this case using the shortcode [trx_popup id="popup_name"]Popup content[/trx_popup] you create the required contents, and in the shortcode [trx_button link="#popup_name" popup="on"] you specify the name of the popup you have created in the parameter link (Be sure to place a sign "#" in front of the name of popup).
• id - unique id for element. Allow to address this element form javascript or CSS
• class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_chat

Creates chat elements.

Parameters:

• title - (string). The title of the chat element.
• link - (string). URL for the current chat element.
• width - (number). Section width (in percent or pixels).
• height - (number). Section height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_columns

Creates columns in the text.

Parameters:

• count - (number). The number of columns in the generated block. IMPORTANT: Inside the block [trx_columns] ... [/trx_columns] the number of blocks [trx_column_item] ... [/trx_column_item] must correspond to the parameter count.
• id - unique id for element. Allow to address this element form javascript or CSS
• class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_column_item

Creates one column item in the columns block.

Parameters:

• span - (number). Indicates the number of the merged columns.
• align - (string). Text's alignment inside column. Permitted values are: center | left | right
• color - (string). Color of the inner text.
• bg_color - (string). Background color of the column.
• bg_image - (string). Background image of the column.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_content

Creates a block for contents (limited by width) on Fullscreen pages.

Parameters:

• style - (string). Any additional CSS-rules for this block.
• class - (string). CSS class name for this block.
• id - unique id for element. Allows you to address this element from javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom the value of which is the number - the margin in pixels from the top and bottom of the block respectively.

trx_dropcaps

Used to create the dropcaps effect - special highlighting of the first letter in a paragraph.

Parameters:

• style - (number). Display style of the first letter. The value can be from 1 to 6. If not specified - use 1.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

Examples:

trx_emailer

Inserts a field for e-mail address. The field "collects" the entered addresses and allows the owner (administrator) of the site to do e-mail - distribution according to this list. More details about the system of e-mail distribution see in the description of "Emailer Tool".

Parameters:

• group - (string). Name of the group collecting addresses. Shortcodes [trx_emailer] with different group names can stand on different pages of the website and collect addresses for different email distributions. In the future, you can make individual distribution for each group.
• open - (string). Should this space be open when reloading the page, or initially only the button should be visible, and when pressing on it, the field opens. Permitted values are: yes | no
• align - (string). Field's alignment with respect to the following text. Permitted values are: center | left | right
• width - (number). Section width (in percent or pixels).
• height - (number). Section height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_form

Display Contact form.
IMPORTANT: To activate the contact form, please paste your email address into the Appearance -> Theme Options -> Contact info -> Contact form email field.

To customize the form in available styles you should edit form template file in any text editor like Notepad or TextEdit. In the .../hot-coffee/templates/trx_form folder you can find form-related files like form_1.php, form_2.php or form_custom.php. These files are responsible for displaying the form in different styles. Choose the file you need, open it in any text editor, and change HTML code according to your needs.

The text for the checkbox "I agree..." is set in Appearance > Theme Options > Customization > Other > 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.

NOTICE! In case you are planning to use default form without consent checkbox, just leave the "Text with Privacy Policy link" option empty in the Appearance > Theme Options > Customization > Other section!

Parameters:

• title - (string). The Contact form's title
• description - (string). The Contact form's description. Displayed under the title.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_gap

Creates a "gap" in contents of the page, allows the contents specified in this shortcode to stretch to the entire width of the window (the screen).

Examples:

trx_googlemap

Displays Google map at the address you specified. Make sure there is a valid API key in the "Google API key" field in the Appearance > Theme Options > Service tab.

Parameters:

• zoom - (number). Initial map zoom (from 1 to 20)
• style - (string). Map frame visual style: default|simple|greyscale|greyscale2|style1|style2|style3
• width - (number). Map frame width (in pixels or percents)
• height - (number). Map frame height (in pixels)
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

IMPORTANT: Address for the Googlemap can be specified in the Googlemap marker shortcode's general settings:



or it can be inherited from the Appearance -> Theme Options -> Customization -> Footer -> Google map parameters section.

trx_hide

Hide any html block with desired selector (id and/or classes combination).

IMPORTANT: For advanced users only! Careless hide of objects can disrupt the design of your site. Be extremely careful.

Parameters:

• selector - (string). Id and/or classes combination (CSS-selector)
• hide - (string). "on" or "off" - do you want hide selector or show it
• delay - (number). Delay before hide/show element (in ms)

Examples:

trx_highlight

Used to highlight a text with the font's color and / or background.

Parameters:

• type - (number). Type selection: accent theme color letters or white letters on a background of accent theme color. Possible values: 1 or 2. Instead, you can explicitly specify the text color and background color using the following parameters.
• color - (string). The color of the text. You can specify the color (white|black|red|blue|green|brown|... - up to 140 styles) ot its code in format #rrggbb, where rr is a hexademical value of the red component, gg - a hexademical value of the green component, bb - a hexademical value of the blue component
• backcolor - (string). The background color of the text. The same parameter as color.
• style - (string). Arbitrary set of CSS-properties (for advanced users only)
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

Examples:

trx_icon

Inserts an image into the text, pressing it (image) to the left or right edge of the text, and the next image text flows around it on the opposite side. You can expand the list of available icons by adding new ones from the fontello website. Watch this video guide for more information.

Parameters:

• icon - (string). Icon name. It can take icon name from 'fontello' set. You can select a required icon using the shortcode builder, or you may learn about a complete list of available icons, opening the page "/css/fontello/demo.html" inside the theme folder.
• size - (number). Font size for the icon (in pixels)
• weight - (number). Font weight for the icon: 100-900 (step 100)
• align - (string). Alignment of the icon. It can take one of the following values​​: left|right|center
• color - (string). Color of the icon.
• bg_color - (string). Background color of the icon.
• background - (string). Background style for the icon: none|round|square.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_image

Inserts an image into the text, pressing it (image) to the left or right edge of the text, and the next image text flows around it on the opposite side.

Parameters:

• src or url - (string). URL of the image
• title - (string). Text at the bottom of the image.
• align - (string). Alignment of the image. It can take one of the following values​​: left|right
• width - (number). the image's width (in pixels).
• height - (number). the image's height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Example:

trx_infobox

Creates different types of messages.

Parameters:

• style - (string). The infobox style. It can take one of the following values: regular|info|success|error|result. If this parameter is not specified - it gets 'regular'
• closeable - (string). If this parameter is set to "yes" - right in the block there is a button "x" and the block may be closed (disappear) when you click on it. If this parameter is not specified - it gets "no".
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_line

It creates the line of the set style.

Parameters:

• style - (string). The line style. It can take one of the following values: none|solid|dashed|dotted|double|groove|ridge|inset|outset|shadow
• color - (string). The color line. You can specify the color (white|black|red|blue|green|brown|... - up to 140 styles) of its code in format #rrggbb, where rr is a hexademical value of the red component, gg - a hexademical value of the green component, bb - a hexademical value of the blue component
• width - (number). The line width. It can be set in pixels (simply specify the number) or as a percentage of the page width (specify number with percents). If this parameter is not specified - it gets100%.
• height - (number). Line width (in pixels)
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_list

Creates lists of different styles.

Parameters:

• style - (string). List display style. It can take one of the following values​​: regular|check|mark|error. Can be used both ih a shortcode [list] to set the style of all the elements of the list, and in the shortcode [list_item] to change the style of one item in the list.
• icon - (string). Icon name. It can take icon name from 'fontello' set. You can select a required icon using the shortcode builder, or you may learn about a complete list of available icons, opening the page "/css/fontello/demo.html" inside the theme folder. This parameter can be used both in shortcode [trx_list] to specify an icon for the entire list as a whole, and for [trx_list_item] to change icons of a particular item in the list.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_list_item

Creates one list item in the list.

Parameters:

• icon - (string). Icon's name. It can take icon name from 'fontello' set. You can select a required icon using the shortcode builder, or you may learn about a complete list of available icons, opening the page "/css/fontello/demo.html" inside the theme folder. This parameter can be used both in shortcode [trx_list] to specify an icon for the entire list as a whole, and for [trx_list_item] to change icons of a particular item in the list.
• title - (string). Indicate the title of the item in the list.
• link - (string). URL for the link of the item in the list.
• target - (string). Target for URL.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_menuitems

Displays food menu items in two styles: Style 1 and Style 2. More information can be found in the plugin's section.

To manage "Menu items" proceed to the WordPress Dashboard Menu > Menu Items post type.
For Style 1 use "Menu Items Group", "Featured Image" (for the image), "Excerpt" (for the summary) settings to customize the post.
For Style 2 use "Menu Items Group", "MenuItem Options > Menu Items" (for the price, Nutritions, Ingredients), "Featured Image" (for the image) settings and the general content section (for Description) to customize the post.

Key parameters:

• Menu items style - Choose the necessary style.
• Columns - Choose the necessary quantity of columns to display your items.
• Color Scheme - Choose the necessary color scheme.
• Popup info - Enables popup window to display the necessary item.
• Slider - Enables slider to display the items.
• Custom - This setting allows you to pick team members.
• Categories - Pick the category to get team members from.

Examples:

trx_parallax

Used to create a block with the image that is asynchronously shifting while scrolling through the page.

Parameters:

• style - (string). The style of parallax block. It may be 'light' or 'dark'.Depending on the style, light or dark font for the content block are used.
• color - (string). The background color for the newly created block.
• overlay - (number). Overlay color opacity (from 0.0 to 1.0).
• texture - (number). Texture style number (from 1 to 11). 0 - without texture.
• image - (string). URL of the image used in parallax as asynchronously shifting background.
• image_x - (number). Background position (in percent). For example: image_x="0%" - background image aligned left, image_x="50%" - centered horizontally, image_x="100%" - aligned right.
• video - (string). URL of the local video used in parallax as background.
• dir - (string). Type of picture shifting. Can be "up" or "down".
• gap - (string). Whether to create a "gap" for the content block so that it stretches to the entire width of the window (gap = "yes") or the width of the block will remain equal to the width of contents (gap = "no").
  If parallax block is inserted into the page, whose parameters are already set for "fullwidth" style, you don't have to use gap = "yes". If you used the "gap", and inside the block you need to place contents that should not be stretched to the entire width of the window, simply enclose them (the contents) in the shortcode [trx_content]
• width - (number). Section width (in percent or pixels).
• height - (number). Section height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_popup

Creates a block that opens in a popup window. Surrounds the selected text to the block and gives it the properties of a given class from the style table.

Parameters:

• id - (string). ID of the block. Used in the shortcode [trx_button] parameter link="#popup_id" to show this block.
• class - (string). The name of class of the block
• style - (string). CSS-style for the generated block
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_price_block

Creates a 4 block table with prices:

Parameters:

• align - (string). The table alignment: left|right|center.
• count - (number). Columns count
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_quote

Used to emphasize the big and small quotes in the text.

Parameters:

• cite - (string). URL of the site with the original.
• title - (string). Title for link to the site with the original.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom the value of which is the number - the margin in pixels from the top and bottom of the block respectively.

Examples:

trx_section and trx_block

Surrounds the selected text to the block and gives it the properties of a given class from the style table. These two shortcodes are absolutely identical! They are created in order to overcome the restriction of WordPress due to which the same shortcodes can not be inserted into each other.

Parameters:

• style - (string). CSS-style for the generated block
• align - (string). Block alignment: none|right|left|center
• columns - (string). Block width in "columns" equivalent: 1_2, 1_3, 1_4, 2_3, 3_4
• dedicated - (string). Whether you need to create "selected" block from the contents. If this parameter is set for "yes", the contents of the block is "cut out" of the place where it's mentioned and is displayed at the beginning of the page's contents (before the title) instead of "Featured image".
• scroll - (string). Whether you need to create a container with a scrollbar and an option to scroll content using swipe gestures. Possible values: yes | no
• controls - (string). Whether to display buttons with arrows to control scrolling. Possible values: yes|no
• dir - (string). Scroll type: horizontal|vertical
• color - (string). Color of the inner text.
• bg_color - (string). Background color of the section.
• bg_image - (string). Background image of the section.
• width - (number). The block's width (in pixels or percents).
• height - (number). The block's height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

You can wrap any shortcode you want into the "section" one, for example Google map.

trx_skills

Shows the levels of your abilities in many different styles.

Parameters:

• type - (string). Type of the skills block: bar|pie|counter|arc
• style - (number). Style of the skills blocks (only for type="counter"): from 1 to 4
• dir - (string). Direction: horizontal|vertical
• layout - (string). Skills block's layout: rows|columns
• count - (number). Number of skills items in the block.
• maximum - (number). Max value for each skills element. Default value is 100
• title - (string). Skills block's title.
• subtitle - (string). Skills block's subtitle - showed in the center (only if type="arc").
• align - (string). Alignment of the skills block: left|right|center
• color - (string). Color for the skills elements. The main color of accented theme's elements is used by default.
• width - (number). The skills block's width (in pixels or percents).
• height - (number). The skills block's height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_skills_item

Shows one item of the skills block. Used only in the [trx_skills] shortcode.

Parameters:

• title - (string). The name of the current element.
• level - (number). Ability level for the current element (up to maximum)
• color - (string). Color for the current item. The main color of accented theme's elements is used by default.
• style - (number). Style of the skills item (only for type="counter"): from 1 to 4
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_slider

And one more feature of our theme - shortcode "Slider". It can display all posts from a specific category or the slideshow of the Revolution Slider you have prepared beforehand, as a slider (if you have previously installed this plugins).

Let us examine its parameters:

• engine - (string). The engine of the slider: swiper|revo. "Revo" options are available if the plugin revslider.zip is installed. The default parameter is "swiper".
• alias - (string). Name of the slide show, prepared in Revolution Slider (if engine=revo)
• interval - (numbers). Slides change interval (in milliseconds: 1000ms = 1s). Default: 5000 (if engine=swiper).
• ids - (numbers). Comma-separated ID posts to be displayed in the slider (if engine=swiper).
• cat - (number or string). ID or slug of the category, which puts out the most recent (or the first) posts added (unless ids parameter is specified). If parameter "cat" is not specified - posts from any category will be displayed (if engine=swiper). It is allowed to specify several ID's (or slugs) separated with commas.
• count - (number). The number of posts displayed from the category (if engine=swiper)
• offset - (number). How many posts to skip before starting output (if engine=swiper)
• orderby - (string). Posts order by (if engine=swiper):
  • date - posts ordering by descending of publish date
  • views - posts ordering by descending of views count
  • comments - posts ordering by descending of comments number
  • author_rating - posts ordering by descending of review's author marks
  • users_rating - posts ordering by descending of review's readers marks
  • random - posts ordering is random
• order - (string). Posts order: asc|desc
• controls - (string). The presence of the buttons with arrows in the slider: yes|no
• pagination - (string). The presence of the circles (to switch between slides) at the bottom of the slider: yes|no
• border - (string). The presence of the border (phone image) around the slider: none|dark|light
• titles - (number). Show or not post infobox on each slides (if engine=swiper): none|fixed|slide. If titles='slide' - infobox hide on hover, if titles='fixed' - infobox position is fixed.
• description - (number). Posts excerpt max length. If 0 - excerpt not showed.
• links - (string). Make each slide as link to the correspond post (if engine=swiper): yes|no
• align - (string). The alignments of the slider: left|center|right
• width - (number). The slider's width (in pixels or percents).
• height - (number). The slider's height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_slider_item

Create one item of the slider. Used only in the [trx_slider] shortcode.

Parameters:

• src or url - (string). URL of the image for current slide.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_table

Displays a table.

Parameters:

• style - (number). The table style from 1 to 4.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_tab_item

Creates one tab item (with tab content) in the tabs block.

Parameters:

• title - (string). Headline for current tab (instead tab_names in parent shortcode [tabs])
• id - (string). ID for the current tab content (optional)
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_team

Displays the members of your team (photo with description).
IMPORTANT: You can change content for each Team post in WordPress dashboard > Team tab, just open single team post and edit the Team Member Details section for the position and social links, the Featured Image section for the image, the Excerpt section for the summary.

Parameters:

• count - (number). Number of items in the team block
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_team_item

Displays one member of your team.

Parameters:

• user - (string). Contains the user login to your blog. The user's data contains the description and links to the user profile in popular social networks. If team member is not registered in your blog - you can put name, photo, email and socials links directly in parameters below.
• name - (string). The team member's name.
• photo - (string). The team member's photo url.
• email - (string). The team member's email.
• socials - (string). The team member's socials links, separated with character '|'.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_testimonials

It generates a block with the statement of any person (you must also specify its parameters).
IMPORTANT: You can change content for a single Testimonial post in WordPress dashboard > Testimonials tab, just open a single testimonial post and edit the Testimonials Details section (for the author's name, position), the content section itself and the Featured Image section (for the image).

Parameters:

• title - (string). Title of the block
• Testimonials style - Allows you to select the necessary style.
• controls - (string). The presence of the buttons with arrows in the block: yes|no
• width - (number). The block's width (in pixels or percents).
• height - (number). The block's height (in pixels).
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples:

trx_testimonials_item

It generates one item for testimonials slider.

Parameters:

• photo - (string). The displayed photo (unless user parameter is specified).
• name - (string). The displayed name (unless user parameter is specified).
• position - (string). The position (unless user parameter is specified).
• email - (string). E-mail (unless user parameter is specified)
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

trx_tooltip

Used to create pop-up tips that appear when you hover over a given piece of text.

Parameters:

• title - (string). Tooltip text.
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.

Examples:

trx_video

Inserts a video file from one of the most popular video hosting services - youtube or vimeo.

Parameters:

• url or src - (string). URL of a video file
• image - (string). URL of the cover image for the video. For video from Youtube picture is retrieved automatically.
• title - (string). Shows title bar above the video frame
• autoplay - (string). Allows autostart playback. The value can be "on" or "off".
• width - (number). Video frame width in pixels or percent.
• height - (number). Video frame height in pixels
• id - unique id for element. Allows you to address this element form javascript or CSS
• class - class name for element. Allows you to set up additional decorations for element in CSS stylesheets.
• top, bottom, left, right the value of which is the number - the margin in pixels from the top, bottom, left and right of the block respectively.

Examples: