Ringo User Guide

Clean Blogging Wordpress Theme


First of all, a big thanks for purchasing Ringo theme. This document includes helpful information about theme installation, capabilities, features and options.

Also please check our Help Desk if you have any questions that are beyond the scope of this document.

System requirements

If you're planning to build a website using WordPress, you must first ensure your hosting provider meets WP's requirements.

Database
PHP
Server Resource Limits, important for Demo Import

Installation

Installing the theme can be done two ways. You can upload the theme ZIP file using the built in WordPress theme upload, or copy the files through an FTP client.

Be sure to extract the file ringo.zip from the ThemeForest download before uploading. Using the ThemeForest ZIP file directly will result in a "Missing Style Sheet" error.

Once the theme is uploaded, activate it from Appearance > Themes by clicking the "Activate" link for "Ringo".

After you have activated the theme you need to install the plugins that are required and recommended to use with the theme.

Using Wordpress Theme Upload

  1. Login to your WordPress admin.
  2. In the Appearance > Themes menu click the tab "Install Themes"
  3. At the top of the page click, "Upload", then click the file input to select a file.
  4. Select the zipped theme file, "mednight.zip" available in ThemeFile folder from the package downloaded from ThemeForest, and click "Install Now"
  5. After installation you will receive a success message confirming your new install.
  6. Click the link "Activate"

Uploading by FTP

  1. Login to your FTP server and navigate to your WordPress themes directory.
  2. Normally this would be "wp-content/themes"
  3. Extract the files from the zipped theme available in the package downloaded from ThemeForest.
  4. Copy the folder "ringo" to your themes directory.
  5. After the files finish uploading, login to your WordPress admin.
  6. In the "Appearance" menu click "Themes"
  7. Click "Activate" for the theme "Ringo"

Installing the Plugins

After you had activated the theme, you need to install the plugins required by the theme.

Required & recommended plugins

The following is the list of plugins that are required and recommended for use with Ringo Wordpress theme:

Required & recommended plugins

The following is the list of plugins that are required and recommended for use with Ringo Wordpress theme:

  1. After you have activated your theme, you'll see a notice about required plugins for Ringo, to proceed click "Begin installing plugins".
  2. On clicking on it, you will be redirected to Install Required Plugins Page. Alternatively this page can be accessed from Appearance > Install Plugins as well.
  3. You will now see a list of plugins required and recommended for use with this theme. Click on the Select All checkbox to select plugins.
  4. Click on Bulk Actions dropdown menu, choose Install dropdown option and click the Apply button.
  5. If all plugins are installed successfully, you will be redirected to WP Plugins page.
  6. In case you encounter any problems, try installing them one by one.
  7. After you have installed all the plugins, activate them by navigating to Plugins page, select the required plugins, choose activate from the dropdown option and click on Apply button.

You have now successfully installed and activated the plugins required for Ringo Wordpress Theme.

Demo import

To import the demo content you need to navigate to Theme Options > Demo Import. Then select the Default demo version and click the button "Import demo content". This could take several minutes, depending on your internet connection. If you import demo content it will overwrite the existing data and settings. An xml exported file is also available in the main download file under folder "export".

IMPORTANT: Make sure that all the System status are all in green, otherwise the demo content could fail.

Getting started

After you've successfully uploaded and activated Ringo, it is time to setup the theme.

Theme Color

Ringo allows you to change the main color of your site in one click using a simple colorpicker tool. Just navigate to Theme Options > Style > Main color and select the color you want.

Header

The header offers some few options by going to Theme Options > Header Layout. You can enable / disable the social icons, trending button, and change the trending megamenu background image.

Journal page

Ringo allows you to create page with a list of posts using different layouts. You can also filter the posts by:

  1. Latest posts
  2. Features posts
  3. Latest posts from a category
  4. Latest posts by post format

Here is how to create such a page:

  1. Navigate to Pages > Add new
  2. Give the page a suitable name.
  3. Switch the page template to "Journal Page" and a new options will appear after the text editor:



  4. Choose the layout type you want and select the post filter.
  5. Save the page and done!

Output:

Homepage slider

You can easily add the Ringo default slider ( this feature is only available on journal page template ):

  1. Create a journal page.
  2. Select the "Slider" tab section in "Template - Journal Page".
  3. Check the Enable slider option.
  4. Use the options to setup you slider:



  5. Save / Update the page and done!

Output:

Thumbnail navigation

Ringo allows you to add thumbnails as fast links under the slider and before the post listing. Here is how to add it to your page ( only available for journal page template ):

  1. Create a journal page.
  2. Select the "Thumbnail navigation" tab section in "Template - Journal Page".
  3. Check the Enable thumb navigation option.
  4. Use the options to setup you navigation:



  5. Save / Update the page and done!

Output:

Bottom focus posts

As a final step, you can enable the bottom focus posts to take the attention of you visitors, at the bottom of the page. This feature is only available on journal page template.

  1. Create a journal page.
  2. Select the "Bottom focus posts" tab section in "Template - Journal Page".
  3. Check the Enable bottom focus posts option.
  4. Use the options to setup you navigation:



  5. Save / Update the page and done!

Output:

Theme Options

The Theme Options panel helps you easily take control over the appearance of your site, by allowing you to upload your logo, style the theme with the colors you choose, change fonts, turn features on and off, without having to write any code.

To access it, navigate to the "Appearance > Theme Options" section in the WordPress dashboard.

Getting started

  1. Logo
  2. Logo mobile version
  3. Fav icon
  4. Enable site description under logo
  5. Custom site description
  6. Enable smooth scroll
  7. Footer copy

Header layout

  1. Header version
  2. Dark header
  3. Sticky header
  4. Display breadcrumb by default
  5. Enable search option
  6. Show default wp admin bar

Style

  1. Main color
  2. Custom CSS
  3. Custom Javascript

Social

  1. Social icons

Fonts

  1. Body font
  2. Body font declaration
  3. Heading font
  4. Heading font declaration
  5. Additional elements font
  6. Additional font elements declaration

Blog & Pages

  1. Enable single post author
  2. Comment type

Demo import

  1. One click demo import

*NOTE: If you import demo content it will overwrite the existing data and settings. Choose the demo you want and then click the button "Import demo content".

Fonts

Ringo can use any of the several hundreds of Google fonts available. You can select one font for the body text (often a clean, light font) and another font for everything else (menu font, titles, etc).

How to change the current theme font:

  1. Go to "Appearance > Theme Options > Fonts".
  2. Choose the font you want for body and headings. ( After selecting the font, a demo text will appear bellow the dropdown menu to show you how it looks like ).



  3. After you have the font, save the changes.

SEO

Ringo does not force a website to have a specific format to show the title at the top of the browser, this is to provide the freedom to set them up as you wish. It is recommended to install a free SEO plugin such as: All-In-One Seo or SEO by Yoast. Both these plugins will allow you to set the titles as you wish to show them and at the same time improve your SEO.

Translation

Ringo comes with everything setup to easily translate it into any language. To translate into a different language:

  1. Go to the theme translation folder, which is located in "ringo/languages/"
  2. Make a copy of the file 'default.po' and rename the file to the locale of your language, example: Spanish would be 'es_ES.po'
  3. Open Poedit (can be downloaded for free from http://www.poedit.net/) and open the file you have created in it
  4. Translate all the strings and save your changes. After you save, you will have two files, exaple: Spanish would have 'es_ES.po' and 'es_ES.mo'
  5. Upload these files to "ringo/languages/"
  6. Make sure your WordPress settings ( Settings > General > Site Language ) has the correct language.

Updates

You can update the theme in two ways, and we recommend the first one. You can also make a backup of your files, before updating.

Recommended theme update method

When Ringo is activated it recommends several plugins. One of them is called "Envato Wordpress Toolkit" which when enabled and setup, will automatically alert you on your Dashboard when a new version of the theme is available and allows you to install it with only a few clicks. If you did not install the plugin when you first installed Ringo, and wish to install it now, please follow these steps:

  1. Go to "Appearance > Install Plugins"
  2. Hover over "Envato Wordpress Toolkit" and click on "install plugin"
  3. Go to "Plugins > Installed Plugins" and activate "Envato Wordpress Toolkit"
  4. A very good tutorial on how to use this plugin can be found at: http://wpmu.org/envato-wordpress-toolkit-a-themeforest-auto-updater/

All your settings should remain intact after updating the theme (menu settings, theme option settings, etc).

Alternative theme update method

You can also update the theme manually by going to Themeforest.net, logging into your account and downloading the latest Ringo version. For users who are not using a Child Theme:

  1. Deactivate your current Ringo version in the Theme section (This can be done by activating any other theme)
  2. Delete the Old Ringo theme from your website
  3. Upload the new version of Ringo as normal and activate it

For users who are using a Child Theme:

  1. Delete the Old Parent Ringo theme from your website
  2. Upload the new Parent version of Ringo as normal and activate it