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.

Ariele 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 ariele.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 Ariele
  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 ariele.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 ariele 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 Ariele theme in the list of themes.
  7. Move the cursor on the block with the Ariele theme and click the Activate button.
    Activate Ariele 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:
    Ariele 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:

Ariele 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.
    Ariele 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;

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. Decide if you want to use a logo, but if not, add/edit the site title
  6. Add or edit the site tagline (description).
  7. 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.
Ariele 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 an overlay search page that shows up when you click on the magnifying glass icon from the social bar area:

Ariele search icon

The top bar area has it’s own custom options:

  • Log in to your WordPress Administration dashboard.
  • Navigate to Appearance > Customize > Top Bar Options
    1. You can show the top bar area
    2. You can show the left side (social icons)
    3. You can show the right side search area (search icon)
    4. You can change the background colour of your top bar area
  • Click the Publish button after your changes
Ariele top bar area with social and search

Theme Customization

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

Customizer

The Ariele 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.

Ariele customizer

Boxed Layout

With Ariele, you can have your website pages full width or you can change to the boxed layout style.

Ariele boxed layout
Ariele full width

To choose a boxed or full-width layout, follow these steps:

  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options
  3. Look for the Boxed Layout setting and check the box next to it.
  4. Click the Publish button

Blog Intro

Ariele 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 the “What’s New?” example below:

Ariele blog intro
  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Label Options
  3. Type a blog title (heading) for your intro.
  4. Type a blog introduction for your intro.
  5. If you decide to hide the blog intro, you can check the box next to the Hide the Blog Heading Group setting
  6. Click the Publish button.

Blog Layouts

The Ariele theme has 8 blog layouts.

  • Classic Right Sidebar
  • Classic Left Sidebar
  • Grid
  • Grid Left Sidebar
  • Grid Right Sidebar
  • Wide
  • Minimal Left Sidebar
  • Minimal Right Sidebar

To change the layout, follow these steps:

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options.
  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
  3. Find the Use Excerpts setting and check the box next to it.
  4. In addition to excerpts, you can also change how many words to show for excerpts. Look for the Excerpt Size setting and enter how many words you want to show. You can also use the up/down arrow (hover over the field) on the field to change the count by increments of 5 words.
  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. For the Ariele theme, the elements to show or hide have the word “summary” in the labeling.

Ariele show or hide elements in the blog
  1. Log in to the WordPress Administration dashboard.
  2. Navigate to the Appearance > Customize > Theme Options
  3. Check the boxes next to each item that are associated with the “summary“.
  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
  3. Find the Full Post Style 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
  3. Check the boxes next to each item that is associated with the “Full Post“.
  4. Click the Publish button.

Hiding the Featured Image Captions

In the event you want to disable the featured image captions as you see here:

Ariele featured image caption example
  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Theme Options.
  3. Check the box Hide the Featured Image Caption to hide the caption.
  4. Click the Publish button.

Theme Backgrounds

Ariele offers many background options as it relates to not just the page background itself, but also select elements like the content containers. Let’s take you through each one.

Page Background Image

This will take you through the steps of adding a background image or photo to your page. Please keep in mind that your background will only show if you are using the boxed layout for your website.

  1. Log in to the WordPress Administration dashboard.
  2. Go to Appearance > Background.
  3. Upload or select an image from your Media Library
  4. Click the Publish button.

Background Colours

This tutorial will take you through the rest of your background options, relating to colours and not images.

  • Log in to the WordPress Administration dashboard.
  • Go to Appearance > Colours
    1. Colour selector for your body background
    2. Colour selector for your inner page background
    3. Colour selector for your post container background
    4. Although this is not a background, this sets the border colour
  • Click the Publish button.
Ariele backgrounds

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

Labels

With Ariele, you can change some of the labels such as “Read More“, and a few others that show up in the front-end of your website. But we’ve also included an additional setting for the default blog home page. When you first install WordPress, your blog is the front page and you will notice there is no title or introduction for it, so we’ve included one.

Blog Intro

NoteThe blog heading is only if you are not using a custom page for your blog.

Empt blog title group label settings
  1. Log in to the WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Label Options.
  3. Customize the label you want to change for each of the listed label settings
  4. Click Publish button.

When done, this will add a similar blog intro group to the live demo like this:

Ariele blog intro

NOTE: When you move the blog from the front-page of your website, this setting will no longer be used; the page you create will be then be used to display the title and the introduction text. However, the setting to disable the intro, even with a page being used, will still hide it if you choose.

Read More

To change Read More to something else, you can use this setting:

  • Log in to the WordPress Administration dashboard.
  • Navigate to Appearance > Customize > Label Options
  • Edit the Read More Text field
    Ariele read more setting
  • Click the Publish button

Ariele includes the option to display Related Posts at the bottom of each article, but this tutorial is going to show how you can change the heading “Your Might Also Like“.

Ariele related posts example
  1. Log in to the WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Label Options
  3. Look for the Related Posts label field and then change it to your own preference
    Ariele Related Posts label setting
  4. Click the Publish button.

Archive Titles

Unfortunately, with WordPress, when you visit a category or other type of archive page, you will always get a prefix label. For example, a blog category will always get the prefix “Category:” added. So if your blog category is People, you will see Category: People

This tutorial will show how to disable the prefix labels.

  1. Log in to your WordPress Administration dashboard.
  2. Navigate to Appearance > Customize > Label Options.
  3. Check the box next to the Hide Prefix in Archive Page
    Ariele hide archive prefix label
  4. 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 > Label Options
  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.

We have incorporated the Colorbox lightbox feature for viewing images from the WordPress Gallery Shortcode (even the block gallery). You can now view your photos 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 > Other Options
  • Look for the Enable Gallery Lightbox setting and toggle the setting
    Empt gallery lightbox setting
  • Click the Publish button

Disable Gutenberg Styles

Not everyone wants to use the Gutenberg block editor that is now the default editor in WordPress. Many are using the Classic Editor instead, so we added a setting to disable the block styles.

  1. Log in to the WordPress administration dashboard
  2. Go to Appearance > Customize > Theme Options
  3. Look for the Disable Gutenberg Styles setting and check the box to disable
  4. Click the Publish button at the top

Once you do this, no more block styles will load, which helps speed up your website. From this point, just keep the classic editor as your default one.

Remember, though, when disabling the block styling, anything that was using blocks will now be unstyled. You will also lose the ability to do some of the blocks that we put into the live demo for this theme.

Theme Sidebars and Widgets

With the Ariele theme, you get 12 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.

Ariele 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 Footer 1, your widget will become 100% in width.
  • Publish a widget in Footer 1+2, each widget will now be 50% in width.
  • Publish three widgets in Footer 1+2+3, each widget will become 33% in width.
  • Publish four widgets in Footer 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 Footer 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. You even have the option to add a signature.

Ariele about me widget
  • Log in to the WordPress Administration dashboard.
  • Then navigate to Appearance > Widgets
  • Drag the Ariele About Me widget into the sidebar position you want to show it in.
    1. Add a title for your widget
    2. Upload a portrait of yourself (or author).
    3. (Optional) Upload an image of your signature.
    4. Add author’s name
    5. Add an author’s introduction
    6. (Optional) Insert a URL link if you want to show a button linking to something
    7. (Optional) Type in a button label
  • Click the Save button

Recent Posts Widget

We’ve included a nice widget for you that displays the most recent posts with thumbnails. The thumbnails are automatically generated from the featured image you upload for the post(s). You can publish this in the left or right sidebars, or the bottom, or the footer.

Ariele recent posts widget
Ariele recent posts widget in the footer
  • Log in to the WordPress Administration dashboard.
  • Then navigate to Appearance > Widgets
  • Drag the Recent Posts with Thumbnails widget into the sidebar position you want to show it in.
    1. Add a title for your widget
    2. Select how many posts to show
    3. Choose how to order the posts
    4. Select the category to grab posts from
    5. Display the post date?
  • Click the Save button
Ariele recent posts settings

Comments Widget

We took the default WordPress Recent Comments widget and made a couple of modifications to it. Instead of a basic list of comments, we added more style.

Ariele comments widget
Ariele comments widget in the footer
  • Log in to the WordPress Administration dashboard.
  • Then navigate to Appearance > Widgets
  • Drag an Ariele Recent Comments widget into a sidebar position
  • Click the Save button