Introduction

GutenMag - Gutenberg Magazine and Blog WordPress Theme

A short guide and general information to help you get to know your new theme.

Above all, We would like to thank you for purchasing this theme, your contribution is very much appreciated.


This document covers the installation and use of this theme and reveals answers to common problems and issues - We encourage you to read this document thoroughly if you are experiencing any difficulties. If you have any questions that are beyond the scope of this document, feel free to pose them in the dedicated support forum.

Getting Started

Installation of the theme

Installation of the theme

To install this theme you must have a working version of WordPress already installed. For information regarding the installing of the WordPress platform, please see the WordPress Codex - http://codex.wordpress.org/Installing_WordPress

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 -> Add New Themes -> Upload. Go to browse, and select the zipped theme folder. Hit “Install Now” and the theme will be uploaded and installed.
Some webservers have a limitation for the maximum allowed size of files being uploaded to them and that value may be exceeded by the theme file. If that is the case you can receive an error that states: The uploaded file exceeds the upload_max_filesize directive in php.ini. or Are you sure you want to do this? Please try again. If you get any of these errors please increase the values of upload_max_filesize and post_max_size directives in your php.ini file to 20M or follow the Installation via FTP section described above.
Once the theme is uploaded, you need to activate it. Go to Appearance -> Themes and activate your chosen theme.
After that you need to activate the pre-installed plugins:
1. Gutenberg
2. STMT Theme Options
3. Pearl Header Builder
4. MailChimp for WordPress Lite
5. AddToAny Share Buttons
All the plugins which are not free come under our Extended License, so you don’t need to pay for their license to use them. Some of them might have messages requiring activation, but they are already activated on our side. No purchase code needed. When using them under our license you will need to wait for the plugin updates in our regular theme updates. If you want to be able to auto update them from wp-admin, you will need to buy your own personal license for that.
Also you can update included plugins via upgrading the theme. We include latest versions of plugins in every update of the theme.

What to do if the theme installation fails

What to do if the theme installation fails?

PHP Configurations

If the installation stalls and fails to respond after a few minutes, or if WordPress gives you an error message, you are suffering from PHP configuration limits that are set too low to complete the process. You should contact your hosting provider and ask them to increase those limits to a minimum as follows:
  • max_execution_time 600
  • memory_limit 256M
  • post_max_size 32M
  • upload_max_filesize 32M
Besides this, theme requires at least PHP 5.6. Also, here you can see WordPress Requirements and recommendations: https://wordpress.org/about/requirements/.
You can verify your PHP configuration limits by installing a simple plugin found here: http://wordpress.org/extend/plugins/wordpress-php-info. And you can also check your PHP error logs to see the exact error being returned.
Besides this, you can upload the theme using your FTP client, upload the non-zipped theme folder into the /wp-content/themes/ folder on your server

Viewing System Status

You can also view some of your WordPress system settings by going to the GutenMag Theme System Status page. (Click on GutenMag > System Status in the WordPress menu.) This page will provide information about your WordPress environment and your server environment.
Any items that require your attention will be highlighted in yellow.

Theme Activation

Theme Activation

After completing installation of the theme, you need to activate your product under Dashboard -> GutenMag following these instructions:

1. Click on this Generate A Personal Token link. IMPORTANT: You must be logged into the same Themeforest account that purchased Motors. If you are logged in already, look in the top menu bar to ensure it is the right account. If you are not logged in, you will be directed to login then directed back to the Create A Token Page.

2. Enter a name for your token, then check the boxes for View Your Envato Account Username, Download Your Purchased Items, Verify Purchases You've Made and List Purchases You've Made from the permissions needed section. Check the box to agree to the terms and conditions, then click the Create Token button.

3. A new page will load with a token number in a box. Copy the token number then come back to this registration page and paste it into the field below and click the Submit button.

4. You will see a green check mark for success, or a failure message if something went wrong. If it failed, please make sure you followed the steps above correctly.
Paste the token in the provided box and click on the Submit button.
If activation is successful, you will see a green check mark.
You can follow this manual if activation fails.

Importing the demo content

Importing the demo content

Once the theme is installed, you will find a new GutenMag menu in the WordPress dashboard. You can use this menu to access the different theme-related pages.
Don’t know where to start on building up your site? We have created an option for you to recreate our theme demo site with just one click.
Tip: Before importing the demo content, you can check out the various demos at http://gutenmag.stylemixthemes.com/. You can see the different demos and decide on which one suits your firm the best.
Click on GutenMag > Install Demos in the WordPress menu.
Tip: You can use the demo content as a starting point for your website and modify the content to suit your needs. In that case, select the demo layout that is most appropriate for your website.
Please note: All demo site images replaced with placeholders due to licensing policy.
Each demo layout requires a number of plugins to function properly. Fortunately, StyleMix Themes has made it easy for you to install the plugins and they will be installed automatically during demo setup proceed. In order to start the import proceed, click on the Setup layout button.
Note: Depending on the speed of your Internet connection, it may take some time to install all the plugins and import the demo content.
All the plugins which are not free come under our Extended License, so you don’t need to pay for their license to use them. Some of them might have messages requiring activation, but they are already activated on our side. No purchase code needed. When using them under our license you will need to wait for the plugin updates in our regular theme updates. If you want to be able to auto update them from wp-admin, you will need to buy your own personal license for that. However, we always include the latest versions of the plugins in every update of the theme.
Setup Layout feature installs all required plugins, imports the chosen demo layout and widgets. After finishing the proceed you can visit your site front page in order to see all ready features 
Tip: If you want to start from scratch after viewing the demo content,you can remove the demo content using the Reset WP plugin (https://wordpress.org/plugins/reset-wp/). This plugin resets the WordPress database back to its defaults. It will delete all customizations and content, but it does not modify files; it only resets the database. Please see the above link for more details.

What if the Import fails or stalls?

If the import stalls and fails to respond after a few minutes You are suffering from PHP configuration limits that are set too low to complete the process. You should contact your hosting provider and ask them to increase those limits to a minimum as follows:
  • max_execution_time 600
  • memory_limit 128M
  • post_max_size 32M
  • upload_max_filesize 32M
You can verify your PHP configuration limits by installing a simple plugin found here: http://wordpress.org/extend/plugins/wordpress-php-info. And you can also check your PHP error logs to see the exact error being returned.

Update the theme

Update the theme

We will periodically provide updates of your theme. These updates are essential if you want to have a bug-free website as we give new features and improvements to the theme over time. Some of these updates might be needed in order to make the theme compatible with newer versions of WordPress.
Note: There is no risk of losing your settings and pages when you update the theme. However, any modifications you have made to the core theme files will be lost, so you should back up those files before you update the theme.
Tip: After upgrading the theme, you can update extra plugins via GutenMag > Plugins.
There are three ways of updating our WordPress themes to newer versions:
  • Updating via the WordPress Admin Panel (using Dashboard > Updates)
  • Update via the WordPress Admin Panel (using an extra plugin)
  • Updating via FTP

Updating via the WordPress Admin Panel (using Dashboard > Updates)

The easiest way of updating the theme is via Dashboard > Updates. When an update is available for your theme, you will get a notification in your WordPress Dashboard and you can update your theme by clicking on Dashboard > Updates and updating the theme (just as you would update any other installed theme).
Note: You will need the Token key you had generated when you had originally installed the theme. You will find this under the Settings > API Keys section of your profile on Themeforest.

Updating via the WordPress Admin Panel (using an Extra Plugin)

For this method you should first install Theme Upgrades Tool (http://wordpress.org/plugins/easy-theme-and-plugin-upgrades/). This plugin will update your theme when you upload the gutenmag.zip file.
Once you have installed the Easy Theme and Plugin Upgrades plugin:
  • Download the theme file update from ThemeForest.
  • Extract the gutenmag.zip file from the downloaded theme file.
  • In the WordPress dashboard, click on Appearance > Themes > Add New > Upload Theme > Browse...
  • Select the gutenmag.zip file that you extracted in step 2 and click on Install Now.

Updating via FTP

Another way of updating your theme is via FTP. Extract the contents of the gutenmag.zip file (which you will find inside the theme update file you have downloaded from Themeforest). The contents will be extracted to a folder called gutenmag\ and to subfolders within the gutenmag folder.
Tip: Make sure your unzipping software does not create any extra directory with the same name nested within the gutenmag\ folder.
Using an FTP program, upload the gutenmag\ folder (and its subfolders) to /wp-content/themes/ on your web server.
Note: The FTP program will give a warning that the gutenmag\ folder already exists. Choose Replace All.
Final Tip: Whichever method you use to update your theme, clear your browser cache after each update if you notice anything off. Old theme files can sometimes persist in your local cache and make you think something’s wrong.

Theme Features

Theme Options

Theme Options

WordPress Customize allows you to setup the general styling of the website visually. In WordPress menu go to Dashboard > Theme Options . Here, you can set up the following:
  • General site settings such as default visualization options.
  • Colors scheme.
  • Footer settings.
  • Typography settings.
  • Socials.
  • Archive and Single page options.
General Theme Options:
  • Color Scheme;
  • Content max width;
  • Global Post Templates;
  • Global Sidebar options;
  • Blog page view type.
Typography settings:
If you want to change your website typography settings, you need to go Them Options > Typography. It’s possible to change typography options for Main (body) and Headings, also Paragraphs, Spacing, and Button settings
Footer & Socials settings:
Here you can set up Footer Background Color, Copyright text, Privacy and Terms URLs. Social links are also could be entered here.
Archive Pages:
Search, Category, Tags Page Background images and View Types could be changed here:

Setting Up the Header

Setting Up the Header

You can set up the theme header individually. Every section of the header can be modified and it’s possible to add different elements like: dropdown, text, menu, popup, button, infobox, etc.
To change the header layout:
1. Click on Header Builder in the WordPress menu:

2. Drag & Drop needed elements:

2. Click on the Submit button to save your changes:
Here you can see detailed video tutorial:

Menus

Menus

There are two navigations on the site – Header menu and Footer menu, so you can adjust them under Appearance -> Menus
This is standard Wordpress functionality, you can choose from the pages, post categories, or custom links.

Localization

Localization

You can change your site main language via Settings -> General -> Site Language.
Before adding translations for static strings it needs to rename language files correctly according your site languages. Theme language files are located in a ../gutenmag/languages/ folder. You can find a list of language codes at WordPress in your Language. As an example, the language code for English is en_EN, so you would save the translated files as en_EN.po first, then en_EN.mo.
There are several ways to fill up translations. One of them if using PoEdit platform. You can add translation via editing your .po file and at the end PoEdit generates .mo file for you. Then you needs to upload ready translation files to primordial folder (../gutenmag/languages/).
Another way is to use a localization plugin like: Loco Translate

Content

Setting up Content Pages and Posts

Setting up Content Pages and Posts

You can add regular content to your website as normal pages and posts using Gutenberg page builder. Gutenberg is more than an editor. While the editor is the focus right now, the project will ultimately impact the entire publishing experience including customization (the next focus area).
Discover more about the Gutenberg - https://wordpress.org/gutenberg/.
If you are an Gutenberg newbie, this article will help you understand the essentials of successful page-building. You will learn about:

Blog page

Blog page

TThe Blog page is a usual blog, formed from the posts which belong to categories created by you, which have tags and featured images that show in the post listings on the blog page. You can set a page as a Blog posts archive page via Appearance -> Customize -> Site Settings -> Static Front Page.
The blog page can have the sidebar on the left, right or no sidebar, and the contents of the sidebar, as described above, are set under the Appearance -> Widgets. Other settings of this archive page you can setup via Theme Options -> Archive pages:
Blogs can be posted by someone who has the access to the backend of the site with admin or author role. Anyway that person will be able to log into the WordPress panel and have a user profile.
Default blog layout is grid layout and once you set up an empty page in the theme setting where it is said blog, it will show posts in grid layout.