This is the documentation for the following WordPress themes: Visby, Årstad, Nurmes, Sorsele, Nordkapp, Skagen.

Table of contents

1. Installation
2. Default Setup
3. Homepage Setup
4. Post & Page Templates
5. Recommended Plugins
6. Images
7. Custom Menu
8. Demo Import
9. Translation (Localization)

Installation

(via WordPress Dashboard)

1. Downloaded the theme package; e.g. nurmes.zip,
2. Go to Appearance >Themes,
3. click on “Add New” > and “Upload theme”,
4. click on the ‘Browse’ button, find the nurmes.zip file on your computer and press ‘Install Now’,
5. Activate theme,
6. After the theme activation: go to Appearance > Install Plugins, and install and activate the Redux Framework plugin!
7. Refresh the dashboard page and the Theme admin panel button will appear;
8. Go to the Theme admin panel (theme options) and setup your theme.

You need to install/activate the required plugins. You can do this by visiting Appearance » Install Plugins inside the wp dashboard.

Default Setup

1. Install and activate the Redux Framework plugin!
2. Go to the Theme admin panel
   
3. hit the “Save Changes” button to set default style settings:

Homepage Setup

1. In Settings > Reading set the default setting,
2. Adjust the “Blog pages show at most” number value to set a number of posts on the front page and in the archives.
   
3. Whole post content may be visible on the homepage. In this case, use a standard, native ‘Read More’ block to “split” post content:

Post & Page Templates

Some of my themes include page/post templates – different layouts for your posts (No Sidebar Layout, Left Sidebar Layout, etc.). You can select these layouts for every post (or page) in the right column when you are writing a post:

Recommended Plugins

The following message may be visible after theme activation:

There are listed recommended plugins. You can install them plugins in Appearance » Install Plugins too.

Images

Important! It is possible that images are wrongly cropped and look ugly after the theme activation.

In this case, use the following plugin: http://wordpress.org/extend/plugins/regenerate-thumbnails/
You’ll be able to regenerate old images (from the previous theme) to a new, proper resolution.
Start the regeneration in Tools > Regenerate Thumbnails. This process can take a while and you cannot close the tab/window until regeneration is done.

Custom Menu

Create own custom menus first! Please see following tutorial for more info about menus in WordPress.

Colored Menu Item (on the right)

1. Toggle ‘Screen Options’ on the top of the menu screen:
2. Enable ‘CSS Classes‘ and ‘Description‘ option:
3. Toggle any menu item and type special word into ‘CSS Classes’ field

Menu Item Description

1. Toggle any menu item and type some text word into ‘Description’ field (see previous steps if the field is not visible/enabled):

Menu Icons

1. 1. Before (or after) menu label add this piece of code: <i class="fas XXX"></i>
2. Enter full icon code – ‘fa’ or ‘fas’ class is required
3. For XXX you can set any icon name. You can find all icon names on Font Awesome homepage
4. 

Demo Import

Install and activate the ‘One Click Demo Import’ plugin.

After that import full demo content easily in Appearance > Import Demo Data.

Translation

This theme is translation/localization ready and comes with a .pot file. File is located in theme folder inside the ‘lang’ folder’; e.g. ../visby/lang/visby.pot

1. You need to use localized WordPress installation (core) in the first place:
2. If not, localization will be not successful.
3. Download poedit software here,
4. Install it and in this software translate .pot file line by line (visby.pot in our case),
5. Once you have translated all the strings, you can save this as your .po file.
6. The filename of your .po / .mo file is crucial! Gettext uses the ISO 639 standard for language abbreviations and ISO 3166 for locales. If your translation is written in deutsch for example, your file name will look like de_DE.po. Capitalization is also important here. For a full list of language and country codes, check out these two links: Gettext language codes and Gettext country codes
7. Once you save, POEdit by default automatically creates a .mo file alongside your .po file. Put these files into ‘lang’ folder.
8. Access your wp-config.php file found in your WordPress’ root folder. Your file should already contain define(‘WPLANG’, ”); but if it does not, you can add it in. You simply need to add your language and locale code into the define. If you were to translate your theme into German, you would have this: define('WPLANG', 'de_DE');
9. Your internationalization is complete!