# CouponHut

- Subsolar Designs
- Official Site

Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, please feel free to contact us via the Support tab of the theme on themeforest. Thank you so much!

# Installing Theme

Unzip the downloaded package. You can install the theme in one of the following ways:

- FTP - copy the non-zipped folder in the /wp-content/themes/ directory in the Wordpress installation of your server.
- Upload - Go to Appearance > Themes in the admin dashboard, click the Add New button, then Upload Theme and choose the zipped file with the theme.

> If you get a style.css not found error, make sure you are uploading the correct file. It's important to know that the account that you have to install is the one inside the downloaded package.

After that go to Appearance > Themes and click Activate on the theme. After the activation a warning about the plugins that are required will be shown at the top:

Click on Begin Installing Plugins.

# 1 Click Demo Install

CouponHut options panel and page builder is powered by the awesome Unyson Framework. After installing and activating it, go to Unyson in the Admin Dashboard and install the 2 extensions - Page Builder and Backup.

You can install the initial dummy content so you get your site up and running faster than ever. After doing the steps above, click on Tools > Content Install and install the dummy data.

> Warning! All your existing content will need to be replaced with the demo content and thus it will be deleted.

It will create some sample deal posts, placeholder images, navigation menu, sidebar, front page build the way it is shown in the demo and a contact page.

# Page Builder

After installing and activating Unyson plugin in the Admin Dashboard and install the Page Builder extension.

When creating a new page, a button above the content editor Visual Page Builder will show the builder.

It contains three categories of elements, each in its own tab. Clicking or dragging an element will add it to the page flow. Clicking once the element is inserted will open its options. Most of them are configurable.

It's recommended to install the dummy demo content. It inserts a configured Front Page. You'll see how easy it is to edit a page this way.

Here you can find a video that shows the features of the Unyson Page Builder (the video is not created for any theme in particular).

# Register User as a Company

To enable users to be registered as a companies, enable the option from Appearance > Theme Settings > Deals > Show register as a Company field on registration.

This will add a checkbox when a user is registering if he want to register as a Company. It will allow him to submit deals and edit them.

When registered and logged in, a Profile menu will appear under the profile name in the upper right in the navigation bar. When clicked, the page will show information under My Company, and by clicking Edit, the user can fill some basic information about the Company.

Next to Profile is a Sumbitted Deals link, where a user can see the submitted deals by him.

Note! You'll have to create one Page with the Submit Deal Template so that a Submit button appears in the top right profile menu in the navigation bar.

An additional menu will appear in the main navigation bar with Login and Profile links.

Once a user submits deal, a new email will arrive on the email set in the New Deal Email field in Appearance > Theme Settings > Deals . The deal is uploaded with Pending status until it is approved and updated by the admin. The admin is required to check the deal description, add the Company, Category and click Publish. Once it is published the deal is visible for the users.

# Page Builder Shortcodes

Here is a list with short descriptions for each of the sections that can be inserted in the page builder. Click on the Content Elements tab:

### Hero Image/Video

Here you can select the big image or video for the top of the page and the text on it.

### Featured Deals

You can fill it with the deals that you want to be featured.

### Latest Deals

This section will be automatically filled with the latest added deals. You can configure how many of them to be shown.

### Featured Companies

You can fill it with the companies that you want to be featured.

### Latest News

This section will be automatically filled with the latest added blog posts.

# Theme Options

Navigate to Appearance > Theme Settings in the Admin Didebar.

The options here are pretty self explanatory. We will stop only on some of them:

### General

Here you can position the logo in the main navigation bar. Just write 4 vallues in pixels with space between them. The order of the values represents the direction - top, right, bottom, left.

### Styling & Layout

You can select on which pages to show the top block with the search and category fields.

### Colors

Change the main colors of the theme.

### Deals > Order Categories By

Select the default way that the Categories views are ordered

### Typography

Select the Heading and Body fonts of your site.

### Connect & Social

The API keys that the Twitter and Mailchimp widgets use. You can find.create yours on the official sites of the applications - https://apps.twitter.com/ and https://admin.mailchimp.com/account/api/

# Setting Up The Homepage

To set up the home page where you'll insert the sections with your content you'll first have to create a normal Page ( Pages > Add New ) with your content and after that do the following steps:

Go to Settings > Reading Change the Front Page to the Page that you've already created.

If you have not used the 1 Click install that theme comes with and want to set up the homepage like the demo, do the following steps.

- Select Template > Front Page from the dropdown at the right.

- Select the Front Page Bulder Template from the Templates button.

- Change the options of the Builder Block by clicking each of them.

# Setting Up the Menu

To customize the navigation menu go to Appearance > Menus and customize it as you'll normally do on a Wordpress site.

And don't forget to check the Theme Location at the bottom to be Sidebar Menu after creating your menu.

If you want to add additional pages to the menu like Deals or Categories click on Screen Options in the upper left corner of the page and check the types that you want to appear as selectables for the menu navigation.

When you are done, click Save Menu.

# Browse Deals and Companies Pages

Important!

You have to create one Page that uses the Browse Deals Template and one that uses the Browse Companies Template. This way all the links in the site, pointing to such pages will work as they should - for example the "All Deals" link in the Featured Deals Shortcode.

# Creating a Deal

Go to Deals > New Deal

Here you can select the type of deal:

Discount - Normal deal about a discount that features a link to it. Coupon - Discount with a special coupon code. The user is present with the code and after that is redirected to the deal.

You are also presented with an option to choose how to show the deal photos - with a single image or slider.

And lastly and most important you can choose when the offer expires. When you choose a day, the offer will end at 00:00 (the beginning) that day.

When you are ready, hit the Publish button.

# Creating a Deal Category

Go to Deals > Deal Categories

Here you can add a new category, write its description and add an icon for it. You can choose (and search) of over 2000 icons.

When you are ready, hit the Add Deal Category button.

# Creating a Deal Company

Go to Deals > Companies

Here you can add a new company, write its description and add a logo.

When you are ready, hit the Add Company button.

# Creating a Contact Form

The theme includes the famous Contact Form 7 plugin. To make it look like the one in the demo, create a Page, select Contact Template and paste there the Contact form shortcode. If you have neve worked with the plugin before, they have a very nice explanation on their site.

For more advanced setting, you can see the Contact Form 7 Documentation.

Here is the code of the form from the demo:

    <p>Your Name (required)<br/>[text* your-name]</p>
    <p>Your Email (required)<br/>[email* your-email]</p>
    <p>Subject<br/>[text your-subject]</p>
    <p>Your Message<br/>[textarea your-message] </p>

From this page you can also select a side imge to show or a map with a location.

Press Publish when ready.

# Bulk Importing Deals

CouponHut comes with the WP All Import plugin and a special CouponHut WP All Import Add-on.

If you have a lot of deals that need to be cenverted for COuponHut, make sure that you have installed the above WP All Import and CouponHut WP All Import Add-on plugins. After that go to All Import in the Admin Dashboard and click New Import

- Click on Upload a file and select your *.csv file.
- In the New Items dropdown, select Deals (don't select the Coupons post type, as it is for WooCommerce, not CouponHut) post type.

On the next step you can revview all the meta information about the deals that are going to be imported. After that proceed to Step 3.

Step 3 is the most important step. Here all the fields (from the posts that are going to be imported) to the right have to be drag and dropped to the corresponding fields that CouponHut uses.

Expand the CouponHut Add-On menu that is below the text content form and start drag and dropping the fields to the corresponding ones in CoponHut.

Some fields like Deal Type can be one of two values. As these two values can be different in name to the metafields that you have in your old deals, they can be set up to the new ones.

Example: In your old theme you had two types of Deals - offer and coupon, but COuponHut has discount and coupon. You can map them by clicking on Set with XPath > Field Options > Mapping* and write you old values that are going to translated to the new values.

After everything is ready, continue and select a unique identifier for each deal (must be field that is different for each deal, normally it's the title).

Click continue, and all deals will be imported in their new format.

# WooCommerce

As of CouponHut 2.2, Woocommerce Plugin will be installed with all the other plugins from the notice that appears after activating the theme.

## For CouponHut version < 2.2 Users that Update to 2.2

The Ultimate Membership plugin is no longer required and it's strongly recommended to be deactivated.

## Setting Up WooCommerce

Please note that you can skip the entire WooCommerce step by step process if you don't plan to use pyment options in your theme.

After setting up WooCommerce by running the Wordpress Setup Wizard, go to Appearance > Theme Setting > Deals and activate the Enable WooCommerce option. If you don't want to manually check the orders as complete in the WooCommerce Settings Panel - activate Auto Complete WooCommerce Orders.

WooCommerce in CouponHut doesn't use the default Products post type, it is integrated in the Deals post type.

When activated WooCommerce automaticaly creates its needed pages like My Account, Checkout, etc. By going to WooCommerce > Settings >Checkout you can check if the right pages are selected in Cart Page and Checkout Page.

In WooCommerce > Settings >Shipping, you can deselect Enable shipping if you don't want your users to enter shipping information when purchasing a deal.

In WooCommerce > Settings >Accounts, make sure that My Account page is set to My Account. This is the page that your users use to see what deals they have bought and review their information and purchase history.

## Creating WooCommerce Deal

We will the a look at some of the fields when we create or edit an existing deal:

Old Price, New Price, Save - These fields are presentational only. They don't have any other functionality apart from showing the user some information about the pricing.

WooCommerce Sale Price - This is the price that will be used for the WooCommerce Pricing. Only numbers must be placed here. The currency sign must not be entered. Make sure you have selected the correct currency in WooCommerce > Settings > General. If WooCommerce Sale Price is left blank or WooCommerce is disabled, the deal will not use a payment system.

# Blog Page

Go to Pages > Add New, write the page title and select Blog from the Template dropdown at the right.

Then click the Publish button.

After that navigate to Settings > Reading in the Worpdress Admin Dashboard and select your blog page for Post Page.

Click Save Changes.

# Shortcodes

You can find a shortcodes button in the default Visual Content Editor when creating a new page. Clicking on it will reveal list of shortcodes that you can add to your content.

# Tips, Tricks & FAQ

### Using a Child Theme

A child theme is a theme that inherits the functionality of another theme, called the parent theme. Child themes allow you to modify, or add to the functionality of that parent theme. A child theme is the best, safest, and easiest way to modify an existing theme, whether you want to make a few tiny changes or extensive changes. Instead of modifying the theme files directly, you can create a child theme and override within. You can find more information here.

The Theme comes with already created child theme. If you create customizations, it's recommended to use that instead of the parent theme.

### It seems like Google Maps is not working. What should I do?

Google have changed their Google Maps policies and now an API Key has to be present for Google Maps to work. Create one, go to Theme Settings > Appearance > Deals and enter your Google API Key. You can find more information here - https://developers.google.com/maps/documentation/geocoding/get-api-key#key

### I can't seem to be able to allow users to register.

To enable user registrations, enable it from the WooCommerce settings panel found in WooCommerce > Settings > Account.

### My page items are Full Width and I don't want them to be like that.

Make sure that you put the page builder item in a Section that is configured to Fill Width Off. You can also iwrap it in a 1/1 column.

### I don't have Browse Deals/Companies page.

You have to create one Page that uses the Browse Deals Template and one that uses the Browse Companies Template. This way all the links in the site, pointing to such pages will work as they should - for example the "All Deals" link in the Featured Deals Shortcode. Please read the Browse Deals and Companies Template section in the documentation.

### I can't see all companies on the Browse Companies Template

For a company to be shown, it must have a logo.

### When I enter a Deal or another page, it gives my 404 Not Found.

Go to the admin dashboard Settings > Permalinks, click on Post Name and after that Save Changes at the bottom.

### What image dimensions whould I use?

The theme resizes the images to the following resolutions:

- Deal Thumbnail - 400x470
- Blog Thumbnail - 400x470
- Single Post Header - 1950x1050
- Company Logo - 440x200
- Contact Page Side Image - 1200x1500
- Widget Bacgrkound Image - 400x800

Please have in mind that the theme shows the Single Post Header to a maximum of 500px, thus some clipping mays still occur.

# Credits

- Isotope