Zugan - Minimal Portfolio WordPress Theme Documentation

1| Requirements

You need at least WordPress version 4.5+ installed for this theme to work properly. It is strongly recommended that you always use the latest stable version of Wordpress to ensure all known bugs and security issues are fixed. Other requirements:

  • PHP version 7.0 or greater. But for maximum speed, we recommend to use PHP version 7+.
  • MySQL version 5.0.15 or greater.

2| Theme Installation

When you are ready to install a theme, you must first upload the theme files and then activate the theme itself. The theme files can be uploaded in two ways:

  • FTP Upload: Using your FTP client, upload the non-zipped theme folder into the /wp-content/themes/ folder on your server.
  • WordPress Upload: Navigate to Appearance -> Themes -> Add New -> Upload. Go to browse, and select the zipped theme folder. Hit "Install Now" and the theme will be uploaded and installed.

Once the theme is uploaded, you need to activate it. Go to Appearance -> Themes and activate your chosen theme.

After that you need to install and activate the following pre-packaged plugins:

  1. Zugan Core: Required and must install plugin.
  2. RT Framework: Required and must install plugin.
  3. Redux Framework: Required and must install plugin.
  4. RT Demo Importer: Required if you want to import demo contents. You can deactivate it after demo is imported.
  5. Elementor: Recommended. Page builder plugin.
  6. Revolution Slider: Optional. Install if you want to show slider.
  7. Contact Form 7: Optional. Install if you want to use contact form.
  8. Mail Chimp: Optional. Install if you want to use the newsletter subcription option and other mailing system.
  9. WooCommerce: Optional. Install if you want ecommerce/store functionality.
  10. Instagram Feed: Optional. Install if you want show Instagram functionality.

N.B: All plugins must be installed and activated if you want your site to look exactly like demo.

To install these plugins, navigate to Appearance -> Install Plugins and start installation.

3| Importing Demo contents

Want to build your site like the demo? You can do it by only one click!

** Note: Before proceeding, please remember that when you are done with the demo import, all existing settings and contents will be removed and replaced by the demo contents. So it is highly recommended that you should only do this in fresh site. **

First please make sure that Zugan Parent Theme is activated on your site.

From Admin menu, navigate to Tools -> Demo Content Install. Or alternatively, navigate to Plugins -> RT Demo Importer -> Install Demo Contents.

In this page, Click on the Install button for installing the demo.

It will take some time for importing the demo contents. Please note: Some images are replaced with a placeholder image because of licensing.

After importing demo data, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.

If you face any issue, check the Troubleshooting section from here.

3.2| Manual Import

We have provided some sample contents inside "sample-data" directory which comes with your theme package. You have to import those contents.

  • Importing Contents: From Admin menu, navigate to Tools->Import. From there select the "WordPress" and then run the importer(It will ask you to install the importer before if this is your first time). In the next step when file uploading option appears, select the "contents.xml" file from sample-data and start uploading. In next step select the checkbox saying "Download and import file attachments" and click on "Submit". Then it'll start uploading contents eg. pages, posts etc.

  • Importing Widgets: You can import widgets using plugin Widget Importer & Exporter. After installing this plugin, navigate to Tools->Widget Importer & Exporter. In the next step when file uploading option appears, select the "widgets.wie" file from sample-data and start importing.

  • Importing Sliders: From Admin menu, navigate to LayerSlider WP, then click on "Import Sliders" option. In the next step when file uploading option appears, select the "slider.zip" file from sample-data and start importing.

  • Importing options: First open the file "options.json" in any text editor and copy the whole contents. Now from Admin menu, navigate to Appearance -> Zugan Options, then go to import/Export tab. From there click on "Import from file" option. A textbox will appear, paste the copied contents on that textbox and click on "Import" button.

  • More Configurations: This theme comes with many pre-packaged plugins eg. Contact Form 7, Breadcrumb NavXT, AddToAny Share Buttons etc . You should also configuire these plugin settings too as per your needs.

4.1| Sitewise Colors

From Admin menu, navigate to Appearance ->Zugan Options. Then go to General tab.

Choose your preferred primary and secondary color from the color palette.

After changing the settings, Click on Save Changes button.

4.3| Preloader

From Admin menu, navigate to Appearance ->Zugan Options. Then go to General tab

Here you can find the option for enabling/disabling "Preloader" option. Also you can upload your custom preloader image. When uploading image, make sure it's a transparent GIF image.

After changing the settings, Click on Save Changes button.

4.4| Back to Top Arrow

From Admin menu, navigate to Appearance ->Zugan Options. Then go to General tab

Here you can find the option for enabling/disabling "Back to Top Arrow" option. Choose your preferred option

After changing the settings, Click on Save Changes button.

4.7| Multi Column Menu

Multi column menu looks like this:

To make any menu item multi column, you have to add some specific classes in the parent menu item. Here's an example:

Here I used css class mega-menu which turns the submenu items into multi column. Also i used another class hide-header which hides the title "Column 1" and "Column 2" inside menu.

NB: If you can't see the field "CSS Classes", you have to enable it first. To do this, go to the top and follow this screenshot below:

4.10| Typography

You can change the typography of Body and Headers. To do this, go to Appearance -> Zugan Options. Then go to Typography tab.

After changing the Typography settings, Click on Save Changes button.

4.11| Contact & Socials

You can set up your contact and social info which are displayed in Top Bar and Footer. To do this, navigate to Appearance -> Zugan Options. Then go to Contact & Socials tab.

After changing the settings, Click on Save Changes button.

5| Layout Settings

From here you can set default layouts for pages, blog, posts etc. You can find this settings on Appearance -> Zugan Options and then Layout Defaults tab.

This settings is similar for all submenus under "Layout Defaults"

Layout: You can choose various layout types for pages eg. Left Sidebar, Right Sidebar, Full Width.

Content Padding Top: Paddings at the top of page contents. (see image below)

Content Padding Bottom: Paddings at the bottom of page contents.(see image below)

Banner: You can enable or disable banner (see image below).

Breadcrumb: You can enable or disable breadcrumb (see image below).

Banner Background Type: You can choose weather you want a background image or background color for banner.

Banner Background Color/Image: You can select the banner background color or image from here.

6| Layout Settings for Individual Post Types

You can override the above settings for individual post types. For any post types (like Posts, Pages, Case Studies, Team, Portfolio etc), when you go to Add New or Edit page, you can find similar settings like above under the "Layout Settings" box. If you change any settings from here, this will take priority. If you choose default, settings from the Zugan Options -> Layout Defaults (described above) will be used.

7| Blog Settings

Navigate to Appearance -> Zugan Options. Then go to Blog Settings tab. From here you can change Blog/Archive related settings.

Also you can upload an alternave preview image which will be used as featured image when no fetured image exists in some layouts (For example, Blog Layout 2). To do this, go to Appearance -> Zugan Options. Then go to General tab. It'll look like this:

After changing the settings, Click on Save Changes button.

8| Post Settings

Navigate to Appearance -> Zugan Options. Then go to Post Settings tab. From here you can change settings for single post .

After changing the settings, Click on Save Changes button.

9| Error Page Settings

Navigate to Appearance -> Zugan Options. Then go to Error Page Settings tab. Settings will look like this:

This part is well explained in the image below:

After changing the settings, Click on Save Changes button.

10| WooCommerce Settings

Navigate to Appearance -> Zugan Options. Then go to WooCommerce tab. Here you'll find WooCommerce related options:

After changing the settings, Click on Save Changes button.

11| Custom Post Type Settings

We have created several custom post types eg. Case Studies, Team, Portfolio etc. You can change the slug (which is used as part of url) of these custom post types easily. To do this, go to Appearance -> Zugan Options. Then go to General tab. Here you'll find these options:

Also you can set up root/archive pages for these Custom Post Types which will be used as breadcrumb. To do this, navigate to Settings -> Breadcrumb NavXT. In this page, Click on the Post Types tab.

Then select the root pages for Case Studies, Team and Portfolio like the image below. It'll be used as archive page.

12| Team

You can add team members from Team menu. For each team member you'll see the following settings:

For displaying Team members, we have created visual composer elements for you. From Visual Composer, Go to Zugan tab, here you'll see Zugan: Team element.

13| Testimonial

You can add testimonials from Testimonials menu. For each testimonial you'll see the following settings:

For displaying testimonials, we have created visual composer elements for you. From Visual Composer, Go to Zugan tab, here you'll see Zugan: Testimonials element.

14| Service

You can add service from Service menu. For each Service you'll see the following settings:

For displaying service, we have created visual composer elements for you. From Visual Composer, Go to Zugan tab, here you'll see Zugan: service element.

15| Elementor Elements

We have created several Elementor elements for you. You can find them leftside of the page When you edit a page with elementor

16| Built-in CSS Classes (Advanced)

You can use the following built-in css classes if needed:

  • Zugan-primary-color: set primary color
  • Zugan-primary-bgcolor: set primary background color

17.1| Setting up Contact Form

We are using plugin "Contact Form 7" for contact functionality. You can see their documentation for better understanding.

If you don't want to go through all the troubles to check their documentation and just want to use the default contact form we provided with this theme, please at least set up the default emails in contact form settings. (Because if you don't do that, all form submission emails will come to us instead of you). To do that, please follow the steps below:

Step 1: Navigate to Contact, and then click on Contact form 1 link.

Step 2: From this page, click on Mail tab. Here you should set your own email address where you want to receive user submitted forms. Then click on save button.

Step 3: Please submit some dummy forms from Contact page to make sure that it's working properly.

17.3| Translating Theme

You can translate this theme to another language easily. You actually have to translate two things for your website to work properly: "Zugan" theme and "Zugan Core" plugin. This plugin plays a major role in theme functionality, so if you don't translate this plugin along with the theme you can't be able to get the full translation.

There are many tools available for translation. But the easiest way is to use plugin "Loco Translate". Using this plugin, you can literally translate any WordPress themes or plugins if it supports translation.

** Note: Please remember, if you update the theme later your translations might be gone if they are stored inside theme/plugin. So please keep a backup of Zugan theme and Zugan Core plugin first before updating theme. **

Here's a quick video tutorial about how to use Loco Translate:

17.4| Optimize Website Loading Speed

If you want to make your website fast like the demo, here's some tricks:

  • Upgrading PHP version: If your current PHP version is less than 7, upgrade it to version 7+. If you don't know how to do it, ask your hosting provider to do it for you.
  • Use HTTPS/SSL: HTTPS has certain advantage regarding loading speed, besides Google recommends it for better SEO. Activate HTTPS in your website. If you don't know how to do it, get help from your hosting provider.
  • Optimize Images: Optimizing images means reducing the image size without losing quality. There are many online tools (For example: https://tinypng.com/) from where you can optimize images very easily. Please optimize images using these tools before uploading it into website.
  • Page Caching Plugin: Use a better page caching plugin. In our demo website, we are using "Autoptimize" and "Cache Enabler" plugin together. If you are going to use "Autoptimize", make sure to turn on the HTML, CSS and JavaScript optimization option.

17.5| Updating Theme

Occationally we provide updates which includes new features and bugfixes. Updating WordPress theme is standard WordPress functionality. There are few ways to update WordPress theme. You can follow any of the methods described below:

** Note: Before updating, make sure to keep a backup of your website to be in safe side. **

Method 1: Automatic Update by Using Envato Market Plugin

  1. Install and activate the "Envato Market" plugin manually. Here's the plugin zip file: http://envato.github.io/wp-envato-market/dist/envato-market.zip
  2. From WordPress Admin Panel, navigate to "Envato Market" menu.
  3. In this page, you'll find a field for insering Envato Token. Insert your Envato Token Code from there. You can generate this code from this link: https://build.envato.com/create-token/?purchase:download=t&purchase:verify=t&purchase:list=t.
    Remember, while generating the token, you have to login using the same envato id which you used to purchase theme.
  4. After completed the above steps successfully, Navigate to Appearance -> Themes. Here you'll see an "Update now" link beside your theme. Click on that link and your theme will be updated automatically.

Here's a quick video tutorial explaining this method:

Method 2: By Uploading zip File

  1. From WordPress Admin Panel, Navigate to Appearance -> Themes.
  2. Activate any other theme (eg. Twenty Seventeen) than the current one.
  3. Delete Zugan Theme.
  4. Now you have to upload the updated theme zip file. To do this, Navigate to Appearance -> Themes -> Add New -> Upload. Go to browse, and select the zipped theme folder. Hit "Install Now" and the theme will be uploaded and installed.

Method 3: By FTP

  1. Using your FTP client, navigate to "/wp-content/themes/" folder on your server and delete the "Zugan" folder from there.
  2. Now upload the latest non-zipped theme folder into that "/wp-content/themes/" folder .

** Note: After updating the theme, please update all plugins which come with the theme. **

18.1| Demo Content installation failed

This is a hosting issue. In most hostings demo installation will work fine. But some hostings block certain permissions which may cause this issue. If this happens to you, you can contact your hosting provider or alternatively send a support request to support@radiustheme.com and we will help you to fix this.

18.2| 404 Error in all pages

If you face this type of issue, please update your permalink. To update permalink, navigate to Settings -> Permalink and then click on Save Settings button.

19| Contact

If you face any issue, please contact at support@radiustheme.com

Thank you for purchasing our theme.