Introduction

We would like to first thank you for purchasing this theme. This documentation consists of several parts that guide you through the entire process of installing and setting up our theme starting from a fresh install.

We did our best to make this documentation as clear as possible with step-by-step guidance, including screenshots. However, if you have any difficulties with this theme or have any suggestions on improving our documentation, please post in our support forums or submit a support ticket.

First Steps

After you have purchased our theme, you will need to download and install it on your website. This tutorial will show you how to do this.

Download from Rough Pixels

There are a couple of ways to download your theme, the first is from a download link found within the email purchase receipt that you get when you made your purchase. Please note that this link has an expiry date.

If you decide to download from this website, you will need to log in and then visit your Purchase History.

Purchase History

From your purchase history, you will click on the View Details and Downloads link.

View Details and Downloads link

Your next screen should now show your download(s) for a single theme.

Seasoning download button

If you purchased the All-Access membership, you should see a large Click Here To Use Your All-Access Pass button. Once you click this, you will be taken to a page where all your theme downloads are displayed; each with a download button:

All Access download button

Installing a Theme

You can install the theme in two ways: through WordPress, or via FTP.

Install via Dashboard

  1. Log in to the WordPress Administration Panels.
  2. After you have logged in, navigate to the Appearance > Themes.
  3. Click the Add New button on the top of the screen.

    Add a new theme from dashboard
  4. On the next page, click the Upload Theme button on the top of the screen.

    Dashboard upload theme
  5. Click the Choose File button to browse your computer and navigate to where you downloaded your theme too. Select the file seasoning.zip and click Install Now.
  6. WordPress will upload and extract the theme archive for you. All you need to do next is to click on the Activate text link under the message for successful theme installation.

    Activate the Seasoning theme
  7. Now you can view your site’s front-end to see the theme active, or you can jump right in and begin setting up your website.

Install via FTP

  1. Navigate to where you downloaded your theme and double-click the seasoning.zip file to extract using your standard zip archive software (eg: WS_FTP Pro, Filezilla, etc.)
  2. Using your FTP client (program) to log into your host web server.
  3. Go the WordPress root folder on your server, then go to /wp-content/themes/ folder.
  4. Upload the extracted file folder seasoninginto the themes folder.
  5. Log in to the WordPress Administration dashboard.
  6. Navigate to the Appearance > Themes. On this page, you should see the Amble theme in the list of themes.
  7. Move the cursor on the block with the Amble theme and click the Activate button.

    Activate Seasoning from the theme page
  8. Now your theme is active!

Theme License Key

This tutorial will apply to all premium themes, but may also include any free versions that we host ourselves instead of the theme directory on the wordpress.org website.

Themes from Rough Pixels use a license key to help manage active memberships, but they also give you the added benefit of receiving update notices with 1-click updating.

The first thing you need to do is log into the Rough Pixels website with your user account and then go to your Purchase History:

Purchase History

Activate Theme License

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to the Appearance > Theme License.
  3. In a new browser window (or tab), log into the Rough Pixels website and navigate to your Purchase History.

    Purchase History
  4. You should see a License Details table with an Inactive status, but from here, you will copy your license key:

    Seasoning license details
  5. Go back to your website’s dashboard with your theme license screen open and paste your key into the field.

    Enter license key
  6. Click the Activate License button and then the Save Changes button
  7. Once you activate your license, you can return to your License Details in your Purchase history to see the status is now set to Active.

Adding Another Licensed Website

Depending on the theme or membership purchase, each one comes with a specific number of license usages. When you first activate your license key, you should see a message similar to this:

Definite licenses left count

With the example above, we see that 1/3 sites have been activated, which means we have 2 left. This also means that this license gives us a total of three separate websites that can use the same license key. If you have additional sites that you want to receive support and updates for, you have to add more sites to your license.

Add More Websites

  1. Log in to Rough Pixels and visit your Purchase History page.
  2. In the License Details table, click on the Manage Sites link.
    Seasoning manage websites
  3. Enter the Full URL (with the http://www or https://www part included) for the website you are adding.

    Add Website to be licensed
  4. Click the Add Site button.
  5. Repeat for additional websites you want to add.

Update Theme

Updating your theme is easily done because we have incorporated an update feature that is similar to the method if you had downloaded a plugin or theme from the wordpress.org website. When an update arrives, you will get a notification in your dashboard in a few areas:

Theme Update Notice
Another Theme Update notice

In the screenshot above, you can click Update Now for your theme, and then once it’s finished updating, you will have the latest version installed.

IMPORTANT: This update method only works if you have activated your theme with a license key, but also, to make sure your theme membership is still active and has not expired.

Installing Plugins

This theme recommends the installation and activation of some plug-ins to add additional features and capabilities. We made a shortlist of plugins to consider plugins:

  • Widget Options — Allows you to publish widgets to select pages and also hide widget titles;
  • Regenerate Thumbnails — This lets you regenerate thumbnails if you ever change sizes or the blog layout;
  • Contact Form 7 — Contact form plugin;
  • Mailchimp for WordPress — Adding a newsletter to your website;

Installing Plugins

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Install Plugins menu.
  3. In the Search field, type in the name of a plugin and once it shows up, click the Install button.

    Search and add plugins
  4. Once installed, you can click Activate and then customize the plugin’s settings if needed.

Site Title & Tagline

To change the site title, tagline and description, follow these steps:

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Site Identity.
  3. Open the Site Identity tab.
  4. Add or edit your site title.
  5. Add or edit your site description (tagline).
  6. You also have the option to hide the title and/or tagline; ideal if you want to use a logo.
  7. We’ve added a couple of colour selectors for the title and tagline.
  8. Click Publish button.

Favicon

Follow the below steps to set favicon on your site.

upload a site favicon
  1. Prepare your favicon image file. It must be square, and at least 512 pixels for the width and height.
  2. Log in to the WordPress Administration dashboard.
  3. Navigate to Appearance > Customize > Site Identity.
  4. Open the Site Indentity tab.
  5. Click Select Image at Site Icon section, upload the image file you prepared in the above step from Upload Files tab screen, and click Select.
  6. Click Save & Publish button.

Navigation Menus

The Amble theme supports up to 4 custom navigation menu locations. WordPress comes with a simple user interface that makes it quite easy for beginners to create and manage menus. From here, you can create your main menu, footer menu, and social icon menus.

Creating Menus

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Menus
  3. If you don’t have any menus, click the Create Menu button and create a new menu.
  4. From the blocks on the left side select pages that you want to add in your menu. Click the Add to Menu button.
  5. Once you’ve added a few items to your menu, you will see the added menu items on the right side in the Menu Structure section.
  6. If you want to rename a menu item, click the down arrow of a menu item to display its properties. You can then edit the navigation label that is displayed on menus.
  7. You can also change the order of menu items by dragging them to the position that you want them.
  8. To create a drop-down menu, drag a menu item slightly to the right of the menu item above it to create a sub-item relationship on the menu.
  9. Scroll to the bottom of the menu editor window. In the section titled Theme locations, click the checkbox for the location where you want your menu to appear.
  10. Click Save Menu button.
Seasoning creating menus

Social Profile Menus

The social profile menus are generally found at the top of your webpage and depending on the theme, in the footer area. The Seasoning theme supports the most popular social networks, which you can use to get followers to your site.

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to Appearance > Menus.
  3. If your social menu is not made, you will need to create a new one.
  4. You will add each social network by pasting in their respective URL into Custom Links the box under Add Menu Items. For example, we would enter in https://twitter.com/roughpixels for our twitter profile URL.
  5. Drag your new menu item(s) into your new menu
  6. Assign your social menu to the Top Social Links and/or Bottom Social links menu locations under Menu Settings
  7. Click the Save Menu button

Enable Thumbnail Creation

This theme includes the option to enable automatic thumbnail creation each time you upload a photo. This is generally a benefit when you want to maintain a consistent thumbnail size for blog posts, widgets, and anything else that uses thumbnails.

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options > Thumbnail Settings.
  3. Choose the type of thumbnail(s) you want to enable for automatic creation. We recommend that if you know what blog layout you plan to use, only set the thumbnail crop for that blog. If you enable the others, you end up with a lot more thumbnails that won’t be used.
  4. You also have an option to custom size your featured image for posts and pages. To handle this, you get settings for the width and one for the height.
  5. Click the Publish button to update the customizer.

With this theme, you get a hidden search bar that is located at the very top. When you click on the magnifying glass icon from your social menu area, a search form will slide into view:

Seasoning top search bar

Custom Login Page

You can customize your default WordPress login page with a nice feature included with this theme that lets you add a nice photo or graphic. Here is an example:

Seasoning custom login example

You can add a logo (I recommend a size of 450×300 pixels) that goes just above the login form. This is a preset dimension, so I recommend uploading your image with the size mentioned.

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options > Basic Settings.
  3. Look for the Login Page Image setting and click the Select image button
  4. Browse for your logo image in your Media Library, or upload one.
  5. Click the Publish button to update the customizer.

Theme Customization

The Definite theme offers a lot of customization. Using the theme-specific options and settings, you can change the layout, colors, background image, etc.

Customizer

Seasoning supports the WordPress Customizer. The Customizer is a framework for live-previewing any changes that you make to WordPress. It provides a simple and consistent interface for users to customize various aspects of their theme and their site, from colors and layouts to widgets, menus, and more. Themes and plugins alike can add custom options to the Customizer.

To access the WordPress Customizer, log in to the WordPress Administration dashboard and navigate to Appearance > Customize.

Seasoning customizer view

Blog Intro

Seasoning gives you the option to create a custom blog title and introduction. By default, WordPress does not give you this option, with exception to the category archive pages. Your heading group would look something like this

Seasoning blog intro example
  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options > Blog Settings.
  3. Enable your Blog Title Group by checking the box next to the Display Blog Title Group setting:
    Seasoning enable the blog intro group
  4. Type a blog title (heading) for your intro.
  5. Type a blog introduction for your intro.
  6. Click the Publish button.

Blog Layouts

The Seasoning theme has 6 blog layouts.

  • Default With Sidebar;
  • List Full Width no Sidebar;
  • Masonry Full Width no Sidebar;
  • Grid Full Width no Sidebar;
  • Gallery no Sidebar With Featured Image;
  • Large Full Width no Sidebar.

To change the layout, follow these steps:

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options > Blog Settings.
  3. Find the Blog Layout dropdown setting and select the layout you want to use.
  4. Click the Publish button.

Blog Excerpts

This tutorial will show you how to change your blog summaries to use excerpts instead. This is useful if you want a consistent look to your blog home page (and categories). Excerpts will also hide all formatting and page elements from view.

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options > Blog Settings.
  3. Find the Blog Summary Type  setting and select the Post Excerpt option.
  4. In addition to excerpts, you can also change how many words to show for excerpts. Simply adjust the Excerpt Length setting to what you want.
  5. Click the Publish button.

Blog Display Options

With all of our themes, we give you the option to show or hide various page/post elements:

Seasoning blog display options
  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options > Blog Settings.
  3. Check the boxes next to each item under the Summary Show or Hide Elements section that you want to show or hide on the post or page.
  4. Click the Publish button.

Post Layout

Similar to the blog layout option, you get 3 layouts for your full post view:

  • Post With Right Sidebar
  • Post With Left Sidebar
  • Post Full Width no Sidebar

To change your full post layout, follow these steps:

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options > Post Settings.
  3. Find the Full Post Layout setting and select the layout you want to use.
  4. Click the Publish button.

Post Display Options

Similar to the blog display options, you can show or hide various (full) post elements.

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options > Post Settings.
  3. Find the Show or Hide Post Elements  setting and decide what to show and hide from view.
  4. Click the Publish button.

Seasoning gives you the option to add captions to your blog post and page featured images.

Seasoning featured image captions

Captions will only show if your image has a caption added. However, if you do not want them to show, follow this tutorial:

  1. Log in to the WordPress Administration Panels.
  2. Go to Appearance > Customize > Theme Options > Blog Settings.
  3. Look for the Hide Post Summary Featured Image Caption setting and check the box to disable captions.
  4. For pages, go to Theme Options > Page Settings
  5. Look for the Hide Page Featured Image Caption setting and check the box to disable captions.
  6. Click the Publish button.

Colors

You can quickly and easily change the color with the available selectors that this theme offers. Each colour has a HEX value. For example, the screenshot you see below has a dark blue colour, so the HEX value for this orange is #dd9933. To create your color scheme, follow these steps:

  1. Log in to the WordPress Administration Panels.
  2. Go to Appearance > Customize > Colours.
  3. Open the Colours tab.
  4. Select the colour you want to change and click button Select Color with the built-in colour selector:

    Colour Selector
  5. By moving the circle on the colors area, select a color you want to use.
  6. Click the Publish button.

The copyright text is displayed at the bottom of every page. You can change the copyright text from within the customizer.

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options > Basic Settings.
  3. Type your custom copyright text in the Copyright Name field.
  4. Click the Publish button.

Custom CSS

Part of the WordPress customizer gives you the option to add some of your own CSS stylings. You can quickly and easily add your custom CSS code without touching the theme’s own code. Your CSS code will have the highest priority and will override your theme, and sometimes, plugin styles.

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Additional CSS.
  3. Add your custom CSS code, either by typing it or pasting your code.

    Adding custom CSS to the customizer
  4. Click the Publish button.

Seasoning includes a lightbox feature for viewing images from the WordPress Gallery Shortcode (even the block gallery). We decided to implement a lightbox (the ColorBox lightbox script) into this theme which now displays your gallery images in a popup overlay viewer.

NOTE: We are planning to remove the lightbox in the next update because it does not work with actual image captions correctly (not compatible). We will be offering an alternative.

  • Log in to the WordPress administration dashboard
  • Go to Appearance > Customize > Theme Options > Basic Settings
  • Look for the Enable the Gallery Lightbox setting and check the box.
  • Click the Publish button

Page Excerpts

We’ve given you a nice feature with pages by letting you add custom excerpts to your page titles. You can use excerpts as a way to provide a page introduction in addition to your main content.

Seasoning page excerpts example

To add an excerpt to a page, follow this tutorial:

  • Log in to the WordPress administration dashboard
  • When creating a new page, go to Pages > Add New
  • In the block editor Excerpt box, type out what you want your excerpt intro to display

    Block editor page excerpts
  • For existing pages, open your page up in the editor and then add your excerpt.
  • Click the Publish or Update button

Multiple Authors Template

Seasoning gives you a couple of author page templates, one is for displaying information about an individual author and posts they created. Then there is a custom template that was made specifically for showing a list of authors. The idea for this is to showcase all the authors that may take part in writing and publishing articles in your blog.

All you have to do is create a new page and choose the “Authors” template and then make a menu link to this page.

Seasoning multi-author template

Single Author’s Page

This template displays information about the author and the articles he/she has published. Also, when using the Yoast SEO plugin, you will also get the option to add social links.

Seasoning single author template

Theme Sidebars and Widgets

With the Seasoning theme, you get 18 sidebar positions. These help add more layout and content capabilities for your web pages, but will also depend on what widgets you add to them. To add widgets to the footer of your site, follow these steps:

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Widgets 
  3. Choose a Widget and either drag it to the sidebar where you wish it to appear.
  4. To customize the Widget features, click the down arrow in the upper right corner to expand the Widget.
  5. To save the changes you make to a widget, click Save.
  6. To remove a Widget, click Remove or drag the widget back into the Available Widgets list.

If you change WordPress Themes, any widgets you have will return to the Available Widgets list. You may need to add them again and rearrangement depending upon the new Theme’s sidebar positions.

Seasoning sidebar positions

Dynamic Width Sidebars

Most themes from others have fixed sized sidebars; meaning they don’t adjust in size based on what is published in each position. We offer Dynamic Width Sidebars which do adjust based on how many widgets you publish. If we use our Content Bottom sidebar group as an example, this is how it works:

  • Publish a widget in Content Top 1, your widget will become 100% in width.
  • Publish a widget in Content Top 1+2, each widget will now be 50% in width.
  • Publish three widgets in Content Top 1+2+3, each widget will become 33% in width.
  • Publish four widgets in Content Top 1+2+3+4, each widget will be 25% in width.

You don’t even need to publish them in sequential order of positions; you can do 1+3+4, without one being in the Content Top 2 position. They will still function the same way.

About Me Widget

With Seasoning, you get an “About Me” widget that gives you the option to upload a portrait photo and to write a brief introduction of yourself.

  • Log in to the WordPress Administration dashboard.
  • Then navigate to Appearance > Widgets
  • Drag the Seasoning About Me widget into the sidebar position you want to show it in.
    1. Add a title for your widget
    2. Add author’s name
    3. Add an author’s link to point to a page or a social profile.
    4. Upload a portrait photo
    5. Add an author’s introduction
  • Click the Save button

Recent Posts Widget

The Seasoning theme includes a recent posts widget to display the most recent posts with thumbnails. The thumbnails are automatically generated from the featured image you upload for the post(s).

  • Log in to the WordPress Administration dashboard.
  • Then navigate to Appearance > Widgets
  • Drag the Seasoning Recent Posts widget into the sidebar position you want to show it in.
    1. Add a title for your widget
    2. Choose a category from where to get posts from
    3. Select the number of posts to display
  • Click the Save button
Seasoning recent posts widget

Recent Post Thumbnails

This theme gives you the option to generate cropped thumbnails for this widget (and other parts of your website).

  1. Log in to the WordPress Administration dashboard.
  2. Go to Appearance > Customize > Theme Options > Thumbnail Settings
  3. Check the box next to the Crop images for the recent posts thumbnails setting

No Thumbnail?

If your post does not have a featured image, a placeholder thumbnail will take its place:

Amble recent posts replacement image

Social Profile Widget

A great compliment to your About Me widget, this social widget simply adds a widget to your sidebar with icon-based links to your social profiles. The widget will have preset fields for the available social profiles, but we may add more over time.

  1. Log in to the WordPress Administration dashboard.
  2. Then navigate to Appearance > Widgets
  3. Drag the Seasoning Social Widget into the sidebar position that you want to show it in.
  4. Title your widget
  5. For each social network, enter the full URL to your profile. For example, Twitter would be https://twitter.com/roughpixels

    Seasoning social widget
  6. Click the Save button

Image Widgets

WordPress includes a default Image Widget that lets you display images.

WordPress image widget

Front Page Banner Sidebar

The Seasoning theme has a special style that is dedicated to the banner sidebar when you publish an image widget to it.

This is great when you want to display images in sidebars, but it lacks some important customization features. This theme gives you some flexibility when using the image widget, so let me show you what we did…In the live demo, you will see a big image with a title and a sub-heading above it:

Seasoning front page showing a custom styled image widget

What is special about this, is that when you use the image widget in the Banner sidebar position and add a widget title with an image caption, you get the layout you see in the screenshot above.

NOTE: This style and layout is applied only if you publish the image widget to the Banner sidebar

Adding Image Widget Classes

Here is an example of what this tutorial will take you through the steps to get this result:

Seasoning image widget with a class added

Normally the default style for an image widget is to show the caption below the image, but this theme gives you the option to add a widget class. However, to take advantage of this, you will need a plugin to add classes to widgets. There are only a couple of plugins that do this efficiently:

  1. Widget Options – which the demo for this theme uses
  2. Widget CSS Classes

Although these are considered optional in this theme, either one will be required to add a class to a widget. Unfortunately, WordPress refuses to make this feature built-in, but with the new block editor now part of WordPress, you can now add classes to blocks.

If you decide to use the classes option, here is the one additional style you get where adding the class promo to the class field puts the caption on top of the image instead of the default bottom area (right side screenshot).

Seasoning image widget using the promo class

MailChimp for WordPress

If you are using the Mailchimp for WordPress plugin, you might want to take advantage of this theme’s custom styling. This tutorial is based on the live demo site for this theme.

The first thing that is important, is that you will need some HTML code to paste into your Mailchimp form field.

<div class="row align-items-center">
    <div class="col-lg-12">
        <div class="newsletter-block">
            <p class="newsletter-intro">
                Sign up to receive exclusive tips on making better meals for your family!
            </p>
            <div class="form-group">
                <input type="email" class="form-control" name="EMAIL" placeholder="Your email address" required />
            </div>
            <div class="form-group">
                <input type="text" class="form-control" id="mc-email-1" placeholder="Enter email address" name="mc-email1">
            </div>
            <div class="form-group">
                <input type="submit" value="Sign up" />
            </div>
        </div>
    </div>
</div>

You may need to edit some of the fields as it pertains to your form, but the important part is the <div> and <p> containers and the classes of each of the form input fields, and the input field ID’s. If all goes well, you should get a sidebar Mailchimp widget that looks similar to this:

Seasoning Mailchimp widget style

If you decide you want a horizontal layout of your Mailchimp newsletter widget, we have this on the live demo site for Seasoning.

Seasoning styling for a horizontal Mailchimp newsletter widget

However, to get this layout and style, you need a plugin to add a class newsletter-wide to the widget. The Seasoning theme already has the styling for it, but your newsletter widget needs the class added.