Decoup - A Wordpress Theme by CactusThemes

The Documentation

For support please checkout CACTUSTHEMES SUPPORT FORUM

Decoup - A Wordpress Theme by CactusThemes

Welcome to Decoup!

Thanks for Buying

First of all, thank you for buying our theme. We are a team of developers making awesome WordPress Theme - To make your experience pleasant, we have added as much information as needed in this documentation.So, you should be able to find answers to all problems regarding using the theme.

Created By: CactusThemes

Support Site: http://ticket.cactusthemes.com

Version: 1.0

THEME LAYOUT

MAIN LAYOUT

map2

Installation

The Full Package includes these following files and folders:
  • Documentation folder - Contain this document and other materials
  • Installation Files folder - Contain all installable files, including theme & plugins
    • themes/decoup.zip - WordPress Theme Installation file
    • plugins/decoup-core.zip - WordPress plugin to enable Coupon feature
    • plugins/decoup-shortcodes.zip - WordPress plugin to enable shortcodes
    • plugins/decoup-unyson-backup-restore.zip - WordPress plugin to Import demo data for Decoup
    • plugins/cactus-frontend-submission.zip - WordPress plugin to enable Coupon submission feature
OptionTree plugin is required for the theme to work properly
Note: You can install optional plugins if needed. We recommend using these extra plugins (free). All have been tested and used on our demo page.
Go to Plugins > Add New to install and activate plugins

INSTALL VIA WORDPRESS

  1. Login to WordPress Admin
  2. In the left menu panel go to Appearance > Themes > Add New to install theme, or Plugins > Add New > Upload to install plugins
  3. Click Upload
  4. Browse your download package to select installation files
  5. Click Install Now button
  6. Once it's uploaded, click the Activate link

INSTALL VIA FTP

  1. Use your FTP software to browse to wp-content/themes folder to install theme or wp-content/plugins folder to install plugins
  2. Extract the installation files to their corresponding folders, for example decoup.zip to decoup and upload to server
  3. Once it's uploaded, go to your WordPress Admin, browse to Appearance > Themes or Plugins > Installed Plugins
  4. Click the Activate link
After the process of installation is finished, your page will be displayed in form of a blog page

Update Theme

  1. Deactive current theme by going to Appearance > Themes and activate any other themes such as the default Wordpress 3.8's Twenty Fourteen.
  2. Delete older version by clicking on Delete link. Confirm to delete.
  3. Update and re-install new version.

All posts and settings will be saved. This is data-safe method.

Auto Update

  1. Go to Envato Market, find and download envato-market.zip. Then please upload and install this plugin.
  2. To establish an Envato Marketplace API connection navigate to the Envato Toolkit page and insert your Marketplace username and secret API key in the designated input fields. To obtain your API Key, visit your "My Settings" page on any of the Envato Marketplaces
  3. Once the API connection has been established you will see a list of themes that can be auto installed. If you don't see any themes and are certain you've done everything correct, there is a good chance the theme author has not updated their theme to be available for auto install and update. If that's the case, please contact the theme author and ask them to update their theme's information
  4. Note Only theme is updated. Related plugins must be updated manually. Please check release logs to see if you need to update plugins

INSTALL SAMPLE DATA

ONE + CLICK INSTALL

Before starting, it is noted that

  • First, you have to install Decoup - Sample Data plugin. This plugin is included with your download package
  • It is better to install sample data on a fresh Wordpress installation. Therefore, you may want to reset your site to default settings. Install and use Wordpress Reset plugin to do that. After installed, go to Tools > Reset
  • If you have to run the process more than once, menu items may be duplicated. Just go to Appearance > Menus and edit/delete Main Menu items

Go to Decoup > In Sample Data Tab. Click to install sample data.

IMPORT MANUALLY

Alternatively, you can use traditional way to import data. In /Sample Data/ folder, you can find there are:
  • coupon.xml All Data
  • theme-options.txt Theme Options Settings
  • coupon-widgets.json Widgets Settings
To install sample data as seen on our demo page, following these steps

Step 0. Make sure you have installed the blog theme and all recommended plugins

Step 1. Go to Tools > Import, then click on Wordpress

Step 2. If it is not yet installed before, you have to install it. On the popup window, click on "Install Now"

Step 3. After installed successfully, click Activate Plugin & Run Importer

Step 4. Browse for [path-to-your-downloaded-package]/Installation File/Sample Data/decoup.xml or decoup.xml.gz and click Upload File and Import.

Step 5. After uploaded, the confirmation page appears. Check the Download and import file attachments option and click Submit.  If you have trouble with importing (it might breaks in the middle due to long execution time), try again with this option Unchecked! Or, try to import separate files as they are smaller

Step 6. After uploaded, the confirmation page appears. Check the Download and import file attachments option and click Submit

Step 7. When you see message "All done. Have fun!", you will know that the import is done.  Note: you may need to re-import the second time if the data is large. Back to Step 1. until you see the message below

Step 8. Go to Settings > Reading, set Front page displays to A Static page. Choose Home Page page as Front page and Blog as Posts page

Step 9. Go to Appearance > Menus, choose Main Navigation menu as Prim

ary Menu


Step 10. Install Widget Settings Importer/Exporter and go to Tools > Widget Settings Import to import Sample-data/coupon-widgets.json file

Step 11. Go to Option Tree > Settings > Import and paste content of Sample-Data/theme-options.txt into Theme Options text field, then click Import Theme Options button.

Step 12. OK, done!

MENU

There are three menu locations in the theme:
  • Primary Menu
  • Mobile Menu
  • Footer Menu

If you have imported demo content, follow Existing Menu or else follow Creating a New Menu to create a new menu.

  1. Go to Appearance > Menus
  2. In the Manage Locations area, under Main Navigation, select a menu for in the dropdown box labeled Primary Menu, Mobile Menu or Footer Menu. Click Save

    menu

  1. Go to to Appearance > Menus

  2. Click Create a new menu. Enter a menu's name and click Create Menu

  3. Check the menu item in the boxes in the left column, click Add to Menu to add items to the menu and drag/drop to arrange them.

    createmune

  4. If you would like to use this menu in navigation, in the Manage Locations area, assign your newly created menu to Primary Menu, Mobile Menu or Footer Menu. Click Save

  5. Click Save Menu and that is all

THEME WIDGETS

Add Widget to Sidebar

Please follow these steps to add widget to sidebar

  1. From Admin Panel, navigate to Appearance > Widgets tab to access the list of widgets and widget section.
  2. To activate a widget drag it to a sidebar or click on it. To deactivate a widget and delete its settings, drag it back
  3. All done, click Save to save the widgets added on your sidebar.

Coupon Widgets

  1. Decoup - Coupon Search 

    This widget will help you to display search form to search for coupons & deals

    • Title
    widget
  2. Decoup - Featured Store

    This widget will help you to display featured stores

    • Title
    • Number of Store
    • Order of posts 
    widget
  3. Decoup - Latest Posts

    This widget will help you to display latest post of your blog

    • Title
    • Number of post
    • Type of post to get
    • Order of posts 
    • Category
    • Tag
    • Post ID
    • Widget logic 
    widget
  4. Decoup - Similar Store

    This widget will help you to display similar store

    • Title
    • Post ID
    • Number of Store
    • Type of post to get
    • Order of posts 
    • Widget logic 
    widget

HOW TO CREATE HOME PAGE

  1. Create two new pages in WordPress (under Pages > Add new), and publish them 

    For the purpose of demonstration, we’ll call these “Home” (for the Front, or Home page) and “Blog”
  2. Go to Settings > Reading Settings, and under “Front page displays”, click the radio button for A static page 

    Select “Welcome” in the first drop down (for Front page), and select “Blog” in the second one (for Posts page). Save the changes

FRONTPAGE TEMPLATE

The Blog provides a page template called Front Page to configure special Frontpage (or Home).

  1. Go to Pages > All Pages and edit “Home” page created in previous step
  2. Choose Front Page in Template.
    fp-header

THEME OPTIONS

The blog comes with a lot of options to help you totally customize the look & feel of your site. Go to Appearance > Theme Options to configure.
Below is the detail of how to use those functions.

GENERAL

The general configuration for website
  1. Logo Image - Upload your logo image
    2. general

  2. Retina Logo (optional) - Retina logo should be two time bigger than the custom logo. Retina Logo is optional, use this setting if you want to strictly support retina devices.
  3. Login Logo Image - Upload your Admin Login logo image
    4. gl6

GENERAL LAYOUT

  • Use Custom Code in Main Bottom Sidebar - Select Enable/Disable: Use Custom Code in Main Bottom Sidebar replace for Widgets

    • CUSTOM COLOR

  • Custom Colors - Select Enable/Disable
  • Customize Header Colors - Select Enable/Disable: Change various color settings on Header
  • Mobile Menu Custom Color - Select Enable/Disable: Change various color settings on Mobile Menu

    • CUSTOM FONTS

  • Custom Google Fonts - Choose font: Load custom Google Fonts to be used in website.
  • Custom Font Settings - Select Enable/Disable: Change various font settings

    • Header

    Blog

    Theme Shortcodes

    When Couponseed-shortcodes plugin is installed, shortcodes can be used in either Classic Editor or Visual Composer mode (require Visual Composer plugin installed). You can type shortcode directly in Classic Editor or use Visual Composer element to configure the shortcode
    Most of the properties of shortcodes are optional. You only need to include properties when needed
    1. Using Classic Editor


    2. Using WPBakery Page Builder Editor (formerly Visual Composer)

    LATEST COUPONS

    This shortcode will display a number of latest coupons as specified.

    1. title - text - title of shortcode to display. Default is empty
    2. count - number - number of coupons to show. Default is 6.
      3. latest_coupons

    This shortcode will display a number of popular coupons as slider.

    1. count - number - number of coupons to show. Default is 6.
      2. popular_coupons

    This shortcode will display a number of popular stores as slider.

    1. count - number - number of stores to show. Default is 6.
      2. popular_stores

    This shortcode will display a number of popular stores as a list.

    1. title - text - title of shortcode to display. Default is empty.
    2. count - number - number of stores to show. Default is 48.
    3. text color - color - color of text link. Default is theme color.
    4. background color - color - background color of entire shortcode. Default is theme color.
      5. popular_store_listing

    Button

    1. text_color – hexa color – Color of text
    2. style - select – Select button style
    3. bg_color – hexa color – Color of background
    4. text_hover_color – hexa color – Color of hovered text
    5. bg_hover_color - hexa color – Color of hovered background
    6. icon – string – Icon CSS Class
    7. url – string – URL to navigate
    8. link_target – select – URL target, to open link in new tab (_blank) or current page (leave empty)
      9. Default Style:
      button
      Bordered Style:
      button

    Separator

    1. width – number or percentage: Width of Separator in Pixel or %. Ex: 50%. Default is 100%
    2. height – number: Height of Separator in Pixel. Default is 1(px)
    3. color – hexa color: Color of Separator
    4. padding – mixed: Padding of Separator. Default is ‘0px 0px 0px 0px’ (TOP RIGHT BOTTOM LEFT).
    5. alignment – select: Select alignment: left, center, right
      6. button

    Typo

    This shortcode is used to format text.

    1. size – int – Font size, in pixels
    2. weight - select – Font weight
    3. color – hexa color – Text color
    4. padding – mixed – Padding of text, default is ‘0px 0px 0px 0px’. Format: ‘top right bottom left’
    5. margin - mixed – Margin of text, default is ‘0px 0px 0px 0px’. Format: ‘top right bottom left’
    6. alignment – select – Text alignment (left, right, center)
    7. line-height – select – Line height of text (1em, 1.1em, 1.2em, 1.5em, 2em)
    8. html_tag – string – HTML tag to wrap the text. Default is
      9. button

    Social Accounts

    Social Accounts shortode is only available in Classic Editor. This shortcode will display social account that you configured in theme options panel.

    social_accounts

    CATEGORY PAGE

    1. Each category has its own options which allow you to override settings in Theme Options > Categories
      category

    PAGES

    COUPON LISTING PAGE-TEMPLATE

    Decoup provides a Coupon Listing Page Template to list all coupon. To use this page template, Decoup Core plugin needs to be installed first.

    1. Go to Pages > All Pages and Add New page. Name it Coupon Listing
    2. Choose Coupon Listing in "Template" select box. Leave the page content empty as it is ignored.

      coupon

    Below is a sample of a coupon listing page

    coupon_listing

    DEAL LISTING PAGE-TEMPLATE

    Decoup provides a Deal Listing Page Template to list all deal. To use this page template, Decoup Core plugin needs to be installed first.

    1. Go to Pages > All Pages and Add New page. Name it Deal Listing
    2. Choose Deal Listing in "Template" select box. Leave the page content empty as it is ignored.

      deal

    Below is a sample of a deal listing page

    deal

    PAGE SETTINGS

    POSTS

    POST SETTINGS

    POST FORMAT

    Decoup theme supports Standard, Video, Audio and Gallery Post Format.

    OTHER SETTINGS

    WIDGET CUSTOM VARIATION

    In every widget, there is a textbox called Custom Variation. It is used when you want to customize the widget using custom CSS. The value entered in this textbox is added to the CSS class property of the widget box in front-end, then you can write CSS for this widget

    custom1
    custom2

    WIDGET WIDTH

    Note: When you drag widgets into Footer Sidebar, you can set Widgets manually by using Select Box (col-md-X). Make sure that the total width of each row is 12 column. For example: you have inserted 4 Widgets into Footer Sidebar, you want to split the width of the widget evenly, you need to select the width to be (col-md-3) in Widget width or a Widget named "Recent Posts", you can set its width to be (col-md-3) ​​or you can set its width randomly.
    widgets_width

    DECOUP CORE

    CREATE COUPON

    1. Step 1 - Create a Coupon : Go to Coupon > Add New Coupon
      2. coupon
    2. Step 2 - Enter coupon title and information to fields in Coupon Detail
      3. coupon

    CREATE STORE

    1. Step 1 - Create a Store : Go to Coupon > Add New Store
      2. store
    2. Step 2 - Enter store title and information to fields in Store Detail
      3. store

    DECOUP SETTING

    Go to Decoup Settings on the left of menu to configure several needed information
    decoup_setting

    FRONTEND SUBMISSION

    This plugin allow you or user to be able to submit coupon directly on the site via a form (not in admin dashboard)
    decoup_setting
    To use this feature, please do as following steps:
    1. Step 1 - Install plugin Cactus Frontend Submission & Contact form 7
    2. Step 2 - Create a form using Contact form 7 plugin with the content of the form as code below
    3. Step 3 - Copy shotcode of the form you created before
      4. decoup_setting
    4. Step 4 - Drag a text widget to a sidebar that you want to display coupon submission form. Paste the shortcode from step 3 into the text widget. Now you have coupon submission form work fine on the site.
      5. decoup_setting

    RTL & Translation

    The Coupon is a WMPL compatible and multi-language ready theme. To translate this theme:
    • Download and install this tool POEdit
    • Open POEdit and load [/decoup/languages/decoup.po]
    • Translate the text and save the file
    • A file named decoup.modecoup is created. Save it in /languages/ folder. Rename it with Code Name of your language. For example, de_DE.mo for German - Deutsche. See language code list here http://codex.wordpress.org/WordPress_in_Your_Language
    • For WordPress 4.0 and above, go to Settings > General and choose Site Language
    • For WordPress 3.9.2 and below, open [{wordpress root}/wp_config.php] and find this line define('WPLANG', '');. Change it with your language code, for example define('WPLANG', 'de_DE');
    The Coupon also supports RTL - Right To Left languages. If your language is RTL, go to Appearance > Theme Options > General > RTL mode and check Enable RTL

    Licenses

    The list might not be complete by accident. Authors who think you owe a license in this theme, please contact us at [email protected]

    Support

    If you face any problems with the installation or customization of our product, please do not hesitate to contact us via our support ticket system:

    http://ticket.cactusthemes.com/