Somnus - WordPress Theme

Contents

1. How To Install Your Theme

2. Team Posts

3. Setting Up Your Instagram Feed

4. Common Issue Troubleshooting

5. Importing Demo Data (Auto Method)

6. Theme Post Type Options

7. Initial Theme Setup

8. Theme support Policy

9. How To Rate Your Theme

10. Using The Theme Options

11. Somnus Videos

12. How do I reorder categories/posts etc?

13. Importing Demo Data (Fallback Method)

14. Troubleshooting Your Installation

15. Replace Contact Form with an Image

16. Class Posts

17. Contact Form 7 Overview

18. Setting Up A Logo

19. Installing Theme Plugins

20. WPBakery Page Builder Purchase Code/License

1. How To Install Your Theme

Installing your new theme is very straight forward and should be familiar to anyone who has worked with WordPress to any degree before, however we will outline the process here for you to ensure a trouble-free installation.

To begin, head to your WordPress dashboard and navigate to Appearance in the main menu, from the sub-menu on this page you will then need to select Install Theme, followed by the Upload button. You can see these steps in the animation below.


Its importing you upload the correct zip. By default most users will download the entire package when purchasing a theme, this needs to be unzipped and within this you will see various files and folders covering documentation, demo-data and of course the theme itself - typically the zip you need to upload will have a name similar to themename.zip - this is the one to upload here.

Once the upload has taken place, you will need to hit the Activate link to begin using your awesome new theme.

If your working with a fresh installation of WordPress, one final step you may wish to follow is to set your sites permalinks to something a bit nicer to look at (for a details overview of this settings you can view our blog post). To apply 'pretty permalinks' to your WordPress installation, just head to Settings > Permalinks and set the option to 'Postname'.

2. Team Posts

Heads Up!

Team posts are automatically show at /team/ on your site, though you can use the page builder to add these to a page instead.

Team posts work just like blog posts. Ensure each team post has a featured image set. You’ll also want to set a job title, and some social icons for each team member using the additional inputs underneath the WP Editor/

3. Setting Up Your Instagram Feed

Before you begin, as the API setup is constantly being changed from Instagram, you may wish to use a 3rd party plugin such as https://en-gb.wordpress.org/plugins/instagram-feed/

This plugin not only offers a much simpler setup, it is also very flexible and can create square galleries no matter the original image size supplied to Instagram and much more.

For Stack, Foundry, Padre, Somnus, Machine, LaunchKit, Union, Meetup, Pivot, Acomb and Fulford Users - use the following video guide in conjunction with this article.

For Lydia, Lumos, Kwoon, Hygge, Malory, Kubb and Finch Users - use the following video guide in conjunction with this article.

Due to recent changes in the Instagram API - the process for setting up an instagram feed has become a little trickier, but this guide will help with every step of the way. Essentially you need to create a Client (so Instagram know who you are), and then an access token (the thing that gives your site permission to show images)

IMPORTANT NOTE - You will need to follow these steps using the account you wish to display in your feed, you are not able to show another users feed so using one account (your own for instance) to display anothert users images (your client, for example) will not work.

Step 1 - Creating A Client

To begin, you will need to visit https://www.instagram.com/developer/, where you will be greeted by the following screen.

Hit the 'Register Your Application' button to continue to the next step. On the next screen (seen below) hit 'Register a New Client'

Next, you need to fill in the form provided - most of it is self-explanatory, the key thing to remember is to enter the following in the Valid Redirect URL field

http://www.tommusrhodus.com/instagram/

Ok, step 1 is done, you now have a client, and more crucially, you now have the Client ID you need for the next part. Copy this Client ID into a notepad, you will need it again soon.

Step 2 - Edit Client

Now you have a client, your going to need to allow it to authorise use of your images. To do this, hit the Edit link to begin editing your clients settings.

Once in the settings, head to the Security tab and Uncheck the Disable Implicit OAuth option and hit save.

Step 3 - Putting It All Together

Remember that Client ID from before? Your going to need it here.

To create the Token needed (to enter into the theme options) you will need to copy this url into whatever text/code editor you wish

https://api.instagram.com/oauth/authorize/?client_id=CLIENT-ID-HERE&redirect_uri=http://www.tommusrhodus.com/instagram/&response_type=token&scope=public_content

Replace the CLIENT-ID-HERE text with your actual client ID and then copy the whole URL (complete with your own ID) into your browser.

Next, you will be asked to Authorise access, just hit the Authorise button and continue to the final step.

Once done, you will be presented with this screen.

Copy the Token provided into the theme settings and your done

TROUBLESHOOTING

1. Receiving a 400 error? You must ensure the redirect URL you are entering is EXACTLY as follows (trailing slash included)

http://www.tommusrhodus.com/instagram/

2. Please note that sadly, the way in which Instagram have changed their API means that HashTag based feeds are currently unavailable. We're happy to have created a system to get user feeds back up and running and will re-add HashTag feeds in the future if we can. Your understanding that we're doing everything within our power is appreciated.

3 - When creating your client for the above steps, you MUST make the clients using the account which contains the images you wish to display. You cannot create a client based on one account, and then expect the feed to be able to show another users images - since the Instagram update this simply cannot work.

4 - Need a Numerical ID? Head here to locate your Instagram "Numerical ID" based on your username. https://codeofaninja.com/tools/find-instagram-user-id - This is only required in some of our older themes such as Kubb

5 - Seeing a "Recaptcha" issue when attempting to sign up for a new developer client? If your seeing a message such as the one below

When trying to sign up for a new instagram client, you may wish to use chrome and install this extension https://github.com/PhilGrayson/chrome-csp-disable which should allow the form to work.

This issue has been reported to the instagram team and we hope its resolved soon

4. Common Issue Troubleshooting

Im seeing a 'stylesheet missing' error when trying to upload the theme
Im setting a max_upload_size error when trying to upload the theme
Where is my Visual Composer/Revolution Slider license?
I cant import the demo data, why?
Im getting a 404 error when viewing my portfolio/team etc
My site is slow to load, why?
Iv received an email saying there is an update, what do I do?
I want to translate the theme into my language/change some wording - what do I do?
Why are my page builder blocks not appearing on my blog page?


Im seeing a 'stylesheet missing' error when trying to upload the theme

This means your uploading the wrong zip package. When downloading your theme you have the option to download the full package, or the installable theme itself.

We suggest to download the whole package, then unzip this to locate your theme.zip file (theme name will change based on your purchased theme.


Im setting a max_upload_size error when trying to upload the theme

Some hosting, especially budget shared hosting, may impose file restrictions for uploads to your WP site. In some cases, installing this plugin and work very well https://wordpress.org/plugins/increase-upload-max-filesize/ however if it fails to work then you will need to contact your hosts to they can make the necessary changes from there end as this is something we cannot help with from a theme point of view.


Where is my Visual Composer/Revolution license?

Premium plugins such as Revolution Slider and Visual Composer may request a purchase code during use. This code is used to provide direct updates and support from the plugins creator and as such is not required or supplied for use with our themes. Our frameworks have been carefully create to ensure your running the latest compatible version at all times, so you have no need to worry. Please note that we manually update our bundled plugins after thorough testing as some plugin updates have bugs that we are unhappy to ship to our customers, you will receive updates when we are happy with the plugin. If you truly require auto-updates from these plugins you’ll need to purchase a personal license, please note this is the same for each theme on themeforest that bundles plugins.


I cant import the demo data, why?

Some budget hosting such as godaddy etc are quite poor and offer little in the way of resources so a large task such as importing a whole demo and images etc can be a little too much for them. In cases like this, the 1st thing you should try is the Fallback method - it uses special plugins to lighten the load and helps in 99% of cases.

if the issue persists, then you will need to contact your hosts who can hopefully increase your servers performance to suit the task.


Im getting a 404 error when viewing my portfolio/team etc

WordPress is a rock solid platform in most cases, but sometimes, when working with a new theme for instance, it needs a little nudge to update all of its core settings etc. If your seeing a 404 error or such when trying to view your projects (or team members, clients etc - depending on your theme)

To do this, simply head to Settings > Permalinks and select 'postname' from the options listed - even if this option is already selected, hit save anyway (this is the nudge we mentioned earlier) - Once done, you should be able to view all your content with no issues.

Should any issues remain, this indicates an issue with your server (the theme has no control of this) so you will need to contact your hosts for further support.


My site is slow to load, why?

As you saw when viewing the demos of our themes, our themes are capable of being blisteringly fast, however you may ocationally notice your site is not loading as fast as you hoped – here you can find some tips for ensuring your new site loads as quickly as possible http://www.tommusrhodus.com/speeding-up-wordpress/


Iv received an email saying there is an update, what do I do?

To update your theme to the latest version, you should re-grab the theme files from the downloads page of your themeforest account. You should then use the this article: http://www.tommusrhodus.com/updating-wordpress-theme-themeforest/


I want to translate the theme into my language/change some wording - what do I do?

Like most WP themes, our theme is translatable via the provide PO file - you can read more about this process here http://www.tommusrhodus.com/wp-basics-translating-your-wordpress-theme/ as well as check out this handy video guide for this task 



Why are my page builder blocks not appearing on my blog page?

Basically the way WP works means that archive pages, such as blog categories, search results and the page you nominate to be your blog page under Settings > Reading are controlled by WP so any page builder (Variant, Visual Composer etc) can no longer be used as WP itself handles the page. 

For this reason you will find options for you blog layout within the theme options (Appearance > Customize > Blog Settings) where you can pick the layout, title etc as you wish


5. Importing Demo Data (Auto Method)

We have created a very simple system which can help you get your new theme setup like the demo in just a few clicks, however its crucial that you install all of the themes required plugins prior to beginning the import.

To begin single click import, you need to head to Appearance > Customize - within the theme options you will see a Demo Data area similar to the animation below. Simply click the import button and await the confirmation of the process's completion.

Bare in mind, the import process can take anywhere from 5 to 50 minuits (depending on the speed of your server etc) - you must not navigate away from the page whilst the import takes place.

6. Theme Post Type Options

Our themes allow you to control the urls used for the provided post types (such as team, portfolio etc). The Post Type Options page can be found within Settings in your WP admin area.

By standard, the usual url for your portfolio items would be yoururl.com/portfolio - however, using the provided area you can replace 'portfolio' with whatever slug you wish to use! The same principal applies to other post types also, depending on the theme in use.

Once you have changed your slug you may recieve a 404 error when trying to access your items, to remedy this, simply head to Settings > Permalinks and hit save. This refreshed WP permalink settings and should resolve this for you.

7. Initial Theme Setup

Ok, so far we have installed the theme, we have installed the plugins and imported the demo data, whats next? 

The final step in getting your new theme setup and ready for you to edit as you wish is to setup your home page and menu. To begin, head to Settings > Reading, here you will need to set your Front Page.

By default WP is set to show your latest posts, however to make your theme just like our demo you should select a static front page from the pages provided in the demo data.


Please note - is important to set the Posts Page here also (you should find a blog page in the demo data)

Finally, if you have not done so already, its highly advisable to update your permalink settings. To do this, head to Settings > Permalinks and select any option other than default. We recommended 'postname' - as you can see below.


8. Theme support Policy

Hey There! Please Read The Following:

These Tickets are not for Customisation requests (theme modification, behaviour changes, moving elements, 3rd party plugin integration etc.) Any ticket relating to customisation will be politely forwarded to -- http://www.tommusrhodus.com/contact/ -- and then your ticket will be closed.

"style.css is missing" scroll to the bottom of this message for the answer.

Want your site to load more quickly? A good web host is the best way to do this, we recommend and use WPEngine for all our theme demos.


I run support Weekdays 9am - 5pm GMT. You can expect a response within 12 - 48 hours, Monday to Friday unless there is a national holiday. Here is a list of UK national holidays: https://www.gov.uk/bank-holidays. Note that "bumps" to tickets put you to the back of my queue, be patient, every ticket is answered promptly.


What these tickets are for:

Help using theme features, bug reports & reasonable feature requests for future updates. Need to update your theme? See here: http://www.tommusrhodus.com/updating-wordpress-them...

What these tickets aren't for:

Any issues relating to 3rd party plugins not recommended by the theme, theme customisations, or theme changes your client requires.

What counts as customisation?

If you want to change the appearance or functionality of the theme by editing or extending the theme's code, then that is customisation, and will not be supported through these tickets. Likewise if your client has a function request that does not exist in the theme, these tickets are not the place to have the theme extended for this.

Do you need customisation work?

If that's exactly what you're here for, you can fill out a custom work form here; http://www.tommusrhodus.com/contact/

Things to check when leaving a ticket:

  1. You must leave a link to your site, if not we will ask you to do this anyway and it will result in a delay to your ticket.
  2. Please be descriptive when leaving a ticket, use screenshots if possible, "doesn't work" is not an acceptable descriptive term and you will be asked to explain further.
  3. Disable all non-theme-recommended plugins, undo any code changes, and ensure you're using a default, unmodified version of the theme files. You'll find a lot of the time this fixes your issue.
  4. Tickets without a validated purchase will not be answered. Properly validate your purchase.
  5. If you have a modified theme, or are using a child theme for modification, we cannot help with bugs. Please present bugs to us within the default, unmodified theme, and we will help every time!
  6. Please note Envato's Licensing covers 1 URL per 1 purchase of a theme: http://themeforest.net/licenses/regular - ticket profiles covering multiple URLs with 1 license code, will be stopped until the remaining licenses are provided.

Cheers & Thanks again for your purchase!


A quick point on theme support: All of my themes are tested and thoroughly scrutinised by themeforest support staff and are confirmed 100% working, if you're having any issues you should be 99.9% sure it's a user error, or a bug I will be happy to fix with you. With this in mind, please keep your tone calm & professional, you will always get the same from me. Any tickets left with vulgar language, or with threatening, unprofessional language will be promptly closed and/or deleted. All tickets left with a calm, professional tone will receive awesome support, as always.


"style.css is missing", no it isn't, one of two things has happened and I can help you with both:

  1. You've bought a HTML template. Was your purchase under $17? Then you've not bought a WordPress theme, you've bought a HTML template, contact Envato support, they can help: http://support.envato.com
  2. You've uploaded the main theme .zip, instead, unzip this, inside you'll find documentation and another .zip called themenameWPTheme.zip <= this is what you should be installing.

9. How To Rate Your Theme

10. Using The Theme Options

All options for the theme are found within the WordPress theme customizer, from here you can change logos, colours, loads of stuff!

When you've done making changes, be sure to click the Save Changes button to apply your modificaitons to the front end of the site.

11. Somnus Videos




12. How do I reorder categories/posts etc?

Sadly, by default, WordPress has no easy method built into it for taking control of things such as the order of your Posts, categories (Portfolio, Team, Classes etc based on your theme) - Thankfully there is a very handy plugin which can help - Intuitive Custom Post Order

To install the plugin, simply head to Plugins > Add New and search for Intuitive Custom Post Order - once installed, you will need to head to Settings > Intuitive CPO to set things up. Once there you will see the following screen (the items will vary depending on your theme)

Simply Tick the box next to the content you wish to control and hit save.

Now you can quickly and easily re-order your items by simply dragging them within the WP Dashboard - you can see this wonderful plugin in action below. 

13. Importing Demo Data (Fallback Method)

I have created a folder labeled "Demo XML Data" which contains an export for the Live Preview. The place to upload this XML file is in WordPress under Tools > Import.

Once you've arrived on the Import page, you will click on the "WordPress" link: Wordpress - Install the WordPress importer to import posts, pages, comments, custom fields, categories, and tags from a WordPress export file.

The first time you do this you will get a pop-up prompting you to install the "WordPress Importer". You will need to click "Install Now". Then You will have installed the plugin and need to click "Activate Plugin & Run Importer".

From here you will just need click "Choose File" and select the demo-data.xml file. Then click "Upload file and import".

You will then be prompted to Assign Authors. You can read the description at the top as this explains everything. Note: Make sure you Import Attachments.

Check the box "Download and import file attachments". This will download attachments for images included in the Live Preview demo.

You now just need to wait for the importer to finish. This might take a few minutes depending on your hosting server speed.


14. Troubleshooting Your Installation

  1. Demo data installed correctly, but there's no imges? You either forgot to import attachments when installing demo data, or your server is configured to not allow incoming attachments. You'll need to go through the theme, posts, portfolios and set featured images accordingly.
  2. Seeing a red warning where a revolution slider should be? You just need to import the demo slider included in your themes Demo XML Data folder provided in your package (see video above).
  3. No Menus?! Help! This is simple, go to appearance -> menus and set your registered menus to a theme location.
  4. I'm getting 404 errors on posts & pages. See the permalinks section of this documentation.
  5. My site is slow to load & pages. See this article.

15. Replace Contact Form with an Image

If your looking to replace the contact form within the contact areas http://somnus.tommusdemos.wpengine.com/pages/contact-classic/ with an image just add this to your custom css area (Appearance > Customize > Style Settings > Custom CSS) and add your own image URL 

.fullwidth-map + .top-layer .bg-dark.right {
    background-image: url('http://somnus.mediumra.re/img/tall1.jpg');
    background-size: cover;
}
.fullwidth-map + .top-layer .bg-dark.right > div {
    display: none;
}

16. Class Posts

The classes post type is primarily aimed for displaying classes/agenda details, however it can also be used for other similar data.

You can locate the Class post type by viewing the Classes area within your WordPress dashboard.

A few areas are provided which allow you to input a time, description and teacher name, as well as a regular WP editor area where you can add your course/class details much like a regular post/page.

17. Contact Form 7 Overview

Contact Form 7 is our recommended form plugin for WordPress. It is a simple but powerful form creator for WordPress. Here we will show you how to use Contact Form 7 to create and edit a basic form.

After Contact Form 7 is installed, you’ll find a new menu item in your WordPress admin area called Contact, here is where your forms and created and edited. From the Contact main screen, you will see your first contact form, its usually a default form called 'Contact Form 1' OR if you have imported the demo data for our theme you may see a few forms that we have made specially for you.

When creating and editing forms CF7 uses simple shortcodes (in WordPress these shortcodes are words surrounded by square brackets like “[” and “]”) - these shortcodes are generated via the 'Generate Tag' area (marked in red) and then placed in the form builder area (marked in blue) - you can also add your own HTML to the form for extra control.


18. Setting Up A Logo

You can add your own custom logo in seconds, thanks to our easy to use theme options. To begin, just head to Appearance > Customize in your WordPress admin area.

From here you will need to navigate to the Header Options, where you will find an area to upload your logo. For reference, these options will look similar to the animation below, however be aware the exact option may differ in your particular theme.

Retina Logo Support

Your theme theme of course supports a retina logo for devices that support them - you will find the retina logo upload area in the same place as the regular logo upload area. When supplying a reiina ready logo, you must ensure the filename is identical to your normal logo, followed by @2x

For example, if your logo is called my-logo.png, your retina logo must be called my-logo@2x.png


19. Installing Theme Plugins

When you first install the theme you'll see a popup on your dashboard from the theme asking you to install a number of plugins.


Allow the theme to install these for you. The plugins which are installed are dependent of the theme, the images below are for illustrative purposes only. 

TIP - You can install all plugins at the same time by checking the box at the top of the this list, see below for an example. 


Once done (the process should take no more than a few minutes) You will see a confirmation notice similar to the image below. 

 Now you have the themes plugins installed, you can continue to the next stage of the setup and import the demo data without any issues.

20. WPBakery Page Builder Purchase Code/License

Your theme comes with a copy of the powerful WPBakery Page Builder, however its important to note, being bundled with a theme means that its not possible to "Activate" your copy of the plugin - but this has NO effect on how the plugin works

Activating the plugin allows you access to support and direct updated from the WPBakery team, so if you wish to purchase your own license so you can take advantage of this for whatever reason - you must deactivate and delete the version of WPBakery Page Builder provided with your theme, and install your own via Plugins > Add New in your WP Admin area.

Once done, you can use your new WPBakery Page Builder license to activate as you wish. For details on this see this article.