Most of the issues users may experience are related to Server Requirements not respected.
Issues you may encounter, such as demo content importing fails, menu partially not saving, page not rendered correctly and other oddity are related to excessively low PHP configuration limit settings of the server.
Many hosts will try to keep the limits low to save their resources. These values are typically lower if you choose a low budget host.
Before starting, right after installing the theme, check your System Status.
The most important values you need to be compliant are:
- WP Memory Limit: the WP Memory Limit is the maximum amount of memory (RAM) that your site can use at one time. When you reach your Memory Limit, you’ll encounter a fatal error. (read more)
- Max Input Vars: the PHP Max Input Vars is the maximum number of variables your server can use. Lower values can create issues such lost data in your Theme Options, Widgets disappear etc. (read more)
- Extract the archive package downloaded on ThemeForest.
- In your WordPress admin panel, go to "Appearance" > "Themes".
- Select the "Install Theme" tab at the top panel.
- Choose the "Upload" option and upload the retine.zip file.
- Once you activate Retine, you will be redirected to the "Welcome" page that features a System Status table.
There you will see a button to install and activate the required & recommended plugins. If you see any red message about the Server Requirements not fulfilled please fix.
- You must install all the required plugins if you want to import the demo data.
- If you want to import the demo data, it is recommended to decline all plugin page installations to avoid duplicate content.
- Extract the archive package downloaded on Themeforest.
- Via your FTP client, put the "retine" folder in
- Once the upload is complete you can activate Retine theme.
- Follow the instructions from the paragraph above starting at point 5.
Save some time and use our custom installation services.
Activate Wolf Page Builder Extension plugin
Once the theme and plugins are installed you need to activate the Wolf WPBakery Page Builder Extension plugin to unlock all features.
To do so, go into the Appearance > About the Theme panel and click on the "License" tab.
Simply enter your theme purchase code to activate the plugin.
One-Click Demo Import
Retine includes a 3rd party plugin (One-Click Demo Importer), to allow you to import the demo content easily. It is the most used plugin for this purpose.
IMPORTANT: Before attempting to import the demo content, as mentionned in the "Before Getting Started" section, be sure that your server fulfills the minimum Server Requirements.
Successfully importing the data into WordPress is not something we can guaranty at 100% for all users. There are a lot of variables that come into play, over which we have no control. Most of the time, the main issues are bad shared hosting servers.
After installing and activating the theme, you will have a "blank" version of the theme with the defaults options and mods.
Importing the demo data is the easiest way to setup your theme. It will allow you to quickly edit everything instead of creating content from scratch. In Retine, you can install the whole demo content through the "Import Demo Data" panel.
First of all, you must install all the required plugins after theme activation. You may be invited to install default plugin pages. You must decline all plugin page installations to avoid duplicated content. Once all your plugins are installed, go to the "Appearance" > "Import Demo Data" panel, choose your chosen demo and click the "Import" button and wait, it can take a few minutes.
Note that, as the demo content is in English, the Site Language must be set to "English (United States)" in the "Settings" > "General" panel . You will be able to chage it afterwards.
If you any issue importing the demo content using the "One-Click demo Import" plugin, please check the plugin troubleshooting documentation.
Import Demo Content Manually
First, download the demo data files here.
Upload the zip folder and extract it using an archiver (winrar, winzip etc..). You will find 3 files and a folder in the archive.
- content.xml - The file containing all pages, medias etc...
- customizer.dat - The customizer settings
- widgets.wie - The widgets settings
Import the content
- In your admin panel, go to "Tools" > "Import"
- Choose the WordPress option (last one)
- Select the content.xml file
- Hit the "upload file and import" button and follow the instructions
Note that some of our demo data files are huge and you may encounter issues if your server settings are too low, especially max_execution_time, post_max_size, and upload_max_filesize settings (read more).
Import the customizer settings
On theme activation, all Customizer Mods are automatically set just like the demo. Still, you can reset them or upload a different set of Customizer Mods using Customizer Export/Import plugin.
- In your admin panel, go to "Appearance" > "Customize" or click on the "Customize" link in your frontend admin bar
- Navigate to the "Export/Import" tab
- Click the "browse" button and select the customizer.dat file
- Hit the "Import" button
Import the widgets
To import the widget settings you need Widget Importer & Exporter plugin.
- In your admin panel, go to "Tools" > "Widget Export & Import"
- Select the widgets.wie file
- Hit the "Import" button
Import Revolution Sliders
First download the demo data files here.
You will find the demo sliders in the "revslider" folder.
To import a slider, navigate to your admin Slider Revolution panel, click on the "Import Slider" icon and select your chosen slider zip file from the "revslider" folder.
To update Retine automatically, you can install Envato Market plugin.
You will be invited to install and activate this plugin on theme activation, so it is recommended to install it if you want to update the theme automatically.
Once the plugin is installed, simply go in the Envato Market admin panel and follow the instructions to connect your Envato account.
You will get notified in your admin dashboard every time a new version of Retine is available. Simply follow the link in the notification message and update the theme is a single click in the Envato maket plugin page.
Envato Market plugin is a 3rd party plugin developed by the Envato team and we have no control over its development.
Users have reported issues we this plugin recently. In waiting for this to be resolved, you can update the theme manually.
- Go to your ThemeForest download section and re-upload the theme as you did when you purchased it.
- Navigate to your admin "Appearance" > "Themes" panel
- Desinstall the theme
- Re-install the new theme version
You won't lose any of your content or settings by updating the theme this way.
First note that these options are available if you use the default header. This is not relevant you use a content block as header (if the theme supports content blocks).
You can choose how you want to display your header for each post in the "Header Options" below the main text editor.
This will overwrite the "Header Layout" settings from the Customizer.
- By default, the featured image will be used as header background. If no featured image is set, the header image from the customizer header tab will be used (if set). If no featured image and no default header image is found, the header background will be a simple solid default color.
- If you want a different header image than your featured, simply choose the "Image" option in the dropdown field.
- You can also choose a video or a slideshow as header background. In this case, simply set the desired option and fill the fields below accordingly.
For even more flexibility, if you want to replace the in-built header, you can choose to hide the header completely and use a Content Block.
To set a page as "Front page", go in the "WordPress Settings" > "Reading" panel and set the desired page as "Front page".
Create a Custom Home Page Header
Retine offers the possibility to hide the default page header on certain pages using the header Options below your editor. This way, you can set your own custom page header using WPBakery Page Builder or even use Content Blocks to create a custom header for your page.
Full Screen Section
To create a full screen header section for your home page, insert a WPBakery Page Builder "Row" in your page and set the "Full height" option in the section setttings.
Set the background you want for your section and insert any element you want in the row.
Home Page Slider
If you prefer a slider as home page header you can use our "Advanced Slider" WPBakery Page Builder element or the "Revolution Slider".
In this case, no need to set your first section to "Full Height". You will be able to set the slider height in the "Advanced Slider" or "Revolution Slider" settings.
If you want your slider to take the full space in your section, select the "Full Width" option for your row.
We will see more page builder tricks in the WPBakery Page Builder section.
By default, when no pages are set in the WordPress "Settings" > "Reading" panel, your last posts will be displayed on your front page.
But here, we want to set a specific page for our blog.
To do so, create a page with no content and assign it as "Posts page" in the "reading" settings.
This particular page will used to display the blog archives, categories, tags etc...
The Retine blog supports all WordPress post formats. Post Formats allow you to display your posts differently depending on your content. In you post editor page, you can select which post format you want to use in the "Format" box, usually, at the right of your text editor.
It is the typical WordPress post. It will display the title, the featured image (if set) and the content below.
A single image. The featured image will be used, and, on click, will open its full size version in a lightbox.
The theme will look for the first gallery in your post content and use it as featured gallery.
Any gallery or slider will be considered as gallery.
The first video URL will be considered the video.
You can use our Wolf Video Thumbnail Generator plugin to generate a thumbnail from any Vimeo or YouTube video automatically and use it as featured image. The script will look for the first YouTube or Vimeo URL in your post and generate a thumbnail. You should find the “Video Thumbnail” metabox above the “Featured Image” box.
An audio file. You can use the audio shortcode provided by WordPress using the media library ("Add media" button). You can also embed a soundloud song using WordPress embed feature by pasting your song soundcloud URL.
A link to another site. The first URL in your post will be used and your post title will be linked to this URL.
The first quote of your post will be considered as the featured quote.
Typically styled without a title. Similar to a Facebook note update. You can use this post pormat to display an embed tweet.
Same as status format
A chat transcript, like so:
John: foo Mary: bar John: foo 2
There isn't any specific style for the chat post format in Retine.
Split your post
Firs, note that the more tag won't be used if you choose the "Auto excerpt" option in the customizer "Blog" tab or with certain blog layout.
You can split your post to add a "Continue reading →" link on the post index page.
To do so, use the WordPress more tag.
You can find the More Tag button in the first row of the visual editor
Theme settings are the backbone of the theme. They give you full control over your website and allow you to customize the design without modifying a single line of code. There is three type of options you can set in Retine: the Customizer Mods, the Single Page Options and the other Admin "Appeareance" sub-menus available depending on the plugins installed.
The Customizer Mods are responsible for the global appearance of the entire website, unless otherwise specified in Page Options. They are accessible in the “Appearance” > “Customizer” from your admin panel, or directly by clicking on “Customize” in the frontend admin bar.
The Page Options are located inside every page, post, product (or other post type). You can override particular Customizer Mods for single page diversification.
Most of these settings will be available for all post types.
With Retine, you can load any Google font you like and use it for your menu, headings, text etc...
To load Google Fonts:
- Go to the Google Fonts website and select the fonts you like.
- Open the "Families Selected" frame at bottom right of your screen.
Copy the fonts list from the last part of the URL right after "?family="
Go to the "Appearance" > "Font Loader" panel and paste your fonts list.
Now, you will be able to select your Google fonts anywhere in the theme where a “fonts” option is available.
You can also add any Typekit fonts to Retine using Typypekit Fonts for WordPress plugin.
- Install and activate Typypekit Fonts for WordPress plugin.
- Go to "Settings" > "Typekit Fonts" and follow the instructions to import your font kit into your website.
- Go to "Appearance" > "Font Loader" tab add your fonts separated by a "|" (i.e "Adobe Caslon Pro|Acumin Pro").
Now, you will be able to select your Typekit fonts anywhere in the theme where a “font” option is available.
Set a featured image
A post featured image is an image that you can upload to represent your post, page or other post type.
Set a featured image is very simple: In your text editor, click on "set a featured image" (usually the box at the bottom right), upload an image and click on "use as featured image" instead of "insert into post".
Create a gallery
Note that for a theme that uses WPBakery Page Builder, it is even simpler to insert an image gallery WPBakery Page Builder element.
To create a gallery in your post or page, first click on the "Add media" button at the top of your text editor.
When you open the Media Manager, you will be shown the files in your Media Library. If you’d like to create a gallery from those files, then you’re already where you need to be. Just click on "Create a gallery" on the left menu and select the files you’d like to include in your gallery. You can re-order you image as you wish, upload new files, add captions to your images etc...
This WordPress feature allows you to display a media by simply paste its URL in your post.
For exemple, simply paste a youtube video URL into your post. WordPress will automatically turn that into a YouTube embed.
Learn more infos on the WordPress Codex page.
WPBakery Page Builder
Retine comes with a tailored version of WPBakery Page Builder powered by the Wolf WPBakery Page Builder Extension .
This WPBakery Page Builder extension, only available with Retine, adds many additional elements and comes with a custom admin design.
Additionaly, Retine also adds WPBakery Page Builder modules, so you can use WPBakery Page Builder to display your posts integrated in the theme design. We will see that later in this section.
To use WPBakery Page Builder for your page or post, be sure to click on the "Backend Editor" button at the top left of your WordPress text editor to switch to Page Builder mode.
The "Content blocks" feature is an amazing system to create content that you can use as page fragments, or custom header and footer.
Simply create a content block ("Content Block" > "Add New") using WPBakery Page Builder just like a regular page and use it anywhere you want in different pages.
To create an albums index page, you must have Wolf Albums plugin installed.
Once the plugin is installed and activated, you will see a notification in your dashboard inviting you to create a page for your albums.
Simply click on the "Create Page" button and a page will be automatically created and assigned for the "Albums" page.
You can change the page you want to use as "Albums" page at any time in the "Galleries" > "Settings" panel.
This page will be used by WordPress to display your gallery archives pages: the default gallery index page and the category gallery page.
Note that any content in this page will be ignored.
For more flexibility, you can also create any page and use WPBakery Page Builder to display your albums.
Create a gallery for your album
To create an album, click on "Galleries" > "Add new".
Set a title for your album, insert a WPBakery Page Builder gallery element in page builder mode, and set a featured image that will be used as album cover.
Retine comes with custom features to showcase your photos or images, and use your site as a stock images website.
To use this feature, you must have Wolf Photos plugin installed.
Create a Stock Photos Archives Page
To create the main pagefor your stock photos, you must create a page using the "Stock Photos" template.
This page will be used to display the pages for the catgeories, tags, authors, etc...
Photos Catgories & Tags
When you upload a photo, you can choose to assign it to categories or tags. To do that, simply select the photo in the media manager, or in the admin "Medias" panel and write your category and tags in the appropriate fields separated by a comma.
Only images with a category and/or tags assigned will be displayed in the stock images gallery.
This way, your logo, backgrounds or other images that you don't want to feature won't be display.
When the photo is open in the "Attachment details" or "Insert Media" window, the category, tags and custom fields will be updated automatically, so you don't need to hit any "Save" button.
Simply separate each categories and tags by a comma and when they will be saved, you will see that they are automatically lowercased and re-order alphabetically.
If you make a typo when entering your category or tag, it will be saved as new tag or category. That's why it is recommended from time to time to check the "Media" > "Tags" and "Media" > "Categories" panels to remove unwanted terms.
Photos Custom Fields
In addition to the categories and tags, Retine comes with custom fields for you photo to add additional informations on the single photo page.
You can choose to add a source and source URL and choose to allow free download for your original photo or add a "Purchase" link.
When a "Purchase" link is set for your photo, you can choose to redirect the single photo page directly to the URL where the photo can be purchased. It means that when the visitor will click on the thumbnail, it will be sent to your desired page instead of the single photo page.
Additionally, if you use WooCommerc to sell you photo, you can enter the WooCoomerce ID of the product page, so buyers can add the photo directly to their cart from the stock photo gallery.
By default, the original, high-resolution uploaded photo won't be accessible at all. Even when the photo is open in the lightbox, that's a web optimized photo that is viewed and not the original one.
Add a Watermark to your photo
You can choose to add a watermark to your photo for example if you want to use Retine to sell your work.
When uploading an image, a watermarked and renamed version of the file will be created automatically.
To add watermark your image, simply check the option in the custom fields on your image editor page.
If your photo has been uploaded before installing Retine, you will have to regenerate your thumbnails using Force Regenerate Thumbnails plugin.
Add your own watermark image
You can choose your own watermark transparent image in the admin panel > Settings > Watermark.
Once your watermark image is set, you will have to regenerate your image thumbnails using Force Regenerate Thumbnails plugin.
You can choose to regenerate of your photos one by one in the media library panel in list mode.
To create a "Portfolio" page, you must have Wolf Portfolio plugin installed.
Set your Portfolio Archives Page
Once the plugin is installed and activated, you will see a notification in your dashboard inviting you to create a page for your portfolio.
Simply click on the "Create Page" button and a page will be automatically created and assigned for the "Portfolio" page.
You can change the page you want to use as "Portfolio" page at any time in the "Portfolio" > "Settings" panel.
Note that any content in this page will be ignored.
For more flexibility, you can also create another page and use WPBakery Page Builder to display your works.
Add a work to your "Portfolio" page
To add a work to your "Portfolio" page, go to "Portfolio" > "Add New" and fill the "Release Details" box below the text editor. Additionally, you can insert any content to display on your release page.
On work post type, below your text editor, you will find several option for your current work single page.
It is super simple to create a "One-Page" website with Retine.
To create a one-page website there is 2 things you have to do for each WPBakery Page Builder row:
1. First set a unique section name in your WPBakery Page Builder row settings.
Retine comes with WooCommerce integration, which allows you to build your online shop.
If WooCommerce is activated you will find a "Shop" tab in the Retine customizer options. You can set your number of products per page and your shop layout there.
You can also use WPBakery Page Builder to display your products wherever you want.
You can check the complete WooCommerce documentation here:
Retine comes with a wishlist feature for WooCommerce.
To create a "Wishlist" page, you must have Wolf WooCommerce Wishlist plugin installed.
Once the plugin is activated, you will get a notice that invites you to create a page for your wishlist. Simply click on the "Create Page" button and a page will be automatically created with the [wolf_wishlist] shortcode inserted.
To display a Wishlist icon link into your menu, go in the "Customizer" > "Navigation" tab and check the "Add Wishlist Menu Item" option.
All our theme packages include a child theme. A WordPress child theme allows you to apply custom code changes to your site. Using a child theme ensures your customizations will not be overwritten, even if you update the parent theme.
For most cases, you won’t need a child theme if you just want to add a couple of lines of CSS for a style adjustment. You can add custom CSS styles directly in the Customizer "Additional CSS" tab (since WordPress 4.7.2). But if you need more advanced customizations, like more CSS rules to overwrite the styles of the theme or even add your own PHP functions, it is strongly recommended to use a child theme.
How to set up your own Child Theme
Although child themes can be a great way to add custom changes to your theme, they are most often used to customize core code taken from the parent theme. Because of this, please be aware that customizations of this nature fall outside our scope of support, and we will be unable to assist you with any issues that may arise. To use the child theme, find the “themename-child” folder in your theme package and upload it to your
wp-content/themes folder through FTP. As it is mainly made to be edited, we didn’t include it as a zip file, so you will have to install it manually. Once installed and activated, it will automatically inherit all parent theme features, functions, and styles.
Additional RessourcesWordPress Codex on Child Themes How To Create A WP Child Theme video by WPBeginner.com
Custom 404 Page
To set a custom 404 error page you must install and activate 404page – your smart custom 404 error page plugin.
First, create the page that you want to use as 404 page.
Then, simply navigate to "Appearance" > "404 Error Page" panel in your WordPress admin and set the page you just created as your "Page to be displayed as 404 page" in the plugin settings.
That's it! Simple as that. Now all error pages will display the content of this page.
To switch your website in maintenance mode you can download Wolf Maintenance plugin. It is ultra light and ultra simple to use.
Once the plugins installed, while you're working on your website, go in the admin > Tools >"Maintenance" panel and choose the page where you want to redirect all your visitors. For example a coming soon page.
When your website is ready to go, simply set the options to "Disabled" to put your whole website back online.