Thank you for choosing The7!
In this Quick Start Guide you will find all required information on how to install the theme and bundled plugins, troubleshoot most common issues and make your site look like the theme demo.
For detailed information on theme usage please visit The7 online user guide.
Furthermore you can use Troubleshooter and Knowledge Base at our Support Portal.
The7 comes with complimentary support. So when all else fails, please do not hesitate to submit a support request via our online Help-Desk. Our support policy is available on this page.
We hope you will enjoy working with The7.
Yours sincerely, Dream-Theme.
Before Getting Started
Due to the amount of features, settings and options available in The7, at first you may find it to be a bit overwhelming (compared to a usual "blog" themes).
For super-easy adaptation, we recommend importing a Pre-made Website and avoiding advanced settings. Very soon you will get the idea behind the theme architecture and will be able to use The7 to its full potential.
Also note, that this Quick Start Guide does not cover basic WordPress usage. If you are a WordPress newbie, please get accustomed with it before proceeding with this manual and the theme!
Here are some links that will help you to become more confident with WordPress:
- First Steps with WordPress (this is one of most complete guides): http://codex.wordpress.org/First_Steps_With_WordPress
- Explanations on most common WordPress terms: http://en.support.wordpress.com/lexicon/
- Best WordPress-related articles for Web Developers (from novices to guru): http://net.tutsplus.com/articles/web-roundups/top-50-wordpress-tutorials/
- Make sure you understand Pages, Posts, Menus, Widgets, Plugins etc.
Theme Installation
Before proceeding, please make sure that following plugins are not installed or deactivated:
- WP-pagenavi;
- WP-less;
- Options Framework;
- any plugin that uses tgmpa (TGM Plugin Activation) and lessc (lessPHP) classes.
Depending on where you purchased The7, download it from Freemius or Envato.
Download on Envato
In order to download the theme from your Envato account, please login, hover over your profile name in the upper right corner and refer to the “Downloads” tab (fig. 1.1):
Find The7 theme in your products list. And click the “Download” link on the right (fig. 1.2):
Don't forget to download the "License certificate & purchase code" file. You will need the purchase code later to activate the theme.
Download on Freemius
In order to download the theme from your Freemius account, please login using the email address you’ve submitted when purchasing the theme. Refer to the “Downloads” tab, find The7 theme in your products list. And click the “Download” link on the right (fig. 1.3):
Don't forget to check the Licenses tab in your Freemius account to copy your license key. You will need this key later to activate the theme.
Uploading theme via WordPress admin panel
- Log in to the WordPress admin area.
- Navigate to Appearance > Themes.
- Select the "Add New" (fig. 2.1):
Fig. 2.1 - Uploading theme. - Use the "Upload" button to upload the installable "dt-the7_v.X.X.X.zip" file, that you have previously downloaded to your computer (fig. 2.2):
Fig. 2.2 - Uploading theme. - Follow the instructions below to activate the theme.
If you were not able to install the theme this way, most probably your server has upload file size limit. The theme installable .zip file is too large to be uploaded via WordPress admin area. You can contact your hosting provider and ask to ease this limit (e.g 16 MB will do).
Alternatively you can read on to learn how to install the theme manually.
Uploading theme via cPanel
If your host offers the cPanel control panel, follow these instructions:
- In cPanel File Manager, navigate to your "themes" folder. If your WordPress is installed in the document root folder of your web server you would navigate to "public_html/wp-content/themes" and if you have WordPress installed in a sub-folder called "wordpress", you would navigate to "public_html/wordpress/wp-content/themes".
- Once you've navigated to the "themes" folder in cPanel File Manager, click on Upload file(s) and upload the installable .zip file.
- Once the .zip file is uploaded, click on it in cPanel, then in the panel to the right, click on "Extract File Contents", and that .zip file will be uncompressed.
- Follow the instructions below to activate the theme.
Uploading theme via FTP
To add a theme via FTP, follow these basic steps:
- Unzip the installable file. You need to preserve the directory structure in the archive when unzipping it.
- Using an FTP client to access your host web server, upload the theme folder ("dt-the7") via FTP into "wp-content/themes/" folder.
- Follow the instructions below to activate the theme.
Activate the theme
To activate The7:
- Navigate to Appearance > Themes.
- From the Themes panel, move the cursor over The7 thumbnail image to see actions available for it:
Fig. 3 - Activating The7. - You can view more information about any theme by clicking the "Theme Details".
- A live preview of The7 theme (using your website's content) can be seen by clicking the "Live Preview".
Attention! If the theme preview is blank, do not activate The7! Please refer to this section of Quick Start Guide to resolve the issue. Otherwise, your site will not be displayed correctly.
- To activate the theme click the "Activate" button.
Troubleshooting
Cannot upload the theme
If you were not able to install the theme via "Appearance > Themes" interface (see fig. 4 above), most probably your server has upload file size limit. The theme installable .zip file is too large to be uploaded via WordPress admin area. You can contact your hosting provider and ask to ease this limit (e.g 16 MB will do) or install the theme manually.
Missing the style.css stylesheet
A common issue that can occur with users new to installing WordPress themes is a "Broken theme and/or stylesheets missing" error message being displayed when trying to upload or activate the theme. This error message does not mean that the theme is broken, it simply means that you are uploading the wrong file.
Please make sure that file you are uploading the installable file. It is called something like "dt-the7_v.X.X.X.zip". Please refer to this section of guide for details.
Blank page / allowed memory size error after The7 activation
Blank page on theme preview or after theme activation, in most cases, is the indication of the so-called memory limit issue. It's the same issue when you're getting the "Allowed memory size of xxxxxxxx bytes exhausted" error. Here's how to solve it:
First and foremost, try to edit the "wp-config.php" file in the root of you WordPress installation. Search for 'WP_MEMORY_LIMIT'. If there is such setting, set the limit to '256MB'. If there's no such setting, add this bit of code before the MySQL settings define( 'WP_MEMORY_LIMIT', '256M' );. Also make sure there's no 'WP_MAX_MEMORY_LIMIT' setting in "wp-config.php" file; or make sure it is not less then '256MB'.
Second, if editing "wp-config.php" did not help, try to add this bit of code in the beginning of ".htaccess" file: php_value memory_limit 256M.
Third, if you get the error even after completing both steps above, it may be that your PHP is configured in CGI or suPHP. In this case instead of ".htaccess", you should create a file called "php.ini" and place this bit of code in it: memory_limit = 256M.
If above steps did not yield any result, please don't hesitate to contact your hosting company support department. Since this is most likely a server-related problem, we will not be able to help you.
Failed to create customization .CSS file
Theme will work fine on the vast majority of correctly installed and configured WordPress sites without any additional setup. However on some (very rear) hosting configurations you can notice that images on your site are not uploading/displaying or theme returns notifications about setting certain CHMOD rules on "uploads" folder (see fig. 6 above). If you are experiencing this issue, please follow these steps to fix it:
- Make sure that theme installed strictly to "your_site/wp-content/themes/" folder.
- The folder "your_site/wp-content/uploads" must be created. On some servers you'll need to set its CHMOD to 755, on others – to 777.
- Please check the upload path is set to default (in Settings > Media or in wp-config.php).
If above steps did not yield any result, please don't hesitate to contact your hosting company support department. Since this is most likely a server-related problem, we will not be able to help you.
404 error on some pages
After theme activation, on some pages you can encounter the "404 Page not found" error. This is a simple one. In WordPress admin area, navigate to Settings > Permalinks and click the "Save Changes" button. This will update the ".htaccess" file to work with custom post types of The7 correctly.
Theme Registration
Immediately after theme activation you will be redirected to the My The7 page (fig. 7.1):
Use your purchase code to register the theme and get access to pre-made websites, premium plugins, one-click updates and more.
Note that in case you want to use your purchase code on other domain name (e.g. when you are moving a site from one domain to another) you'll need to de-register the theme first (fig. 7.2):
Also note that running multiple websites on a single license is a copyright violation (unless you have an Unlimited license from Freemius). In other words, it is a serious legal offence and is strictly prohibited. Remember 1 site = 1 purchased license.
Pre-made Websites
You can import pre-made websites (also called "demo websites", "demo content" or just "demos") via The7 > My The7 interface (see fig. 8).
Plugins
In case you have not installed plugins automatically, you can do it in The7 > Plugins interface. The same interface allows you to update plugins (fig. 9):
After installing the plugin, please don't forget to "Activate" it.
Bulk plugins installation / activation / update actions are also available. However note that this feature may not work correctly on some servers.
The7 White-Label Tool
The7 allows you to change theme name, description, thumbnail and other information to better fit your business purposes. These changes will be preserved during theme and plugins updates.
In order to access the white-label tool, please locate "the7-white-label.zip" installable plugin file in "Developer Tools" folder of full theme package; install the plugin and activate it. Tools > The7 White-Label interface will become available upon plugin activation (fig. 10):
Apart from re-branding the theme in "Theme Branding" section, you can hide The7 menu, theme options and remove "The7" branding from plugins in "General" block.
Note that changing theme name will result in "loss" of already existing theme options.
DO NOT PANIC - you options are safe. Theme have simply switched to a theme options bank that corresponds with a new theme name.
Enable the "Use The7 theme options" setting to make theme switch back to the original theme options bank.
After making changes to the theme branding, you can safely remove "The7 White-Label Tool" plugin - all your changes will be preserved. In case you want to make additional changes - simply install the plugin back again.
What's Next?
Once you've read this Quick Start Guide, installed the theme and made yourself somewhat accustomed with it, you may want to read the full user guide available online. Though we hope (and believe), you'll rarely need it.
If you encounter any issues, you can use Troubleshooter and Knowledge Base at our Support Portal.
If you feel that you cannot resolve the issue yourself or need to ask something about theme feature(s), please do not hesitate to submit a support request via our online Help-Desk. (Make sure that you've read our support policy on this page.)
And, of course, you can grab another copy of The7 for your upcoming projects.
We hope you will enjoy working with The7
and it will be a great help in all your endeavors online!
Yours sincerely, Dream-Theme.