PokaTheme Documentation

Follow the instructions below to install and configure your PokaTheme!

Installation/Activation


Installation

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

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

 

Upload the pokatheme.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” PokaTheme.

 

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
PokaTheme 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 see the Hooks section in the documentation or contact us in support forum.

 

Importing demo content

If you want to enable a demo content you have two options. You can either do it automatically or manually. We recommend the automatic option as it is the simplest and fastest, requiring a single plugin installation. Below you can find detailed instructions for both options:

Automatically (Recommended)

  • Activate Poka v3 theme
  • Install and activate One Click Demo Import
  • Go to Appearance > Import Demo Data and click “Import Demo Data”

Manually

  • Activate Poka theme and locate in your zip the folder of the demo content
  • Import the content
    • Go to Tools > Import and Install WordPress Importer
    • Click “Run Importer”
    • Choose the .xml from your zip and click “Upload file and import”
    • Select your current user as the import author, check “Download and import file attachments” and click “Submit”
  • Import widgets
    • Install and activate Widget Importer & Exporter
    • Go to Tools > Widget Importer & Exporter
    • Choose the .wie from your zip and click “Import Widgets”

 

Contact form (optional)

Each demo contains a contact page with a contact form. If you wish to use this form BEFORE demo import you need to install Contact Form 7

 

After successful Content Importing

If you imported demo content you will notice that some new pages have been created. The one with the name Homepage has 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”.

Notice
After importing demo content if there are any caching issues and you don’t see the updated styles you can try updating your visual styles manually from Theme Settings -> Visual Settings and click Update.

 

Migrating Poka v2 to Poka v3

Although Poka v3 has a lot of improvements and bug fixes over Poka v2, we have done our best to make the migration as easy as possible which means you only need to upload and activate the new Poka v3 theme.

If you used the Poka child theme with Poka v2 and now you also want to make changes
to Poka v3 you have to use the new Poka v3 child theme and migrate the changes from the old child theme to the new one.

Specifically copy/paste your current code php/css/js to the new child theme and upload and activate the new child theme to your site.

 

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.
(This applies only in Header style 1)

 

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/

 

Youtube 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.

 

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.

 

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 )

 

Allow unregistered user rating in reviews
You can allow unregistered users to rate your reviews, their IP is going to be saved in order to disallow repeated votes.

 

Enable Font Awesome for the theme
By default FontAwesome is not used in the theme and all the icons have been replaced with svg instead. If you want to use the library you should enable this option.

 

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 theme 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.)

 

Terms & Conditions



You can handle the Terms & Conditions functionality from here.

Enable “Terms and Conditions” functionality
You can switch terms and conditions on/off from here.

Enable “Terms and Conditions” tooltip
If you switch this on, the terms and conditions text will be displayed inside a tooltip which is triggered when the user hovers the text under any affiliate button, otherwise it will appear as regular text under all affiliate buttons.

Text under each affiliate button
Here you can enter the text that appears under all affiliate buttons and triggers the Terms & Conditions popup.

Note: The above will apply only to reviews that you have entered Terms & Conditions text.

 

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.

Hide featured image in posts
If you enable this option the feature thumbnails in posts are going to be hidden.

Make sidebar sticky
Enable this option if you want the sidebar to be sticky.

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

Base font size
The base font of the theme. If you want to make your fonts bigger/smaller because of another font family this is the setting you should tweak.
Default value: 14px

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!

 

Translations


Review post type slug
With this field you can easily change the “Review” post type slug in the URL of your reviews.

All Poka theme sites display their reviews under the URL structure domain/review/review-title, now with this field you can add your own custom review slug.
For example: domain/casino/review-title

Review button text
You can change the text in all the “Review” buttons in the site.

Play now button text
You can change the text in all the “Play now” buttons in the site.

Play button text
You can change the text in all the “Play” buttons in the site.

 

Notice
Poka theme uses WordPress official translations management system using PO/MO files and if you want to completely translate your site to a different language this is the way to go.
By using the options in Translations settings overrides PO/MO files, if you want to use PO/MO files just leave the buttons fields in translation settings empty.

More information about creating/editing language packs

 

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.

Header fields

Header background image
You can set a different background image for each page with this field.

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.

Terms and conditions text
The Terms & Conditions text for the review. Only appears if the show terms and conditions option is checked at theme options.

 


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.

Affiliate link fields

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 link fields for desktop
These are the main fields for the desktop version but are going to be used also in the mobile if the mobile fields are empty.

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 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)

Affiliate link fields for mobile
If you want to have different affiliate links for the mobile version you can use the fields below:

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

Affiliate onclick for mobile
Execute a JavaScript when affiliate link for mobile is clicked.


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.

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.

 


Pages

Header fields

Header background image
You can set a different background image for each page with this field.


This is the post type for the pages of your site.

Page fields

Full width section
You can create unlimited full width sections in every page and you can set in every section a number of options like background image/text color/margin/padding etc.

Show title of the page
If you want to show h1 title of the page check this checkbox.

Hide banner top / bottom
You can hide banners top / bottom for every page individually.

 

Custom Shortcodes


Notice
The Shortcode list button is available only in Classic Editor. In WordPress v5 and newer, pages and posts (except custom post types) use Gutenberg Editor by default and this icon is not visible anymore. You can enable the Classic Editor by installing the “Classic Editor” Plugin: https://wordpress.org/plugins/classic-editor/

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

 

[table_list num=”” cat=”” sort=”” big_table=”” reviews=”” logo_aff_link=””]
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.
reviews : If you want to display specific reviews you can list them by their ID in this parameter separated by comma. When this parameter is used overrides all the other parameters.
For example: 12,20,22,21
logo_aff_link : If you want the logo to have the affiliate link set this option as true.


[affiliates_list num=”” cat=”” sort=”” columns=”” reviews=””]
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
reviews : If you want to display specific reviews you can list them by their ID in this parameter separated by comma. When this parameter is used overrides all the other parameters.
For example: 12,20,22,21


[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 inside Review post or using the parameter id you can also use it anywhere you want. 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.
id : The ID of the review you want to display.


[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=”” read_more_text=”” descr_excerpt=”” descr_length=””]
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 ID.
descr_excerpt: If you want to use excerpt instead of truncated content you can set this parameter to “true”. Default: “false”
descr_length: The maximum number of words for each description. Default: 15
read_more_text : You can write your own text for the button for all the posts of the category.
ajax_load_more: You can allow users to load more posts with ajax. Default: “false”.


[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 ID.


[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.

 

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.
Display only specific reviews (For example: 12,8,20) : If you want to display specific reviews you can list them in this parameter separated by comma. When this parameter is used overrides all the other parameters.


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.
Display only specific reviews (For example: 12,8,20) : If you want to display specific reviews you can list them in this parameter separated by comma. When this parameter is used overrides all the other parameters.

 

Hooks/API


Filters

poka_breadcrumbs_args
Use this to override the breadcrumbs default arguments array.
You can find this filter in inc/addons/breadcrumbs.php
Example Snippet:

add_filter('poka_breadcrumbs_args','my_override_function');
function my_override_function($defaults) {
  $defaults['separator_icon'] = '|';
  return $defaults;
}

poka_breadcrumbs_filter
You can use this filter to alter the HTML of breadcrumbs or append something after the end of breadcrumbs output.
You can find this filter in inc/addons/breadcrumbs.php
Example Snippet:
add_filter('poka_breadcrumbs_filter','my_override_function');
function my_override_function($html) {
  $html .= '<span>Content After Breadcrumbs</span>';
  return $html;
}

poka_rating_icons_array
You can use this filter to change the icons in rating functionality.
You can find this filter in inc/addons/ratings.php
Example Snippet:
add_filter('poka_rating_icons_array' ,'my_override_function');
function my_override_function($rating_icons) {
  $rating_icons['full_star'] = '<i class="fa fa-star"></i>';
  return $rating_icons;
}

poka_ratings_half_icon
Use this hook to disable the default half star icon used in the theme.
You can find this filter in inc/addons/ratings.php
Example Snippet:
add_filter('poka_ratings_half_icon','__return_false');

poka_static_version
You can use this to override the version of static files used by poka in enqueue styles and scripts.
For example when making changes the following example is useful in order all the static files to get a different version in each page load.
Example Snippet:
add_filter('poka_static_version','my_override_function');
function my_override_function() {
   return time();
}

poka_add_attr_aff_link
You can use this hook to add custom attributes to affiliate link buttons.
Example Snippet:
add_filter('poka_add_attr_aff_link','my_override_function');
function my_override_function() {
  return 'rel="nofollow" ';
}

poka_main_col_class_filter
Use this to override the main content width, based on bootstrap grid.
Example Snippet:
add_filter('poka_main_col_class_filter', 'my_override_function');
function my_override_function() {
  return 'col-md-10';
}

poka_main_col_class_filter
Use this to override the main content width, based on bootstrap grid.
Note: If you do that you should also add a filter to poka_sidebar_col_class_filter in order to prevent the grid from collapsing.
Example Snippet:
add_filter('poka_main_col_class_filter', 'my_override_function');
function my_override_function() {
  return 'col-md-10';
}

poka_sidebar_col_class_filter
Use this to override the sidebar width, based on bootstrap grid.
Note: If you do that you should also add a filter to poka_main_col_class_filter in order to prevent the grid from collapsing.
Example Snippet:
add_filter('poka_sidebar_col_class_filter', 'my_override_function');
function my_override_function(){
  return 'col-md-2';
}

 

Actions

poka_before_main
You can use this to add custom HTML elements at the start of the document. Also you can remove attached elements in this action. (For example the breadcrumbs)
Example Snippet:

add_action('poka_before_main', 'my_override_function' , 3 , 0);
function my_override_function(){
   echo '<<h1>Custom Title</h1>';
}

poka_after_main
Same as above, you can use this to add/remove blocks of code after the page main content.
Example Snippet:
add_action('poka_after_main', 'my_override_function' , 3 , 0);
function my_override_function(){
   echo 'Custom Content';
}

 

Recommended plugins


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