IgnitionDeck Integration

As you might know already, the IgnitionDeck plugin comes in three different versions. This theme supports them all, and the following guide will get you through all steps require for integrating each version of the plugin.

Keep in mind that this is not an extensive document for the plugin itself, because it already offers one here:  http://ignitiondeck.com/id/documentation/ignitiondeck-framework-docs/. Make sure to read it in order to familiarise yourself with it before using the theme.

Free version - getting started

To get started you need to install the free version of the plugin first (you should be prompted to do this when activating the theme). If not, go to Appearance > Install Plugins and you’ll see the list of plugins that need to be installed.

After you install the plugin you should see a new menu called IgnitionDeckin the sidebar. Go there and you’ll be asked to register an account with them before continuing. The steps are easy and intuitive. After you enter your details wait a bit and the plugin will be activated. After activation, a new menu item called IDCF will appear in the sidebar. (and you should also have the other two IgnitionDeck plugins installed and activated). If you go there you’ll see some other settings, like a place to enter a license key (more on this later), some project settings and a place to add/view/edit orders.

For now, let’s leave all of these and create our first project. To do this go to Projects > Add New Project and do what you would do when creating any other page or post. Insert a title, write some content, add an optional page subtitle, then hit Publish. When viewing the project created you should see the title, the project sidebar and some content.

Now go back to the project editor and let’s take each panel and see what it does.

1. Project Categories

The categories will be shown in the project grid, so it’s important to add categories here. They are added like tags, but you should add them instead of tags or normal categories. Write your categories in the Project Categories panel and you’ll be able to later use them in various ways.

2. Featured

This option marks the project as featured. There will be no visual changes, but if you plan to have something like a “featured projects” widget on your homepage for example, you should mark featured projects using this panel and order them by featured in the grid shortcode that you’ll insert there.

3. Project URL

This should remain to the Current Project Page, but if you want to make the project to link to a different page when opened, you should use this window.

These are all on the right side. On the left side you’ll see a big Project panel with all kinds of settings. Most of them have a little question mark near the title explaining what they do, but I’ll comment on a few below.

4. Project Type

Sets the type of the project. Projects that are level based require different levels and the users are limited to only pledge what you ask them to, while “pledge what you want” projects can have any amount inserted in there. If you’re using only the free version of the plugin (which doesn’t have user ordering available) you may be better with simple projects like this (without levels), since it will be much easier for you to add orders.

5. Short Description

This description will only appear in the projects grid, nowhere else.

6. Long Description

If you are starting from scratch with this plugin, do not use this field. Leave it blank and insert your content the regular WordPress way, in the default content area. If you do insert content here however, it will still appear in the project page, below the actual content area. This is useful for those of you who were already using the plugin and have their content here. Don’t worry, the content will appear, nothing will go missing.

7. Video

If you insert a video, it will appear at the top of the project page. Please note that adding videos will disable the project image/gallery. So if you want to have a video at the top, you should add images or galleries in the content area, using WordPress ways (add media, shortcodes, etc.). If you want an image or a slider at the top of the project you shouldn’t add a video here and only insert the video in the content area (again, WordPress allows you to do this easily - refer to shortcodes section of the manual).

8. Main Project Image

Will appear in the project’s grid, as the project thumbnail. It should have at least 840px in width or larger, because it will also be used as the project image (at the top of the project - if you do not use a video). The theme will resize the image for thumbnails perfect sizes automatically without distorting (cropping) the image, so you won’t have to worry about thumbnails.

9. Project Reward Levels

Here you need to add the pledge levels for the project. Even a “pledge what you want” project requires at least one level. Leave the price blank if this is the case, but otherwise fill your values there. At this moment, both short and long description of each level should be the same. It might change in the feature, but for now, just have the same text in both fields.

10. Additional Images

If you add additional images (and don’t have a video of course), they will appear in the form of a slider at the top of the project. If you have a video, these won’t appear anywhere.

11. FAQs / Project Updates

If you write anything here, it will appear in a new tab in the project page.

A final note on comments - these can be disabled from each page individually (there’s a tick box to allow comments at the bottom of the editor), or you can disable them globally from the Theme Options.

Make sure that you also complete all the other fields that were not detailed above.

-

When you’re done, Update the project and see what’s changed based on your input. You should also see some levels if you selected the level based project type.

You might see a bug, with the content not being displayed and the product bar being showed twice in the page. If you do get this error, please  read the following article.

Setting up payments

So, now you have a project created, but when you try pledging on it, you'll see that you get just a simple page refresh. This is because you need to setup your payments page. For this purpose, go inside IDCF > IDCF and select your "default purchase page". For this purpose you should create a new page. This page should only contain the payment shortcode, which is the following.

[idc_checkout]

Simply paste this in the page and you'll see the project purchase form. You can easily style this page by giving it a sidebar, a boxed appearance (recommended) and a subtitle.

To work out payments, check out this article on IgnitionDeck: http://ignitiondeck.com/id/documentation/ignitiondeck-commerce/crowdfunding/

Please note that the free version of the plugin only has PayPal as a payment gateway!

Projects grid

To test the grid, create a new page and insert the grid shortcode in it (as instructed in the shortcodes section of the manual). You’ll see the custom grid with the project that you already created.

Custom Widgets

The theme also comes with three custom widgets for IgnitionDeck, widgets that you can use with the free version of the plugin. To see them, go to Appearance > Widgets.

  • IgnitionDeck Categories - this widget can be used to show a list of all project categories. To use it in a page (not a sidebar), simply use the widget area shortcode.
  • IgnitionDeck Search - this widget can be used to create a dedicated search form, which will only go through projects, not anything else.
Author Profile

You’ll notice that each project has an author in the sidebar. This is the actual profile of the author who created the project. To edit authors information, go to the Users menu in the sidebar.

If you want to display social icons but you don’t have the Enterprise version of the plugin, please use the social links shortcode in the description box.

If you want to hide the author box in the sidebar (in case there’s only one author or for any other reason), paste this custom CSS code in the proper place from Theme Options:

#project-sidebar .separator, #project-p-author {display: none;}

#project-sidebar .id-widget .level-binding:first-child {border-top: none;}

IgnitionDeck Commerce & Enterprise

Both versions are supported and style exists for both, so you’ll have no issues in making the theme work with these.

If you want to have products and an interesting commerce platform with good integration for the plugin, use the IgnitionDeck Commerce plugin.

If you want to give your users ability to create projects on your site, use the enterprise version. You don’t need to use the Commerce features if you don’t want to - IgnitionDeck Enterprise works perfectly fine with legacy checkout.

Again, check the original plugin’s documentation to learn how to use these two products.

One small note on something that’s part of the theme - in the moment you install and activate IgnitionDeck Commerce/Enterprise plugin, the login/dashboard menu items will automatically appear.

UP NEXT: Theme Shortcodes