Getting started

General Information

Thank you for purchasing our theme. We are happy that you are one of our customers and we assure you won't be disappointed as well. We do our best to produce top notch 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 lot's of your time and avoid questions with obvious answers.

We also recommend to check our video tutorials and FAQ pages

If you have any questions that are beyond the scope of this help file, please feel free to post your questions on our support forum at http://themerex.ticksy.com.

Please Notice! Our support covers getting setup, trouble using any features, and any bug fixes that may arise. Unfortunately we cannot provide support for customizations or 3rd party plugins. If you need help with customizations of your theme then you should enlist the help of a developer.

Wordpress Information

To use this theme you must have Wordpress engine installed. We assume you have a working version of WordPress already up and running. If not you can check this great video by Woothemes guiding you through the process of Wordpress installation.

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

Theme Requirements

To use this theme you must be running WordPress 3.9 or higher, PHP5 or higher, and mysql 5 or higher. Please contact your web hosting service provider to be sure your server complies with the requirements above. To safeguard your website always use secure passwords and the latest version of Wordpress and plugins

Recommended web hosting services:

Be sure to check php upload_max_filesize and post_max_size is 32M or higher. If you are running shared web hosting you should contact your web hosting service provider to find more information about that. 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 post_max_size 32M
php_value upload_max_filesize 32M
Setting these values will ensure you wont get an error reporting that your upload and post memmory limit is too low.

Getting support

We strive to provide best tech support ever :-). To get free assistance please use our tickets system.

Before submitting a ticket please be sure you checked this documentation file, our FAQ page and video tutorials. Most of the issues that may arise have already been resolved and answered.

Please Notice!
To get tech support you will need your purchase code. To get the code please go to your themefoest download page and click on theme download link. Here you should stick with the last option and download text file containing your license details and purchase code proving your order.



Our support covers getting setup, trouble using any features, and any bug fixes that may arise. Unfortunately we cannot provide support for customizations or 3rd party plugins. If you need help with customizations of your theme then you should enlist the help of a developer.

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 frequent error meaning you are trying to install incorrect package.

To install "Person" theme you must have a working version of WordPress already installed. For information in regard to installing the WordPress platform, please see the WordPress Codex - http://codex.wordpress.org/Installing_WordPress 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 3.9+. 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 Person.zip file and ONLY use the extracted /Person theme folder
    3. Upload the extracted /Person 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 "Person.zip" and click in Install Now button.
    4. After successfull 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.
    6. A new menu item Appearance -> Theme Options will appear.

Plugins

The theme comes with several plugins on board, these are Mass E-mailer tool for email marketing and PO composer tool allowing to edit language file in an easy and human friendly way. Luckily you dont have to mess up with plugins installation, they all work out of the box.
Besides that the theme has great banner plugin allowing to create effective advertising campaigns in an easy and intuitive way. By default this plugin is not active. To enable it please navigate to Plugins -> Installed Plugins, find banner plugin and activate it. You can find more information about this plugin at official page

If you are planning to create multilingual site using WPML plugin you should be aware that some plugin features may fail in AJAX mode so we recommend to use standard mode for multilingual websites. For smooth plugin performance we recommend to pass language variable using POST method, go to plugin settings page and set the URL parameter as follows:


IMPORTANT: When AJAX version is enabled some 3rd party plugins that require jQuery scripts may fail since the page wont reload and wont load new scripts. If this happens you should disable AJAX page loading.

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 the best practice to backup both your files and database regulary and especially before making some serious updates. We recommend using free backup plugins for WordPress like WPOnlineBackup

Update Option 1. Update using WordPress uploader

  1. Log into your Themeforest account and navigate to your downloads tab. Find the theme and download “Installable WordPress file”.

  2. Log into your wordPress website and go to Appearance -> Themes
  3. Activate a different theme. Delete the previous version of Person and re-upload the new Wordpress Installable files that you have downloaded from Themeforest in the 1st step.
  4. Once it uploads, choose to activate the theme.
  5. Update the included plugins if you see a notification message letting you know the plugins have a new version.

Update Option 2. Update using FTP client

  1. Log into your Themeforest account and get the last version of the theme as described above.
  2. Connect to your server using desktop client software(we recommend CyberDuck and Filezilla)
  3. Change directory to /wp-content/themes
  4. Remove existing folder with old theme files
  5. Unpack theme installable files downloaded from themeforest and upload to themes folder
  6. Update the included plugins if you see a notification message letting you know the plugins have a new version.

Demo Content

Our themes have simple One click dummy 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 be sure you have installed all required plugins, please refer to Plugins installation section of this document for details..

IMPORTANT: When installing demo-data ALL EXISTING CONTENTS of your website will be deleted and replaced with the new data! We highly recommend you to install demo data only on blank Wordpress install.

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

  1. Log in to your site as an administrator.
  2. You may see a message prompting to install additional plugins, please make install if you see this notification(this is optional feature, some themes may come with integrated plugins)
  3. Go to Appearance -> Install Dummy Data:



  4. On the page that showed up, please set the required parameters. IMPORTANT: if you want to get a precise copy of our demo site choose "Overwrite existing content"



  5. Click on "Install Demo Data" button. IMPORTANT: Please wait whie 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 following message:



    In 99.9% it works fine but if something went wrong and data was not imported please repeat the procedure described above. If you are making the install on your local machine please check your internet connection and firewall settings, this may affect data transfer.

Quick start

Person is a vCard Wordpress theme with advanced options. It has some specific features peculiar to vCard websites only:

  • Main menu supports up to 6 menu items
  • Main menu does not support submenu elements
  • The theme supports multisite/multiuser features with great content filtering options.
  • The theme supports AJAX/Standard loading mode
  • The theme supports multiple skins
  • The theme can be used to build micro communities and social networks
  • In multiuser mode you can filter the content by author. This feature allows to use the theme for teams portfolio sites or mini social/professionals' networks for small and medium communities.

After theme activation and demo content import we are ready to get started with basic theme settings. First we recommend to set desired operation mode:

  • AJAX mode (recommended) - when you click on menu item the website does not reload the page but instead launches AJAX request and loads the content on the same page(you will see preloader while new content is being loaded)
  • Standard mode - when you click on the menu item your website reloads the page as usual.

To switch between modes navigate to Theme Options -> Service -> Ajax loading of content

Working in Ajax Mode

After enabling Ajax load mode all URL requests will be processed by Ajax module. The content of all pages will be loaded in central page block, the page wont reload.
Your 1st step is setting up main menu. After dummy data import you have few menus in your theme, now it's a good time to define a default one used for the main menu of your website. Go to Appearance -> Menus -> Manage locations and select "main menu", click on save changes button.


Great! Now we should take care of other site pages not included in the main menu. As we mentioned before they will still load in the central part of the front page, one of main menu items is supposed to be active. Thus we need to define default main menu item for these pages, it will act as a sort of a container for the pages not included in the main menu. if we don't create such default container the pages will be "homeless" and won't load successfully. To do this please navigate to Theme Options -> Customization -> Menu and select default menu items for external links and pages
NOTICE! We assume you imported dummy content and have main menu structure as a preview page theme. If you you should create this main menu item first and only after that assign it as a default menu for external links and pages.

To change your site title and tagline go to Settings -> General Please notice, these parameters are important for search engines. For advanced SEO management we recommend installing 3rd parties plugins like All In One SEO pack

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 example below.

Now let's set main menu background image, navigate to Theme Options -> Customization -> Menu, lets select an image for background and set it fullscreen. You can also set your own image and play with background display options.

Working in Standard Mode

Optionally your site may work in standard mode when pages reload every time you go to another section of your website. This is a regular and standard way the websites perform. If you opt to stick with this operation mode you should go to Settings -> Reading and define default Home page and blog page. You should select one of existing pages(we assume you imported dummy data) or 1st create your own custom page and then select is as a default one.



The second step is to define main menu, you should navigate to Appearance -> Menus -> Manage Locations and choose one of existing menus to act as a main theme menu.




To change your site title and tagline go to Settings -> General Please notice, these parameters are important for search engines. For advanced SEO management we recommend installing 3rd parties plugins like All In One SEO pack

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 example below.

Now let's set main menu background image, navigate to Theme Options -> Customization -> Menu, lets select an image for background and set it fullscreen. You can also set your own image and play with background display options.

Basically that's all you need to modify so far. If you followed the instructions above you must have live website. The rest of the theme can be adjusted using Theme options panel and page options.

Now let's navigate to Appearance -> Theme Options. It gives you control over most of theme settings from one place. There are quite a lot of parameters here, but luckily the majority of them have default values that suit most of the users. We will take a really closer look at them a bit later. Now just a few words about how it all works to give you an idea of our Settings Inheritance System

IMPORTANT: One of the most important theme features is Settings Inheritance System. You can flexibly control the appearance and behaviour of the whole website and individual pages, posts and categories. You can set individual display styles, sliders, output settings of page components (posts), and many more for the required category or for each post separately. In a couple of words you can set global styles and then change them for each page/post/category individually. These changes will override global styles affecting selected elements and their descendant elements.

How it works

First, you should navigate to Appearance - Theme Options and set global options that will work throughout the whole site. These settings will be default for all categories, pages, and posts of the theme:

As we mentioned above most of global theme settings can be overridden in the categories, pages, and posts. For example, you need to change style of blog stream page for category that contains Portfolio type posts. Navigate to that category, click on edit button and in the bottom of the page change appearance settings according to your needs:

From now on, all the posts in this category and its subcategories will be displayed in the style of "Portfolio (4 columns)". Posts of the rest of categories (unless individual settings were applied) will be displayed as defined in Theme Options. By the way, the remaining settings of the category that were not changed (overridden) will also be inherited from the parent ones. If the settings were not changed here too - from Theme Options.

If you want to change the appearance of individual post in the category you should find that post, click on "edit" button and set custom parameters. You can find "Post options" in the bottom of the post edit page. These parameters will override both category settings and global settins defined in Theme Options panel.

Theme Options

As we mentioned in our previous chapter the theme has Settings Inheritance System. Most of the settings defined in Theme Options work throughout the website and can be overridden later for selected pages/posts/categories. Now, let's review in details each element of Theme Options panel and see how it affects website behaviour and appearance.

NOTICE! In top left corner of Theme options panel you can see Save and Reset buttons. Using this menu you can save your changes or roll back to default settings.

Customization

This section gives you lot's of space for your creativity. You can make a really deep customization of the theme:

Since there are too many options they are subdivided logicaly into several subsections:

General

  • Contact form email - Contact form messages and new user registration notifications will be forwarded to this email address. If left empty, default Wordpress admin e-mail will be used.
  • Select theme skin - allows to select one of available skins, read more in Theme Skins section. By default the theme comes with one skin, but you can add your custom skins if you need.
  • Show theme customizer - Here you can choose to show or not show theme customizer tab for site visitors. On the front end of the theme you can find theme customizer in right menu panel.

  • Show control - shows navigation elements for better browsing/scrolling
  • Show left panel - Left panel contains the list of authors available at the website. By clicking the author you can visist his site(see Wordpress Multisite Setup for details) or just see all his post s on the blog.

  • Show control - shows navigation elements for better browsing/scrolling
  • User roles - this option helps to sort users by roles. Blog posts belonging to users from selected groups will be displayed at your site.
  • Exclude users - here you can fill out the ID's of the users whose posts won't be displayed at blog page(these users will be removed from top users menu panel).
  • Author filter mode - Enables/disables authors filtering mode. This feature is really important as it allows to use the website as a usual blog(if this feature is disabled) or display the posts of only selected authors(if the option is on, admin will be the default author)
  • Select administrator - if your website functions in non multiuser mode the posts of this user will be dispayed by default
  • Theme color(main) - Color used for main theme elements in navigation, social icons, Fontawesome elements ect
  • Theme color(accent) - Secondary theme color used for less important elements like hover effects, blog menu decoration elements etc.
  • Favicon - In this field you can upload the icon to your website(16x16px .png or .ico image)
  • Quick access button - show/hide quick access button allowing to access top and bottom menu items when one of the pages is active, see a screenshot below

  • Your CSS code - here you can add your custom CSS styles.
  • Your HTML/JS code - Adds extra custom html/js code, will be inserted in bottom of the page.
Menu

This section of options panel gives control over main menu look and behaviour.

  • Menu items - when Ajax load mode enabled every page loads it's content in central page block. One of main menu items activates. This option defines one of main menu items which will be active when external page content loads.
  • Initial loading -> Show the menu item - defines default Home page of your website. If this feature is disabled only main menu and footer area will be displayed, this is default option.(works only if Ajax mode is enabled. If your website works in usual standard mode you can select default home page by going to Settings -> Reading -> Home Page).
  • Initial loading -> Menu Items If option above is enabled here you select a page acting as a Home page
  • Front page loading If no page for initial loading is set in Reading Settings -> Front page displays -> A static page -> Front page, short messages list will appear in new element of Home Page. You can set the page you need (in WP Settings above) or simply turn off initial loading of pages. To do that simply set OFF. This parameter will only work for NON-Ajax method
  • Background color set main menu background color
  • Background predefined image - set one of predefined background images for the menu(the images are built in theme)
  • Background image - upload your custom background image for the main menu.
  • Show background image - Show/Show full height/Hide - there are options for background image positioning. When "Show full height" selected the image will stick to the top of the page leaving no blank space.
  • Format menu items - these settings define the look of your main menu. You can select one of built in menu styles.


    • Curve menu style


    • Corner menu style


    • Colored rows menu style


    • Text with images menu style


    • Text with icons menu style
  • Colored rows pointer - if "Colored rows" menu style enabled you can switch this option on tu add menu item pointers.
  • Display the background color of each item - allows to add custom color styles to main menu(navigate to Appearance -> Menus add custom color to menu items

    )
  • Use custom typography for menu allows to set custom font family and font size for main menu items.
Notice! You can combine menu style, background settings and menu colors to reach awesome results. Examples above are just 5 of huge variety of possible main menu variations!

Logo

This group of settings affects logo positioning and formatting. This theme supports logo text, logo description and logo image.

  • Show Logo text - show/hide logo text.
  • Logo text - add logo text here, HTML markup is supported.
  • Show Logo description - show/hide logo description
  • Logo description - add your logo description here, HTML markup is supported
  • Show Logo image - show/hide logo image
  • Logo image - upload logo image using this form.
  • Logo heigt - sets the height of the logo in header
  • Logo alignment you can align logo to left or center, unlike other themes only 2 options are supported.
  • Logo icon (top) - allows to upload logo image to display in top user menu area

Footer

This section gives control over footer area elements.

  • Alignment of widgets in the footer enables/disables entral alignment of footer widget elements. If this option is disables footer widgets will be aligned to the left, if enabled central alignment will be appied.
  • Show Copyright area in footer - enables/disables Footer copyright output
  • Footer copyright text - fill out this text area withyour copyright text, HTML markup is supported.
  • Terms of use text Terms of use link text
  • Terms of use link - add the URL of your Terms of Use page here.
  • Privacy policy text Privacy policy link text
  • Privacy policy link - add the URL of your Privacy policy page here.
Sidebars

  • Custom sidebars - here you can generate custom sidebars that can be later attached to any page of the website. Just add a sidebar, name it and save. Later you can populate it with widgets and assign to any page. See sidebars for details.
  • Show main sidebar - defines the position of main sidebar on the blog page, you can elect between left, right and hide.
  • Select main sidebar - select one of available sidebars to display in main sidebar area
  • Show footer sidebar - enable/disable footer sidebar
  • Select footer sidebar - select one of available sidebars to display in footer
Media

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

  • Substitute standard Wordpress gallery - Do you need to replace the original Wordpress gallery in the body of the post with our slider?
  • Show gallery in the form of tiles - display gallery in a form of tiles, applicable for 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).
  • Gallery popup engine - What popup manager to use for zoomed pictures in the galleries?
  • Theme-styled Standard Wordpress gallery - Substitute standard Wordpress gallery with our theme-styled gallery
  • Substitute audio tags - Do you need to substitute tag <audio> in the post body with special iframe (used for audio files from the server soundclouds)
  • Substitute video tags - Do you need to substitute tag <video> in the post body with special iframe (used for audio files from the server youtube and vimeo)
  • Use MediaElement script for audio and video tags - Do you wan to design tags <audio> and <video> with the popular script MediaElements?
Body Style

  • Body style - The way of page displayed:
    1. boxed - page body is located in 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 zone of limited width by screen center.
  • Background color - Global background color for all pages of the theme
  • Background predefined pattern - One of the built-in theme images filling the background as tile (repeated both vertically and horizontally).
  • Background custom pattern - Here you can upload your own image filling the background as tile (repeated both vertically and horizontally).
  • Background predefined image - One of the built-in theme images used as a fixed background (not repeated).
  • Background custom image - Here you can upload your own image to be used as a fixed background (not repeated).
  • Background custom image position - Here you can select the position of the uploaded image.
Typography

Typography settings for heading and paragraph text.

  • Use custom typography - Use custom font settings or leave theme-styled fonts
  • Heading 1...6, Paragraph text - Font name for the each typography element.
  • Size - Font size (in pixels).
  • Line height - Inter line distance (in pixels).
  • Weight - Font weight: 100 - light (use it only for large font sizes), 400 - normal, 700 - bold, 900 - extra bold. IMPORTANT: Note that selected font support desired weight settings.
  • Style - Font style: "I" - italic, "U" - underline.
  • Color - Text color.

All fonts in this list loaded from Google Web Fonts!

If you are testing the theme on your local computer without internet connection the fonts wont load making site pages load slowly as well.

How to install custom @font-face fonts into the theme?

Blog & Single

This section will let you to flexibly set up the appearence and behavior 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 parametres of separate pages and blog in Appearance - Theme Options - Blog & Single 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 View Full Post - Shows full post content. In multi user site mode works for resumee posts, in single user mode works just as a usual blog with the exception that it displays all post content.
    • Blog Excerpt - show large image and only a brief summary of the post (Excerpt) or the part before tag "Read more"
    • Blog View Full Width - Stretches the post to full width of the page..
    • 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, Full width) - displays post as pictures with hover effect. This description shows up when you hover over the image. All pictures are cropped to the same size. In full width mode stretches portfolio post to page full width.
  • Show filters - Whether to display buttons of posts filtering to select the group of posts belonging to one category or tag.
  • Use as filters keywords - What to use to create buttons of filtration - categories or tags.
  • 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
    • 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).
  • Post excerpt maxlength - How many characters from post excerpt will be displayed in blog streampage (only for Blog style = Excerpt). 0 - don't trim excerpt.
  • Show post title - show/hide blog post title.
  • Show post excerpt - show/hide blog post excerpt(post excerpt length defined above).
  • Show post info - show/hide blog post information.
  • Post info set - if you enabled 'show post info'parameter you can control what post info will be displayed. You can show/hide comments, author, date, category, likes. You can also drag and drop these panels to change the order of these elements on the front end.
  • Style display images in a portfolio - You can select between 4 available image display options: small square, large square, horisontal rectangle, vertical rectangle.
  • Show buttons on social networking subscription - show/hide social network buttons.
  • Show when you hover on the picture additional panel - show/hide view/like/zoom panel when you hover over the post image.
  • Show Breadcrumbs - show/hide breadcrumbs.
Single post (page) parameters

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

  • Frontend editor - his option allows authors registered on your site, edit and delete posts directly on the website's pages.
  • Show featured image before post - Do I 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 info - Whether to display the info area (date, author, categories list) of ​​a single post (page)
  • Show post info set - Allows to turn on/off some post info like author, comments, date, category, likes.
  • 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 post counters - Enable/Disable "Counters" section (with buttons "Views", "Comments", "Likes", etc.) 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 number of columns - How many columns of related posts will be displayed.
  • 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 OR "View more" for dynamic-loading for the next batch of articles (without reloading the page).
  • Blog pagination style - Block with page numbers style: as standard page buttons or scrollable block with page numbers.
  • 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.

Social

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.

  • Twitter, Facebook, Google Plus ... URL - URLs of popular social networks. Only icons with filled URL are displayed in widget "Social".
  • Style social networks - in this specific theme you can select between dark and colored styles.
  • Show social icons color - enable/disable social button color(applied to header and footer social buttons links). In example below we changed color to magenta

  • Social color(in header) - add special color to social links buttons.
  • Show additional button - this option enables additional social button in header.You can assign custom link to this button.

  • Show social share buttons - Wether to display the block with buttons of social networks for
  • Share buttons - Share URLs of popular social networks. If URL not filled - used internal theme URLs (if exists). IMPORTANT: We used fontello icons library, you can use one of existing icons or add your own by suppleing a link.
  • Twitter API keys - In this section, you must specify a username and keys received when registering your application on https://apps.twitter.com.

Service

In this section you can configure miscellaneous theme settings.

  • Ajax loading of content request - use ajax content loading instead of standard page reloading. when this option is enabled new pages will load the content on the current page without refreshing the page.
  • Image dimensions - you can switch between original and retina ready image dimensions here
  • Responsive Layouts - enable/disable responsive layout
  • Notify about new registration - if this option is on you will get notification about new user registration at your website. The message will be sent to default admin email address(if contact email is empty).
  • Enable Update Notifier - this option enbles built in update notifier. If you want to be aware about new theme updates kepp this option turned on.
  • Enable Emailer in admin panel - 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]
  • Enable PO-Composer in admin panel - Do you want to show "PO Composer" item in the menu "Appearance" in the admin panel. This program allows you to edit. PO-files with variants of translation of your website.
  • Remove line breaks around shortcodes - Remove empty paragraphs and line breaks around shortcodes.
  • Google Tags Manager code or Google analitics code - Put here the GTM code from your account to easy manage analitics, remarketing and many other Google tags. Or only Google analitics code. It will be placed at top of page (after open tag body).
  • Google Remarketing code - Put here the Google Remarketing code. It will be placed at bottom of page (before close tag body).

Page Options

Every page, post and category has Options panel allowing to override some of global theme options and add custom look to these elements. To find ths panel simply click on Edit page link and scroll down the page, you will find this panel in the bottom of the page. As you can see on image below not all options can be overridden, just some of them. We wont focus much on this panel as we described it's features above. The main thing you should remember is that this panel sets custom styles and behavours for selected element and nested elements(if any, this can be applied mostly to subcategories in selected category)

Homepage

Person is extremely easy to setup. To build front page you dont have to apply many efforts. In fact this is a pseudo-page that works out of the box and contains no content but just showing header, main menu and footer. To view actual pages you need to click one of menu items or links.

In case you want to create an alternative page showing some information on the front page you should:

  1. Navigate to Pages -> Add page and create a page with actual content
  2. Go to Appearance -> Menus -> Add this page to main menu
  3. Go to Appearance -> Theme Options -> Menu -> Enable initial loading and select the page you've created as a default front page

This will set another alternative front page.

Blog & Portfolio

As a WordPress user you probably know that blog is an extremely handy tool for company news and events page, so it's not just for bloggers. Besides that our themes allow to use it as a great on line portfolio helping to advertise your creativity and this theme demonstrates how to build both portfolio and blog using blog features. To use the blog's functionality in our theme, you need to create a category which contains blog posts, let's call it "Blog". To do this, you need to:

  • Go to Posts -> Categories under the WordPress menu and then click on Add New.
  • Put your Title as usual ("Blog" for example) and save the category
  • When the category is created click on edit button and go to the bottom of the page to Page Options -> Blog and Single . Select desired blog layout in Blog style dropdown menu

  • Save changes.
  • Go to Appearance -> Menus and add Blog vategory to main menu.
  • Go to Posts -> Add Post and create your blog entries. Don't forget to assign them to "Blog" category if you want them to appear on Blog page.

Another cool feature of this theme is "Blog view full post" layout. We used it to create author's Resume pages. It's very easy to create resume page, simple go to category options and select "Blog View Full Post" option as a blog style. So here are few easy step to create a resume:

  1. Create a category for resume posts and select "Bog View Full Post"
  2. Add a post and assign it to this newly created category
  3. This posts will act as authors resume
If you click on author icon in top authors menu you will see his posts. If "Author filtering mode" is disabled this category will simply display full blog posts text.

The procedure of adding portfolio items is practically identical with 2 exceptions:

  1. When you create a category for portfolio items at Page options page select Portfolio layout:

  2. When creating a portfolio post don't forget to add "featured image"(in blog post you may skip this option) - this image will be dispayed as a main portfolio item image:

  3. If selected Portfolio (Full width) layout you ca additionally set post size, simply navigate to Post Options -> Blog and Single -> Straem Page -> Style display images in a portfolio. Here you can select one of desired parameters.

Filter pages

Another great feature of the theme is built in post filters helping to sort posts according to their type of content in a simple and intuitive way. Among other posts you can select pages containing Video only, Gallery Only, Audio Only

Lets see an example how to create a page that contains only posts with Video posts. To do that we will have to use "Video filter" . For pages Audios filter or Galleries filter (if needed) configuration should be done the same way.

Only Videos

Let's set up an "Video only filter" page. To do this, you need to:

  • Go to Pages under the WordPress menu and then click on Add New.
  • Add page Title as usual ("Only Videos" for example)
  • Choose "Only Videos" as the page's template
  • Publish this page.


Now you can add this page to the menu, and users of your website will be able to pick from the entire number of posts only those containing Video posts; If required you will be able to set individual style of the page display, see Page options for details.

Only Audios

Audio Filter page is similar to "Only Reviews"(see above)

Custom pages

Page 404 should be edited manually. For pages Archive pages or Search results (if needed) configuration should be done the same way, see an example below.

Page 404

To edit 404 page you will need any text editor, TextEdit or Notepad will work great but we recommend a bit more professional thinks like Notepad++ or Sublime.

To customize this page you should edit page template file. Open root folder of your theme and find /templates folder. This folder contains post-layout-404.php file. You can open it in any text editor and chage HTML code according to your needs.



When site visitor tries to open a page that does not exist he will see the result of your work.

Archives

To create Archives page go to Pages -> Add New and select Archives template

Publish the page

Click on view page to see the results

Widgets

Person theme comes with main and footer default sidebars. Have a look in Appearance - Widgets.

In Appearance - Theme Options - Sidebars you can create an unlimited number of additional sidebars and populate them with widgets according to your needs.

To add widgets to newly created sidebar go to Appearance -> Widgets and drag and drop widgets to sidebar area:

Person theme has the following custom widgets:

  1. Flickr
  2. Twitter
  3. Popular Posts
  4. Recent Posts
  5. Recent Comments
  6. Advertisement
  7. Log & Social Icons
  8. QR-code

To add a sidebar to page simply go to Pages -> Edit page you want to modify, in the bottom of the page find Sidebars and select a sidebar you want to associate with this page. Click on Update button in top right corner, this will save changes to the page.

Shortcodes

Shortcodes are a cool feature in WordPress that essentially allows you to do some pretty incredible things by just inserting a shortcode into a page or post. Using Shortcodes is a breeze, just insert one where you want the relevant content to show up.

The theme comes pre-packed with a number of shortcodes allowing you to add the info easier.

IMPORTANT: Please make sure to always start new shortcodes from new lines. Most of the time you wont encounter any errors if you don't do that but unfortunately WordPress does mess up the html sometimes. This is true for all shortcodes, but the inline ones like trx_highlight, those are the only ones that don't need a new paragraph.

Please note that almost all the shortcodes allow parameters:

  • id - unique id for element. Allow to address this element form javascript or CSS
  • 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.

Also, note that "on | off" and "yes | no" in values of the parameters are interchangeable! That is, if the shortcode's description indicates that the value of a parameter can be "on" or "off", it means that along with them you can use the "yes" or "no".

Here's a list of the shortcodes included into the theme.

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!
  • 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.
  • 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 counter="off" initial="2"]
[trx_accordion_item title="Item 1"] Maecenas blandit, orci vel pretium posuere, lectus ligula fermentum nibh, nec auctor odio dolor ac justo. Suspendisse egestas fringilla tristique. Curabitur facilisis eros a nunc dictum, quis cursus felis rhoncus. Vivamus in molestie turpis, in porta tellus. Duis euismod turpis vel congue vulputate. [/trx_accordion_item]
[trx_accordion_item title="item 2"] Maecenas blandit, orci vel pretium posuere, lectus ligula fermentum nibh, nec auctor odio dolor ac justo. Suspendisse egestas fringilla tristique. Curabitur facilisis eros a nunc dictum, quis cursus felis rhoncus. Vivamus in molestie turpis, in porta tellus. Duis euismod turpis vel congue vulputate. [/trx_accordion_item]
[trx_accordion_item title="Item 3"] Maecenas blandit, orci vel pretium posuere, lectus ligula fermentum nibh, nec auctor odio dolor ac justo. Suspendisse egestas fringilla tristique. Curabitur facilisis eros a nunc dictum, quis cursus felis rhoncus. Vivamus in molestie turpis, in porta tellus. Duis euismod turpis vel congue vulputate. [/trx_accordion_item]
[/trx_accordion]

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow set up additional decorations for element in CSS stylesheets.

trx_audio

Inserts an audio file.

Parameters:
  • 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). Allow 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. 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.
  • Icon - Specify and icon used for the audio file
  • URL (source) for image file - add custom image to audio file
  • Author content - Add author content
  • Title content - Add audio title content hereaccordion
Examples:
[trx_audio url="http://person.themerex.net/wp-content/uploads/2014/02/laura.mp3" controls="show" autoplay="off" width="100%" top="50"]

trx_author

This shortcode displays author information and avatar image. It works like trx_team but shows information about one author only.

Parameters:
  • Top margin set top margin parameter
  • Bottom margin set bottom margin parameter
  • Element ID - set unique element ID.
  • Element CSS class - add custom css class to the element.
  • Alignment - Set element alignment: none, central, left, right
  • Block size - set block size (in pixels).
  • Author member - set one of existing users names here
  • Name - set author name.
  • Position - set author position.
  • E-mail - set author e-mail.
  • Photo - set author photo.
  • Description - add brief author description.

trx_banner

Inserts a picture - banner with a title. Hovering over the image creates an illusion of movement and adds hover-effect.

Parameters:
  • url or src - (string). URL of an image file
  • title - (string). The text -title that appears when you hover over the image.
  • link - (string). URL of the link that leads you to the banner or header.
  • target - (string). Name the window or frame where the link opens.
  • rel - (string). Gallery Name: group of banners with the same parameter "rel" composes gallery when displaying in a popup window.
  • popup - (string). Opens full-size image in a popup window instead of clicking on the link. The value can be "yes" or "no".
  • align - (string). Press the image to the left or right, and the text following it will flow around it on the opposite side.The value can be "left" or "right".
  • width - (number). Banner's width (in percent or pixels).
  • height - (number). Banner's 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.
Examples:
[trx_banner src="http://person.themerex.net/wp-content/uploads/2014/02/masonry5.jpg" popup="no" title="Title banner" link="http://mysite.net"]Sample banner content[/trx_banner]

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" 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 the one hand, it is rather simple - it just displays the specified number of posts from a given category. But just look how it's doing that! 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. I think you had a chance to make sure of that by the example of creating of many different homepages.

Let's examine its parameters more carefully:
  • Post output style - (string). Block display style:
    • regular
    • date
    • image_large or image_medium or image_small or image_tiny
    • accordion
    • list
    • portfolio(full width)
    • masonry2 or masonry3 or masonry4
  • Categories List - select categories to display in blogger shortcode. You can select one or multiple categories.
  • Number of visible posts - (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)
  • Post IDs list - (numbers). Comma-separated ID posts to be displayed.
  • Post Direction - You can select vertical or horizontal direction
  • Use scroller - Enable/disable scroll bar
  • Show post info block - Show/hide post info block(tag, author, date, etc)
  • Description length - (number). The number of characters to display in description block.
  • More link text - (string). Set your custom text for read more button.
  • Width - (number). The width of the element in pixels or percents.
  • Height - (number). The height of the element in pixels only.
  • Top margin - (number). Top margin in pixels.
  • Bottom margin - (number). Bottom margin in pixels.
  • Left margin - (number). Left margin in pixels.
  • Right margin - (number). Right margin in pixels.
  • Element id - unique id for element. Allow to address this element form javascript or CSS
  • Element 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:

Style "Date" Direction "Vertical"

[trx_blogger count="4" orderby="date" order="desc" style="date" dir="vertical" descr="100" cat="masonry-demo"]

Style "Date" Direction "Horizontal"

[trx_blogger count="4" orderby="date" order="desc" style="date" dir="horizontal" descr="100" cat="masonry-demo"]

Style "Accordion"

[trx_blogger count="4" orderby="date" order="desc" style="accordion" descr="100" cat="masonry-demo"]

Style "image_small" Direction "Horizontal"

[trx_blogger count="4" visible="2" orderby="date" order="desc" style="image_small" dir="horizontal" rating="no" descr="300" cat="masonry-demo"]

Style "image_large" Direction "Horizontal"

[trx_blogger count="4" visible="2" orderby="date" order="desc" style="image_large" dir="horizontal" rating="no" descr="300" cat="masonry-demo"]

trx_button

Creates different types of buttons.

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: small|medium|large. 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 "/includes/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). Do I 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_button type="square" style="light" size="small" icon="icon-code" bottom="20"]Example[/trx_button]
[trx_button type="square" style="dark" size="medium" icon="icon-code" bottom="20"]Example[/trx_button]
[trx_button type="square" style="global" size="large" icon="icon-code" bottom="20"]Example[/trx_button]
[trx_button type="square" style="global" size="small" fullsize="yes" link="#popup_shortcode_1" popup="yes" icon="icon-code"]Get shortcode[/trx_button]

trx_chat

Creates a chat elements

Parameters:
  • border - Can take on|off parameters. This element adds or removed border arount the content of the chat shortcode
  • 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. 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 title="Mike" link="#"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod temporincididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
[/trx_chat]

[trx_chat title="Lisa" link="#"]
Vivamus nec quam nec elit porta dictum. Praesent dignissim eget ligula vel posuere. Proin sed mauris faucibus, euismod erat a, placerat odio.
[/trx_chat]

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_columns count="3"]

[trx_column_item]
1/3
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur
[/trx_column_item]

[trx_column_item]
1/3
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur
[/trx_column_item]

[trx_column_item]
1/3
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur
[/trx_column_item]

[/trx_columns]
[trx_columns count="3"]

[trx_column_item span="2"]
2/3
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Lorem ipsum dolor sit amet, consectetur adipisicing elit
[/trx_column_item]

[trx_column_item]
1/3
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur
[/trx_column_item]

[/trx_columns]

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow set up additional decorations for element in CSS stylesheets.

trx_contact

This shortcode displays content in a form of column and has parameters similar to trx_title shortcode. This shortcodes was used at Contacts page to display a colomn with icon that contains company contact information.

Parameters:
  • Top margin set top margin parameter
  • Bottom margin set bottom margin parameter
  • Element ID - set unique element ID.
  • Element CSS class - add custom css class to the element.
  • Columns(horizontal) - You can set from 1 to 5 horizontal columns here
  • Title - set column title.
  • Icon Color - set icon color
  • Icon background - set icon background.

trx_contact_form

Display Contact form

Parameters:
  • title - (string). The Contact form's title
  • description - (string). The Contact form's description. Displayed under the title.
  • 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.

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. Allow to address this element from javascript or CSS
  • class - class name for element. Allow 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_parallax image="http://person.themerex.dnw/wp-content/uploads/2014/09/person-parallax-7.jpg" style="dark" color="#000000" overlay="0.7" speed="0.2"]
[trx_section class="textured" color="#ffffff"]
[trx_content top="6em" bottom="6em"]
[trx_title type="1" align="center" style="regular" color="#ffffff"]What our happy customers say[/trx_title]
[trx_testimonials style="2" bottom="0"]
[trx_testimonials_item name="Brandoncarr" position="Purchaser" email="wpspace.johnsnow@gmail.com"]
Buy with confidence. This theme is top quality. Find an issue? Worry not, because the support that this team provides is amazing! I would definitely recommend this theme for your next project or any other theme from ThemeREX for that matter. Thanks Irvin!
[/trx_testimonials_item]
[trx_testimonials_item name="Giggles666" position="Purchaser"]
Awesome, thanks for looking out for us ThemeREX. Money well spent.
[/trx_testimonials_item]
...
[/trx_testimonials]
[/trx_content]
[/trx_section]
[/trx_parallax]

In this example, using the shortcode [trx_parallax] we create a section, stretched to the entire screen with asynchronously shifting background image. Inside it, using the shortcode [trx_content], we insert the text content that will be limited in width like the rest of the site's content.

trx_countdown

Creates a block for the countdown - how much time is left until a date (time) in the future.

Parameters:
  • style - (string). Any additional CSS-rules for this block.
  • class - (string). CSS class name for this block.
  • 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.
Examples:
[trx_countdown date="2014-12-31" time="23:59:59"]

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 3. If not specified - use 1.
  • 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.
Examples:
[trx_dropcaps]Consectetur adipisicing elit ...[/trx_dropcaps]
[trx_dropcaps style="2"]Consectetur adipisicing elit ...[/trx_dropcaps]
...
[trx_dropcaps style="3"]Consectetur adipisicing elit ...[/trx_dropcaps]

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. 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_emailer group="Under Constraction" align="center" open="no"] [trx_emailer group="Under Constraction" align="center" open="yes"]

trx_googlemap

Displays Google map at the address you specified

Parameters:
  • address - (string). The address to which you want to display the map
  • latlng - (double,double). The latitude and longtitude coordinates for map center
  • 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. 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_googlemap address="25 Broadway, New York" width="400" height="300" style="greyscale2"]

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_hide selector="#sidebar .calendar"]

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
Examples:
[trx_highlight type="1"]dolore molestiae voluptatum[/trx_highlight]
[trx_highlight type="2"]dolore molestiae voluptatum[/trx_highlight]

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.

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 "/ includes / 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. 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_icon icon="icon-trophy" color="#1e73be" size="36"]
[trx_icon icon="icon-trophy" color="#ffffff" background="round" bg_color="#1e73be" size="36"]
[trx_icon icon="icon-trophy" color="white" background="square" bg_color="#1e73be" size="36"]

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. 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_image url="http://person.themerex.net/wp-content/uploads/2014/09/post-01.jpg" title="This image aligned right" align="right"]

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. 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_infobox style="success" closeable="yes"]
<b>Success Message.</b> Lorem ipsum dolor sit amet.
[/trx_infobox]

[trx_infobox style="info" closeable="yes"]
<b>Info Message.</b> Lorem ipsum dolor sit amet.
[/trx_infobox]

[trx_infobox style="error" closeable="yes"]
<b>Error Message.</b> Lorem ipsum dolor sit amet.
[/trx_infobox]

[trx_infobox style="general" closeable="yes"]
<b>General Message.</b> Lorem ipsum dolor sit amet.
[trx_button type="square" style="global" size="small" fullsize="no" popup="no" top="30"]Buy[/trx_button] [/trx_infobox]

trx_line

It creates the link of the set style

Parameters:
  • style - (string). The line style. It can take one of the following values: none|solid|dashed|dotted|
  • 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. 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_line style="solid"]
[trx_line style="dashed"]
[trx_line style="dotted"]

trx_list

Creates lists of different styles

Parameters:
  • style - (string). List display style. It can take one of the following values​​: unordered|ordered|iconned(you can set custom icon)|arrows|disk. 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). Set one of avaiable icons if 'iconned' style enabled.
  • 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.
  • 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.
Examples:

trx_list_item

Creates one list item in the list

Parameters:
  • title - (string). Indicate the title of the item in the list.(shows as a tooltip)
  • content - (string). add list item content.
  • 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.

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 parameteres 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. 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_parallax image="http://person.themerex.dnw/wp-content/uploads/2014/09/person-parallax-7.jpg" style="dark" color="#000000" overlay="0.7" speed="0.2"]
[trx_section class="textured" color="#ffffff"]
[trx_content top="6em" bottom="6em"]
[trx_title type="1" align="center" style="regular" color="#ffffff"]What our happy customers say[/trx_title]
[trx_testimonials style="2" bottom="0"]
[trx_testimonials_item name="Brandoncarr" position="Purchaser" email="wpspace.johnsnow@gmail.com"]
Buy with confidence. This theme is top quality. Find an issue? Worry not, because the support that this team provides is amazing! I would definitely recommend this theme for your next project or any other theme from ThemeREX for that matter. Thanks Irvin!
[/trx_testimonials_item]
[trx_testimonials_item name="Giggles666" position="Purchaser"]
Awesome, thanks for looking out for us ThemeREX. Money well spent.
[/trx_testimonials_item]
...
[/trx_testimonials]
[/trx_content]
[/trx_section]
[/trx_parallax]

In this example, using the shortcode [trx_parallax] we create a seciton, stretched to the entire screen with asynchronously scrollable background image. Inside it, using the shortcode [trx_content] we insert the text content that will be limited in width like the rest of the site's contents.

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_button type="square" style="light" size="huge" link="#popup_shortcode_1" popup="yes" icon="icon-code"]Get shortcode[/trx_button]

[trx_popup id="popup_shortcode_1"]
Shortcode "Dropcaps" (Style 1)
Shortcode text for example above:
...
[/trx_popup]

trx_price

Creates a block with price for a specified period.

Parameters:
  • money - (string). Money value (dot separated, for example: 49.99).
  • currency - (string). The currency name or sign. For example: $
  • period - (string). The period name. For example: monthly
  • 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_price_data type="price" money="49.99" currency="$" period="monthly"]

trx_quote

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

Parameters:
  • team member - Here you can add a team member or choose "not user" option.
  • URL source - Add image URL if you want the quote to contain an image, we recommend to upload the image 1st into media library.
  • cite - (string). URL of the site with the original.
  • title - The name of cite author.
  • 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 the value of which is the number - the margin in pixels from the top and bottom of the block respectively.
Examples:
[trx_quote title="Steve Jobs"]
Your work is going to fill a large part of your life, and the only way to be truly satisfied is to do what you believe is great work. And the only way to do great work is to love what you do.
[/trx_quote]

trx_resume

This shortcode displays content a single or double columns block. Additionally you can set an icon

General Tab

Parameters:
  • Top margin set top margin parameter
  • Bottom margin set bottom margin parameter
  • Element ID - set unique element ID.
  • Element CSS class - add custom css class to the element.
  • Icon - set element icon
  • Icon color - set icon color.
  • Icon background color - set icon background color
  • Style - 1 or 2 columns.

Tabs parameters

  • Text color - set content text color
  • Resume item content - add content to your resume item

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). Do I 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). Do I 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. 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_section align="right" dedicated="yes" columns="1_2" bottom="30"]

[trx_quote title="Steve Jobs"]
Your work is going to fill a large part of your life, and the only way to be truly satisfied is to do what you believe is great work. And the only way to do great work is to love what you do.
[/trx_quote]

[trx_button type="square" style="light" size="huge" fullsize="yes" link="#popup_shortcode_1" popup="yes" icon="icon-code"]Get shortcode[/trx_button]

[/trx_section]

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. 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_skills type="counter" maximum="1000" layout="columns" count="4"]
[trx_skills_item level="999" title="CSS3" style="1"]
[trx_skills_item level="549" title="HTML5" style="2"]
[trx_skills_item level="174" title="PHP" style="3"]
[trx_skills_item level="68" title="MySQL" style="4"]
[/trx_skills]
[trx_skills type="arc" subtitle="Skills"]
[trx_skills_item level="95" title="JavaScript" color="#1172d3"]
[trx_skills_item level="90" title="CSS3" color="#3487da"]
[trx_skills_item level="80" title="HTML5" color="#589ce0"]
[trx_skills_item level="53" title="PHP" color="#7cb2e7"]
[trx_skills_item level="45" title="MySQL" color="#b7d4f2"]
[/trx_skills]
[trx_skills type="bar" dir="vertical" layout="columns" count="3"]
[trx_skills_item level="98%" title="English"]
[trx_skills_item level="66%" title="Spanish"]
[trx_skills_item level="87%" title="French"]
[/trx_skills]
[trx_skills maximum="100" type="bar" dir="horizontal" layout="rows" count="5"]
[trx_skills_item title="English" level="98%"]
[trx_skills_item title="Spanish" level="66%"]
[trx_skills_item title="French" level="87%"]
[trx_skills_item title="Latin" level="82%"]
[trx_skills_item title="Others" level="76%"]
[/trx_skills]
[trx_skills maximum="100" type="pie" dir="horizontal" layout="columns" count="4"]
[trx_skills_item title="English" level="41%"]
[trx_skills_item title="Spanish" level="56%" color="#dd3333"]
[trx_skills_item title="French" level="66%" color="green"]
[trx_skills_item title="Latin" level="90%" color="orange"]
[/trx_skills]

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow 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 or Royal 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. This theme supports only swipe slider and it's integrated into the theme.
  • interval - (numbers). Slides change interval (in milliseconds: 1000ms = 1s). Default: 5000.
  • ids - (numbers). Comma-separated ID posts to be displayed in the slider.
  • 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. It is allowed to specify several ID's (or slugs) separated with commas.
  • count - (number). The number of posts displayed from the category
  • offset - (number). How many posts to skip before starting output
  • orderby - (string). Posts order by:
    • date - posts ordering by descending of publish date
    • views - posts ordering by descending of views count
    • title - alphabetically posts ordering
    • comments - posts ordering by descending of comments number
    • 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=flex|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=flex|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. 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_slider engine="royal" alias="1" height="500"][/trx_slider] [trx_slider engine="swiper" cat="5" count="3" orderby="date" order="desc" controls="no" titles="no" border="dark"][/trx_slider] [trx_slider engine="flex" cat="5" count="3" orderby="date" order="desc" controls="yes" pagination="yes" titles="slide" links="yes" border="light"][/trx_slider] [trx_slider engine="swiper" cat="5" count="3" orderby="date" order="desc" controls="yes" pagination="yes" titles="no" border="none" height="390"][/trx_slider] [trx_slider engine="swiper" border="dark" controls="yes" pagination="yes" links="yes"]
[trx_slider_item src="http://person.themerex.net/wp-content/uploads/2014/02/slide3.jpg"]
[trx_slider_item src="http://person.themerex.net/wp-content/uploads/2014/02/slide2.jpg"]
[trx_slider_item src="http://person.themerex.net/wp-content/uploads/2014/02/portfolio16x9_13.jpg"]
[/trx_slider]

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow set up additional decorations for element in CSS stylesheets.

trx_table

Displays the table

Parameters:
  • style - (number). The table style from 1 to 4.
  • 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_table style="1"]
Paste here table content, generated on one of many public internet resources, for example:
http://html-tables.com/
or http://tablegen.nfshost.com/
or http://www.impressivewebs.com/html-table-code-generator/
[/trx_table]
[trx_table style="2"]
Paste here table content, generated on one of many public internet resources, for example:
http://html-tables.com/
or http://tablegen.nfshost.com/
or http://www.impressivewebs.com/html-table-code-generator/
[/trx_table]

trx_tabs

Creates blocks with tabs

Parameters:
  • style - (string). You can select style1|style2 options, see the screenshot below to see the difference
  • tab_names - (string). Headlines tabs listed per the sign "|" (vertical bar)
  • initial - (number). The number of previously open tabs (from 1 to the number of tabs)
  • scroll - (string). Create a scrollable area in the each tab: 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. 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_tabs initial="1" tab_names="Tab images 1|Tab images 2" scroll="yes" height="230"]

[trx_tab]
[trx_image url="http://person.themerex.net/wp-content/uploads/2014/03/tab1.jpg" align="left" width="160" right="30"]
[trx_title type="4"]Lorem ipsum dolor sit amet, consectetur[/trx_title]
Proin gravida nibh vel velit auctor aliquet. Aenean sollicitudin, lorem quis
[trx_line style="solid"]
[trx_image url="http://person.themerex.net/wp-content/uploads/2014/03/tab2.jpg" align="left" width="160" right="30"]
[trx_title type="4"]Lorem ipsum dolor sit amet, consectetur[/trx_title]
Proin gravida nibh vel velit auctor aliquet. Aenean sollicitudin, lorem quis
[ trx_line style="solid" ]
...
[/trx_tab]

[trx_tab]
[trx_image url="http://person.themerex.net/wp-content/uploads/2014/03/tab1.jpg" align="right" width="160" left="30"]
[trx_title type="4"]Lorem ipsum dolor sit amet, consectetur[/trx_title]
Proin gravida nibh vel velit auctor aliquet. Aenean sollicitudin, lorem quis
[trx_line style="solid"]
[trx_image url="http://person.themerex.net/wp-content/uploads/2014/03/tab2.jpg" align="right" width="160" left="30"]
[trx_title type="4"]Lorem ipsum dolor sit amet, consectetur[/trx_title]
Proin gravida nibh vel velit auctor aliquet. Aenean sollicitudin, lorem quis
[trx_line style="solid"]
...
[/trx_tab]

[/trx_tabs]

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. Allow set up additional decorations for element in CSS stylesheets.

trx_team

Displays the members of your team (photo with description)

Parameters:
  • count - (number). Number of items in the team block
  • 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_team count="3"]
[trx_team_item user="johndoe"]
[trx_team_item user="johnsnow"]
[trx_team_item name="Jessica Brown" email="jessica.brown@gmail.com" photo="http://mysite.com/wp-content/uploads/2014/06/jessica.jpg" position="manager"]Lorem ipsum dolor ...[/trx_team_item]
[/trx_team]

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow 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)

Parameters:
  • style - (number). Display style of the block: 1 or 2
  • title - (string). Title of the block
  • controls - (string). The presence of the buttons with arrows in the block: bottom|off
  • width - (number). The block's width (in pixels or percents).
  • height - (number). The block's 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.
Examples:
[trx_testimonials style="1" title="Style 1" height="220"]

[trx_testimonials_item name="Brandoncarr" position="Purchaser" email="example@domain.name"]
Buy with confidence. This theme is top quality. Find an issue? Worry not, because the support that this team provides is amazing! I would definitely recommend this theme for your next project or any other theme from ThemeREX for that matter. Thanks Irvin!
[/trx_testimonials_item]
[trx_testimonials_item name="Green2005" position="Purchaser" email="wpspace.marthastewart@gmail.com"]
Best purchase i made in envato. Great Theme!
[/trx_testimonials_item]
[trx_testimonials_item name="Waldo Orlandini" position="Purchaser"]
Hi! I've just check and it work perfectly! Thank you very much for your kindness and for all the work you've done to solve this issue. I'll write about your fantastic support wherever i can. Thanks again.
[/trx_testimonials_item]
...
[/trx_testimonials]
[trx_testimonials style="2" title="Style 2" height="230"]

[trx_testimonials_item name="Brandoncarr" position="Purchaser" email="wpspace.johnsnow@gmail.com"]
Buy with confidence. This theme is top quality. Find an issue? Worry not, because the support that this team provides is amazing! I would definitely recommend this theme for your next project or any other theme from ThemeREX for that matter. Thanks Irvin!
[/trx_testimonials_item]
[trx_testimonials_item name="Green2005" position="Purchaser" email="wpspace.marthastewart@gmail.com"]
Best purchase i made in envato. Great Theme!
[/trx_testimonials_item]
[trx_testimonials_item name="Waldo Orlandini" position="Purchaser"]
Hi! I've just check and it work perfectly! Thank you very much for your kindness and for all the work you've done to solve this issue. I'll write about your fantastic support wherever i can. Thanks again.
[/trx_testimonials_item]
...
[/trx_testimonials]
[trx_testimonials style="3" title="Style 3" height="230"]

[trx_testimonials_item name="Brandoncarr" position="Purchaser" email="wpspace.johnsnow@gmail.com"]
Buy with confidence. This theme is top quality. Find an issue? Worry not, because the support that this team provides is amazing! I would definitely recommend this theme for your next project or any other theme from ThemeREX for that matter. Thanks Irvin!
[/trx_testimonials_item]
[trx_testimonials_item name="Green2005" position="Purchaser" email="wpspace.marthastewart@gmail.com"]
Best purchase i made in envato. Great Theme!
[/trx_testimonials_item]
[trx_testimonials_item name="Waldo Orlandini" position="Purchaser"]
Hi! I've just check and it work perfectly! Thank you very much for your kindness and for all the work you've done to solve this issue. I'll write about your fantastic support wherever i can. Thanks again.
[/trx_testimonials_item]
...
[/trx_testimonials]

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)
  • link_text - (string). Current testimonials text link
  • link - (string). Current testimonials link(href)
  • 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.

trx_title

Generates standard html title tag.

Parameters:

  • type - (number). The title level from 1 to 6
  • style - (string). The title style: regular|iconed.
  • weight - Font weight - 100-900 or normal|bold
  • align - Title alignment: left|center|right|justify.
  • icon - Only used for style="iconed". Contains the icon name.
  • image - Only used for style="iconed". Contains the small image name (from folder "/images/icons").
  • picture - Only used for style="iconed". Contains the any image url.
  • position - Only used for style="iconed". Position of the icon or image: left|right|top.
  • size - Only used for style="iconed". Size of the icon or image: small|medium|large|huge.
  • background - Type of background under the icon or image: none|circle|square.
  • bg_color - Type of background under the icon or image.
  • width - (number). The block's width (in pixels or percents).
  • 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_title type="4" style="iconed" icon="icon-diamond" size="medium" position="left" background="square"]
Title 1 with icon left
[/trx_title]

[trx_title type="4" style="iconed" icon="icon-tools" size="medium" position="left"]
Title 3 with icon left
[/trx_title]

[trx_title type="4" style="iconed" icon="icon-diamond" size="small" position="left" background="square"]
Title 1 with small icon
[/trx_title]

[trx_title type="4" style="iconed" icon="icon-tools" size="small" position="left"]
Title 3 with small icon
[/trx_title]

[trx_title type="3" align="center" style="iconed" picture="http://person.themerex.net/wp-content/uploads/2014/02/playg.png" size="huge"]Title with image on top[/trx_title]

trx_toggles

Creates blocks of type "toggles". Comparing to the "accordion" you can close all the blocks or open more than one.

Parameters:
  • counter - (string). Enumerate headings of elements: 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.
  • 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_toggles top="10"]

[trx_toggles_item title="Lorem ipsum dolor sit amet"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Consectetur adipisicing elit" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Sed do eiusmod tempor" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[/trx_toggles]
[trx_toggles style="2"]

[trx_toggles_item title="Lorem ipsum dolor sit amet" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Consectetur adipisicing elit"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Sed do eiusmod tempor" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[/trx_toggles]
[trx_toggles style="3"]

[trx_toggles_item title="Lorem ipsum dolor sit amet"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Consectetur adipisicing elit" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Sed do eiusmod tempor"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[/trx_toggles]
[trx_toggles style="2" counter="on" large="on"]

[trx_toggles_item title="Lorem ipsum dolor sit amet" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Consectetur adipisicing elit"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[trx_toggles_item title="Sed do eiusmod tempor" open="yes"]
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum.
[/trx_toggles_item]

[/trx_toggles]

trx_toggles_item

Creates one item of the toggles block.

Parameters:
  • open - (string). The initially open this block: yes|no
  • title - (string). Contains the title for the current element as favorite.
  • 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.

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. Allow to address this element form javascript or CSS
  • class - class name for element. Allow set up additional decorations for element in CSS stylesheets.
Examples:
... [trx_tooltip title="Tooltip text"]consectetur adipisicing elit[/trx_tooltip] ...

trx_twitter

Used to create slider with twitter feed.

Parameters:
  • interval - (number). Interval before slides change (in milliseconds). Default value is 7000 (7000ms = 7s)
  • count - (number). Interval before slides change. Default value is 3
  • user, consumer_key, consumer_secret, token_key, token_secret - (string). Parameters from your twitter application. Default values pick up from Theme Options.
  • width - (number). The slider's width (in pixels or percents).
  • height - (number). The slider's 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.
Examples:
[trx_twitter count="5"]

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). Show title bar above the video frame
  • autoplay - (string). Allow 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. 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_video url="http://www.youtube.com/watch?v=636Dp8eHWnM" autoplay="off" title="on" image="http://person.themerex.net/wp-content/uploads/2014/02/video_post.jpg"] [trx_video url="http://www.youtube.com/watch?v=636Dp8eHWnM" height="315"] [trx_video url="http://player.vimeo.com/video/9679622" height="292"]

trx_zoom

Inserts a picture with "zoom" or "lens" effect.

Parameters:
  • url or src - (string). URL of a original image.
  • image - (string). URL of the cover image. If cover image is larger then original image we'll get a "zoom" effect. If the cover image is of the same size, but differ only with сlearness or coloration - we'll get a "lens" effect.
  • border - (string). Whether to display image fringing as a mobile gadget: none|dark|light
  • align - (string). Alignment for the zoom block: left|right|center
  • width - (number). Video frame width in pixels or percent.
  • height - (number). Video frame 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.
Examples:
[trx_zoom url="http://person.themerex.net/wp-content/uploads/2014/02/tablet_1.jpg" over="http://person.themerex.net/wp-content/uploads/2014/02/tablet_3.jpg" border="light" height="310"] [trx_zoom url="http://person.themerex.net/wp-content/uploads/2014/02/tablet_3.jpg" over="http://person.themerex.net/wp-content/uploads/2014/02/tablet_2.jpg" border="light" height="310"] [trx_zoom url="http://person.themerex.net/wp-content/uploads/2014/02/masonry12.jpg" over="http://person.themerex.net/wp-content/uploads/2014/02/masonry12.jpg"]

E-commerce support

The Person is compatible with Easy Digital Downloads e-commerce plugin, making your WordPress site an awesome looking store. The Person makes it extremely easy to get your digital products to start making profit.
You can start selling your digital goods in seconds. The plugin is really good for selling eBooks, graphics, software, scripts, icons and many other products providing great statistics and sales reports.
Besides that you can distribute your freebies and collect your customers email to keep them up to date. You can read more about easy Digital downloads using these links:

Emailer - mass e-mail distribution and collection of subscription lists

Our themes come with another great tool helping you keep in touch with your customers and site visitors. It's a small addon helping to collect emails and send newsletters. If you are running small project it's a great alternative to professional email services like MailChimp or Sendgrid.

WARNING: Before using mass email tool please check if your web hosting provider allows to send mass email. Most of shared web servers stricktly prohibint sending mass emails and can block your account.

WARNING: If you have more than 1000 subscribers we highly recommend using professional mass email services to ensure high deliverability, high open/click rate. Always make sure you are using double opt-in email list, getting too many abuse reports may affect your site SEO. Remember, SPAM is no-no!

ADVICE: To keep your list healthy and up to date we recommend using Email validation service, this is a great tool to filter junk emails if you purchased emails list elsewhere !

Emailer Features:

  • Emailer will help you to automatically create and update mailing lists.
  • You can easily create a mailing list for an arbitrary list of clients, or you can use one of the lists as the basis, completing it with arbitrary set of addresses from a text file.
  • Sent letters can be decorated using a standard WordPress editor.
  • It's possible to add an attachment-file (a document or an archive) to the e-mail.

To enable "Emailer" go to Appearance -> Theme Options and select "Yes" in the field "Enable Emailer in admin panel". You will get a new menu item "Appearance" - "Emailer".

How it works

Distribution lists - shortcode [trx_emailer]

If you want your site visitors to be able to subscribe to any kind of newsletters, simply create a page (post) newsletter description, and add a shortcode [trx_emailer group = "mail_delivery_name"] to it, where mail_delivery_name is a name of the list of subscribers. That's it!

As a result, a subscribtion form will appear on the page you've created above:



where your visitors can leave their e-mail address (with option dbl-in checking):



and after confirmation their email appear in the subscribers list:



Using menu Appearance - Emailer you will do a distibution for this list:

Emailer consists of 2 basic panels:

  • on the left hand - email composer that includes visual text editor, attachment form and subject line.
    NOTICE! We do recommend reading general newsletter guide lines before sending emails, this helps to improve deliverability and not look spammy.
  • on the right - field to select one of the previously created mailing groups. If you want to create a newsletter for an arbitrary list of addresses, in this field you don't have to choose anything, but simply insert the e-mail address list into the next field - "List of recipients". Each address in this field ("List of recipients") must begin from a new line or you must put signs ";" or "" between the addresses.
    If you chose a group form the list, the field List of recipients will display the list of e-mail addresses from that group. IMPORTANT: In this list, you will see only confirmed addresses! Under the list of recipients, you can specify name and e-mail adress of the newsletter sender . If these fields are not filled out, the data are collected from WordPress settings: menu Settings - General.
    To the right from the field of group selection, there is a set of switchers that allow to manage current group:
    • Update - update the list of e-mail addresses when sending an e-mail (if you edited it in the field below)
    • Clear - delete unconfirmed addresses from the list of e-mail addresses when sending an e-mail
    • Deleter - delete the entire group after sending an e-mail

NOTICE! A good practice of email marketing is adding extra paragraph to your privacy policy page covering terms of emails usage.

May the work with your mailings be pleasant, and most importantly, profitable!

PO Composer and MO Generator

Translating WordPress theme may be a serious issue. To be more specific, the localization itself does not cause any problems, but further theme updates may bring some troubles: we get a new .po-file with updated structure. The changes may affect different parts of the file, which requires another translation!

For instance, you bought the theme that includes only the english version. Normally, these are the files "en-EN" or "en-GB" located in the subfolder "languages of the theme folder. You need translation into your native language, e.g. German. You have copied the files "en-GB.po"and "en-GB.mo" inside the folder 'language' and have named them "de-DE.po"and "de-DE.mo" respectively.

Then, you have launched an application for editing .po-files (e.g., POEdit) and translated all strings into German. Congrats! You've done such a huge job!

However, after a while you find out that another update of your theme has been released! You download it and... here comes the most interesting part :( The translation file has changed! Now It has new lines, and some of the old ones changed significantly. How to find out what exactly was changed? Obviously, you don't want to translate it all over again...

Or, you simply want to create translation file for your languange, but you don't have a .po-file editor. Sure, you can edit a .po-file using a regular text editor. But how to get a corresponding .mo-file?

For many customers, these problems become one of the reasons why they prefer not to update their themes. Of course, another good reason is the fact, that users have already made a lot of changes to the theme (logo, style tables etc).

By the way, to make an update of WordPress themes easier, it is not recommended to make changes into the theme files, it is preferable to create a child theme based on your theme, and make all changes there. In that case, after updating of the parent theme, you at least won't lose the changes you've made.
You can read more about child theme in previous chapter or at official WordPress website.

What we offer:

  • "PO Composer" will help you solve one of the problems related to theme update: it will help you easily find new and not changed strings for translation. Basically, it will simply prepare an updated translation file for you, where all the strings you have translated before will be added. If you like, you'll be able to move all translated strings to the end of the file. And to do (to be more precise, to complete) translation will be easy as ABC.
  • Using the "PO Composer" you will also be able to edit any .po-files (both already existing on your server and the ones being uploaded), and then generate corresponding .mo-fiels for them.
  • If the theme is allowed a record to the folder "languages", it will be able to update the .po-file in the folder with the current theme independently!

To enable "PO Composer" navigate to "Appearance -> Theme Options" and select "Yes" in the field "Enable po-composer in admin panel" . You will get a new menu item "Appearance" - "PO Composer".

How it works

Now, you opened the "PO Composer" page in the menu "Appearance - PO Composer". What's next?

PO Composer page

PO composer consists of two major panels. On the left hand you choose a .po file to edit(the file may be located in the parent or child theme , this may be any downloadable file or even the content of your Clipboard); on the right - fields to select. Po-file to be merged with the one selected on the left (if needed). If you do not want to merge files, but only edit one of them - simply do not select anything in the right section.

Let's have a look at options available:

  1. Upload .po-file - This option allows to selcet any .po-file from your computer and upload it for editing.
  2. Edit .po-text - This option allows text of any .po-file into the text field and edit it.
  3. Parent languages/parent_xxx - This option allows to select one of the .po-files in the folder"languages" of the parent theme on your server.
  4. Child languages/child_xxx - This option allows to select one of the .po-files in the folder "languages" of the child theme on your server (this option is available only if the child theme is active at the moment)

If you tick "Move translated strings down" - in the .po-files all translated strings will be moved at the end of the file.

Variants of use:

  1. If you want to edit one of the language files in the folder with parent or child theme:
    In the left block of settings, select an option "parent_xxx" or "child_xxx", where "xxx" is the name of the translation file you want to edit, and then click the button "Load" under the left block.

    Edit language file

    The text of the selected file will appear in the field for editing:

    Edit language file

    You can make changes directly to this file.
    Attention! Editing this file requires high level of expertise. You should know exactly what you are doing and understand that removing any special character will break file structure. Therefore we recommend using simplified and user friendly editor.
    To stay on the safe side switch to the tab "Strings editor"and you will see the list of strings for translation. Below the list, there is a text field for editing current string. You simply scroll through the list and edit string by string. Strings that have been translated appear in the list in a different color. See example below:

    Edit strings list
    When you are through with the editing simply switch back to the tab "Plain text" and click "Update" to generate .mo-file and update the file on the server (please make sure the file and file containing folder have write permissions).

    Update after editing

    After files update you will get download links allowing to download newly generated .PO and .MO files. Please make sure you have set write permissions to 'language' folder and it's subfolders. In this case all files in subfolders will be updates automaticlally . Otherwise you will have to update translation files manually. To find out more about file permissions on your server please contact your web hosting service company.

    Update after editing

  2. Editing the random .po-file:
    In the left block of settings, select the option Upload .po-file and click the button "Upload" below the left block.

    Upload file

    The text of the selected file will appear in the edit box:
    Edit language file

    All further steps are completely similar to those we have described in the previous example.
  3. Editing text from the Clipboard:
    In the left block of settings, select the option Edit .po-text and into the text field insert the text from the Clipboard:

    Edit plain text

    All further steps are completely similar to those we have described in the previous examples (see above).
  4. Merging different versions of translation file:
    For example, you are using the child-theme. You have updated the parent theme, and the folder with the child-theme in the subfolder "languages" contains old language files. You want to update the language file in the child-theme by adding the new and changed strings of the updated theme and keeping all your previously translated strings. On the left, you need to select "parent_xxx", and on the right - "child_xxx" (where "xxx" is the language code) and click the button "Merge":

    Merge files

    The text of the merged file will appear in the edit box:
    Edit merged file

    All further steps are completely similar to those we have described in the previous examples (see above).

Forget the agony with the translation update ;)!

Sources and Credits

This section discloses the sources of various files used within the theme and describes their function. Use this section to gain an understanding on how the theme functions behind the scenes if considering any type of modification.

  • Fonts:
    • "Roboto Slab" (non standard), "Bree Serif" (non standard) and other 40 Google fonts
    • Fontello (non standard, icons set)

All non standard fonts are from Google Web Fonts and Fontello icons set

We have used the pictures from:
http://www.bigstockphoto.com/

All images are copyrighted to their respective owners and not available for download with this theme.

Once again, thank you so much for purchasing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have any questions that are beyond the scope of this help file, please feel free to email via our user page contact form from our Profile Page on ThemeForest. Thank you so much!

ThemeREX