Price Compare Documentation

Price Comparision Wordpress Theme

Welcome

Price Compare - Price Comparision WP Theme

This document is help file for Price Compare- Price Comparision WP Theme proudly made by powerthemes.  

In short Price Compare- Price Comparision WP Theme is the most complete wordpress theme for comparing prices of the product among many different stores which offers that product.

 

 

Instalaltion

In the following video we will explain to you how to properlly install the theme so watch this video carefully.

Demo Importing

In this video we will explain to you how to properlly import demo content

 

Permalinks

In these settings you can translate permalinks which are being used in the theme. After the changes in this section you need to visit page Settings->Permalinks in order to make wordpress aware of the changes.

Keyword Slug - input slug for the keyword search on the site.

Product Slug - input slug for the viewing product single page.

Product Category Slug - change slug for the product categories.

Product Brand Slug - change slug for the product brands.

Product Tag Slug - change slug for the product brands.

 

Search bar

Here you can customize search bar which is located bellow navigation on every page.

Enable Search Bar - enable or disable search bar.

Search Bar Categories - select which categorioes are available on the categories dropdown in the search bar.

404 Page

Here you can configure look of the 404 page.

Error Page Image - select which image will be disaplyed on the 404 page.

 

Content Direction

Setup text direction of the site.

Site Content Direction - select LTR or RTL site direction.

White Titles

White Titles Icon - select which icon will be visible to all white block headers which serve an icon.

Appearance

Main Color - select main color of the site.

Main Font Color - select font color for the items who have main vcolor as their background.

Secondary Color - select secondary color.

Secondary Font Color - select font color for the elements who have secondary color as their background.

Secondary Color On Hover - select secondary color on hover.

Secondary Font Color On Hover - select font color for the elements who have secondary color as their background on hover.

Top Bar Bg Color - select background color of the topbar.

Top Bar Font Color - select font color of the top bar.

Submenu Background Color - select background color of the submenu.

Submenu Font Color - select font color of the submenu.

Submenu Border Bottom Color - select bottom border color of the submenu on hover.

Categories Background Color On Hover - select background color of the category items on hover.

Categories Font Color On Hove - select font color of the categories on hover.

Copyrights Background Color - select bacground color of the copyrights section.

Copyrights Font Color - select font color of the copyrights section.

Copyrights Link Color - select font color for the links in the copyrights.

Site Main Font - select main font for the site.

Top Bar

Setup look of the top bar.

Show Top Bar - enable or disable top bar.

Facebook Link - input link to your facebook page.

Twitter link - input link to your twitter page.

Google link - input link to the google + page.

Top bar Mail - input mail which is disaplyed on the top page.

Top Bar Phone Number - input number which is displayed in the top bar.

Logo

Setup logo settings.

Site Logo - upload site logo.

Site Logo Padding - input logo padding in the format TOP RIGHT BOTTOM LEFT. For example 10px 0px 10px 0px.

 

Navigation

Setup navigation.

Enable Sticky Navigation - enable or disable sticky navigation.

Mega Menu

Setup mega menu.

Mega Menu Sidebars - input number of mega menu sidebars.

Copyrights

Setup copyrights.

Copyrights - input copyrights text which is visible at the bottom of the page.

Copyrights Right Image - upload image which is visible on the right side of the copyrights.

Search Page

Setup search page.

Sidebar Position - select sidebar position.

Visible Search Categories - input number of initially visible categories.

Visible Search Brands - input number of visible brands.

Product Box Style - select style of the product boxes.

Price Ranges - input price ranges which will be available on the search page. In order to input price interval use (-) for example for the products with min prices between 100 and 500 you will put 100-500 with no spaces and with no sign. You can create as many price ranges as you want and each one must be in the one line. In order to create price filter for example all products with min price larger then 500 then just type 500.

All Categories

Setup all categories page.

Sort By - select by which field to sort categories.

Sort Order - select how to sort categories.

All Brands

Setup all brands page.

Sort By - select by which field to sort brands.

Sort Order - select how to sort brands.

Registration Page

Set up store registration page.

Input Price Packages - input available price packagesd. Format is PACKAGE_NAME|DAYS|PRICE|ACTIVE One package needs to be in one line. You can create as many as you need. For example  Monthly|30|25.99|A or Monthly|30|25.99

Email Of Sender - input email of the sender message for the image which is being send to the pesion by the them ( expired subscription, near to expiration,... ).

Name Of Sender - input name of the sender message for the image which is being send to the pesion by the them ( expired subscription, near to expiration,... ).

 

Contact Page

Setup contact apge.

Mail - input mail on which messages will arrive.

Mail Subject - input subject of the mail which is being sent.

Google Map Markers - input google markers which will be disaplyerd on the ovontact page.

Disable Scroll Zoom - disable or enable zoom on the map.

Payments

Main Currency Unit - input currency unit.

Main Currency Unit Abbreviation - input abbreviation of the currency which is being used.

Unit Position - select position of the unit.

PayPal API

Setup PayPal API.

PayPal Mode - select paypal mode you are using.

Paypal API Username - input your paypal username  make sure there is no spaces arround it.

Pypal API Password - input your paypal password make sure there is no spaces arround it.

Paypal API Signature - input paypal signature.

Stripe API

Configure Stripe payment.

Public Client ID - input publick client ID.

Public Secret ID - input publick secret  ID.

Skril API

Setup skrill payment.

You skrill mail - input your skrill mail.

You skrill secret word - input secret worf of the skrill.

 

Bank Transfer

Setup bank transfer.

Bank Account Name - input your bank account name.

Bank Name - input name of the bank.

Bank Account Number - input your account number.

Sort Number - Input your SORT number.

IBAN Code - Input your IBAN number.

BIC / Swift Code - Input your BIC / Swift number.

iDEAL API

Setup iDEAL payment.

Mollie ID - input your mollie ID.

Mail Chimp API

Setup MailChimp API.

Mail Chimp API - input API key of your mailchimp account.

Mail Chimp List ID - input subscribe list from your mailchimp account so user get connect to it.

Stores Cron Job

Here you can setup cron job to run the importing when site is at low traffic. Wordpress cron is different from the linux one since it needs to be triggered. In order to accomplish this, you can use some online service for cron triggering or if you know linux you can create one on your server.

Available options are:

Enable Cron - enable or disable cron to be executed.

Start Date Of Cron - input start date of the cron job.

Start Time Of Cron - input start time of the cron job in the format hh:mm for example 10:33 or 23:33.

Repeat Cron Job - select when to repeat cron job.

Products

Here you can setup product options.

Products Per Page - input how many products to disaplay per page on search.

Products Single Layout - select layout of the product single page.

Number Of Similar Products - input how many similar products to be dispalyed.

 

Standard

This post format have these options:

Input URL to be embeded - in this field you ca input what ever URL you would like to be emebede. If this option is empty thanthe featured image will be shown.

Gallery

This post format have these options:

Add images to the gallery - here you can select the images you want to show and also to cheange their order.

Link

For the link post format you have this option:

Input link - here you can input the link for which you want to be displayed. Additionally you can set its background by setting the featured image.

Image

This post format have no addition options since it will use the featured image.

Video

This post format have these options:

Input video URL - here you can input the URL to the self hosted or video which will be embedded.

Select video type - select if the provided URL is from the self hosted video or from the video which should be ebedded.

Quote

For the quote post format you have these options:

Input the quotation - here you can type the quotation for which you want to be displayed.

Input the quoted person's name  - input the full name of the person who is being quoted.

You can also set the background image by selecting the featured image.

Status

This post format have no addition options since it will use the featured image.

Audio

This post format have these options:

Input URL for the audio - input the URL to the audio file.

Select type of the audio - select if the audio file is selfhosted or if it needs to be embeded (supported format for self hosted audio is mp3).

Additionaly to this if you set featured image and you input the auio URL the image will be displayed in the bakground.

Page Templates

Price Compare comes with the following page templates:

  • All Brands
  • All Categories
  • All Stores
  • Contact Page
  • Home Page
  • Page Full Width
  • Page Left Sidebar
  • Register Store
  • Search Page

Sliders

This post format is reserved for creating sliders which are being used on the search page and in the slider shortcode.

In order to create new slider you need to add new slide and select image and put link which will be added to that image.

Slider can be attached to certain category ( if search is conducted for more then one category then no slider will be visible )

You can also select if this slider will be displayed if users lands on the search page but search results are not filtered by any category ( when displaying products of all categories )

Parsers

This post format is being used to create custom parsers for the import feed. This is good if you are using site for the affiliate import

When populating paths to the tags and/or attributes whixh holds the required data there are several thisng you need to know before beggining:

1. If nested tag holds information than path looks like this: product_info/name

...
<product_info>
    <name>Product name</name>
</product_info>
...

2. If attribute stores the information then path is like this: @name

...
<product_info name="Product Name">
    ....
</product_info>
...

3. if attribute of the nested tag holds information then path looks like this: product_info/product_desc@name 

...
<product_info>
    <product_desc name="Product Name">
    </product_desc>
</product_info>
...

4. All pathc are written from the root path defined in the beggining.

For this post type you have these options to set:

Parser Format - (required) - in this field you have to select which type of the feed will be parsed either XML or CSV

Product Root - (required) - In this field you need to enter path to the tag which containes information about product. If you have selected Parser Format to be CSV then write in this field products/product else if you have selected it to be XML then open your XML and find the path. For example if the feed XML is something like this:

<products>
    <product>
        ...
    </product>
    <product>
        ...
    </product>
</products>

 Then path would be products/product, if for example format is like this:

<product>
        ...
</product>
<product>
        ...
</product>

 then path would be product

Product Name - (required) - input path to the element which stores product name

 

Product Categories - (required) - input path to the tag containing product categories.

Parser Categories Separator - (required) - input separator which is being used to separate categories. Categories are considered that they are nesting so first category fill be parent, next one child of the previous and so on. This is also what is considered whn categories are being created.

Product Tags - input path to the product tags.

Parser Tags Separator - input separator which is being used to seaprate tags.

Product Brand (required) - input path to the element containing product brand information.

Product Price (required) - input path t the element containing product price value.

Product URL - input path to the element containing value for the product URL

Product ID (required) -  input path to the element containing value for the product ID

Product Description  -  input path to the element containing value for the product description

Product Short Description  -  input path to the element containing value for the product short description

Product Shipping -  input path to the element containing value for the product shipping

Product Shipping Comment -  input path to the element containing value for the product shipping comment

Product Image -  input path to the element containing value for the product image

Products

This post type hold all information about products. All the values are auto populated when feed importer are being used, but also you can add/edit product manually

For the post title input title of theproduct

In the description input detailed description for the product

 

Beside these basic options you have also custom taxonomies associated with this post type. These taxonomies are:

  • Brand - this is brand of the product its options are descripbed in the section bellow
  • Category - this is where you select to which category product bellong. Additional category settings are described in the section bellow.
  • Tags - this is the place where you input comma separated list of the tags of the product.

 

Prodcts also have custom meta values which are also available on the product edit screen. These fields are:

Product In Short - this is where you type product in short which is displayed just bellow imageor beside the image.

Product Clicks - this is number of visits to single page. This field is auto populated but you can edit it manually too.

Product Store Clicks - this is the number of click on any store, offering product, from the product single page. Field is populated automatically but you can also change it manually.

Product Unique ID - this is unique product ID by which it is checked if the product is imported already during feed import. mak sure that this value is unique for each prodct.

 

Bellow the meta values you have also box where you can add/edit/delete feeds for the product. This is the information which is displayed in the table on the single product page. Fields are self explanatory.

Brands

This is custom taxonomy for the product post type and beside basic settings like any other taxonomy it also have option to set image which would be logo of the brand.

This is done either on adding new brand .

Or on edit screen of the already added brand:

 

Categories

This is custom taxonomy for the product post type and beside basic settings like any other taxonomy it also have option to set image which would be background image of the category mega submenu and on the categories shortcode and to set icon for the category which is visible on the main category filter on every page.

This is done either on adding new category

Or on edit screen of the already added category:

 

Stores

I the submenu of the products you will also notice link with title Stores. This is the place where store information is being added. Managing stores is like managing any other post.

Fields which are available in the store management are:

Store Name (required) - this is where you input name of the store you are adding

Store Slug (required) - this is store slug which must be unique. If it is empty then it will be generated from the title. In this case title must be unique

Store URL (required) - this is link to the store.

Store Logo (required) - this information is populated when store is submited from the front end.

Clicks Through - this is number of click to that store from product single oage. This is auto populated but you can also change it manually.

Store Contact Name - this information is populated when store is submited from the front end to know who to contact once the store checks are over.

Store Contact Email - this information is populated when store is submited from the front end to know how to contact submitter.

Store Contact Phone - this information is populated when store is submited from the front end to know how to contact submitter.

Store Package - this information is populated when store is submited from the front end. If you are using affiliates then no need to select it. Packages are created in the Price Compare theme option described in the options section

Store Expire Date - this information is populated when store is submited from the front endand it is populated based on the calculation using current date and number of days in the package. If you are using affiliate leave this blank.

Store Feed Link - this is the link to the XML or CSV file where feed is uploaded.

Store Status - this is status of the store if it is paid or not. If it is paid it also means that store is active and importer will not skipp it. This is also autopopulated when submitter pays for the stores

Store Parser  - select custom parser for this store. If it is set default that means that the feed is created like in the documentation described bellow. If you however using affiliate feed then select parser which you have previously created for that feed. If you are allowinf stores to create their own feed then select parser you have prepared for that particular store.

XML Feed Structure

If you are using this theme to earn by storing information about product prices of different stores then we have prepared default parser for that feed. In order to properly use this parser all feeds of all stores must follow next structure:

<products>
	<product>
		<pid>123456</pid>
		<name><![CDATA[ASUS Notebook]]></name>
		<description><![CDATA[Best computer out there, with plenty of features,...]]></description>
		<short_desc><![CDATA[Best computer out there, with plenty of features.]]></short_desc>
		<url>http://www.google.com</url>
		<categories><![CDATA[Cloth, Man, Shoes]]></categories>
		<tags><![CDATA[black,new,brand]]></tags>
		<brand><![CDATA[apple]]></brand>
		<price>10.99</price>
		<shipping>10.99</shipping>
		<shipping_comment><![CDATA[We do not deliver on Saturday.]]></shipping_comment>
		<image>https://image_link.png</image>
	</product>
</products>

Fields are:

pid (required) - Unique identification of the product. This is being used to check if product already exists.

name (required) - Name of the product. It will be used if the product is not already imported.

description - Description of the product. It will be used if the product is not already imported.

short_desc - Short description of the product. It will be used if the product is not already imported.

url - URL to the product on your store. If this is empty link to your store will be used instead.

categories (required) - Comma separated list of the categories. Comma separation is for the nesting of the categories.

tags - Comma separated list of the tags.

brand (required) - Manufacturer name of the product.

price (required) - Price of the product. Field requires number only with decimals separated with dot (.) if the price has any.

shipping - Shipping of the product. Field requires number only with decimals separated with dot (.) if the price has any.

shipping_comment - Small desciption for the shipping comment.

image - Input URL to the featured image of the product.

 

All this information is also presented to the submitters once they arrive on the register store page

 

CSV Feed Structure

If you are using this theme to earn by storing information about product prices of different stores then we have prepared default parser for that feed. In order to properly use this parser all feeds of all stores must follow next structure:

pid,name,description,short_desc,url,categories,tags,brand,price,shipping,shipping_comment,image
"123456","ASUS Notebook","Best computer out there, with plenty of features,...","Best computer out there, with plenty of features.","http://www.google.com","Cloth, Man, Shoes","black,new,brand","apple","10.99","10.99","We do not deliver on Saturday.","https://image_link.png"

Fields are:

pid (required) - Unique identification of the product. This is being used to check if product already exists.

name (required) - Name of the product. It will be used if the product is not already imported.

description - Description of the product. It will be used if the product is not already imported.

short_desc - Short description of the product. It will be used if the product is not already imported.

url - URL to the product on your store. If this is empty link to your store will be used instead.

categories (required) - Comma separated list of the categories. Comma separation is for the nesting of the categories.

tags - Comma separated list of the tags.

brand (required) - Manufacturer name of the product.

price (required) - Price of the product. Field requires number only with decimals separated with dot (.) if the price has any.

shipping - Shipping of the product. Field requires number only with decimals separated with dot (.) if the price has any.

shipping_comment - Small desciption for the shipping comment.

image - Input URL to the featured image of the product.

 

All this information is also presented to the submitters once they arrive on the register store page

 

Mega Menu

In order to create mega menu fo to Appearance->Widgets and drag and drop widgets to the one of the Mega Menu sidebars ( number of these sidebars can be set in the theme options ) 

Once you have set it as you would like go to Appearance->Menus and assign Mega Menu to one or more top level menu items 

Update menu settings and visit front end. You will se your mega menu.

Widgets

Price Compare theme coes with the following custom made widgets which are available in the Appearnce->Widgets page:

  • Comapre Brands - here you can select number of brands to show. They are then ordered by number of items associated with them or you can manually select which brands to dispaly
  • Compare Store - sere you can select how many stores to display. They are ordered by number of click to that store from the product single page. Also you cans elect manually shich stores you wish to display.
  • Compare Banner - this is used to place image with the link.
  • Compare Categories - this widget is being used to display list of the categories on the front end
  • Compare Latest Products - use this widget to display latest products added.
  • Compare Icon Text - use this widget to display text with title and text
  • Compare Custom Menu - use this widget to display menu in one or multiple columns. Menu is created in the Appearance->Menus
  • Compare Social - use this widget to add social links and comapre logo.

Shortcodes

Price Compare theme comes with the following shortcodes which are availablein the editor.

  • Compare Grid
    • Row - use this shortcode to wrap column shortcode
    • Column - use this shortcode to create columns inside one row. Possble values are 1 2 3 4 5 6 7 8 9 10 11 12. Sum of these numbers inside one row should be 12
  • Compare Element
    • Banner - use this shortcode to place image with link on the page
    • Blogs - use this shortcode to place blogs on the page
    • Categories - use this shortcode to place categories slider on the page
    • Content - use this shortcode to place text in the white box on the page
    • newsletter - use this shortcode to place newsletter subscribe box on the page.
    • Products - use this shortcode to place products on th epage
    • Price table - use this shortcode to place table containing available packages on the page.
    • Sidebar - use this shortcode to place sidebar on the page
    • Slider - use this shortcode to place slider on the page.

All these shortcodes have some options which are available once you click on certain shortcode. Options are self explanatory.

Credits

Big Thanks To:

  • Redux Framework
  • owlSlider
  • Responsiveslides
  • Bootstrap
  • jQuery
  • Magnific Popup
  • Bootstrap Table
  • User Avatars