Cherry WordPress Documentation

Introduction

Thank you for purchasing a WordPress template. This documentation consists of several parts and shows you the entire process of setting up and administering a WordPress Website from scratch.

What is WordPress CMS?

WordPress is a free and open source blogging tool and a content management system (CMS) based on PHP and MySQL. It enables you to build Websites and powerful on-line applications and requires almost no technical skills or knowledge to manage. Many aspects, including its ease of use and extensibility, have made WordPress the most popular Web site software available. Learn More

What is a WordPress template

A WordPress template is a skin for a website built with the WordPress CMS platform. In other words, you can easily change your WordPress Web site appearance by installing a new template in a few easy steps. With all its simplicity, a WordPress template is provided with all the necessary source files and you are free to edit or extend it the way you need.

Files structure

The template package you have downloaded consists of several folders. Let's see what each folder contains:

  • Documentation - contains documentation files.
    • template_instructions.html - the main documentation file. You are right here :)
  • Screenshots - contains template screenshots. Not for production.
  • Sources - contains template source files.
    • psd - template Adobe Photoshop source files (.psd).
  • Theme - contains WordPress theme files.
    • CherryFramework.zip - Cherry Framework theme archive. Contains all theme files. Should be installed through WordPress extension manager.
    • theme####.zip - theme(child-theme) archive. Contains all theme files. Should be installed through WordPress extension manager.
    • sample_data - contains files that can make your WordPress website look like our live demo.
      • sample_data.xml - contains all template sample data (posts, pages, categories, etc.).
      • widgets.json - contains widgets settings.
    • manuall_install - contains files that can make your WordPress website look like our live demo.
      • uploads - contains theme images.
      • theme#####.sql - database backup file (contains theme content).
    • license.txt - contains license details.
  • fonts_info.txt - contains links where the template custom fonts can be downloaded.
  • info.txt - contains instructions on how to extract source files.

Prepare

Before you proceed to setting up your WordPress website, please make sure you are fully prepared. Please complete the following preparation steps:

Editing software

To feel comfortable working with your WordPress template, we recommend that you download all applications required. You can see the list of required software on the template preview page.
Requirements may vary depending on the template, we're going to tell you in general what’s needed:

  1. First of all, you need the right applications to extract the password protected sources_#########.zip archive. You can use WinZip 9+ (Windows) and Stuffit Expander 10+ (Mac).
  2. You may also need Adobe Photoshop application. It’s used to edit .PSD source files and it’s necessary if you want to edit template design graphics and images.
  3. To edit the template source code files, you need some code editor like Adobe Dreamweaver, Notepad++, Sublime Text, etc.
  4. To upload files to the hosting server, you may need an FTP Manager like Total Commander, FileZilla, CuteFTP, etc.

Hosting

As WordPress CMS is a PHP/MySQL based application, you need to prepare a hosting environment to run WordPress.

If you have a live hosting, please make sure it matches WordPress software requirements and is ready to be used for WordPress websites.

Otherwise, you can run WordPress locally on your computer using the local server. To create a local hosting server, please use the localhost applications, such as WAMP, AppServ, MAMP, etc. Any of those can be easily installed as any other program and used to run WordPress.

Please check the tutorials below on how to configure a local development environment:

Getting Started

Engine installation

Download the correct WordPress engine version. At the template preview page, in the requirements section, you can see the required WordPress version. Please make sure you are downloading the correct one.
  1. The WordPress engine can be downloaded from the official website at WordPress.org Download WordPress. In case you need an earlier release, you can click the Release Archive link.
  2. When you are done with the downloading, you need to extract the files from the engine and template packages. To extract the files from the WordPress engine ZIP package, you can use any archive manager that can handle ZIP archives.

    The following tutorials will show you how to extract files on Windows(WinZip) and MAC(StuffitExpander).

  3. After extracting the files, you need to upload the WordPress engine files and folders to your hosting server.

    All these files and folders should be uploaded to your hosting server. The engine files should be uploaded to the PUBLIC_HTML or WWW directory on your server.

    If you don’t see PUBLIC_HTML or WWW directories on your hosting server, please contact your hosting provider and specify where to upload the website files.

    Please check the following tutorials on how to upload files to a server:

  4. At this step you need to create a database which will be used by your WordPress engine.

    You can create a new database using the database management tool from your hosting control panel (usually PhpMyAdmin).

    With the phpMyAdmin tool, you will be able to create a new database in 3 simple steps (check the slides below):

    1. Click the Database button from the top navigation menu to access the database listing.
    2. Input database name into the "Create new database" field.
    3. Click the Create button on the right side.

    Your database can be seen in the database listing. Click on its name to get access to the database.

    • 1. Click the Database button to access the database listing.

    • 2. Input the database name.
      3. Click the Create button.

    • 4. Your database can be seen in the database listing. Click on its name to get access to the database.


    You can also check the detailed video tutorial on How to create a database.


    If you have any issues creating a database, please contact your hosting provider for help and assistance.

    Feel free to check the detailed tutorials below:

  5. In your browser address bar, type your domain name/root to the WordPress files and press Enter. This will start the installation procedure.
  6. Creating a configuration file. The initial WordPress installation screen will notify you that the configuration file is unavailable. Click the Create Configuration File button to create it.
    Creating configuration file.

  7. Inserting database details. You need to input the WordPress database connection details here.
    Inserting database details.

  8. Inserting website details. On the following screen, you should input the website details such as:
    • website title
    • administrator username and password
    • website email address.
    Inserting website details.

  9. When you are done, click the Install WordPress button.
    Install WordPress button.

    If all data has been inserted correctly, you’ll see the Success window with the button to log in to your WordPress administration panel.

Feel free to check the detailed tutorials below:

Theme installation

There are two ways to install the theme: via the WordPress admin panel or via FTP. If one way does not work for you for some reason, you can always try the other one.

Upload via WordPress admin:

The installation process includes two steps: the framework installation and the child theme installation. Both steps are basically identical and easy to follow.

  1. Log in to your WordPress admin panel (add /wp-admin to your domain name in the browser address bar).
  2. Go to the menu Appearance > Themes and click the Install Themes tab.
  3. Click the Browse button and navigate to the unzipped template package on your computer.
  4. Look for a file called CherryFramework.zip. Click on it to select, then click OK.
  5. Click the Install Now button and wait until the installation is complete.
  6. Click the Activate theme link.

For more information, feel free to check the detailed video tutorial on How to install a WordPress theme via admin panel and How to install Cherry framework template.

Congratulations, you have just installed the framework. Now you can proceed to installing the child theme: theme####.zip. The steps are the same:

  1. Go to the menu Appearance > Themes and click the Install Themes tab.
  2. Click the Browse button and navigate to the unzipped template package on your computer.
  3. Look for a file called theme####.zip (where XXXX is the unique number of your theme). Click on it to select, then click OK.
  4. Click the Install Now button and wait until the installation is complete.
  5. Click the Activate link to change the current layout of the site to the theme your purchased.

Congratulations, both the framework and theme have been successfully installed!


If there are problems with installing them via the admin panel, here's the alternative way to do it.
Upload via ftp:

To use this method, you need to have access to your WordPress site files on FTP through the File Manager of your hosting control panel or an FTP client like Filezilla, CuteFTP, Total Commander, etc.

  1. Unzip the CherryFramework.zip and theme####.zip files to any folder on your hard drive (fist, right-click each of the .zip files, select Unzip to… CherryFramework and theme#### accordingly, so you get the two folders called CherryFramework and theme####).
  2. Upload the CherryFramework and theme#### folders to the /wp-content/themes/ directory on your FTP server.
  3. Log in to your WordPress admin panel (add /wp-admin after your domain name in the browser address bar).
  4. Go to the menu Appearance > Themes.
  5. Under the Available Themes section find theme#### and activate it by clicking the Activate button.

Plugin Installation

Once the theme is installed and activated, you will need to install its plugins:

  1. In your WordPress admin panel,  go to the menu Plugins -> Add New.
  2. Click Upload.
  3. Click Browse.
  4. Navigate to the theme####.zip\includes\plugins folder in your template package (theme####.zip should be unzipped).
  5. Select one of the .zip files in this directory and click OK.
  6. Click Install Now.
  7. When the plugin is installed, click Activate.
  8. If there is more than one plugin in the /plugins/ folder, repeat the steps to install and activate all of them.

Theme Plugins:

Cherry Plugin

Attention: Installation and activation of Cherry Plugin is required for the correct work of shortcodes and widgets.

Download: https://github.com/CherryFramework/CherryFramework/raw/master/includes/plugins/cherry-plugin.zip
Description: The Cherry team has already created a Cherry framework that can be reasonably called perfect, but we are always looking for more improvements. Meet the Cherry Plugin. This is an extension for our Cherry framework where we've included all the shortcodes and widgets you will ever need. The plugin is fully compatible with any WordPress theme powered by Cherry Framework. So far, the plugin is a beta release, but we're going to keep on improving it to deliver even more cool features.

Contact Form 7

Download: http://wordpress.org/extend/plugins/contact-form-7/
Description: Contact form for contact page.

Compatible Plugins:

WPML

Download: http://wpml.org/
Description: WPML makes it easy to build multilingual sites and run them.

JigoShop

Download: http://wordpress.org/plugins/jigoshop/
Description: A feature-packed eCommerce plugin built upon WordPress core functionality ensuring excellent performance and customizability.

WooCommerce

Download: http://wordpress.org/plugins/woocommerce/
Description: WooCommerce is a powerful, extendable eCommerce plugin that helps you sell anything. Beautifully.

BuddyPress

Download: http://wordpress.org/plugins/buddypress/
Description: Social networking in a box. Build a social network for your company, school, sports team or niche community.

bbpress

Download: http://wordpress.org/plugins/bbpress/
Description: bbPress is forum software made the WordPress way.

Mingle Forum

Download: http://wordpress.org/plugins/mingle-forum/
Description: Mingle Forum allows you to easily and quickly put a Forum on your WordPress site/blog.

WP Forum Server

Download: http://wordpress.org/plugins/forum-server/
Description: This WordPress plugin is a complete forum system for your wordpress blog.


Sample Data Install

To make your WordPress website look like our live demo, please follow the instructions below. We also suggest you always have a backup .sql file exported from your database.  

  1. Go to the menu Cherry Options > Import.
  2. Follow the steps there. On Step One you will be prompted to upload the file with sample_data.xml extension, which contains all template sample data (posts, pages, categories, etc.). Once you have selected the file, click the Upload File and Import button (If you do not want to install sample data from live demo, you need to skip this step.)

     

  3. After this you will need to select the author for the posts and pages you are importing. Click the Next button to run the process.

    Sample data import process usually takes around 2 minutes, so be patient and wait a bit. Please, don't terminate this process.

  4. On the third step, you will be prompted to upload widgets.json (This file, located in the /theme/sample_data/ folder of the template package, contains widgets settings. Before importing the file, make sure there are no widgets already added to your site: go to the menu Appearance > Widgets, open the widget areas on the right and if there are any widgets, drag and drop them to the left side under Inactive Widgets so that all these widget areas are empty). Once you have selected the file, click the Next button (If you do not want to install widgets settings from live demo, you need to skip this step).
  5. This will allow you to choose what widgets you would like to install from the list. All widgets should be checked if you would like to install them all. Сlick Next to proceed to the next step.
  6. Click the Save Changes button to activate the SEO-optimized permalinks structure.
  7. Congratulations! You have successfully installed your Cherry WordPress Theme. You can look at the theme now.

Manual installation

If you are having problems with installing the sample data, please follow the instructions below.

ATTENTION: Importing the SQL file to your database will overwrite your existing content and website settings. DO NOT import the SQL file if you want to keep the existing content.
NOTE: Always back up your database before performing any modifications.
Please note that the prefix of WordPress database tables should be wp_.

If the database prefix is different, it should be changed according to this manual.

To make your WordPress look like our live demo, please follow the instructions below.

  1. Make sure the theme has been installed according to the following directions.
  2. Copy the"uploads" folder (that is located under the theme/manual_install/ folder of your template package) to the /wp-content/ folder on your FTP.
  3. Open the theme####.sql file that is located in the theme/manual_install/ folder in any text editor (preferably Dreamweaver or Notepad) and replace all instances of "your_website_url_here" with your website URL in the entire document using the Find and Replace tool (hit Ctrl+H hot keys to open this window). E.g.: http://www.mywebsite.com
  4. Please, make sure that you do not have the forward slash "/" sign at the end of the address and the url starts with http://www.
  5. Save your changes and close the file.
  6. Now you can import the dump file with the phpMyAdmin tool or some other database management tool.

If you have problems with manual installation, please read this manual.

If you have installed the theme with the sample data install or manual install and the theme is displayed differently from the Live demo, please open Cherry Options and click "Restore Defaults."
NOTE: Congifure the given settings right after the installation of the theme.

In this template custom Permalinks are used, so the standard paths like http://demolink.org/?p=1 are replaced with http://demolink.org/home, etc. This type of links configuration not only improves the blog followers' experience, but also helps with SEO-optimisation of your site. The advantages and the main features of this link configuration method are covered at http://codex.wordpress.org/Using_Permalinks

Please follow the steps below:
  1. Log in to your WordPress Administration Panel (Dashboard).
  2. Go to the menu Settings > Permalinks.
  3. On the permalinks settings page, please check Custom structure, then copy and paste the following settings /%category%/%postname%/
  4. With that done, click the Save changes button.

If you install the theme with the dump.sql file, the settings will be configured automatically. However, you need to save the current settings by clicking Save changes. Otherwise, some links may not work.


WordPress 3.0 comes with a new menu management panel, which makes building your site’s navigation very easy and flexible.

This theme is registered with two menu locations:

  • Header Menu - in the Header
  • Footer Menu - in the Footer
For more info on how to set up your menu in wp 3.0, see http://codex.wordpress.org/Appearance_Menus_SubPanel.
Note! If the menu does not appear as the live demo, go to Appearance > Menus and select the dropdown "Header Menu."

Cookies are small text files which websites place on visitors’ computers. They’re typically used to identify that particular visitor and provide them with a better experience. Cookies are a crucial part of many website functions which we take for granted.

For instance, it’s usually cookies which allow online shops to remember what items you have in your shopping trolley. They’re also used to keep you logged in to a website, or to provide valuable usage statistics and information to website owners.

If you run a website, it almost certainly uses cookies. Their most likely function is to monitor visitor numbers and behaviours through tools like Google Analytics. They may also be used to display relevant adverts to visitors, or – if you sell online – to power key parts of your online shopping system.

26th May 2012 - The ICO released a change to the enforcement, "implied consent" is now allowed as long as you make it clear where your privacy/cookie policy is.

Following the Cookie Law conditions you can add sufficient modules to your website. Module will display a warning message about the cookies used on your website. You can use the following ones: Cookie Banner, Cookie Notice

Back up and Update

Before updating Cherry Framework, we strongly recommend you make a backup of the current version.

Backup

To do everything correctly, you need to follow a few simple steps:

  1. In your admin panel, open the tab Appearance => Themes.
  2. Then you need to find Cherry Framework in the Available Themes section.
  3. Press the Backup button which is under the Cherry Framework thumbnail.
  4. Wait till the process begins.
  5. …And it’s done.

Now you can find the archive with your framework or child theme in the wordpress/wp-content/themes_backup/ folder.

If some difficulties occur, you can download the archive and re-install the framework via tabs Appearance -> Themes -> Install Themes -> Upload.

Update

To update Cherry Framework, you need to follow these simple steps:

  1. In your admin panel, open the tab Appearance => Themes.
  2. Find Cherry Framework in the Available Themes section.
  3. Press the button Update Now which is under the Cherry Framework links.
  4. Wait till the process begins.
  5. …And it’s done.

Page Templates and Sidebars


ATTENTION: It is necessary to edit styles in the style.less file. Because of options styles are compiled anew and the main-style.css file is rewritten after saving.

Page Templates

  • Default Template (the default page template with a sidebar position)
  • Full Width Page (a page template with one column without a sidebar)
  • Home Page (a page template used for the Home page)
  • Filter Folio 2 cols (a page template for the custom gallery/portfolio posts displayed in 2 columns)
  • Filter Folio 3 cols (a page template for the custom gallery/portfolio posts displayed in 3 columns)
  • Filter Folio 4 cols (a page template for the custom gallery/portfolio posts displayed in 4 columns)
  • Testimonials (a page template to display the testimonial custom posts)
  • FAQs (the page template to display the FAQ posts)
  • Archives (the page template for displaying archives)

Sidebar Position

  • Sidebar - areas located on the right/left side of the pages
  • Footer Area 1,2,3,4 (optional) - areas located at the bottom of the pages

Posts, Categories and Post Formats

Adding category

Review the following article for more information on adding categories: http://codex.wordpress.org/Manage_Categories_SubPanel

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Posts tab.
  3. With that done, click Categories for blog posts.
  4. Type in the name of your new category.
  5. After that, click the Add New Category button.
Click the Publish button.

Creating a Blog post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Posts tab.
  3. Click the Add New tab.
  4. Type in your post content. For more information on adding posts, please check the following link http://codex.wordpress.org/Posts_Add_New_SubPanel.

Choosing a Post Format

Please review the following link for more information on different post formats: http://codex.wordpress.org/Post_Formats.

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Posts tab.
  3. To choose the post format, check the ones listed in the Format box.
Note: Some of these formats have their own options. Their settings will appear under the post editor.

Below is the list of available post formats with their descriptions and settings.

Standard Post Format

Standard Post Format

A regular, standard post has the following fields:

  • Post title - post title
  • Post content - post content
  • Categories - post category(-ies)
  • Tags - post tags
  • Featured Image - post image
  • and other fields which can be enabled under the Screen Options section located at the top right corner.

Aside Post Format

Aside Post Format

This is a simplified regular post version. In other words, it comes with a post content field only and you don't need to fill in the post title and other fields. This is a so called post-note.

Gallery Post Format

The main feature of this post format is the ability to maintain unlimited number of attached images.

Adding a Gallery Post Format:

  1. Click the Add Media button.
  2. To add images from your hard drive, drag and drop your files into the box that appears or click Select Files to choose a picture from your computer to upload.
  3. After the images have finished uploading, you will be shown all the images in your Media Library. Select Uploaded to this post to see attached images.
  4. When you’ve finished editing, you may close Media Library. The uploaded images will be attached automatically.

The gallery post format has all the standard fields (like title, content, categories, etc.) just like the regular post format.

Link Post Format

Link Post Format

After selecting the Link post format, you will get an additional URL field where you need to specify the link (URL) for the target page/resource. The Post title will be used as your link text.

If you fill in the post content field, it will be used as the target page/source description.

Image Post Format

Image Post Format

An Image post format is a post format based on a single image uploaded via the Featured Image option.
Upon selecting the Image Post Format, you will be able to disable the lightbox image feature by selecting the corresponding setting in the Enable Lightbox image option.

Quote Post Format

Quote Post Format

A Quote Post Format serves as a so-called post-citation. It's used to publish quotes.

Upon selecting this post format, you will get an additional The Quote field - basically the body of the quotation and an Author field - the quotation author name.

Audio Post Format

Audio Post Format

Audio Post Format is used for publishing audio content.

Upon selecting this post format, you will get the following additional options:

  • Title - a track title
  • Artist - an audio track performer
  • Audio Format - an audio track format
  • Audio URL - a direct link to the audio track

Video Post Format

Video Post Format

A Video Post Format is used for publishing video content.

Upon selecting this post format, you will get the following additional options:

  • Title - a video clip title
  • Artist - a video clip performer
  • URL #1 - a direct link to a video clip in m4v format
  • URL #2 - a direct link to a video clip in ogv format
  • Embedded Code - used for off-site video embedding, e.g. via youtube, vimeo, etc.

Manual: How to create audio/video post

Creating a slider post

Slides are essentially a custom post type which means that they are different from common posts, such as blog posts. That allows us to manage the content of the site really easily.

Creating a slider post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Slider tab.
  3. And now click the Add New tab.
  4. Insert your slider title.
  5. Upload your image through the Featured Image option (click the Set featured image link).
  6. You can use the following fields for your slider:
    • Caption - the field for the slide caption.
    • URL - the field for the slide URL (you can put an external link here).
  7. When you are done, click the Publish button.

Adding a Portfolio post

Portfolio items are essentially a custom post type http://codex.wordpress.org/Post_Types#Custom_Types which means that they are different from common posts. That allows us to manage the content of the site really easily.

Adding a portfolio post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Portfolio tab.
  3. And now the Add New one.
  4. Fill in all the required fields (title, content).
  5. Upload your image through the Featured Image option (click the Set featured image link).
  6. And click the Publish button.

Choosing Portfolio post format

Creating a portfolio post in this theme allows you to select one of the available post types.

  • Image - a default gallery post format. Displays only the featured image.
  • Slideshow - the project gallery is displayed as a slideshow. It can contain an unlimited number of images uploaded and attached to the post.
  • Grid Gallery - post images are displayed as a gallery. Can contain an unlimited number of images uploaded and attached to the post.
  • Video - in this post type you can embed a video from any video hosting (YouTube, Vimeo, etc.).
  • Audio - selecting this post type, you can embed your audio link.

Adding a Testimonials post

Adding a Testimonials post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Testimonials tab.
  3. Then click the Add New tab.
  4. Fill in all the required fields (title, content).
  5. Upload your image with the help of the Featured Image option (click the Set featured image link).
  6. You can use the following fields for this sort of posts:
    • Name - author's name
    • URL - author's link
    • Info - author's additional info.
  7. Hit the Publish button.

Adding a FAQs post

Adding a FAQs post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the FAQs tab.
  3. And now the Add New button.
  4. Since it is a question/answer type of post, the title of the post is the question and the content is the answer.
  5. Click Publish.

Adding an Our Team post

Adding an Our Team post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Our Team tab.
  3. And now the Add New button.
  4. Fill in all the required fields (title, content).
  5. Upload your image using the Featured Image option (click the Set featured image link).
  6. You can use the following fields for this sort of posts:
    • Position - the position of the person
    • Info - additional information.
  7. Click Publish.

Adding a Clients post

The Clients post type is optional. Your theme may not include it.

Adding a Clients post

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Clients tab.
  3. After that, click the Add New button.
  4. Fill in all the required fields (title, content).
  5. Upload your image with the help of the Featured Image option (click the Set featured image link).
  6. You can use the following fields for this sort of posts:
    • URL - client url
    • Target - The target attribute specifies a window or a frame where the linked document is loaded.
  7. Click Publish.

Portfolio page

Creating a Portfolio page

Creating a Portfolio page

Portfolio pages can be created with the help of the page templates.

  1. Log in to your WordPress Administration Panel (Dashboard).
  2. Click the Pages tab.
  3. Click the Add New tab.
  4. Type in your page name, for example Portfolio page.
  5. Select your page template ( Filter Folio 2 cols, Filter Folio 3 cols or Filter Folio 4 cols in the Page Attributes drop-down menu).
  6. With that done, click the Publish button.

You can create a category portfolio page using the Category Include field. You need to write the slug of the category which you want to be displayed.

Feel free to check out the following tutorial on how to add portfolio page and how to work with portfolio page.

Shortcodes

A shortcode is a powerful content building tool http://codex.wordpress.org/Shortcode. Shortcodes are easy to use. First of all, make sure that the editing mode is set to Visual.

Then please click the button for the shortcodes. After that, select the shortcode you want to insert.


All available shortcodes are conditionally divided into these groups:

  • Dynamic - used for content output (posts, custom post types, tags, etc.)
  • Grid Columns - various columns for grid forming.
  • Elements - additional elements for content forming.
  • Other - additional elements for advanced/complex content forming.

Dynamic

Post Grid
[posts_grid columns="3" rows="3" order_by="date" order="DESC" thumb_width="100" thumb_height="100" meta="yes" excerpt_count="20" link="yes" link_text="more" custom_class="custom_class"]

Description: displays standard and custom posts in table view with a configurable number of columns and rows.


Post List
[posts_list numb="3" thumbs="large" thumb_width="100" thumb_height="100" post_content="excerpt" order_by="date" order="DESC" link="yes" link_text="more" tags="yes" custom_class="custom_class"] 

Description: displays standard and custom posts as on the blog page.


Mini Post Grid
[mini_posts_grid numb="3" thumbs="small" thumb_width="100" thumb_height="100" order_by="date" order="DESC" align="left"]

Description: a more compact version of the [post_grid] shortcode. Displays the images of standard and custom posts with a configurable images size.


Mini Post List
[mini_posts_list numb="3" thumbs="small" thumb_width="100" thumb_height="100" meta="yes" order_by="date" order="DESC" excerpt_count="20"] 

Description: a more compact version of the [posts_list] shortcode. Displays standard and custom posts in list view.


Recent Posts
[recent_posts num="3" post_format="standard" meta="false" thumb="true" excerpt_count="20"]

Description: displays the recent posts which can be configured with the following options (post type, number of posts, post format, excerpt length, button title and others).


Recent Testimonials
[recenttesti num="2" thumb="true"]

Description: displays the specified number of Testimonials custom post type posts, includes the ability to show/hide posts images and manage word count.


Banner
[banner img="#" banner_link="#" title="Title" text="Text" btn_text="Button" target="_self"]

Description: used to display a block with static text and/or image, title, link, etc.


Comments
[recent_comments num="5"]

Description: displays the latest comments.


Post Cycle
[post_cycle num="5" type="blog" meta="false" thumb="true" thumb_width="50" thumb_height="50" effect="slide"]

Description: compact display of different posts in mini-slider view.


Carousel
[carousel num="5" type="blog" thumb="true" thumb_width="120" thumb_height="50" date="yes" author="yes" min_items="3"]

Description: displays the posts in carousel view, has various additional options.


Roundabout
[roundabout title="Title" num="3" type="blog"]

Description: Roundabout is a jQuery plugin that converts a structure of static HTML elements into a highly customizable turntable-like interactive area.


Service Box
[service_box title="Title" icon="icon1" text="Your text" btn_text="Button" btn_link="#" btn_size="normal" target="_self"]

Description: used to display information blocks that include title, icon, text, button. The main feature of this shortcode is the existence of pre-installed icons.


Hero unit
[hero_unit title="Title" text="Text" btn_text="Button" btn_link="#" btn_style="default" btn_size="normal" target="_self"]

Description: used to display major website information, promotions, etc. Usually located on the main website page, right after the header.


Categories
[categories class="plus"]

Description: used to display the tags.


Tags
[tags]

Description: used to display the tags.


Columns

Grid Columns (span1-12)
[span#] [/span#] 

Description: used for the formation of structural grid elements, where # is a number from 1 to 12, which defines the element width.


[row]
[span6] Your Content... [/span6]
[span6] t... [/span6]
[/row]

Note, when forming a grid, you should "wrap" grid elements into [row] shortcode:


Fluid Columns (one_half, one_third...)
[one_half] [/one_half] 

Description: used to form structural grid elements, where the grid elements width is delineated with %.


[row_fluid]
[five_sixth] Your content... [/five_sixth]
[one_sixntent... [/one_sixth]
[/row_fluid]

Note, when forming a fluid grid you should "wrap" grid elements into the [row_fluid] shortcode:


Multiple Columns (75% / 25%, etc.)
[row]
[span8] t... [/span8]
[span4] Your content... [/span4]
[/row]

Multiple Columns shortcodes are used to simplify content forming by inserting the most common grid variants.


Elements

Label
[label style="default"]label[/label]

Description: used to display a label with pre-defined styling.


Highlight
[highlight]Text[/highlight]

Description: used to highlight a chosen text fragment.


Button
[button text="Text" link="#" style="default" size="normal" target="_self" display="inline" icon="no"] 

Description: used to insert a button with various display settings (style, size, icon, etc.).


Dropcap
[dropcap]L[/dropcap] 

Description: used to display a dropped capital letter.


Blockquote
[blockquote] Text... [/blockquote]

Description: used to display a quotation.


Icon
[icon image="#" align="left"]

Description: used to display a simple icon.


Frame
[frame] I'm frame [/frame]

Description: used to display a container, which can maintain various content.


Horizontal rule
[hr] 

Description: used to display a horizontal line.


Small Horizontal rule
[sm_hr] 

Description: used to display an alternative horizontal line with a smaller margin.


Vertical Rule
[vr] 

Description: used to display a vertical line.


Spacer
[spacer] 

Description: used to set vertical spacing between elements.


Progress bar
[progressbar value="20" type="info" grad_type="vertical" animated="no"]  

Description: used to display an indicator of some process completion.


Address
[address] Your address here [/address] 

Description: used as some container for the address.


Clear
[clear] 

Description: used for the re-zeroing of element flow around.


Lists shortcodes (unstyled, check, check2, arrow, arrow2, star, plus, minus)
[check_list] List here ... [/check_list] 

Description: a set of shortcodes used to display various lists stylizations. Each shortcode implements its own marker for the list items.

Other

Video Preview
[video_preview post_url="http://demolink.org/blog/video-post-type/" title="yes" date="yes" author="yes"]

Description: used to insert video preview, which can be loaded from the off-site services (youtube, vimeo) or from your website (self hosted).

Alert Boxes (message, info, success, danger)
[alert_box style="message" close="yes"]Hello, World![/alert_box]

Description: a shortcodes set used to display service messages.


Close icon
[close dismiss="alert"]

Description: used to display the close icon which closes the parent element.


Well
[well size="well-normal"] Your text here... [/well]

Description: used to insert a stylized container.


Small
[small] Your text here... [/small]

Description: used to insert a text block with a smaller font size.


Title Box
[title_box title="Title" subtitle="subtitle text" icon="#"]

Description: used to display double title: the main title text and an additional one.


Tabs
[tabs tab1="Title #1" tab2="Title #2" tab3="Title #3"] [tab1] Tab 1 content... [/tab1] [tab2] Tab 2 content... [/tab2] [tab3] Tab 3 content... [/tab3][/tabs]

Description: used to display content arranged into tabs. Tabs may contain static and dynamic content.


Accordion
[accordions] [accordion title="title1" visible="yes"] tab content [/accordion] [accordion title="title2"] another content tab [/accordion] [/accordions]

Description: used to display an accordion - fold up panels with titles.


Table
[table td1="#" td2="Title" td3="Value"] [td1] 1 [/td1] [td2] some title 1 [/td2] [td3] some value 1 [/td3] [/table]

Description: used to display a table.


Google Map
[map src="#" width="300" height="200"]  

Description: used to display Google maps. To make the shortcode work, you need to insert the desired location link from Google.


Audio / Video

Description: WordPress 3.6 has great support for embedding YouTube and Vimeo videos, but if you want to play a video or audio file, like an MP3 or MP4 file, that has been uploaded to a server, you need to implement some kind of player so that the file would appear as media rather than a link on your site. Read More

The process is similar to inserting an image into your post content:
  1. Add or edit a page or post.
  2. Click in your content where you want the player to appear, then hit Add Media above the content editor.
  3. Click Upload Files.
  4. Upload an audio or video file.
  5. Make sure the file you uploaded is selected, then under Attachment Display Settings, set Embed or Link to "Embed Media Player."
  6. Click Insert into page.

WordPress will have inserted a shortcode for your audio or video that will be replaced with the player.

Maybe you uploaded an audio or video file to another server, for example Amazon S3 or a file hosting service. Just enter the URL to your media file (unlinked) on a line of its own. For example, you want to embed a YouTube video. Simply paste that into your content on a line of its own and the YouTube player will show in its place when you publish. Be sure that the URL is not linked.

http://www.youtube.com/watch?v=mmRPSoDrrFU

That simple line above becomes this:

Plugins and Custom Widgets

Widgets

The following widgets are also used in the theme:

Cherry - Recent Comments

Displays recent comments in a more convenient format. The given widget includes the following options:

  • Title: - Widget Title
  • Number of comments to show: - Number of comments to show.

Cherry - Recent Posts

Displays your recent posts. You can also show custom posts of certain categories and add a read more link. The given Widget contains the following options:

  • Title: - Widget Title
  • Category Slug: - Post Category Slug.
  • Post Format: - Choose Post Format for displaying posts.
  • Post Order: - You can choose the order for displaying posts.
  • Posts per page: - The number of posts to display.
  • Excerpt length (words): - excerpt length (the number of words).
  • Link Text: - the Link Text that is displayed after the Recent Posts.
  • Link Url: - the Link URL that is displayed after the Recent Posts.

Cherry - Advanced Cycle

This multifunctional widget is used to display different post types including the blog posts. Highly customizable, it has the functionality of changing display settings. This widget contains the following options:

  • Title: - Widget Title
  • Posts type: - select posts type
  • Number of posts to show: - the number of posts
  • Sort by: - post selection option
  • Reverse sort order (ascending): - reverse sort order
  • Show number of comments - show the number of comments
  • Show meta - show meta
  • Container class: - wrapper class. Set to featured_custom_posts by default.
  • Show post title - show post title
  • Date as title - for using the date instead of the title
  • Before title: - custom HTML-markup before the title
  • After title: - custom HTML-markup after the title
  • Show post excerpt - show excerpt
  • Excerpt length (words) - excerpt length (the number of words)
  • Excerpt as link - convert excerpt into a link
  • Show "More" link - show link More after the post
  • Link text: - link text
  • Link class: - CSS-class for the More link
  • Show post thumbnail - show thumbnail for a post
  • Width: - image width
  • Height: - image height
  • Thumbnail as link - convert the image into a link
  • Show global link to all posts - Show global link to all posts
  • Link text: - the text of the given link
  • Link URL: - link URL.

Cherry - Social Networks

This is the widget that allows linking to your social network accounts. The widget contains the following options:

  • Title: - Widget Title
  • Facebook URL, Twitter URL, Flickr URL, etc. - the links to your Social Network accounts
  • Display: the way icons are displayed
    • Icons - icons only
    • Labels - text only
    • Both - icons and text.

Manual: How to work with the social icons widget


Cherry - 125x125 Ads

This is the Widget that allows you to show a set of banners. The widget contains the following options:

  • Title: - Widget Title
  • Image Ad link: - path to your banner image
  • Add link: - your banner link.

Cherry - Twitter

This widget allows you to display the latest tweets from your twitter account. The widget contains the following options:

  • Title: - Widget Title
  • Twitter Name: - your twitter name
  • Tweets number: - the number of tweets to show.

Cherry - Flickr

This widget allows you to display photos from your Flickr gallery. It contains the following options:

  • Title: - Widget Title
  • Flickr ID: - your flickr ID
  • Images count: - the number of photos to show
  • Link Text: - the link text under your flickr photos.

Cherry - vCard

This widget allows you to display information about your company or about you. It contains the following options:

  • Title (optional): - Widget Title
  • Street Address: - put your street address here
  • City/Locality: - enter your city or location here
  • State/Region: - enter your state or region here
  • Zipcode/Postal Code: - enter your zipcode or postal code here
  • Telephone: - telephone number
  • Email: - your email.

Cherry Options

The following theme contains the Settings option. These settings allow you to change the theme’s color palette, order of items, turn items on/off and do lots of other things. In order to use these settings, please go to Appearance → Cherry Options.

General

  • Body styling - you can select the body color and the background pattern.
  • Header background color - Header background color.
  • Buttons and links color - Buttons and links color.
  • Body Text - You can choose your preferred font for body text. The following options are available for editing the fonts:
    1. Font size
    2. Line height
    3. Font Family
    4. Font style (normal, bold, italic)
    5. Character Sets (Latin, Greek, Cyrillic, etc.)
    6. Color
  • Note: Font marked with an asterisk (*) means that it will be loaded from the Google Web Fonts library.

  • H1-H6 Headings - You can choose your preferred font for headings and titles. The following options are available for editing the fonts:
    1. Font size
    2. Line height
    3. Font Family
    4. Font style (normal, bold, italic)
    5. Character Sets (Latin, Greek, Cyrillic, etc.)
    6. Color
  • Note: Font marked with * means that it will be loaded from the Google Web Fonts library.

  • Display search box? - show/hide the search bar in the header.
  • Display breadcrumbs? - show/hide the breadcrumbs in the pages.
  • Custom CSS - if you need to add some CSS rules, but you don't want to mess with the main css file, you can use this field. Just insert your new css rules.

Logo & Favicon

  • What kind of logo? - indicates what kind of logo to use, the text one or the image logo.
  • Logo URL - with Image logo selected, you can upload the new image with the help of the 'upload' feature or use any picture from the Media Library.
  • Logo Typography - You can choose your preferred font for the text logo. The following options are available for editing the fonts:
    1. Font size
    2. Line height
    3. Font Family
    4. Font style (normal, bold, italic)
    5. Character Sets (Latin, Greek, Cyrillic, etc.)
    6. Color
  • Note: an asterisk * near the font means that the font will be loaded from the Google Web Fonts library.

  • Favicon - you can upload the new favicon with the help of the 'upload' feature or use any picture from the Media Library.

Slider

Disable Slider

You can switch off the slider.

Slideshow
  • Sliding effect - slider transition effect
  • Number of columns - number of columns
  • Number of rows - number of rows
  • Banner effect - select your banner animation type
  • Pause time - pause time (ms)
  • Animation speed - animation speed (ms)
  • Slideshow - Animate slider automatically?
  • Thumbnails - Display thumbnails?
  • Pagination - Display pagination?
  • Next & Prev navigation - Display next & prev navigation?
  • Display next & prev navigation only on hover? - If 'yes,' the navigation button (prev, next and play/stop buttons) will be visible on hover state only, if 'no,' they will always be visible.
  • Play/Pause button - Display Play/Pause button?
  • Loader - slider loader.
Accordion
  • Slides to display - Select the slides that you want to be displayed on the slider. If no slide is selected, all slides will be displayed.
  • Slideshow - Animate slider automatically?
  • Pause on mouseover - The auto play will pause when you mouse over the slider.
  • Pause time - pause time (ms).
  • Animation speed - animation speed (ms).
  • Animation slowdown - You can choose different types of animation slowdown for transition of slides.
  • Mouse events for transition of slides - You can choose different types of mouse events for transition of slides.
  • Active slide - Set the number of slides that will be active by default. If the value is 0, all slides will be of the same width when a page loads.

Blog

  • Blog Title - your Blog Title used on the Blog page
  • Related Posts Title - your title used on Single Post page for related posts
  • Sidebar position - you can select the position for the sidebar (right or left)
  • Blog image size - the image size (Normal size or Large size) for the Blog page
  • Single post image size - the image size (Normal size or Large size) for the single post page
  • Enable Meta for blog posts? - display meta for posts
  • Enable excerpt for blog posts? - display excerpt for posts
  • View meta of the blog - select the meta block type which will be displayed on the blog and post pages
  • Post publication date - Should the post publication date be displayed?
  • Author of the post - Display the author of the post?
  • Direct link to the post - Should the direct link to the post be displayed?
  • Post categories - Should the post categories be displayed?
  • Tags be displayed - Should the tags be displayed?
  • Number of comments - Should the number of comments be displayed?
  • Number of views - Should the number of views be displayed?
  • Number of likes - Should the number of likes be displayed?
  • Number of dislikes - Should the number of dislikes be displayed?

Portfolio

  • Filter - Portfolio filter.
  • Show title? - Enable or Disable the title for portfolio posts.
  • Show excerpt? - Enable or Disable the excerpt for portfolio posts.
  • Excerpt words - Excerpt length (words).
  • Show button? - Enable or Disable the button for portfolio posts.
  • Layout - Portfolio has different layout modes. You can set and change the layout mode with this option.
  • Portfolio 2 columns items amount - Portfolio items number for Portfolio 2 columns template.
  • Portfolio 3 columns items amount - Portfolio items number for Portfolio 3 columns template.
  • Portfolio 4 columns items amount - Portfolio items number for Portfolio 4 columns template.

The sections 'footer logo,' 'contacts' and 'social' below are optional. Some themes may not include them.

Contacts

  • Street Address - street address.
  • City/Locality - city/location.
  • Zipcode - zipcode.
  • Phone number - phone number.

Social

  • Facebook URL - Facebook URL.
  • Google+ URL - Google+ URL.
  • RSS URL - RSS URL.
  • Pinterest URL - Pinterest URL.
  • Linkedin URL - Linkedin URL.

Shop Beginners Kit

Important! Shop Beginners Kit works only with the Cherry Framework version 2.0 and higher.
If your version is arlier than 2.0, you need to update Cherry Framework.

The Shop Beginners Kit offer can be bought as a bundle with any WordPress theme or separately.

First of all, you need to install and activate either the WooCommerce or Jigoshop plugin and it will be ready to work with your store.

You may download the plugins here:

Jigoshop Plugin: http://wordpress.org/plugins/jigoshop/
WooCommerce Plugin: http://wordpress.org/plugins/woocommerce/

Please note! For normal operation you need only one plugin.
Plugin Installation
  1. In your WordPress admin panel,  go to the menu Plugins -> Add New.
  2. Click Upload.
  3. Click Browse.
  4. Select one of the plugin files in this directory and click OK.
  5. Click Install Now.
  6. When the plugin is installed, click Activate.
If you bought this offer together with the WordPress theme, you need to perform several steps to make sure things work right.

Also, you can install widgets and demo products for your store.

You need to perform the following steps:

  1. Installation of widgets:
    • In the menu, find Cherry Options -> Import
    • Select jigoshop_widgets.json or woocommerce_widgets.json depending on the plugin you’ve chosen. After that, press the button Show Widget Settings (you can skip this step and set up all the necessary widgets manually using the menu option Appearance -> Widgets).
    • Select the widgets you want to install and then press the Import Settings button.
    • Wait until the installation finishes.
  2. Setting up demo products.
    • Select the shop_sample_data.xml file and press the Upload file and Import buttons (you can skip this step and do it later).
    • In the field Import Author, select your user and press the Import Data button.
    • After setting up demo products, press the Finish button. Now your store is ready for further work.

If you decided to add store functionality to the template you previously bought, you need to get additional files that enable compatibility of the Cherry Framework with WooCommerce and Jigoshop plugins.

First of all, you need to acquire the "Shop Beginners Kit" offer, then you need to go through a few more simple steps:

  1. Install and activate WooCommerce or Jigoshop plugins (you need only one of them).
  2. From the folder theme####, copy two files (shop.less and shop.php) into the root folder with your child theme.

Also, you can install widgets and demo products for your store. Please check the instructions above.