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.

Step 2. Theme installation

Now you can proceed to installing the child theme: theme####.zip. The steps are the same:

Go to the menu Appearance > Themes and click the Add New Theme button.

Click the Upload link.

Click the Browse button and navigate to the unzipped template package on your computer.

Look for a file called theme####.zip (where XXXX is the unique number of your theme). Click on it to select, then click OK.

Click the Install Now button and wait until the installation is complete.

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!

Step 3. Sample Data Installation

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.

NOTE: For templates built on Cherry Framework v3.0 or earlier to install Sample data you need to upload XML and JSON files from "sample_data" directory. Images and other media files should be uploaded from "manual_install\uploads" directory. Make sure to upload all images from all subdirectories.

Go to the menu Cherry Plugin > Import Content.

First of all you may see requirements table that shows if you hosting server meets Cherry Plugin requirements. Please contact your hosting provider if there are any warnings.

If all server settings are OK you'll see uploading screen. Open "theme/sample_data" directory from the template package and upload all files to WordPress. You can upload all files selecting them in the "theme/sample_data" directory (CTRL+A or Command+A) and dragging them to the uploading area.

Make sure to upload all files from the sample_data directory including .JSON and .XML files. When upload is done click "Continue Install" button to proceed.

ATTENTION: .JSON and .XML are required to proceed with the sample data installation. Continue Install button will be available only in case both .XML and .JSON files have been uploaded.

Congratulations! You have successfully installed your Cherry WordPress Theme. You can look at the theme now.

Getting Started

Preparation

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:

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).

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.

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:

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.

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.

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.

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.

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

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.

Save your changes and close the file.

Now you can import the dump file with the phpMyAdmin tool or some other database management tool.

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

Install Sample Data via FTP 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.

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."

Unzip the CherryFramework.zip and theme####.zip files to any folder on your hard drive (first, right-click each of the .zip files, select Unzip to… CherryFramework and theme#### accordingly, so you get the two folders called CherryFramework and theme####).

Upload the CherryFramework and theme#### folders to the /wp-content/themes/ directory on your FTP server.

Log in to your WordPress admin panel (add /wp-admin after your domain name in the browser address bar).

Go to the menu Appearance > Themes.

Under the Available Themes section find theme#### and activate it by clicking the Activate button.

Plugin Installation

After you install and activate the theme, you may need to install the additional plugins:

When the theme is activated, on the top left corner you will find the notice to install additional plugins. Follow the Begin installing plugin link.
You can also install the plugins from the Dashboard, navigate to Appearance- > Install Plugins.

Check the required plugins.

In the Bulk Actions drop-down menu select Install and click Apply.

Theme Plugins:

Cherry Plugin

Attention: Installation and activation of Cherry Plugin is required for the correct work of shortcodes and widgets. Cherry Plugin is installed and activated by default on installing Cherry Framework.

Download:https://github.com/CherryFramework/CherryFramework/raw/master/includes/plugins/cherry-plugin.zipDescription: 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.

Back up and Update

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

Backup

You can create a Backup for both CherryFramework and child theme. This can be done in "Cherry Options > Data management" section in WordPress admin panel.

Backup can be easily done clicking "Backup" buttons under Cherry Framework and child theme blocks.
Now you can find the archive with your framework or child theme in the /wp-content/themes_backup/ folder.

You can also download it clicking "Download backup" button. If some difficulties occur, you can re-install the framework via tabs Appearance -> Themes -> Install Themes -> Upload.

Update

To update Cherry Framework, you need to the following:

In your admin panel, open the tab "Cherry Options > Data management".

Click Update button under Cherry Framework block

Wait till the process begins.

Rest Cherry Framework will do by itself.

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.

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

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.

Standard 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.

Aside Post Format

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:

Click the Add Media button.

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.

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.

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:

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:

Add or edit a page or post.

Click in your content where you want the player to appear, then hit Add Media above the content editor.

Click Upload Files.

Upload an audio or video file.

Make sure the file you uploaded is selected, then under Attachment Display Settings, set Embed or Link to "Embed Media Player."

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.

Widgets

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:

Cherry - Instagram

Widget is used to display recent Instagram posts. It contains the following options:

Widget Title: (optional): - Widget Title

User Name: (required field) - Instagram User Name(Widget will work only for users who have full rights opened in Instagram account.)

Number of displayed images: - Number of displayed images(Max value: 20 images.)

Image dimensions: - the size of the displayed image(Large/Thumbnail)

Show image description: - enable/disable image description

Show comments number: - enable/disable comments number

Show likes number: - enable/disable likes number

Show image publication date: - enable/disable image publication date

Show Image URL: - enable/disable Image URL

User account button text: - text profile link Instagram

Custom CSS class: - widget custom class

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.

Layout Style: - you can select layout for Your site(wide/boxes style)

Header styling: - Header background image and fill color.

Buttons and links color - Buttons and links color.

Buttons and links hover color - Buttons and links hover color.

Body Text - You can choose your preferred font for body text. The following options are available for editing the fonts:

Font size

Line height

Font Family

Font style (normal, bold, italic)

Character Sets (Latin, Greek, Cyrillic, etc.)

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:

Font size

Line height

Font Family

Font style (normal, bold, italic)

Character Sets (Latin, Greek, Cyrillic, etc.)

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:

Font size

Line height

Font Family

Font style (normal, bold, italic)

Character Sets (Latin, Greek, Cyrillic, etc.)

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.

Navigation

Menu Typography - You can choose your preferred font for the main menu. The following options are available for editing the fonts:

Font size

Line height

Font Family

Font style (normal, bold, italic)

Character Sets (Latin, Greek, Cyrillic, etc.)

Color

Note: an asterisk * near the font means that the font will be loaded from the Google Web Fonts library.

Delay - delay in milliseconds that defines when the menu hides

Fade-in animation - enable/disable the fade-in animation

Slide-down animation - enable/disable the slide animation

Speed - the speed of the sub-menu expanding

Arrows markup - enable/disable arrows for the menu items that have sub-menus

Mobile menu label - This text is visible in mobile select menu.

Use stickUp menu - Enable this option if you want to use stickUp menu.

Slider

Slider height can be defined in "wp-content/themes/theme###/slider.php". Edit "height" value in $slider_default_params array.

Disable Slider

You can switch off the slider.

Slideshow

Sliding effect - slider transition effect

Sort by parameter - sort retrieved posts by parameter (order by)

Sort order - sort order for posts

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.

Sort by parameter - sort retrieved posts by parameter (order by)

Sort order - sort order for posts

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

Blog layout - choose blog layout

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

Display share button in single post? - display share button in single post

Should images be uploaded on page scroll? - you can enable images load only as you scroll down the page. Otherwise images will load all at once.

Enable excerpt for blog posts? - display excerpt for posts

Button text for blog posts. - button text for blog posts

View meta of the blog - select the meta block type which will be displayed on the blog and post pages

Feedburner URL - Feedburner is a Google service that takes care of your RSS feed. Paste your Feedburner URL here to let the readers see it in your website.

Display Footer menu - enable or disable the footer menu.

Footer Menu Typography - You can choose your preferred font for the footer menu. The following options are available for editing the fonts:

Font size

Line height

Font Family

Font style (normal, bold, italic)

Character Sets (Latin, Greek, Cyrillic, etc.)

Color

Note: an asterisk * near the font means that the font will be loaded from the Google Web Fonts library.

Cookie Policy

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.

For your convenience, we have added a Cookie Banner in Cherry Options.

Display Cookie Banner? - Should the Cookie Banner be displayed?

Text - Text for a Banner content

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

Footer Logo

Logo Image Path - with Image logo selected, you can upload the new image thorugh the 'upload' feature or use any picture from the Media Library.

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 Options

Product title length limit - max number of words, which will shown in product title on catalog page (leave empty for displaying full title)