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.

Amble 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 amble.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 Amble
  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 amble.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 amble into 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 Amble from the themes 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:

    Amble 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:

Amble licenses left

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.

    Amble manage sites
  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;

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. Now you will see three input fields:
    • Logo — Upload a logo if you plan to use one.
    • Site Title — Displayed in the sidebar and in the browser tab.
    • Tagline — This is your site tagline, also known as the site description.
  5. Type your custom the site title and tagline.
  6. 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 3 custom navigation menu locations which include your main menu, a social, and a footer menu. WordPress comes with a simple user interface that makes it quite easy for beginners to create and manage 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.
Amble 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 Amble 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 one or both of the social 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:

Amble top search

Front Page Featured Post

When viewing the demo site for Amble, you will see a featured post displayed at the top banner area. Normally themes will use a slider option, but we decided to make this less resource-intensive by letting you choose “any” blog post as your featured post.

Amble featured post

This is how you can set up your featured post:

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options > Basic Settings.
  3. Look for the Front Page Featured Excerpt Size setting and change it to your preference.
  4. Click the Publish button.

The only caveat is that this shows the latest post that is tagged with “featured“, so if you want to use an older post, you will need to delete the tag from the existing post that is being displayed. If you are always featuring the latest post, then you don’t have to delete the tag from older posts, only if you use a post from a previous date.

NOTE: We will be changing this to make it easier in an upcoming update.

Featured Post Excerpt Size

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options > Basic Settings.
  3. Look for the Front Page Featured Post Tag setting and change the default Featured tag to whatever you want–or you can leave it as it is.
  4. Click the Publish button.

Featured Post Image

This theme has a setting that lets you crop your featured post image so things stay consistent.

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options > Basic Settings.
  3. Look for the Crop image for the Front Page Featured Post setting and check the box to crop it.
  4. Click the Publish button.

Normally this should be done if you plan to use the front page featured post, so that when you upload a photo for your blog post, having this one thumbnail setting checked will also generate a pre-sized image.

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:

Amble custom login page

You can add a logo 450×300 pixels that sits 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 Amble theme offers a lot of customization. Using the theme-specific options and settings, you can change the layout, colors, background image, etc.

Customizer

The Amble theme 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.

Amble Customizer

Blog Intro

Amble 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

Amble 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:

    Amble enable blog intro setting
  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 Amble 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:

Amble 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.

Page Background

Using the WordPress page background feature, Amble incorporates this into your theme. Backgrounds are best suited when you are using a boxed layout for your pages.

  • Log in to the WordPress Administration Panels.
  • Go to Appearance > Background.
    1. Change the background colour with the selector
    2. If you are adding a background image, use the image button.
  • Click the Publish button.
Amble page background

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.

Theme Sidebars and Widgets

With the Amble theme, you get 11 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.

Amble 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 Bottom 1, your widget will become 100% in width.
  • Publish a widget in Content Bottom 1+2, each widget will now be 50% in width.
  • Publish three widgets in Content Bottom 1+2+3, each widget will become 33% in width.
  • Publish four widgets in Content Bottom 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 Bottom 2 position. They will still function the same way.

About Me Widget

With Amble, 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 Amble 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. Upload a portrait photo
    4. Add an author’s introduction
  • Click the Save button
Amble About Me widget

Recent Posts Widget

The Amble 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).

  1. Log in to the WordPress Administration dashboard.
  2. Then navigate to Appearance > Widgets
  3. Drag the Amble Recent Posts widget into the sidebar position you want to show it in.
  4. Enter the number of posts to display
  5. Click the Save button

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 Amble 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

    Amble social widget
  6. Click the Save button