­
menu

GIG WordPress Documentation

Version:2.6.3Date of Publication: June 22, 2015View Changelog for this theme
Buy this Themeview a Demo of this themeSupport center

Introduction

Back To Top

Thank you!

We would like to take this opportunity to thank you for your purchase!

This instruction manual will give you the knowledge (with screen shots) to set up your theme with ease. However, should you have any questions concerning your purchase, please go to our Support Center and open a ticket.

You will need to create an account and verify your purchase as support is only offered for verified purchases. If you need help with purchase verification, please follow this link.

Support is ONLY provided to verified purchases and is limited to installation and functionality issues with the theme and does not include support for customization work or 3rd party plugins.

Getting Started

Back To Top
Your theme has been developed using the latest version of WordPress (which at the time of this publication is 4.2). If you do not have the latest version, it’s highly recommended that you upgrade your site version to this to ensure the theme’s capabilities. To get the latest version, click here.

WordPress is extremely easy to get set up on your server – it comes with simple directions and you can be up and running within just a few short minutes. Once you have your WordPress set up and running, you can upload your theme and plugins and we will begin set up shortly.

Please ensure you download your GIG theme from the IgnitionDeck Member Dashboard. Once downloaded, you’ll may want to unzip the package.

To do this:

  1. Open your Gig theme download – you do not need to unzip this first - however there are some files under Extras you may wish to use (wordpress_content.xml, ID Skin CSS).
  2. You can upload the file directly to your “/wp-content/themes/” directory. This directory contains all your necessary files for your theme. Alternatively you can take the gig-wp.zip and navigate to Appearance / Themes. Click the tab at the top that says ‘Install Themes’ and follow the onscreen instructions to upload the gig-wp.zip.
  3. Plugins are not included in the download, but later on you will see what plugins we used with links to download and setup. You can upload these plugin directories via FTP or just navigate to Plugins / Add New. Click the link at the top to ‘Upload’ and upload the .zip version of the plugin. Follow the onscreen instructions from there to set up and activate your plugins.
  4. It’s now time to start putting the pieces together. If this is a fresh install of WordPress, you can login and delete the ‘Sample Page’ and the ‘Hello World’ post as well as remove all the default widgets that WordPress sets up for you on activation. To delete the page, navigate to ‘Pages’ from the WordPress admin. To delete the post, navigate to ‘Posts’ from the WordPress admin and finally to remove the widgets, navigate to ‘Appearance’ / ‘Widgets’ and click the arrow on each widget and select delete.
  5. Navigate to ‘Appearance’ / ‘Themes’ and find the screen shot for GIG and click activate.
  6. Permalinks – Navigate to ‘Settings’ / ‘Permalinks’, set the permalinks to whatever you would wish them to be. We recommend setting them to ‘post name’ as this can help boost SEO.
  7. Media Settings – Navigate to ‘Settings’ / ‘Media’ – this is not required, you can set your thumbnail size to what ever you wish, however, our live preview site is ‘Width 220 Height 160’. Also make sure the box to ‘Crop thumbnail to exact dimensions (normally thumbnails are proportional)’ is checked.

GIG Admin

Back To Top

GIG Admin Panel comes with several areas that you will need to set up in order to finish your install. Everything is documented in the admin section, but below you will find each section in more detail of what it does for your site. To access the Admin Panel, click on ‘Appearance’ and ‘Theme Options’.

Setup

Back To Top

gigsetupoptions

Top Logo

Simply upload your top logo to appear in the head of all pages, by clicking . When finished, a preview of your logo will appear under the input box. All uploads in the Theme Options will have the same functionality. We used 91px x 71px (transparent png).

Favicon

This process works the same as above. Recommended size is 16px x 16px (transparent png).

Theme Accent Color

Click in the box where you see the #FE4365 and a color picker box will open, you can pick a color from here or if you know they color you want, you can type in ‘#COLORNUMBER’ to choose the color of the top and bottom borders you will see on every page. You will see a box floating to the right of this text field – that is just a sample to show you what color you chose. This color will be reflected throughout the theme as shown in our live preview.

Upload Special Stylesheet

Using the same upload process, you can create your own stylesheet to use within this theme by uploading the stylesheet here. The theme will recognize that upload and replace the default standard style.css with what you have uploaded.

Read More Button Text

Enter the text you want to appear when you use the more tag for posts, this setting will enter the text that is a link to the single blog post.

Custom CSS

This is an easy way for you to ‘override’ any CSS that is in the style.css file, without causing problems for you during theme updates.

Tracking Code

This is where you need to place your tracking code for your analytics (such as Google Analytics) and the theme will call this code at the end of every page for your reporting needs.

Copyright Left

Enter your copyright information here that will appear on the left side below the footer. HTML is acceptable. Example: 2013 gig.

Copyright Right

Enter your copyright information here that will appear on the right side below the footer. HTML is acceptable.

Blog Setup

Back To Top

gigblogsetupoptions

Blog Heading Title

This heading will appear on the homepage above the blog loop.

Upload your left side image for the blog page

This is the image that will appear on the left of the content of the blog index page as well as the blog single pages. Recommended size is 400px X 1600px.

Search Page Image Upload

Back To Top

gigsearchoptions

Upload your left side image for the search page

This is the image that will appear on the left of the content of the search page. Recommended size is 400px X 1600px.

404 Page Image Upload

Back To Top

gig404options

Upload your left side image for the 404 page

This is the image that will appear on the left of the content of the 404 (error) page. Recommended size is 400px X 1600px.

My Gallery Single Page Image Upload

Back To Top

gigmygalleryoptions

Upload your left side image for the My Gallery single pages

This is the image that will appear on the left of the content of the My Gallery single pages. Recommended size is 400px X 1600px.

My Music Single Page Image Upload

Back To Top

gigmymusicoptions

Upload your left side image for the My Music single pages

This is the image that will appear on the left of the content of the My Music single pages. Recommended size is 400px X 1600px.

Plugins

Back To Top
As mentioned previously in the documentation, plugins are no longer provided as part of the download. Here is a list of the plugins we used in the live preview (should you wish to use them) as well as the links to those plugins.

Please note that plugins are created by many users, many for free, from all corners of the world, not all plugins play nicely together and it will be up to you to make sure the plugins you have activated are compatible with each other – this is not a limitation of the theme in any way – it’s just if the plugin author created the code cleanly and using WordPress guidelines.

IgnitionDeck Plugins – used for the crowdfunding part of the theme. These plugins are available on their own here, but inside the Gig theme package download we provide a skin for this. The skin is located inside your download under the directory ‘Extras’ and is called ignitiondeck-gig.css. For instructions on installing your Skin, go here.

If you have upgraded to WordPress 3.9 and you don’t see the cr3ativshortcode, you will need to deactivate and delete this plugin and redownload (and setup) the plugin again.

  • Contact Form 7 – used to power the contact form on the contact page.
  • Creativ Shortcodes – used for all the short codes seen in the live preview.
  • Easy FancyBox – used for the lightbox for WordPress gallery images.
  • Single Post Template – used for the single blog pages to provide the ability to select a page template per post.
  • IgnitionDeck Plugin – used for the crowdfunding part of the theme. These plugins are available on their own here, but inside the Gig theme package download we provide a skin for this. The skin is located inside your download under the directory ‘Extras’ and is called ignitiondeck-gig.css. For instructions on installing your Skin, go here.

Page Templates

Back To Top

gigpagetemplates

There are 12 page templates included with this theme.

Default

This page DOES bring in the widgets you have created under ‘Page’ in the widget section of the WordPress admin. The featured image of this page becomes the image that will appear to the left of the content.

Band-Gallery

This page template will bring in your content as well as all of your ‘My Gallery’ items. The featured image of this page becomes the image that will appear to the left of the content.

Band-Member

This page template will bring in your content as well as all of your ‘Band Members’ items. The featured image of this page becomes the image that will appear to the left of the content.

Band-Music

This page template will bring in your content as well as all of your ‘My Music’ items. The featured image of this page becomes the image that will appear to the left of the content.

Event-Page

This page template will bring in your content as well as all of your ‘Events’ items. The featured image of this page becomes the image that will appear to the left of the content.

Homepage-ContentFullWidth

This page template uses ONLY the content you place in the page. There aren’t any dynamic loops or widget areas called on for this page. The featured image of this page becomes the image that will appear to the left of the content.

Homepage-LeftBlog&RightWidget

This page template will bring in the Homepage-Top widget area first (full width), then a dynamic loop on the left for your latest blog articles and then the Homepage-Side widget area on the right. The featured image of this page becomes the image that will appear to the left of the content.

Homepage-LeftContent&RightWidget

This page template will bring in the Homepage-Top widget area first (full width), then your content you place in the page on the left and then the Homepage-Side widget area on the right. The featured image of this page becomes the image that will appear to the left of the content.

Homepage-LeftWidget&RightBlog

This page template will bring in the Homepage-Top widget area first (full width), then a dynamic loop on the right for your latest blog articles and then the Homepage-Side widget area on the left. The featured image of this page becomes the image that will appear to the left of the content.

Homepage-LeftWidget&RightContent

This page template will bring in the Homepage-Top widget area first (full width), then your content you place in the page on the right and then the Homepage-Side widget area on the left. The featured image of this page becomes the image that will appear to the left of the content.

Page-FullWidth

This page DOES NOT bring in the widgets you have created under ‘Page’ in the widget section of the WordPress admin. The featured image of this page becomes the image that will appear to the left of the content.

SITEMAP

This is a special template that will list your pages, posts etc. dynamically.

When creating your blog page, you just need to create a new page, name it and publish it. You do not need to choose a page template as WordPress has a specific php file used for the blog index page. Just remember to set it as your ‘Posts page’ as detailed later under the ‘YOUR FRONT PAGE’ section. The left side image is called from the theme options.

Widgets

Back To Top
GIG comes equipped with several widget areas. Widget areas are simply a place for you to put whatever content you want and you have the option of choosing one of WordPress standard widgets such as ‘Categories’ or ‘Pages’, or even use a text widget to place any text or html that you would like. This theme will allow you to use your shortcodes in the widget areas should you choose the ‘Text Widget’.

Next you will see screen shots and code snippets (if needed) to see how we set up our widget areas. First, to get to Widgets, click on ‘Appearance’ and then click ‘Widgets’.

gigwidgetsall

Homepage-Top

Back To Top

gighomepage-top

Homepage-Top

In this widget section, we are using a couple of different widgets. Both are ‘text’ widgets.

Take a look below as we break down each widget.

gigtextwidget3

Using a text widget, we’ve placed the shortcode for the slider that we created here.

[soliloquy id="816"]

gigtextwidget2

Using a text widget, we’ve placed some HTML here that we have in the CSS to create some space.

<div class="clearbig"></div>

Homepage-Side

Back To Top

gighomepageside

Homepage-Side

In this widget section, we are using a couple of different widgets. Both are ‘default’ widgets that either came with the theme, one of the plugins or WordPress itself.

Take a look below as we break down each widget.

gigevent

Using a default Theme widget, we use the ‘Sidebar Event Loop’.

gigrecentpost

Using a default WordPress widget, we use the ‘Recent Posts’.

Page Widgets

Back To Top

gigpagewidgets

Page

We are only using 1 widget here, but that doesn’t mean you can’t use more! :)

Using a default Theme widget, we use the ‘Sidebar Event Loop’.

Blog Widgets

Back To Top

gigblogwidgets

Blog

In this widget section, we are using several widgets. All are ‘default’ widgets that either came with the theme, one of the plugins or WordPress itself.

Take a look below as we break down each widget.

gigsearchwidget

Using a default WordPress widget, we use the ‘Search’.

gigtagcloud

Using a default WordPress widget, we use the ‘Tag Cloud’.

gigrecentpost

Using a default WordPress widget, we use the ‘Recent Posts’.

Footer Left

Back To Top

gigfooterleftwidget

Footer Left

We are only using 1 widget here, but that doesn’t mean you can’t use more! :)

Using a text widget, we’ve placed some shortcodes for the follow icons here.

[creativ_social][creativ_social_link service="ja-social-icon-twitter" link=""] [creativ_social_link service="ja-social-icon-facebook" link="#"] [creativ_social_link service="ja-social-icon-linkedin" link=""] [creativ_social_link service="ja-social-icon-pinterest" link=""] [creativ_social_link service="ja-social-icon-gplus" link=""] [creativ_social_link service="ja-social-icon-spotify" link=""] [creativ_social_link service="ja-social-icon-youtube" link=""] [creativ_social_link service="ja-social-icon-vimeo" link=""] [creativ_social_link service="ja-social-icon-myspace" link=""][creativ_social_link service="ja-social-icon-soundcloud" link=""] [creativ_social_link service="ja-social-icon-instagram" link=""][/creativ_social]

Footer Right

Back To Top

gigsearch

Footer Right

We are only using 1 widget here, but that doesn’t mean you can’t use more! :)

Using a default WordPress widget, we use the ‘Search’.

404 Error Page Widget

Back To Top

gig404widgets

404 Error Page Widget

In this widget section, we are using several different widgets. One text widget and two WordPress default widgets.

Take a look below as we break down each widget.

gigtextwidget1

Using a text widget, we’ve placed some text to go above the search box.

gigsearch

Using a default WordPress widget, we use the ‘Search’.

gigpages

Using a default WordPress widget, we use the ‘Pages’.

Content Import & Setup

Back To Top
NOTE: Crowdfunding projects cannot be imported with an xml file. If you try to import them this way, they will not work properly. Open up your ‘GIG-WP-Package’, inside there you will see an XML file. This is the exported content, pages, images etc from the live preview site. The ONLY thing the XML import will not do is set up your widget areas (which we’ve already covered above).

In the WordPress admin area, click ‘Tools’ > ‘Import’ > ‘WordPress’. WordPress may ask you to install this before allowing you to upload your file, just follow the on screen instructions. Once this is installed, click ‘browse’ and select the ‘wordpress_content.xml’ > ‘open’. From here you just need to select the ‘Upload file and import’.

From the drop down on ‘-Select-’, choose ‘admin’ and then make sure you click the box next to ‘Download and import file attachments’. And that’s it – your site should start looking very similar to the live preview. If you do not choose ‘admin’ or the user you set up with ‘admin’ rights, you will not receive any images on the import.

If you get any error messages like ‘Could not import….post type does not exist’, it could be because you haven’t got the theme activated or one of the plugins we use in the live preview hasn’t been installed/activated.

Back To Top
GIG supports WordPress menus (2 in total) and styling for 3 levels. Navigate to ‘Appearance/Menus’ to create your menu. Click the ‘+’ to create a new menu. Name the menu ‘Primary’ and drag and drop the pages that you wish to have in your menu. When finished, click ‘Save Menu’ and then make sure from the ‘Theme Locations’ (located in the top left) that you choose ‘Primary’ from the drop down for the ‘Primary Navigation‘.

gigmenu

If you did the XML import, you only need to select the ‘Primary’ from the Theme Locations and click ‘Save’.

gigmenulocation

To get categories from your blog articles or the taxonomies used such as Gallery Venue or Music Type or even your individual posts from your Custom Post Types such as My Music, My Gallery, Events or Band Members to show in your menus, click the ‘Screen Options’ from above and select one of the above mentioned items, then you can drag and drop your items to your menu.

Don’t forget to click ‘Save Menu’ after making any changes.

WordPress Post Format

Back To Top
GIG utilizes the WordPress standard Post Format Types of ‘standard’, ‘audio’, ‘link’, ‘gallery’, ‘video’ and ‘quote’. When you create your posts you just define the ‘format’. The title of every post on the main blog page will link to the actual post.

All of the articles on the main blog page will display the title, comments and the text up to the more tag you place on the page.

Below are some further details concerning the rest of the video post formats.

Audio Post Format

Back To Top
With WordPress 3.9 all you need to do to add an audio file is either copy/paste the URL to the audio file in the content area or click the ‘Add Media’/’Create Audio Playlist’ and select your audio files from the library and insert the audio playlist. Where ever you place the play list (before or after the more tag) is where it will appear on the blog and single pages.

If you have just upgraded the theme – you will need to go back through your audio posts and correct the audio files for legacy posts.

Video Post Format

Back To Top
If you are using the Creativ Shortcodes plugin, just click the cr3ativshortcode and select ‘Video’, from the drop down you can choose Youtube or Vimeo and then enter your link. The video will appear wherever you have placed this code (either before or after the more tag) and because you used the short code will automatically resize correctly based on the screen size.

With WordPress 3.9 you can now create a video playlist for self hosted video’s uploaded to your media library exactly the same way you did the Audio Playlists with the exception of click ‘Add Media’/’Create Video Playlist’. The above reference on using the video shortcode from Cr3ativ Shortcodes still stands if you are using a Vimeo or Youtube video URL.

Gallery Post Format

Back To Top
For the main blog page, we extract all of the images attached to the post (if more than 1 image) and display the images in a slider. If there is only 1 image attached (or less), the code will display the featured image.
All you need to do is create a new post, choose ‘Gallery’ for the post format, enter your title and content and upload all your images. The slider (or featured image) will display above the excerpt for the main blog page, and works exactly the same for the single page.

Quote Post Format

Back To Top
For the main blog page & the single page, we extract the entire post and place it inside a
blockquote styled tag.
All you need to do is create a new post, choose ‘Quote’ for the post format, enter your title and content.

Link Post Format

Back To Top
For the main blog page, we extract the first link and display this under the title, the link and the link text will point to where ever you have told it to, the title will still point to the blog post itself.
All you need to do is create a new post, choose ‘Link’ for the post format, enter your title and content (including your link).

Standard Post Format

Back To Top
For the main blog page will extract the featured image. If you didn’t set a featured image, none will display.

Band Members: A Custom Post Type

Back To Top

gigbandmember

This is a custom post type created specifically for your site.

It works much the same as a standard post. You can enter content etc.

Below the content area there are several meta boxes for you to add additional information for each member:

Title

Enter the title of the member here.

Head Shot Image

Upload an image that will be used on the band member index page. Remember once you have uploaded to click ‘None’ on the link to the image or the image will not insert properly.

bandmemberupload

Social Icon Link, Alt Text and Upload

The rest of the boxes are for you to upload a social icon (up to 7) of your choice, putting the link to that social follow as well as the alt text for the image.

The featured image will become the large image on the left of the content for each single band member pages.

To create your ‘index’ page for your galleries:

  1. Create a new page.
  2. Choose the ‘Band-Member’ page template.
  3. Enter the content you want to appear above the band member loop, publish the page and add to your menu.
  4. Start entering your ‘band members’ as shown in the screen shot above.
  5. That’s it, after this, the template will do the rest by pulling in the band members.

Please note you should never create a page with the same name as the custom post type as WordPress will produce 404 Page Not Found errors.

Events: A Custom Post Type

Back To Top

gigevents

This is a custom post type created specifically for your event section of your site. It works much the same as a standard post but the featured image will become the large image on the left of the content for each single event pages.

1 day after the event has passed, the event will drop out of the loop. This is the same for the event ‘index’ page as well as the event loop widget.

Below the content area there are several meta boxes for you to add additional information for each event:

Date of Event

Choose the date of the event from the date picker.

Time of Event

Enter the time(s) of the event however you wish them to appear.

Event Venue

Enter the Venue Name where the event is to be held.

Address

Enter the address to the venue.

Venue City/State

Enter the Venue City and State.

Google Map Link

You can place a URL to the map/directions.

Google Map iFrame

You can embed a map (such as Google) by copying/pasting the iFrame code here.

Cost of Event

Enter the cost of the event (if applicable).

Event Tickets Link

If you are selling the tickets online, you can place that link here.

To create your ‘index’ page for your events:

  1. Create a new page.
  2. Choose the ‘Event-Page’ page template.
  3. Enter the content you want to appear above the event loop, publish the page and add to your menu.
  4. Start entering your ‘events’ as shown in the screen shot above.
  5. That’s it, after this, the template will do the rest by pulling in the events.

Please note you should never create a page with the same name as the custom post type as WordPress will produce 404 Page Not Found errors.

My Gallery: A Custom Post Type

Back To Top

giggallery

This is a custom post type created specifically for your band’s gallery section of the site. The featured image is used as the ‘heading’ image in the gallery index page and the image that appears left of the content was set earlier in the theme options panel for the single pages.

To create your ‘index’ page for your galleries:

  1. Create a new page.
  2. Choose the ‘Band-Gallery’ page template.
  3. Enter the content you want to appear above the gallery loop, publish the page and add to your menu.
  4. Start entering your ‘gallery posts’ as shown in the screen shot above.
  5. That’s it, after this, the template will do the rest by pulling in the gallery posts.

Please note you should never create a page with the same name as the custom post type as WordPress will produce 404 Page Not Found errors.

My Music: A Custom Post Type

Back To Top

gigmusic

This is a custom post type created specifically for your band’s music section of the site.
The featured image is used as the ‘heading’ image in the music index page and the image that appears left of the content was set earlier in the theme options panel for the single pages.

The audio files are brought in exactly the same as audio post format, either create an audio playlist or just place the url to the audio file in the content area.

Below the content area there are several meta boxes for you to add additional information for each music item:

Release Date

From the date picker, choose the release date of the single/album.

Record Label

Enter the record label (if applicable).

Catalog Number

Enter the catalog number (if applicable).

Purchase Button Text 1 & 2

For these 2 boxes, you can place text for the buttons, such as “Buy on iTunes” or “Buy on Amazon” etc.

Purchase Button Link 1 & 2

For these 2 boxes, you would place the link to the above text, such as a direct link to buy it on Amazon etc.

  1. Create a new page.
  2. Choose the ‘Band-Music’ page template.
  3. Enter the content you want to appear above the music loop, publish the page and add to your menu.
  4. Start entering your ‘music posts’ as shown in the screen shot above.
  5. That’s it, after this, the template will do the rest by pulling in the music posts.

Please note you should never create a page with the same name as the custom post type as WordPress will produce 404 Page Not Found errors.

Setting Your Front Page in WordPress

Back To Top
Navigate to ‘Settings’ and then ‘Reading’ and set the front pages as Static and choose “Home” for the “Front Page” and “Blog” for the “Post Pages” as in the image below.

gigreadingsetting

We tell WordPress to ‘discourage search engines’, obviously you wouldn’t want to do that, but since this is just a demo site, we have this clicked.

Special Notes

Back To Top

Retina Support

Back To Top
This theme has the retina.js script built in making your site retina ready. However, this is all dependent that the images you upload are retina ready. To get these images retina ready – all you need to do is take your original images and double them in size, name them with the @2x. For example, yourlogo.png is 100 x 200 – create another image yourlogo@2x.png and upload this image for the retina devices. The script will display the yourlogo.png for all browsers and devices that do not support the retina ready technology. The retina.js script will look for an image in the same directory that has @2x and automatically use this image for retina ready devices.

Support

Back To Top
Please read all the documentation and follow all steps before opening a support ticket – i can assure you that this documentation should cover all aspects of this theme, it’s use and setup!

We have a dedicated support center as mentioned on the first page of this documentation where you should direct all questions with regard to the functions and operation of this theme.
We supply support not because we have to, but because it’s the right thing to do. I only have a few rules – here they are:

AddThis Sharing
PrintMore
Hide
Show