Documentation for Muzak

About

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

WooCommerce

To enable eCommerce functionality for your website you need to install and activate the WooCommerce plugin by WooThemes. You can download the plugin free of charge from the WordPress Plugin Repository. For installation and usage instructions please refer to the plugin’s documentation.

Once you have installed and activated the WooCommerce plugin please install its pages by clicking on the button that WooCommerce provides on its banner. This will likely create a duplicate of some pages along with the pages install by the sample content but its a needed step. You can delete the old pages that came with the sample content or use them instead it’s up to you.

Setting up your WooCommerce Widgets

Once you’ve activated the WooCommerce plugin, you will find a new sidebar (widget area) in your Widgets’ page through the WordPress Dashboard. This new sidebar (Shop Sidebar) controls the widgets that will be displayed in the listing and product pages. You can apply any widget you want, including the CSSIgniter custom widgets. Finally, you can also apply WooCommerce widgets in the frontpage or footer widget areas.

Zip file contents

In the zip file, you will find the following:

1. DOCUMENTATION Contains a text file with a link to this document.
2. HTML Contains the HTML version of the template. You can integrate it to your favorite CMS.
3. PSD Contains PSD files of the template.
4. WORDPRESS In this folder you will find the zip file which contains the theme, called “wp_muzak-v4.x.zip”

Theme Installation

Login to your WordPress admin panel. Go to Appearance > Themes. Click on the Install Themes tab. Click upload and Browse. Select the wp_muzak-v4.x.zip located in the WORDPRESS folder and click OK. Wait for the theme to upload and you will get a message that says “Theme installed successfully”. Click Activate and.. congratulations! You just installed the Muzak theme!

NOTE: In order to setup the theme as seen on our preview you need to keep reading. Even If you are an experienced WordPress theme user do read this documentation in order to understand my approach on various things around the theme.

Recommended image sizes

• Listing thumbnails: 580x350px
• Post thumbnails: 750x450px
• Discography listing thumbnails: 560x560px
• Event thumbnails: 560px width, not restricted in height.
• Fullwidth thumbnail (slider and fullwidth page templates): 1140x641px

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.

• 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 a page which will serve as your contact page.
• 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.

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!

Importing sample content

To get the sample content file go to appearance > theme settings > site options and scroll down until you see the download sample content link. Extract the zip file you got and now you have the required xml file to import the sample content.
Importing the sample content is easy. Go to Tools > Import and select the last option called WordPress.

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

If the Importer is not installed, a popup window will appear asking you to install it. Click the Install button on the right and click Activate Plugin & Run Importer

Click Browse, select the muzak.wordpress.2014-06-26.xml file you extracted earlier and click Upload file and import. It will ask you to import one or more authors. Just assign the posts from all of them to your existing user account by selecting it from the drop down menu. Check the Download and import file attachements. Click Submit.

NOTE 1: This will take a while. It could even take minutes because of importing all the images etc. So if you are out of coffee, go for a re-fill :)
NOTE 2: Images are under copyright so you can't use them.
NOTE 3: You need to set your permalinks at Settings > Options > "Post name"
option.
NOTE 4: If you get a SERVER TIME OUT you need to contact your hosting provider. It's not a fault with the theme :)

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

Theme settings

I’m sure you can’t wait to preview the theme but be patient we are getting there! So, go to Appearance > Theme Settings and you will see our custom Settings Panel. Let’s see all the options and see what each of them does.

Site Options Tab

With the first option you can upload your logo if it’s an image logo, you have the option to add a normal and a high resolution logo (for retina-type devices). If you want text go to Settings > General and set the Site Title and the Tagline if you wish.

Next you have the option to set a favicon and touch icons for mobile devices.

Homepage Options

Here you can choose whether to show the slider on the frontpage, whether it will be automatic, set the number of items that will appear in the Homepage slider and the number of news items that will be displayed below the slider. Just set the number that you want in both of them.

You can also select if you want to display the latest news on the homepage or the contents of a page. If you want to display the latest news make sure the box is set up like this

otherwise select a page from the drop down.

Display Options

The descriptions for each option are detailed so just follow the instructions for each box and set the settings that you want.
We will see various other options and how we set them as we move along.

Color options

Here you can select a predefined color scheme or uncheck the checkbox Disable custom background and set your own custom background color and image if you wish.

Audio Options

Here you can set up the theme’s music player. You can use either the tracklisting from an album, or a ShoutCast/IceCast stream which outputs mpeg audio. You can also select if you want the audio to auto-play when the page load, or not (default).

Now playing feature

You can enable fetching and displaying the title of the song currently playing. Please note that in order for this to work you need a ShoutCast server v2.0 or higher and your stream URL needs to be in the form of IP:port i.e. “http://192.102.192.1:8006/stream;”

Event Options

Here you can toggle the event page’s map, the old events or enable pagination for them if you so desire. You can also set the single event and event buttons to open in a new page.

Section Titles

Here you can customize the title for each one of the theme’s sections. The section title is the title displayed between the menu and the content of the page.

e-Commerce Options

Here you can select whether you want to show up-sells and related products on your single product view, also you can select the number of products per page on your shop page.

Archive Options

Here you can set a number of items to be displayed in each taxonomy listing page, the number of columns the listing page will have and toggle the isotope filtering and masonry layout.

Twitter Options

Here you can connect the theme to your twitter account so you can display your latest tweets via the CI Tweets widget.

Google Options

Copy / paste your Google Analytics code in this box.

FeedBurner Feed URL

Copy / paste your feedburner feed code in this box.

Custom CSS

If you are familiar with CSS and you want to add some extra styles just insert them in this area.

Homepage setup

If you have imported the sample content these pages have been created for you :)

Go to Pages > Add new and create a new page. Give it a title like “Home” and on the Page Attributes box on the right select one of the Homepage templates. Each one has a description on the right on how the content will be displayed (For example Content / Sidebar #1 / Sidebar #2). Have a look at the following screenshot:

A new panel called Frontpage Options will appear below the main text editor, there you have the option to select a category of slideshow items to display on the slider. This allows you to categorize slider items and quickly switch between displayed groups.

Now go to Settings > Reading and set the page you just created as your Front page. Have a look at the image below.

As you can see there’s an option Posts page under the Front page option. Create a new page called Blog or News or anything that you want to publish normal posts and set it here as your Posts page page.

Back to the homepage

The homepage as you can see consists of some specific areas. The slider, 2 sidebars and a main area where you can display your news posts. Let’s setup the slider. Go to Slider > New Slider Item. 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 and finally in the Slider Settings you can set the URL where users will visit if they click on this slider item, if you want a video on the slider instead, place the video URL in the corresponding box. Finally by checking the box you can disable the text displayed on the slider. Here’s a screenshot:

Easy eh? You can link to internal parts of your website or even other sites. We decided to make the slider that way for extra flexibility. Moving on! If you have selected a homepage template with 2 sidebars, go to Appearance > Widgets and you will see 2 widgetized areas called Homepage sidebar #1 and Homepage sidebar #2. Fill them with the widgets that you want. We will explain a bit later of our custom widgets and how to use them.

Now the main area will display your normal blog posts and you can set the number of posts that will be displayed in this area from our Theme Settings > Homepage options.

Navigation setup

One last thing that we need to setup for our homepage (but visible on any other page of our website as well) is the main navigation. So go to Appearance > Menus create a new menu with a menu name of your choice. In the Theme Locations select the menu you just created. Add items from the left hand side boxes on the right. Re-order with drag and drop. Like the image below:

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

Event page setup

If you have imported the sample content these pages have been created for you :)

It’s time for the world to know about our events! Go to Pages > Add new and create a new page. From the page attributes on the right, from the Templates dropdown select the Events template. Now you can start inserting your events from Events > New Events item. So. Give the event a title so you can remember it. We are not showing the title somewhere. It’s just an identifier for you. We leave the main editor empty and we move a bit lower in the Event Settings section where we fill the details of the event like the image on the below.

For a preview on how the events are shown check our online demo here.

As you can see in the Select the event status dropdown we have 4 different types of statuses.

1. Tickets Available
2. Sold Out
3. Canceled
4. Watch live

For status “Sold out” and “Canceled” you don’t have to set anything else. For status “Tickets Available” you can insert the URL from the site where people can buy tickets in the input field below with the title “If the event is still available enter the URL where someone can buy tickets”. Same thing for the status “Watch live”.

A last option for the events page is that you can show/hide the events map and the past events. Just go to Appearance > Theme settings > Archive Options and at the very end of this section check / uncheck the checkboxes for these options.

Discography setup

If you have imported the sample content these pages have been created for you :)

To create a listing page for your discography items, go to Pages > Add New, create a page called discography-listing (or something similar), apply to it the Discography template from the page attributes panel on the right and move to the Listing Options panel that appears.

Here you can set the number of columns your listing page will have, enable/disable the isotope filtering system and select how many items you want to display on the page.

Let’s see how we can recreate an album from the preview like this one.

Go to Discography > New Discography Item. 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.

Tracklisting

Each discography item, can have multiple tracks assigned to it. Tracks can be registered through the Tracks Details section, 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 the lyrics for each track, in the big Song Lyrics field.

Tracks can be re-arranged by dragging and dropping them in the appropriate order. 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.

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 simplest usage 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. E.g.:

[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, so the following is totally valid:

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

The older syntax, [tracklisting][track][/track][/tracklisting] is still supported but not preferred. See the additional information section below.

Videos setup

If you have imported the sample content these pages have been created for you :)

To create a listing page for your videos, go to Pages > Add New, create a page called video-listing (or something similar), apply to it the Videos template from the page attributes panel on the right and move to the Listing Options panel that appears.

Here you can set the number of columns your listing page will have, enable/disable the isotope filtering system and select how many items you want to display on the page.

Let’s add some videos. We have 2 options. We can display self-hosted videos, or videos from YouTube, Vimeo etc.

Go to Videos > New Videos Item and you will see the following screen.

1. Is the title of the video
2. The video’s featured image
3. URL to the video
4. Check only if your video is self-hosted

Galleries setup

If you have imported the sample content these pages have been created for you :)

To create a listing page for your galleries items, go to Pages > Add New, create a page called gallery-listing (or something similar), apply to it the Photo Galleries template from the page attributes panel on the right and move to the Listing Options panel that appears.

Here you can set the number of columns your listing page will have, enable/disable the isotope filtering system and select how many items you want to display on the page.

In order to create a new photo gallery go to Galleries > New Gallery item you will see something like this:

1. This is a title for you to remember. We don’t display it anywhere.
2. The featured image that will be displayed in the listing page like here
3. The venue name (e.g Amnesia club)
4. The location (Ibiza, Spain)
5. You can use the add media button to upload your images.
6. Here you can drag & drop the uploaded images to re-order them.

More information on gallery usage can be found in the additional information section below.

Artists setup

If you have imported the sample content these pages have been created for you :)

To create a listing page for your artists, go to Pages > Add New, create a page called artist-listing (or something similar), apply to it the Artists template from the page attributes panel on the right and move to the Listing Options panel that appears.

Here you can set the number of columns your listing page will have, enable/disable the isotope filtering system and select how many items you want to display on the page.

In order to insert a new artist just visit Artists > New artist. In this section you wont find any custom fields, so you can enter the name of the artist in the title field, use the featured image and the main editor for any content (biography etc.)

Widgets

We have created 11 custom widgets. They are really simple and they let you display various important info around the site.

The theme also provides seperate widgetized sidebars for each section.

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.

Creating Galleries

To create a gallery using our gallery management system follow these steps:

1. On the “Gallery Information” panel click the Add Images button.
2. To upload your images, drag & drop them in the Edit Gallery window which will pop-up, or select Add to Gallery in order to select already uploaded ones. Once you are done, click the Update Gallery button on the lower right.
3. Your “Gallery Information” panel will look like this
4. You can re-arrange the order of images by drag & drop.
5. If you wish to remove an image from the gallery, hover your mouse over it and click the X as shown below.
6. By checking the Randomize order box your gallery images will appear in random order which will change on every page refresh.
7. When done, publish the gallery item.

If you need to add images after the gallery’s creation just follow the same procedure.

Older shortcode syntax (not recommended)

Discography items didn’t support a real track listing in previous versions of the theme. The following is provided for reference to early theme users that may have their discographies set up according to this older way. The following is still fully supported, but not the recommended way any more, as it’s harder and less flexible.

The format is like this:

[tracklisting]
[track track_no1 title="Nobody Move" subtitle="Self-hosted audio player" type="player" buy_url="http://someurl"]https://www.cssigniter.com/assets/audio/track1.mp3[/track]
[track track_no="2" title="Wega - Ruback" subtitle="Embeded from SoundCloud" type="soundcloud" buy_url="http://someotherurl"][soundcloud width="100%" url="http://api.soundcloud.com/tracks/44790907" iframe="true" ][/track]
[/tracklisting]

As you can see we start with an opening [tracklisting] tag. This is there just to inform WordPress that we are creating a new track listing. Then in order to create a new track you start with opening a new [track] item followed by:

track_no: The number of the track

title: The first title

subtitle: OPTIONAL the subtitle of the track, if any.

type: player or soundcloud depending on the type of audio you want. If it’s player you specify the path to the mp3 file. If it’s soundcloud then you use the soundcloud Widget Code found when you click the Share button under a soundcloud track. USE type=”soundcloud” for MixCloud sounds too!

buy_url: if you want to sell each track seperately you can provide the URL for each track where people can visit and buy it.

download_url: a button will be displayed giving your user the option to download the track.

We close the tracklisting tag with [/tracklisting] and we are done!

Multilingual capabilities

This theme is officially compatible with the WPML plugin. WPML is a premium plugin which helps you create and manage multilingual sites. You can purchase it from here. After purchase you can download the plugin’s files and install them from Plugins > Add New > Upload more info on installation here. Finally the detailed documentation for the WPML plugin, can be found here.

Next Steps

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