Documentation Poka Theme v2

Follow the instructions below to install and configure your Poka theme!

Installation/Activation


Installation

The zip you just downloaded contains all the files you are going to need, in detail:

  • Poka v2 theme
  • Your child theme
  • Documentation
  • Demo content

 

Upload the poka_v2.zip file which is inside your main zip via the the WordPress Admin Panel.
To do so, go to “Appearance” > “Themes” in the menu, then select the “Install Themes” tab at
the top of the page. Once you are at this page, select “Upload,” then “Choose File” to locate the
.zip folder on your computer and select “Install Now.”

 

Activation

Once you have installed the theme, you can go back to the “Themes” page in
the WordPress Admin Panel (“Appearance” > “Themes”) and select “Activate” Poka v2 theme.

 

Making changes to your theme

If you want to change something in the theme it is highly recommended to install the provided
Child theme and make all the changes you want there in order to have the ability to update
Poka v2 theme in future versions without losing your changes.
The theme is using a lot of actions/hooks so you can override/change most of the Poka theme
functions in your child theme.
For further help about Theme API contact us via email or support forum.

 

Demo content

Available demos:
Demo1 (http://pokav2.pokatheme.com/demo1/)
Demo2 (http://pokav2.pokatheme.com/demo2/)
Demo3 (http://pokav2.pokatheme.com/demo3/)
Demo4 (http://pokav2.pokatheme.com/demo4/)

If you want to enable one of the above demo content follow the next steps:
Locate in your zip folder the sub folder of the demo you want.

Step 1. Activate Poka v2 theme

Step 2. Import theme options
First install “Theme options importer” https://wordpress.org/plugins/options-importer/
After install and activation go to Tools -> Import and select Options “Run Importer”.
Select your *-theme-options.json file and select “ All Options ” and check Override existing
options.

Step 3. Import demo content
Go to Tools -> Import and install WordPress Import.
Then select *-content.xml from your zip and click Upload file and import.
On the assign authors dialog select your current user to assign the posts and check
“Download and import file attachments”
After a couple of minutes (depending on your server/connection) when the import is completed.

 

Migrating Poka v1 to Poka v2

If you are running a site with Poka v1 and you want to migrate to Poka v2 you have to follow a
few steps for a successful migration.
Although Poka v2 is a complete rewrite we have done our best to make the migration as easy
as possible but some data may need update in your site after Poka v2 activation.
After uploading and activating Poka v2 follow these steps:

  1. Install Regenerate Thumbnails ( https://wordpress.org/plugins/regenerate-thumbnails/ )
    and goto Tools/Regenerate Thumbnails to resize your images to the new thumbnail
    sizes. Poka v2 uses bigger thumbnails in general and a bulk resize is suggested in order
    for your images to look good. Also it is suggested to use transparent png images for
    review logos in Poka v2.
  2. You have to manually update in all your reviews the field “Bonus promo title” with the
    appropriate text. In Poka v1 a similar field was “Bonus small”.
  3. In Poka v1 there was a field called “ Content top full width ” which was used for full
    width section in pages. In Poka v2 it is replaced with a dynamic field “ Full width
    sections ” in which you can create as many full width section you want. If you used
    “ Content top full width ” you have to transfer the content from these fields to the new
    field “ Full width sections ”. You can create a new full width section to the page you want
    and paste the content from the old field.
  4. If you used the Poka child theme with Poka v1 and now you also want to make changes
    to Poka v2 you have to use the new Poka v2 child theme and migrate the changes you
    made to the old child theme to the new as needed.
  5. For the Review single pages if you want to display the screenshots thumbnails you can
    use the shortcode [screenshots_carousel title=”Screenshots”] and place it anywhere in
    the review content you want.

 

First step after activation

If you imported demo content a new page has been created with the name Homepage and it’s
been set as your front page in wordpress options. This is the page you can use for the
homepage of your site and you can customize it using all the available shortcodes.
If you haven’t imported demo content you can create your own page and then you can set it as
“Frontpage” at Settings/Reading “Front page displays” and select “A static page”.

Theme Settings


Page Intro
In this field you can enter the content you want to display next to the logo to the Header of the site. If you leave this field empty then nothing is going to appear.

 

Google Analytics code
If you want visitor statistics in this field you enter the Google analytics code. You can get yours from : http://www.google.com/analytics/

 

Facebook link
The link to your social account that is going to appear in the footer. If you leave it empty then the icon is going to hide.

 

Twitter link
The link to your social account that is going to appear in the footer. If you leave it empty then the icon is going to hide.

 

Instagram link
The link to your social account that is going to appear in the footer. If you leave it empty then the icon is going to hide.

 

Google+ link
The link to your social account that is going to appear in the footer. If you leave it empty then the icon is going to hide.

 

Affiliate redirect link folder
All the Reviews that contain an affiliate link use a specific URL structure to hide the affiliate link to the visitor. In this field you can set the URL structure for your affiliate links.
For example : ww.yoursite.com/go/affiliate_name.
Default value :go

 

Footer copyright text
The copyright text that is been displayed to the footer.

 

Show related articles in posts page
If you want related posts widget in the bottom of your posts single page check this checkbox.
(Related articles are considered articles in the same category as the current article)

 

Allow users to comment in posts
If you want comments in your posts check this option. (It is recommended users to be logged in to comment.)

 

Allow users to comment in reviews
If you want comments in your reviews check this option. (It is recommended users to be logged in to comment.)

 

Allow users rating in reviews
Users will have the ability to rate the reviews only if they are registered and only once in every review. Then the average of all the ratings is going to be displayed in the review. (You can override users rating with yours rating for a specific review from the Review fields )

 

Enable AMP pages in the theme
Before enabling this option you have to install and activate the following plugin:

AMP


In order for the AMP version of pages to work you have to refresh your permalinks with the
following steps: Settings -> Permalinks -> select “Post name” and click “Save Changes”
For more information about AMP pages https://www.ampproject.org/
In Poka v2 AMP pages are enabled for single posts / pages / review pages

 

Banners

You can have banners anywhere in the content with shortcodes or in the sidebar with Text widget or with the AdRotate ad widget.
Also you have the following fixes Banner areas:

 

Banner fullwidth top
This is the banner available space between the main content and the site header. The available
width in desktop mode is 1110px and you can place your banner snippet, an image with a link or
your Adrotate shortcode.
(You can hide the banner at pages/reviews/categories by selecting the appropriate rules in the
checkboxes.)

 

Banner fullwidth bottom
This is the banner available space after the main content and before the site footer widget area.
The available width in desktop mode is 1110px and you can place your banner snippet, an
image with a link or your Adrotate shortcode.
(You can hide the banner at pages/reviews/categories by selecting the appropriate rules in the
checkboxes.)

 

Visual Settings


General

Header style
You can select how your header should look like by selecting one of the available header styles.

 

Header background
You can override the default header background by uploading your own image.

 

Hide breadcrumbs
Check to hide breadcrumbs.

 

Override reviews breadcrumb link
When you are in a review page and you have enabled breadcrumbs the parent link is the
archives page of reviews. If you want to override this link with your own page you can select it in
this dropdown.

 

Review style
You can select one of the three different styles for the reviews pages

 

Taxonomy review style
You can select one of the five different styles for the reviews taxonomies.

 

Category style
You can select one of the two different styles for the posts categories.

 

Sidebar to the left
Check to display the sidebar to the left side of your site.

 

Site logo
Here you can upload the logo of your site.

 

Logo width
If your logo image is bigger than you actually want it in your site or if you want your logo to be retina ready in this field you can set the actual width for your logo. If no width is set then is going to be displayed as uploaded.
For retina ready logo: If you want for example your logo to be 180px you can upload a logo at 360px and then set the width to 180px.

 

Logo width (mobile view)
For mobile devices we usually want our logo to be smaller that in desktop. In this field you can
set the width of your logo for the mobile view.

 

Site background color
The background color of your site.

 

Element radius
Select the border radius for buttons and other elements.

 

Fonts

Main font color
The primary font color is going to be used to your site.
Default value: #2d2d2c

 

Main Font Family
You can change the font in your site with one of the availables in the dropdown.

Secondary Font Family
You can select a different font family for the header of the site, if left in “Same as main font
family” the main font family is going to be used.

 

Colors


In colors tab you can change all the colors that are used in the theme. Each color represents the
default color used in the theme. For example the green color is mainly used in the affiliate
buttons and you can change it to whatever you like!

 

Post types


Post

You can use Posts in order to create news, video posts, tutorials etc and whatever else you need. You can create categories and display the posts with the category view or with the news shortcode.
In Posts there are available two post formats, standard and video. With video format the first video in your posts content is displayed as featured image in category view and in news shortcode.

Post categories
You can override the default category style for each category from the dropdown “Category
style”

 


Reviews

This is the post type that it is for your affiliates reviews. This post type has the metabox Affiliate fields where you can find all the available settings for each review.

Affiliate fields

Affiliate link
In this field you can find all the affiliate links you have created in Affiliate links post type. This is the affiliate link for your review when the user clicks Visit review.

 

Bonus promo title
The bonus of the Review that is going to be used in widgets and in shortcodes .

 

Free spins promo text
The free spins bonus of the review that is going to be used at the shortcode
[single_affiliate_freespins] and in reviews pages.

 

Affiliate rating
The rating of the review with available options 1-5 in order to display the stars in Review shortcodes, Review table and Review page.

 

Ratings number base
If you have enabled users ratings this is the field to set the base number if you want your
reviews not to start from zero.

 

Rating override
If you have enabled user ratings but for a specific review you want your rating to appear check
this option.

 

Review style
If you want to override the style for a specific review you can select the style from this
dropdown.

 

Affiliate small info
The text info that is going to be used in Review table.

 

Review thumbnail
You can upload screenshots from your review and then display them in a carousel with the
shortcode [screenshots_carousel title=””]

 

Affiliate info list
The list that displays the information about the review. It is displayed in the top of the Review page. You can enter as many list items as you want.

 

Pros/cons
The list items for the Pros and Cons of the review. In order to display the Pros/Cons box in the content you can use the [upsdowns] shortcode.

 


Affiliate links

This is the post type for all of your affiliate links. First you create the affiliate link and then you associate it with a Review with Affiliate link dropdown.
The idea behind this structure is to have a separate Post type for the affiliate links in order to give you the option to use each affiliate link in multiple Reviews.

s10

Affiliate link fields
Affiliate link
The link you want the Play now button to lead to which is the target link you have from your affiliate associate.

Affiliate key
The word you want to be displayed in the frontend in the URL structure.
Use only one word or use _ for multiple words. e.g. poker_site

Affiliate onclick
Execute a JavaScript when affiliate link is clicked.

(Below you can find examples for Google Analytics events)
Example Google Analytics Classic : _gaq.push([“_trackEvent”, “Button”, “Click”, “Casino name”]);
Example Google Analytics universal : ga(“send”, “event”, “Button”, “Click”, “Casino Name”);
(This version is used in the theme by default)


Sliders

This is the post type for the sliders of your site. Each post is a different slider and inside every slider you can set the slides and the options of the specific slider.

s9

Slider fields

Slider images
You can add as many slides as you want with the Add image button. In every slide you can set the image of the slide, the alignment of the image, the Caption of the slide, the position of the Caption and if you want the Caption to have a black transparency for better readability in complex images.

 

Slider timeout
If you want the slider to auto rotate enter the time in ms. If you don’t want the slider to auto rotate enter 0. If you want for example each slide to stay for 8sec and then rotate to the next enter value 8000.

 

Custom Shortcodes


In every wordpress content editor (in any post type) you can find the shortcodes button where you can find all the custom shortcodes of the theme.

Below you can find all the custom shortcodes of the theme:

 

[table-list num=”” cat=”” sort=”” big_table=””]
The shortcode to use if you want to display a list with Reviews.
num : The number of the reviews you want to display. If you need to display all available Reviews enter -1
cat : If you don’t want to display all the reviews but only the reviews that are in a category enter here the category slug.
sort : The available options are date,rating,title
big_table : If you want to display the list in full width it’s better to set this option as true.


[affiliates_list num=”” cat=”” sort=”” big_table=””]
The shortcode to use if you want to display a multi column list with Reviews.
num : The number of the reviews you want to display. If you need to display all available Reviews enter -1
cat : If you don’t want to display all the reviews but only the reviews that are in a category enter here the category slug.
sort : The available options are date,rating,title
columns : You can display the list in a 2 or 3 column layout. Default value: 3


[search_affiliates_ajax placeholder=””]
This shortcode to display the ajax search form for the reviews.
placeholder : The placeholder for the input. Default value: Search reviews


[single_affiliate title=”” size=””]
This shortcode to display a single review post in two available sizes.
title : The title of the Review post you want to display.
size : The available options are small,big. The small size usually fits better in a widget area and inside a column and the big size fits better in whole content width.


[single_affiliate_freespins title=””]
This shortcode is used to display a single review post with the Free spins bonus custom field.
title : The title of the Review post you want to display.


[single_affiliate_xl title=””]
This shortcode to display a single review post in large size. It is created for use in full width
section.
title : The title of the Review post you want to display.


[affiliates_carousel posts=””]
This shortcode is used to display a carousel with reviews in full width section.
posts : Add the reviews you want to display separated with the character | . For example:
LeoVegas|Bet365|888Poker


[poka_slider title=””]
This shortcode to display a slideshow that you have already created in Slider post type.
title : The title of the Slider you want to display.


[upsdowns]
This shortcode can be used only inside Review post. It works in combination with the values you have entered in custom fields for Ups/Downs. First you enter your Ups/Downs in metabox and then you put the shortcode in content in the position you want to display the Ups/Downs box in the frontend.


[screenshots_carousel]
This shortcode can be used only inside Review post. It works in combination with the images
you have uploaded in Review thumbnails. If you have added images in Review thumbnails with
this shortcode you can create a carousel with the images in any place of the Review content.


[latest_news num=”” cat=””]
This shortcode to display the list of the Posts you have in a grid format.
num : The number of the Posts you want to display. If you need to display all available Posts enter -1.
cat : If you don’t want to display all the Posts but only Posts from a specific category enter here the category slug.


[latest_news_sidebar num=”” cat=””]
This shortcode to display the list of the Posts you have in list format mainly for a use in small
spaces like a text widget.
num : The number of the Posts you want to display. If you need to display all available Posts enter -1.
cat : If you don’t want to display all the Posts but only Posts from a specific category enter here the category slug.


[news_boxes cat=””]
This shortcode to display the 5 latest Posts in a boxy format.
cat : If you don’t want to display all the Posts but only Posts from a specific category enter here the category slug.


[btn href=””]
This shortcode to display a button based on your theme styles.
href : The URL of your button.


[affiliate_link id=””]Button text[/affiliate_link]
This shortcode is used to display a button with the affiliate link you want.
id : The ID of the affiliate link


[social_links]
With this shortcode you can display social icons for the social links you added in Theme Options


[box_text icon=””]Your text[/box_text]
This shortcode is for a box text. You can also add an icon on the side of the box if you use the
parameter icon and add a Font Awesome icon from this page :
http://fontawesome.io/cheatsheet/
icon : Copy and paste an icon from fontawesome.


[two-cols-first] [/two-cols-first] [two-cols-last] [/two-cols-last]
This shortcode is used to create a two colums layout. The content for each column must be placed inside each shortcode.
For example : [two-cols-first] <p>A paragraph</p> [/two-cols-first] [two-cols-last] <p>A paragraph in second colum</p> [/two-cols-last]


[three-cols-first] [/three-cols-first] [three-cols-middle] [/three-cols-middle] [three-cols-last] [/three-cols-last]
This shortcode is used to create a two colums layout. The content for each column must be placed inside each shortcode.
For example : [three-cols-first] <p>A paragraph in first column</p> [/three-cols-first] [three-cols-middle] <p>A paragraph in second column</p> [/three-cols-middle] [three-cols-last] <p>A paragraph in third colum</p> [/three-cols-last]


[four-cols-first] [/four-cols-first] [four-cols-middle] [/four-cols-middle] [four-cols-middle] [/four-cols-middle] [four-cols-last] [/four-cols-last]
This shortcode is used to create a two colums layout. The content for each column must be placed inside each shortcode.

For example : [four-cols-first] <p>A paragraph in first column</p> [/four-cols-first] [four-cols-middle] <p>A paragraph in second column</p> [/four-cols-middle] [four-cols-middle] <p>A paragraph in third column</p> [/four-cols-middle] [four-cols-last] <p>A paragraph in last colum</p> [/four-cols-last]

 

Custom Widgets


From the main WordPress Admin Panel select Appearance > Widgets and you can drag n’ drop any of the widgets to each of the available widgets areas. Primary Widget Area is the sidebar of the site and Footer Widget Area is the widget area that is above the footer.
s12

 

Affiliate sites widget
This widget can be used to display a list of reviews with ratings, bonus and two links one for affiliate link and to one review page.
Title : The title of your widget.
Category Name : If you want to display reviews from a specific category.
Sort : You can select the ordering of the Affiliates. Available options are : Rating/Title/Date
Number of posts : How many reviews you want to display.


Affiliate sites simple widget
This widget can be used to display a list of reviews with title and link to affiliate url.
Title : The title of your widget.
Category Name : If you want to display reviews from a specific category.
Sort : You can select the ordering of the Affiliates. Available options are : Rating/Title/Date
Number of posts : How many reviews you want to display.

 

Recommended plugins


We have integrated support for the following plugins if you need any additional features: