Cherry WordPress Documentation

Introduction

Thank you for purchasing WordPress template. This documentation consists of several parts and shows you the entire process of setting up and administering 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 WordPress a template

WordPress template is a skin for website built with WordPress CMS platform. In other words you can easily change your WordPress Web site appearance installing new template in a few easy steps. With all it's simplicity WordPress template is provided with all 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 - 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 Web site please make sure you are fully prepared. Please complete the following preparation steps:

Editing software

To feel comfortable working with WordPress template we recommend you to download all applications required. You can see the list of required software at 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 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 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 local development environment:

Getting Started

Engine installation

Download 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 could be downloaded from the official website at WordPress.org Download WordPress. In case you need earlier release you can click the Release 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 and specify where to upload the website files.

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

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

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

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

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

    Your database can be seen in the database listing. Click on it's name to get access to the database

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

    • 2. Input database name
      3. Click Create button

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


    You can also check 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 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 configuration file. The initial WordPress installation screen will notify you that the configuration file is unavailable. Click Create Configuration File button to create it.
    Creating configuration file.

  7. Inserting database details. Here you need to input the WordPress database connection details.
    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 Install WordPress button.
    Install WordPress button.

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

Feel free to check detailed tutorials below:

Theme installation

There are two ways to install the theme: via the admin panel of WordPress 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:

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

  1. Login 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 till the installtion 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 till the installtion 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 to install them via the admin panel, here's the alternative way to do it.
Upload via ftp:

This way assumes that you have access to your WordPress site files on FTP through the File Manager of your hosting control panel or an FTP client like Filezilla, CutrFTP,. Total Commander etc.

  1. Unzip the CherryFramework.zip and theme####.zip file 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 two folders called CherryFramework and theme####).
  2. Upload the CherryFramework and theme#### folders to the /wp-content/themes/ directory on your FTP server.
  3. Login 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 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 (the theme####.zip should be unzipped).
  5. Select 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 are more than one plugin in the /plugins/ folder, repeat the steps to install and activate all of them.

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 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 Next button to run the process.

    Sample data import process usually takes approximately 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 all these widget areas are empty). Once you have selected the file, click 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 SEO-optimized permalinks structure.

  7. Congratulations! You have successfully installed your Cherry WordPress Theme. You can look 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 backup 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 bellow.

  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.

When you installed theme using sample data install or manual install and theme is displayed not as at 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 way of links configuration can be used not only by our blog followers but will also help 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 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 Header
  • Footer Menu - in Footer
For more info on how to setup your menu in wp 3.0, see http://codex.wordpress.org/Appearance_Menus_SubPanel
Note! If the menu does not appear as the livedemo, go to Appereance > Menus and select the dropdown "Header Menu"

Backup and Update

Before updating Cherry Framework we are strongly suggesting you make a backup of the current version.

Backup

To make things right you need to follow some 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 button Backup which is under the Cherry framework’s 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 may download the archive and re-install framework via tabs Appearance -> Themes -> Install Themes -> Upload.

Update

To update Cherry Framework you need to follow some 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 button Update Now which is under the Cherry framework’s 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 Post tab
  3. With that done, click Categories for blog posts
  4. Type in the name of your new category
  5. With that done, click the Add New Category button
Click the Publish button.

Creating a Blog post

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

Choosing a Post Format

Review the following link for more info on different post formats: http://codex.wordpress.org/Post_Formats

  1. Log into your WordPress Administration Panel (Dashboard).
  2. Click the Post tab
  3. To choose post format, check the ones listed under 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 which 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. Uploaded images will be attached automatically.

The gallery post format has all the standard fields (like title, content, categories etc.) same as 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.

In case you will 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 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 so-called post-citation. It's used to publish a quotation of some person.

Upon selecting this post format you will get an additional The Quote field - basically the body of the quotation and an Author field - 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 custom post types which means that they are different from common posts, such as blog posts, portfolio posts etc. That allows us to manage the content of the site really easy.

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 with the help of the Featured Image option (click the Set featured image link)
  6. You can use the following fields for your slider:
    • Caption -a field for slide caption.
    • URL -a field for slide URL (you can put external link here).
  7. And click the Publish button

Adding a Portfolio post

Portfolio items are essentially custom post types http://codex.wordpress.org/Post_Types#Custom_Types which means that they are different from common posts, such as blog posts, portfolio posts etc. That allows us to manage the content of the site really easy.

Adding a portfolio post

  1. Log in to 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 with the help of 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 featured image.
  • Slideshow - the project gallery is displayed as a slideshow. It can contain unlimited number of images uploaded and attached to the post.
  • Grid Gallery - post images are displayed as a gallery. Can contain unlimited number of images uploaded and attached to the post.
  • Video - by selecting this post type you can embed a video from any video hosting (YouTube, Vimeo etc.).
  • Audio - by 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. And 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 an 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 a 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 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:
    • Position - the position of the person.
    • Info - an additional info
  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 category portfolio page using 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 off all, make sure that the editing mode is set to Visual.

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


All available shortcodes are conditionally divided into the three 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 configurable amount 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: more compact version of [post_grid] shortcode. Displays the images of standard and custom posts with 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: more compact version of [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, posts amount, post format, excerpt length, button title and others).


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

Description: displays specified amount of Testimonials custom post type posts, includes the ability to show/hide posts images and manage words 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 forming of structural grid elements, where # - a number from 1 to 12, which defines element width.


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

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


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

Description: used for forming of structural grid elements, grid elements width is delineated with %.


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

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


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

Multiple Columns shortcodes used to simplify content forming by inserting the most used 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 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 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: shortcodes set used to display various lists stylizations. Each shortcode implements it's 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: shortcodes set used to display service messages.


Close icon
[close dismiss="alert"]

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


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

Description: used to insert stylized container.


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

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


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

Description: used to display double title: main title text and 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 wanted to play a video or audio file, like an MP3 or MP4 file, that has been uploaded to a server, you needed 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, say 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:

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 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: - Link URL that is displayed after the Recent posts.

Cherry - Advanced Cycle

The multifunctional widget is used to display different post types including the blog posts, as well as 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 date usage instead of the title
  • Before title: - custom HTML-markup before Title
  • After title: - custom HTML-markup after 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 link 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.
  • Ad link: - your banner link.

Cherry - Twitter

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

  • Title: - Widget Title
  • Twitter Name: - your twitter name
  • Twitts number: - amount of twitts to show.

Cherry - Flickr

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

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

Cherry - vCard

This widget alllows 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 locality 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 of 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. There are following options 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.

  • H1-H6 Headings - You can choose your preferred font for headings and titles. There are following options 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, whether 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 pic from the Media Library.
  • Logo Typography - You can choose your preferred font for text logo. There are following options 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: * near the font means that 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 pic from the Media Library.

Slider

Disable Slider

You can switch off 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 be visible always
  • Play/Pause button - Display Play/Pause button?
  • Loader - Slider loader
Accordion
  • Slides to display - Select the slides that you want to be displayed on 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 slide that will be active by default. If the value is 0, all slides will be of the same width when page loads.

Blog

  • Blog Title - your Blog Title used on 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 meta block type which will be displayed on 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 view - Should the number of view 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 title for portfolio posts.
  • Show excerpt? - Enable or Disable excerpt for portfolio posts.
  • Excerpt words - Excerpt length (words).
  • Show button? - Enable or Disable button for portfolio posts.
  • Layout - Portfolio has different layout modes. You can set and change the layout mode via this option.
  • Portfolio 2 columns items amount - Portfolio items amount for Portfolio 2 columns template.
  • Portfolio 3 columns items amount - Portfolio items amount for Portfolio 3 columns template.
  • Portfolio 4 columns items amount - Portfolio items amount for Portfolio 4 columns template.

Shop Beginners Kit

Important! Shop Beginners Kit works only with Cherry Framework version 2.0 and higher.
If version is less than 2.0, you may update Cherry Framework.

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 the plugin either WooCommerce or Jigoshop and it will be ready to work with your store.

You may download 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 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 WordPress theme you need to make several steps to make sure things work right.

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

You need make 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 widgets you want to install and then press Import Settings button.
    • Wait till installation finishes.
  2. Setting up demo products.
    • Select shop_sample_data.xml file and press Upload file and Import buttons (you can skip this step and fulfill it later).
    • In the field Import author select your user and press Import Data button.
    • After setting up demo products press Finish button, now your store is ready for further work.

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

First of all you need to acquire "Shop Beginners Kit" offer, than you need to do some 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 route folder with your child theme.

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