Huesos Documentation

on

Overview

Information described in this documentation will give you an idea of how to setup your site to look and function like the theme demo. View the changelog for more a detailed record of all the changes made to Huesos.

Getting Started

After activating Huesos, you can jump in and start customizing your theme right away by going to Appearance → Customize. You’ll find options for adding a logo, changing colors, assigning custom menus, and front-page settings.

Detailed instructions for working with the theme’s unique features are included below, but if you run into any issues or have a question and have an active support license, you can get in touch through the priority support form.

Huesos requires WordPress 4.1+

Site Logo

Your site’s title and tagline will be displayed in the header area of Huesos by default, but you can easily replace the text with your own logo or custom image in the Customizer:

  1. Go to Appearance → Customize
  2. Click the Site Title section to expand it
  3. Upload a new image in the Logo field

You may also customize the site title and tagline text in this section, or hide them to display the logo by itself.

Homepage

The homepage is typically one of the first pages most visitors see when visiting your site. While it shows a list of your latest posts by default, Huesos includes various options that allow you to customize the layout and information displayed so you can highlight your most important information.

Read the instructions for setting up a static front page if you’d prefer to use a page for your homepage. You’ll also want to create a page for displaying your latest posts — see the Blog section below.

Widgets

Additional content can be added to the homepage using widgets — go to Appearance → Widgets and drag individual widgets to the widget area labeled Home. By mixing and matching widgets, you can create a truly unique homepage.

Blog

When using a static front page, you’ll also want to be sure to create a page for your posts. If you haven’t already done so:

  1. Go to Pages → Add New to create a new page for your posts
  2. Give the page a title (“Blog” or “News” work well)
  3. Click the Publish button to create the page
  4. Go to Settings → Reading
  5. Select the page you just created in the Posts Page dropdown
  6. Click the Save Changes button

Now when visiting that page on your site, it will display a list of your latest posts. Be sure to add it to your Primary Menu so your visitors can easily find it.

Post Formats

Aside from standard posts, Huesos has built-in support for two more Post Formats: Links and Quotes.

Custom Menus

Custom Menus provide granular control over the links that appear in the various navigation areas on your site. Huesos supports two menu locations: the Primary Menu navigation and the Social Menu (the social icons on the lower left sidebar in the demo).

You can create and assign menus by going to Appearance → Menus.

Primary

The Primary Menu appears just below the Site Title and is the most important tool for helping visitors navigate your site. It supports up to three levels of nested menu items.

Social

The Social Menu allows you to display links to your social media profiles as icons. Each menu item should be added as a Custom Link. Huesos will automagically display the correct icon based on the link URL. For example, a link like https://twitter.com/audiotheme will display a Twitter icon because the theme has detected it is a URL pointing to Twitter.

The following icons are bundled in Huesos for use in your Social Menu: Amazon, Apple/iTunes, Bandcamp, Facebook, Flickr, Google Play, Google+, Instagram, Last.fm, LinkedIn, Pinterest, Rdio, ReverbNation, SoundCloud, Spotify, Tumblr, Twitter, Vimeo, WordPress, and YouTube.

If you’d like to add support for additional icons, read the section on customizing Huesos below.

Sidebars & Widgets

Huesos features two widget areas: a Main Sidebar and a Home widget area. Read more about managing widgets in the documenation on using WordPress Widgets.

Main Sidebar

When it contains visible widgets, the Main Sidebar appears on the right side of posts, archives, and any pages using the default page template.

It can be disabled on individual pages by selecting the No Sidebar or Full Width page templates (see Page Features & Templates).

To toggle the sidebar on the AudioTheme archives and pages, edit the respective archive and check the box to disable the sidebar. For instance, to disable the Main Sidebar when viewing records or tracks:

  1. Go to Discography → Archive
  2. Check the checkbox that says “Disable the sidebar on this archive?” to disable the sidebar when viewing the list of records
  3. Check the checkbox that says “Disable the sidebar for posts in this archive?” to disable the sidebar when viewing individual record and track pages
  4. Click the Update button

Custom Sidebars

It’s also possible to create custom sidebars for individual pages using a plugin like Simple Page Sidebars.

Another option is to use the Widget Visibility module in Jetpack to control which pages individual widgets will show.

Home

The Home widget area appears below the main content on the homepage and provides a unique way to feature your important media and content (see Homepage setup).

Page Features & Templates

Huesos includes two page templates that allow you to remove the sidebar from a particular page. The No Sidebar page template simply removes the sidebar, while the Full Width page template removes the sidebar and allows your content to expand to fill the empty space.

To assign a page template:

  1. Create a new page or edit an existing page
  2. Find the Page Attributes box and select a page template option in the Template field

Audio Player

As you begin publishing records and tracks (with playable MP3 files), the site-wide audio player will automatically become available and display the most recent record by default.

Visitors can choose to play various records and individual tracks in the audio player by clicking the play button on record artwork and tracks as they browse the site. Their selection and play state will be remembered as move from page to page.

For more control over the default playlist, Cue can be installed to manage playlists with any arrangement of tracks.

Gig, Record, & Video Archives

Be sure to read the documentation about setting up your archives to add links to your discography, gig, and video pages.

Gigs

Help on how to setup gigs can be found in the AudioTheme plugin documentation.

Records

Help on how to setup records can be found in the AudioTheme plugin documentation.

Videos

Help on how to setup videos can be found in the AudioTheme plugin documentation.

Photos

The photos page in the theme demo is displayed using a WordPress gallery shortcode. To display the photos in a tiled grid, you will need to install and activate the Jetpack plugin, then enable its Tiled Gallery module.

Once Jetpack is activated, you can create your Tiled Gallery by following these steps:

  1. Go to Jetpack → Settings
  2. Activate the Tiled Galleries module
  3. Edit an existing page or create a new page
  4. Create a new gallery with the “Tiles” option selected
  5. Optional: To make all of your galleries tiled by default, go to Settings → Media in your site’s dashboard and select the checkbox next to “Display all your gallery pictures in a cool mosaic”

Plugin Support

Huesos also has built-in support and styles for the plugins listed below. Each plugin can be installed and activated from the Plugins screen in your WordPress dashboard.

WooCommerce

We’ve added basic support for WooCommerce to ensure its templates load correctly within Huesos, however, you will need to customize the WooCommerce styles if you want a more seamless integration.

Customizing Huesos

Custom CSS

For making minor CSS customizations, we recommend using a plugin that allows you to easily add your snippets in the WordPress admin panel. If you’re already using Jetpack, it ships with a Custom CSS module, otherwise, Custom CSS by Dev7studios is a good standalone option.

Child Theme

When looking to make more advanced customizations to Huesos, make your changes in a Child Theme to ensure your modifications aren’t lost when we release updates. You should never directly edit code in a parent theme.

You can download a sample child theme here. In the sample, we’ve changed the site content background color from white to red as a way to demonstrate the changes are working.

Need Customization Help?

If you need help customizing your theme, you can find help in the following places