Cherry4
Introduction
Thank you for downloading Cherry Framework 4. This documentation consists of several parts and covers the entire process of installing and setting up Cherry Framework starting from scratch.
What is Cherry Framework
Cherry Framework 4 is an open source theme framework for WordPress. It has a rich variety of features and functional enhancements that allows to create WordPress websites and themes of any complexity.
Cherry Framework Structure
Cherry Framework is built as a WordPress theme. Let's check what's inside:
-
- assets
- CSS, SCSS and JS files.
-
- content
- page and post template files (.tmpl)
-
- languages
- localizations files.
-
- lib
- framework core.
-
- menu
- menu template files (primay, secondary).
-
- templates
- template files for static areas, system pages, header and footer wrappers etc.
-
- woocommerce
- Cherry Framework compatible WooCommerce file updates.
-
- 404.php
- 404 error page template. Displayed if WordPress can not find the requested page.
-
- base.php
- file specifies the basic structure of pages.
-
- cherry-options.php
- default values for Cherry Framework options.
-
- footer.php
- footer template file.
-
- functions.php
- file contains additional functions that are required for Cherry Framework theme functioning. Also file contains somу WordPress core features enhancements, for example: thumbnails diemsions, path to loxalization files, widgets dimensions etc.
-
- index.php
- main templates file. If your theme use custom template files this file is required.
-
- page.php
- WordPress page template file.
-
- rtl.css
- right-to-left styling.
-
- screenshot.png
- theme screenshot.
-
- single.php
- single post page template. Used to displayed requested post.
-
- style.css
- main stylesheet file. It is required to be present in the theme. Should contain theme info in comment block.
Preparation
Before installing a Cherry Framework, you need to get fully prepared. We recommend that you get the following aspects covered:
Software
Before you even start working with Cherry Framework, you should download the required software. You can check the required software on the template preview page.
Requirements can alter from template to template, so we will list the most important ones:
- First of all, you will need the right software to extract files from the password protected sources_#########.zip archive. You can use WinZip 9 or a later version (if you have Windows OS) or Stuffit Expander 10 or a later version (if you have Mac OS).
- You might also need Adobe Photoshop. It is used to edit the source .PSD files in case you need to change the graphic design and images of the template.
- To edit the template source code, you can use code editors like Adobe Dreamweaver, Notepad++, Sublime Text, etc.
- To upload files to a hosting server, you will need an FTP manager like Total Commander, FileZilla, CuteFTP, etc.
Hosting
As WordPress CMS is a PHP/MySQL platform, you need to have the hosting server prepared for it.
In case you already have a hosting server, you need to check whether it is compatibile with WordPress hosting requirements , in other words, whether you can host a WordPress website with it.
Cherry Framework itself requires Apache or Nginx hosting servers with the following configuration settings:
Recommended Configuration
- In php.ini define the following:
- 'max_execution_time' => 60;
- 'memory_limit' => 128;
- 'post_max_size' => 8;
- 'upload_max_filesize' => 8;
- 'max_input_time' => 45;
- 'file_uploads' => 'on';
- 'safe_mode' => 'off';
- in .htaccess file: 'php_value max_execution_time' => 60;
- in wp-config.php: 'set_time_limit' => 60;
- 1 GB of disk space
- memory limit per process: 64mb (128mb or more recommended)
PHP and MySQL
Minimal required version of PHP is 5.2.4 and MySQL 5. PHP 5.2 is already not safe as contains critical vulnerabilities that can be used to harm your website. Some Cherry Framework extensions will not work with PHP 5.2 and require version 5.4 or later.
Recommended settings are:
- PHP 5.4
- MySQL 5.5 or later
- mod_rewrite
- php fopen
- suPHP
You can also install WordPress on your PC or laptop through a local server. You can use the next software to create a local server: WAMP, AppServ, MAMP, etc. All of these support WordPress and can be installed as regular software.
These tutorials will help you set up the local server: