Setting up your theme

1) Creating theme pages

  1. Homepage: Create a page named Home and apply to it the Homepage Template from the page attributes panel on the right.
  2. Discography listing: This page will list your discography items. Create a new page and apply the Discography Listing template to it. From the Discography Listing Options panel that appears below the main text editor, you can select the column number for the listing page, toggle the isotope effect and modify the number of items displayed on the page at once. Additionally you can select a Base Category for the listing page. Meaning that you can use the template to display only one of your discography categories, instead of all of them.
  3. Artists listing: This page will list your artists. Create a new page and apply the Artists Listing template to it. From the Artists Listing Options panel that appears below the main text editor, you can select the column number for the listing page, toggle the isotope effect and modify the number of items displayed on the page at once. Additionally you can select a Base Category for the listing page. Meaning that you can use the template to display only one of your artist categories, instead of all of them.
  4. Events listing: This page will list your events. Create a new page and apply the Events Listing template to it. From the Events Listing Options panel that appears below the main text editor, you can change the events sections titles and toggle the appearance of future or paste events. Select the column number for the listing page, toggle the isotope effect and modify the number of items displayed on the page at once. Additionally you can select a Base Category for the listing page. Meaning that you can use the template to display only one of your event categories, instead of all of them.
  5. Gallery listing: In this page you display your galleries. Create a new page and apply the Galleries Listing or Galleries Stapel template to it. From the Galleries Listing Options panel (that appears below the main text editor when you select the Galleries Listing template), you can select the column number for the listing page, toggle the isotope effect and modify the number of items displayed on the page at once. Additionally you can select a Base Category for the listing page. Meaning that you can use the template to display only one of your gallery categories, instead of all of them.
  6. Videos listing: This page will list your videos. Create a new page and apply the Videos Listing template to it. From the Videos Listing Options panel (that appears below the main text editor), you can select the column number for the listing page, toggle the isotope effect and modify the number of items displayed on the page at once. Additionally you can select a Base Category for the listing page, meaning that you can use the template to display only one of your gallery categories, instead of all of them.
  7. Blog: This page will display your posts if you apply the default template to it.

(TIP: all page titles serve as examples, you can name your pages according to your needs.)

Once the pages are created, navigate to Settings > Reading. Set the Home page to be your static frontpage and the “Blog” page to be your posts page, as demonstrated in the image below.

reading-settings

2) Populating your blog

To add new posts to your blog, go to Posts > Add New, title your post and enter the content in the editor. Upload a featured image by clicking Set featured image on the Featured Image panel. Add a category and/or tag to the post from the respective panels and publish the post by clicking Publish.

add-new-post

3) Creating Slider items

Go to Slideshow > Add New. Set the title. This is the text that will be displayed inside the slide. Set the featured image which will be cropped automatically to fit the slider. In the Slider Settings you can set the slider button text & URL. Set up to two subtexts and choose whether they will be rotated. Slider behavior, like autoplay and slideshow speed can be configured under Appearance > Customize > Front Page.

oscillator-homepage-video-music-player

The music player that appears at the bottom of the slider on the theme’s demo, can be configured under Appearance > Customize > Front Page.

4) Creating event items

Now you can start inserting your events from Events > New Event. Start by giving the event a title. We leave the main editor empty and we move a bit lower in the Event Settings section. Here you can fill in the event’s info, details, status, location and sidebar placement. Each tab provides some information concerning its usage.

oscillator-event-settings

TIP: If you leave the coordinate boxes empty the map won’t appear in the single event view

5) Creating discography items

Go to Discography > Add New. Set the album title and upload the album’s cover in the featured image section. Now in the main editor you can write anything you want. Plus you can display the tracklisting of your album with the ability to let the users review your tracks! To do this you are going to use our tracklisting system.

oscillator-discography-settings

In the Discography Settings panel, you can fill in the album’s info, details, and track.

Tracklisting

Each discography item, can have multiple tracks assigned to it. Tracks can be registered through the Tracks section, that is within the Discography Settings section.

To add a new track, press the Add Track button. This will add a new empty line for you to fill. First, add a title and optionally a subtitle. If the track can be purchased online, enter the URL inside the Buy URL field.

You can provide a preview (or even the full song) for your visitors to listen to, by entering the URL of the MP3 file inside the Play URL field. You can upload and/or select an already uploaded song through the WordPress Media Manager, by pressing the button located inside the field.

You may allow your users to download the track, by entering the song’s URL inside the Download URL field. Please note that for locally hosted MP3s, the theme tries to force the visitor’s browser to download the file. If the file is on another server, whether it will be downloaded or just opened, is a matter of configuration of the remote server and not the theme’s issue.

You can also add lyrics for each track, in the Song Lyrics field.

Tracks can be re-arranged by drag and drop. Track numbers are automatically updated to be in sequence.

In order to remove a track, press the Remove Me button next to the desired track. Please be careful, as there is no confirmation of removal. If you publish/save/update the post, the change is irreversible.

oscillator-track-listing

Displaying the track listing

Once you add your tracks you may display them by using the [tracklisting] shortcode in the discography item’s main text box. By default, it will display the tracks of the current discography item, so the simple way to do it, is this:

[tracklisting]

You may also display the track listing of any discography item, in any other post/page or widget (that supports shortcodes) by passing the ID or slug parameter of the discography to the shortcode, like this:

[tracklisting id=”25″]

or

[tracklisting slug=”the-division-bell”]

You can also selectively display tracks, by passing their track number (counting from 1), separated by a comma, like this:

[tracklisting tracks=”2,5,8″]

And can limit the total number of tracks displayed like this:

[tracklisting limit=”3″]

Of course, you can mix and match the parameters, like this:

[tracklisting slug=”the-division-bell” tracks=”2,5,8″ limit=”2″]

6) Adding video items

Go to Videos > Add New to give a title and a featured image to your video. Move to the Video Settings panel. Here you can add a date, location and any other information you want for your video. In the Video URL box you will need to place your video’s URL, which is hosted in one of WordPress’s supported providers.

oscillator-video-settings

7) Adding gallery items

In order to create a new photo gallery go to Galleries > Add New. Give a title, a featured image and move to the Gallery Settings panel.

oscillator-gallery-settings

Click the Add Images button to upload your photos. Once you are done you can toggle gallery image randomization if you want.

8) Adding artist items

In order to insert a new artist just visit Artists > Add New. Add the artist’s name as a title, upload the featured image and fill in any information you want in the text editor. You can also fill any additional information in the Artist Settings panel. Publish the item.

oscillator-artist-settings

9) Creating your menu

Now that your content is in place, you will need a menu. Go to Appearance > Menus, check the pages you want on your menu and add them. Give your menu a name and save it. Finally you will need to set your menu as Main menu. This can be done either by checking the Main menu box in Menu Settings just below your menu items in Menu Structure, or by going to the Manage Locations tab and selecting the menu you just created. The theme also features a Footer Menu which you can create and assign following the same steps. The secondary menu will appear above the main menu and to the right. Please note that the footer menu does not support sub menu items.

oscillator-menus

(TIP: for more info on creating and managing menus, please read the WordPress Menu User Guide here)

10) Setting up your homepage

The homepage on Sessions consists a homepage slider and the Front Page widget area. The widget area of the homepage can be accessed under Appearance > Customize > Widgets.

oscillator-customizer-widgets

Duplicating the demo’s homepage

On the theme demo’s front page you can see three slider items, the audio player enabled and the following widgets in the Front Page sidebar:

  • a Theme – Events widget, displaying three upcoming events
  • a Theme – Items widget, displaying three gallery items in a three column layout
  • a Theme – Hero text widget with some text on it
  • a Theme – Tracklisting widget displaying the tracklisting of a discography item
  • a Theme – Latest Post Type widget, displaying the latest six discography items in a three column layout.

11) Changing Footer text

The theme’s footer features an area for you to enter your copyright information or other information. To change the text you need to go to Appearance > Customize > Footer Options and use the appropriate box.

oscillator-footer-options

12) Default header display

You can change the default background image displayed on the header by going to Appearance > Customize > Header Image and upload your own.

oscillator-default-header-display

13) Homepage video and music player

Under Appearance > Customize > Front Page you can select to upload and display a video on the front page. You can also set up the audio player which appears below the slide. You can also use either the tracklisting from an album, or a ShoutCast/IceCast stream which outputs mpeg audio.

oscillator-homepage-video-music-player

14) Section titles

Default titles for sections can be modified under Appearance > Customize > Titles.

oscillator-section-titles

15) Custom Widgets

The theme features several custom widgets, created to help you display your content better.

oscillator-widgets

All widgets can be accessed from Appearance > Customize > Widgets.

Below each widget you will find a small description explaining their functionality.

The Customizer settings panel

All of the theme’s settings have been integrated in the WordPress’ customizer. You can find them under Appearance > Customize. From here you can toggle the sticky header, upload your logo, set up the front page, change the color scheme of the site, add or remove widgets, modify section titles and more.

oscillator-customizer

Additional Information

Useful Plugins

  • CSSIgniter Shortcodes You can use this shortcode plugin to create a variety of layouts and elements on your site. Instructions can be found here.
  • Socials Ignited Use this plugin to create a widget that links to all your social profiles. You can also customize it with your icons and add new social networks. A guide can be found here.
  • Contact Form 7 Use this plugin to create a contact form, then copy the shortcode it gives you and paste it in an empty page.
  • WP Instagram Widget: Use this plugin to help you display your Instagram feed in any of the theme’s sidebars.

Image Sizes

The recommended image sizes for the Oscillator theme are:

  • Post Thumbnail: 750x420px
  • Header Image: 1920x100px
  • Slider: 1920x1060px
  • Square Thumbnail: 650x650px
  • Masonry Thumbnail: 750px width, not restricted in height.