Documentation for Oxium

About

Oxium is a WordPress theme for DJs, Solo artists, Bands, Collectives, Club Owners, music producers, events producers and anyone in the music industry.

WordPress theme installation

The easiest way to install the theme, is by accessing your WordPress admin panel, then go to Appearance > Themes. Select the Install Themes tab and click the Upload link located just below the tab’s name. Click on Browse… and select the WordPress theme zip file you just downloaded. Then click the Install Now button, and after a few seconds, your new theme should be installed. Click activate and the theme is ready to use.

In order to install the theme manually, or in case you have trouble installing it through the admin panel, you have to unzip the WordPress theme’s zip file on your computer, and upload via FTP the resulting theme folder into your WordPress installation themes folder (wp-content/themes). Then, from the WordPress admin go to Appearance > Themes. The theme should be available in your themes list. Click activate.

After activation, you will be redirected to the CSSIgniter Settings panel (accessible from Appearance > CSSIgniter Settings) to start customizing your brand new theme.

Image Sizes

The recommended image sizes for the Oxium theme are:

• Post Thumbnail: 546x546px
• Fullwidth Page – Slider: 750x400px
• Listing thumbnail: 546x300px
• Masonry Thumbnail: 546px width, not restricted in height.

Useful Plugins

These plugins provide functionality and features used directly (or not) by the Theme. So, it is recommended to install and activate them before importing your sample content.

• AudioIgniter use our free audio player plugin to create playlists and display them on the discography items or anywhere else on your site.
• CSSIgniter Shortcodes you can use our custom made shortcode plugin to help you create a variety of layouts and elements on your site. Instructions 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.
• One Click Import : Use this plugin to help you import your content with just one click.

Importing Sample Content using One Click Import

To automate the process of importing and for a better experience we have natively included support for OneClick Import Plugin. Let install it fist:

From your WordPress dashboard

1. Visit ‘Plugins > Add New’,
2. Search for ‘One Click Demo Import’ and install the plugin,
3. Activate ‘One Click Demo Import’ from your Plugins page.

From WordPress.org

1. Download ‘One Click Demo Import’.
2. Upload the ‘one-click-demo-import’ directory to your ‘/wp-content/plugins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
3. Activate ‘One Click Demo Import’ from your Plugins page.

Once the plugin is activated you will find the actual import page in: Appearance > Import Demo Data.

 Click on the Import demo data button and you are done!

This plugin requires PHP version of at least 5.3.x, but we recommend version 5.6.x or better yet 7.x. Please contact your hosting company and ask them to update the PHP version for your site.

Importing sample content manually

To get the sample content file you can click the link in the notice that will appear on your dashboard immediatelly after activating the theme.

Extract the zip file you downloaded and upload the xml file in Tools > Import > WordPress (if not already present, you will be prompted to install the WordPress importer plugin), assing the authors to an existing user and make sure you check the “import attachments” box. You can now import the sample content.

You can also download the Sample Content for Oxium by clicking here

Importing widgets

You can also import the widgets you see on the theme’s demo. To do that, you need the Widget Importer & Exporter plugin. To install it go to Plugins > Add new search for widget importer exporter and install the plugin. Activate it and go to Tools > Widget Importer & Exporter click choose file and upload the oxium_widgets.wie file which is located in the sample content zip file, click Import widgets and you are good to go.

WARNING: As this will create posts, pages, custom post types, categories, widgets, etc. and change various system settings, it is strongly advised that you do this on a clean WordPress installation, without any previous and/or precious data. Under no circumstances we can be held responsible for total or partial data loss, so please be careful.

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 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 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 toggle the appearance of future or past events 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 will display your galleries. Create a new page and apply the Galleries Listing 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 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 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, 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 and set the “Home” page to be your static frontpage and the “Blog” page as your posts page, as demonstrated in the image below.

Notice: if you have selected the Blog – Fullwidth template, do not set the blog page as your static posts page, leave that drop down empty.

2) Populating your blog

To add new posts to your blog, go to Posts > add new, title your post, 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, if you so desire, from the respective panels and publish the post by clicking “Publish”.

3) Creating slider items

The slider on the front page is created by the Theme – Slider widget. You can access it either under Customize > Widgets or Appearance > Widgets. Add the widget to the Front Page sidebar, select the slideshow speed and toggle the automatic slide functionality and press the Add Item button to add your first slide.

Fill in all the required information, like title, subtitle and link URL and click the Select Image button to upload the slider image.

Next click the Add Item again to add another slide, continue as needed and once done click the save button.

4) Creating event items

Now you can start inserting your events from Events > Add New. 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 links. Each tab provides some information concerning its usage.
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! For this we are going to use our tracklisting system.

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

To create playlists and display your tracks on the discography items, or anywhere else on your site use our AudioIgniter plugin. It’s documentation can be found here.

6) Adding video items

Go to Videos > Add New, give a title and a featured image to your video and 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 on one of WordPress’s supported providers.

7) Adding gallery items

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

Here you can give your gallery a subtitle, select the number of colums and finally click the Add Images button to upload your photos. Once 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. In the Artist Settings panel you can fill in a subtitle for the artist i.e. Vocals, Drums etc and any other related information, then publish the item.

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 in the same manner. 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.

(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 Oxium consists exclusively of widgets placed in the Front Page widgets area. We saw earlier how we can create slider items. The widgetized area of the homepage can be accessed under Appearance > Customize > Widgets or Appearance > Widgets.

Duplicating the demo’s homepage

Below are the widgets found on the demo’s homepage here

1. A Theme – Slider widget with three slider items
2. A Theme – Latest Discography widget displaying the latest discography item
3. A Theme – Events widget displaying four upcoming events (recurring events are enabled)
4. A Theme – Latest Galleries widget displaying two gallery items
5. A Theme – Latest Videos widget displaying four videos
6. A Theme – Latest Posts widget displaying two blog posts

11) Custom Widgets

The theme features seven custom widgets which are displayed below to help you display your content better.

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

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

The Customizer settings panel

All theme customization is done via WordPress’s built in customizer. If you haven’t used it or want to learn more about it, please read this article.

Go to Appearance > Customize and you will see this

TIP: any changes you make in the tabs below will be previewed live on the site which appears in right side of the screen, however to save these changes you need to click the Save & Publish button on the top of the bar, if you have made a change but see the button grayed out (for example changed the font size of a heading), move the cursor outside the input box, for example, to the next input box, then the button should be clickable again.

Let’s take a look at the options each tab gives you.

Site Identity

In this tab you can modify the site’s title, tagline, logo and site icon.

Layout Options

Here you can configure the length of the automatic excerpt and choose between numbered and older/newer pagination.

Content Colors

Are you looking to create your own unique color scheme? This tab will help you do it by allowing you to modify the colors of many elements of the content. To do that click the Select Color button and either use a hex color value in the box or use the palette to select a color.

Widgets

Through this tab you can add widgets to the theme’s sidebars.

Social Networks

Here you can fill in the URLs to your various social network profiles supported by the theme. These will appear on the footer automatically.

Posts Options

Here you can toggle various aspects of the single post, like the appearance of categories, date, comments etc.

Related Items

Here you can toggle the appearance of related items for each post type and also modify the section’s title.

Menus

Here you can create and assign menus to the theme. See below for more info on how to add items to your menu. To learn more about menu creation check out the Codex’s menu user guide here.

Footer Options

Here you can modify the theme’s footer text.

Static Front Page

Set the Homepage created before as your static front page to take advantage of the drag & drop widgetized template we have created for you.

Other

In this tab we host the custom CSS panel which you can use to insert styles for elements not covered in the rest of the tabs, additionally you will find input boxes where you can place your Google Analytics tracking ID and Google Maps API key (if necessary).

How to use the page builder template

The theme comes bundled with a page builder template which allows you to use your favorite page builder plugin on it and create unique layouts very easily.

To use that template start by going to Pages > Add New. This will create a new page. Add a title to your page and select the Page builder template from the template drop down in the Page Attributes metabox.

That’s it. You can now start building your page using the page builder of your choice, once done publish it and check it out.

Next Steps

Still have questions or problems setting up your CSSIgniter Theme? We will be happy to help you out in our support forums