Somerville

Theme Documentation

Hello there...

Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to contact me via Support page. Thanks so much!

Created: 25.10.2018
By: Dannci & Themnific | Support*

* Please note, that theme support does not include:

  • Customization and installation services
  • Support for third party software and plug-ins

 

Theme Instalation

Installation via WP Dashboard:
  1. Unzip the main (downloaded) theme package – to get somerville.zip file,
  2. Go to Appearance >Themes,
  3. click on “Add New” > and “Upload theme”,
  4. click on ‘Browse’ button, find somerville.zip file on your computer and press 'Install Now',
  5. Activate theme,
  6. After theme activation go to Appearance > Install Plugins, and install and activate Redux Framework plugin!
  7. Refresh admin page and Somerville - admin panel' button will appear;
  8. Go to Somerville - admin panel (theme options) and setup theme.

 

Installation via FTP:
  1. Unzip the main (downloaded) theme package / twice / to get main theme folder ‘somerville’,
  2. Using FTP client (e.g. Filezilla) upload 'somerville' folder into 'themes' folder in your WordPress installation ( YOUR_HOSTING_ROOT/YOUR_SUBDIRECTORY/wp-content/themes/ ),
  3. Go to Appearance >Themes, find Somerville theme and activate theme,
  4. After theme activation go to Appearance > Install Plugins, and install and activate Redux Framework plugin!
  5. Refresh admin page and Somerville - admin panel' button will appear;
  6. Go to Somerville - admin panel (theme options) and setup theme.

 

1) You need to install and activate required plugins.You can do this by visiting Appearance » Install Plugins inside wp-admin.

2) theme is compatible with 'Gutenberg' plugin; we recommend to install/activate this plugin too.

.

Default Setup

1. After theme activation go to Appearance > Install Plugins, and install and activate Redux Framework plugin!

2. Then go to Somerville - admin panel

img

and hit "Save Changes" button to set default style settings:

img

You can change styling options later.

 

2. Following message may be visible after theme activation:

img

Click on 'Begin activating plugins' link and install and activate 'Redux Framework' (if not installed yet) and 'Shortcode Ultimate' plugins. Or you can do this by visiting Appearance » Install Plugins

 

4. IMPORTANT! It is possible that after theme activation are images wrongly cropped and look ugly! In this case use following plugin: http://wordpress.org/extend/plugins/regenerate-thumbnails/ to regenerate old thumbnails (from previous theme).
After plugin installation start regeneration in Tools > Regen. Thumbnails. This process can take a while and you cannot close tab/window until regeneration is done.

 

 

 

Homepage Setup

 

Quick Overview

Setup is very easy and intuitive. These steps are required to create a custom journal layout:

1) Creating few posts (set featured image for these posts)

2) Homepage setup (empty homepage)

3) Setup of the 'Homepage Section' in Appearance > Widgets (using homepage widgets)

  1. In 'Pages' section create new page > name it 'Home'
  2. Select 'Builder' template for this page and save page:
    img
  3. Go into Settings > Reading and created 'Home' page set as Static page > Front page,
    img
  4. Empty homepage is created now! In next steps we'll create homepage content using homepage widgets in Appearance > Widgets.

 

Homepage widgets

Important!

I recommend to create few classic blog posts before you start creating homepage (journal) layout. Set 'featured images' for all your posts.

  1. Go to Apperance > Widgets:
    img
  2. Using Drag & Drop, drag widgets labeled as 'for homepage' into the 'Homepage Section':
    img
  3. Change parameters is partial (for homepage) widgets and save/update these widgets.

 

Widgets Screenshots

  1. Themnific: Blog (for homepage)
    img
  2. Themnific: Journal 1 (for homepage)
    img
  3. Themnific: Journal 2 (for homepage)
    img
  4. Themnific: Journal 3 (for homepage)
    img
  5. Themnific: Journal 4 (for homepage)
    img

Blog Template

  1. If you want to create 'blog' page, create empty page (Default template),
  2. name it 'Blog' (or similar),
  3. go to Settings > Reading and set this page as 'Post page'
    img

 

Theme Setup - Admin panel

img

Theme comes with extensive options panel with functions divided to these sections:

img

General Settings:
  1. Upload your Main logo image,
  2. Select layout for the blog page and for archives,
  3. Enable/disable 'Uppercase' fonts,
  4. Set 'Site Borders' width- Wrapper spacing

img

 

 

Primary styling:
  1. Select font family with color, style and width of the font,
  2. Choose colors for typographic elements: body, wrapper, containers (ghost color), text/links, hover, borders etc.

img

 

Header Styling & Settings:
  1. Set background color or background image for header,
  2. Setup color scheme (font, links and border colors) for main navigation
  3. Set other colors for header,
  4. Set custom margins and width limitation for logo image.

img

 

Footer Styling:
  1. Select font family with color, style and weight for footer,
  2. Choose colors for typographic elements: footer background, text, links, hover, borders etc.,

img

 

Other Styling:
  1. Set font styling for 'Meta' sections (date, category etc. post information)
  2. Choose background color for elements (buttons, lines etc.),
  3. Select text/link color for elements (buttons, lines etc.),
  4. Set color scheme for image backgrounds.

img

 

 

Headings Typography:
  1. Select Font-family for all headings (h1- h6) and 'post titles',
  2. Select font weight for all headings (h1- h6) and 'post titles',
  3. Select Font-size for all headings (h1- h6) and 'post titles',
  4. Select font color for all headings (h1- h6) and 'post titles',

img

 

Post Settings:
  1. Turn On/Off partial post sections.

img

Social Networks Settings:
  1. Enter the full URL of social network, your profile or account (enter full URL: http:// or https:// including).

img

 

 

 

If you are finished click on "Save changes" button!

 

 

 

Custom Templates

 

  1. Create a page (or a post) by going to Pages > Add New (Posts > Add New).
  2. In Page Attributes section select custom page template (No Sidebar Layout, Left Sidebar Layout etc.)
  3. Click the Publish button to publish your page (post).

 img

Custom Widgets

Theme comes with few custom widgets (marked as -Themnific).

Go to Appearance > Widgets and setup your sidebar and footer widget areas. Widgets are very easy to setup. Just follow and set partial widgets fields.

img

Note: widgets marked as 'for homepage' are suitable for 'Homepage Section' only!

 

Used Widgets

Following widgets are used in theme demo:

img

As you can see, in theme demo are used custom widgets which come with 3dr party plugins (Twitter, Newsletter etc.).
Please see 'Plugins' chapter for more info about these plugins.

 

 

Images

IMPORTANT! It is possible that after theme activation are images wrongly cropped and look ugly!

In this case use this plugin: http://wordpress.org/extend/plugins/regenerate-thumbnails/ to regenerate old thumbnails from previous theme.
After plugin installation start regeneration in Tools > Regen. Thumbnails This process can take a while and you cannot close tab/window until regeneration is done.

Images and thumbnails are generated automatically.

To display thumbnails correctly upload images via WP interface using "Set featured image" button.
After image upload set featured image.

 

Featured Images - Minimal Sizes
  1. Blog block: 437px of width;
  2. Journal 1 block: 580x620px;
  3. Journal 2 block: 933x680px;
  4. Journal 3 block: 437x400px;
  5. Journal 4 block: 437px of width;
  6. Single post (classic image): 933x680px

 

 

Post Settings & Post Formats

Post Settings:

In post add/edit screen is located custom 'Themnific Post Options' tab. You can disable 'Featured Image' on single post page in this tab.

doc

 

 

 

Custom Menu

 

! Create own custom menus first! Please see following tutorial !

 

 

Custom menu (in sidebar)

1. Create another custom menu (in Appearance > Menus) and add any pages / links into it.

2. go into Appearance > Widgets and using 'Navigation Menu' widget display this menu in Sidebar (Pages); (current page will be highlighted).

 

 

Menu Icons

 

1. Before (or after) menu label add this piece of code

<i class="fa XXX"></i>

Enter full icon code - 'fa' class is required.

2. For XXX you can set any icon name. You can find all icon names on Font Awesome homepage.

3. You can see how-to video here. It is not tutorial for my theme but the process is the same.

 

 

 

 

Plugins

 

 

Recent Tweets Widget

Theme is compatible with Recent Tweets Widget plugin. Plugin is used in demo site.

In search field (Plugins > Add New) insert 'Recent Tweets Widget' and Install plugin.

Plugin widget can be set in Appearance > Widegts:

Note!: You need to get "consumer and secret" codes for 'Recent Tweets Widget' widget:

  1. Go to https://dev.twitter.com/apps/new and log in, if necessary
  2. Enter your Application Name, Description and your website address. You can leave the callback URL empty.
  3. Accept the TOS, and solve the CAPTCHA.
  4. Submit the form by clicking the Create your Twitter Application
  5. Copy the consumer key (API key) and consumer secret from the screen into widget fields

 

 

MailChimp for WordPress

You can easily create newsletter subscribe form with 'MailChimp for WordPress' Plugin: Plugin Homepage

Into search field (in Plugins > Add New) insert 'MailChimp for WordPress' and Install this plugin

Plugin can be set in MailChimp for WP section:

 

 

Shortcodes Ultimate

You can use this plugin in the classic editor for now. The plugin is not Gutenberg compatible yet. You can generate different shortcodes using 'Insert shortcode' button in all Post/Page screens:

img

 

Social Pug

Plugin page: Plugin Homepage

Into search field (in Plugins > Add New) insert 'Social Pug' and Install this plugin.

Plugin can be set in Settings > AddToAny:

Theme is compatible with Simple Share Buttons Adder too.

 

Contact Form 7

Plugin page: Plugin Homepage

Into search field (in Plugins > Add New) insert 'Contact Form 7' and Install this plugin

You can create own contact form(s) in main wp menu > Contact.

You can display created 'contact form' on any page using shortcode.

Please read plugin documetation for more info about this very flexible plugin.

 

 

 

 

Demo Content (XML file)

 

Make sure that Somerville theme is installed and activated before XML import!

 

- In main theme package is attached XML file. Unzip this XML file.

- Go to Tools > Import; install and activate 'WordPress Importer' plugin,

- Find XML file on your computer and import XML file.

- Check "Download and import file attachments" option.

- XML file is bit bigger and sometimes (slow server etc.) needs to be imported more times (until 'Have Fun' message is shown).

 

After XML file import:

- set 'Home' page (with 'Builder' template) as front page (in Settings > Reading),

- Go to Apperance > Widgets and using drag widgets labeled as 'for homepage' into the 'Homepage Section', (more info here)

- save imported custom menus for 'locations' (in Appearance > Menus),

- footer and sidebar widgets can be set in Appearance > Widgets. In demo are used these widgets:

img

 

 

Important!

Due licenses all imported images are for testing purposes only and cannot be used on your live website!!!

You can download free photos for your commercial & personal works on sites like:

http://picjumbo.com/

http://pixabay.com/

https://unsplash.com/grid

 

Translation

  1. You need to use localized WordPress installation (core):
    img
    If not localization will be not successful.
  2. Theme is translation/localization ready and comes with somerville.pot file. File is located in root theme folder inside 'lang' sub-folder: ../somerville/lang/
  3. Download poedit software here,
  4. Install software it and translate somerville.pot file (line by line),
  5. Once you have translated all the strings, you can save this as your .po file.

    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:

    Once you save, POEdit by default automatically creates a .mo file alongside your .po file. Put these files into 'lang' folder.

  6. 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');

Your internationalization is complete!

 

 

 

 


Once again, thank you so much for purchasing this theme.

Go To Table of Contents