Joomla Casino Extensions

engineachooInternet and Web Development

Dec 4, 2013 (3 years and 11 months ago)

358 views

Joomla Casino Extensions
Add an online casino with more than 90 games to any Joomla CMS website
Example of using the CMS Casino component in Joomla
This online casino product line uses the Joomla CMS (content management system) as a basis for the casino front-end (website).
WinningStreak Ltd. and the CMS Casino project are not related to the
Joomla!
project nor to
Open Source Matters
, the organization behind Joomla CMS.
The WinningStreak products (e. g. CMS Casino) are not published, nor marketed and not supported by the Joomla! Project or Open Source Matters.
All in the CMS Casino project described and published source codes are copyrighted by their respective owners and issued and licensed under the
GPL v2
.
Joomla!
®
is the trademark of Open Source Matters, Inc. in the United States and other countries.
Joomla CMS Casino - Extensions Setup Manual
Release: 2.5.3
Copyright 2009-2012 – WinningStreak Ltd.
Last Edit Date: 2012-08-12
Revision: a
Author: Harald Engels
Creation Date: 2011-12-24
Website:
http://joomla.whitelabelcasino.com
Contact:
info@winningstreak.biz
/ +357 99 347085
Joomla CMS Casino Extensions Setup

1
Table of Contents
Introduction
.........................................................................................................................................................................................................
3
6 Steps to Your Own Joomla Casino
..................................................................................................................................................................................
3
Casino Operator or Affiliate?
............................................................................................................................................................................................
3
Casino2Go Affiliate Plan
..............................................................................................................................................................................................
3
WLC Casino Operator Plan
...........................................................................................................................................................................................
3
Requirements
................................................................................................................................................................................................................
3
Casino Installation
.................................................................................................................................................................................................
4
Free Support
.................................................................................................................................................................................................................
4
Casino Extensions Download
............................................................................................................................................................................................
4
Installation of the Casino Extensions
.................................................................................................................................................................................
4
Joomla Caching (see Global Configuration)
.........................................................................................................................................................................
5
Casino Configuration
..............................................................................................................................................................................................
6
Plug-in Check
................................................................................................................................................................................................................
6
XML Data Settings
......................................................................................................................................................................................................
6
Branding
...................................................................................................................................................................................................................
6
Start of the Casino Component
.........................................................................................................................................................................................
7
Casino Component Configuration
......................................................................................................................................................................................
7
Component Settings
...................................................................................................................................................................................................
8
Basic Settings
........................................................................................................................................................................................................
8
Text Settings
.........................................................................................................................................................................................................
9
Layout Settings
....................................................................................................................................................................................................
10
Saving the Component Configuration
..........................................................................................................................................................................
10
Configuration Examples
.............................................................................................................................................................................................
11
All Features
..........................................................................................................................................................................................................
11
No Preview Text
....................................................................................................................................................................................................
11
No Buttons, No Preview Text
...................................................................................................................................................................................
11
Linked Images (only)
............................................................................................................................................................................................
11
Menu Assignment
.....................................................................................................................................................................................................
11
Opening Games in a Centered Pop-up Window
..............................................................................................................................................................
11
Casino Module
..............................................................................................................................................................................................................
12
Games Module Configuration
......................................................................................................................................................................................
12
Details
................................................................................................................................................................................................................
12
Menu Assignment
.................................................................................................................................................................................................
12
Content Settings
...................................................................................................................................................................................................
13
Layout Settings
...................................................................................................................................................................................................
13
Saving the Settings
...............................................................................................................................................................................................
13
Flexible Module Usage
...............................................................................................................................................................................................
14
Plug-in Configuration
.....................................................................................................................................................................................................
15
Plug-in System - CMS Casino
.....................................................................................................................................................................................
15
Affiliate ID
...........................................................................................................................................................................................................
15
Profile ID
.............................................................................................................................................................................................................
15
XML Data Feed
.....................................................................................................................................................................................................
15
XML Data Cache
...................................................................................................................................................................................................
15
Local XML File Usage
.............................................................................................................................................................................................
15
Plug-In Content - Casino ID
.......................................................................................................................................................................................
16
Plug-in System - Universal Joomla Template
.................................................................................................................................................................
16
Centered Pop-up Windows Without Casino Template
..................................................................................................................................................
16
Extension Updates
........................................................................................................................................................................................................
17
Safe Overwriting
......................................................................................................................................................................................................
17
Template Installation
................................................................................................................................................................................................
17
Extension Removal
.......................................................................................................................................................................................................
17
Life-time Affiliate Commissions
...................................................................................................................................................................................
17
Embedding Alternatives (Custom HTML Modules)
..............................................................................................................................................................
17
Embedding of HTML Code (via IFRAME)
.......................................................................................................................................................................
18
Embedding of Generic Code (via PHP)
.........................................................................................................................................................................
18
Requirements
.......................................................................................................................................................................................................
18
Gaming Interface
.................................................................................................................................................................................................
19
Gaming Interface Links
.................................................................................................................................................................................................
19
Game Portfolio
.............................................................................................................................................................................................................
19
Gaming Interface Branding
............................................................................................................................................................................................
19
Affiliate Back-end
................................................................................................................................................................................................
20
Affiliate Account
...........................................................................................................................................................................................................
20
Website Profiles
............................................................................................................................................................................................................
20
Marketing Materials
.......................................................................................................................................................................................................
21
Casino Templates
.................................................................................................................................................................................................
22
Template Structure
.......................................................................................................................................................................................................
22
Template Elements
...................................................................................................................................................................................................
22
Template CSS
..........................................................................................................................................................................................................
22
Installing Templates
......................................................................................................................................................................................................
22
Template Configuration
..................................................................................................................................................................................................
22
Templates For Joomla 3.0
..............................................................................................................................................................................................
23
Appendix
............................................................................................................................................................................................................
24
Creating Game Portfolio Previews
....................................................................................................................................................................................
24
Building a Joomla Casino from Scratch
.............................................................................................................................................................................
24
Restrictions
.................................................................................................................................................................................................................
24
Countries
................................................................................................................................................................................................................
24
Payment Methods
.....................................................................................................................................................................................................
24
Error List
.....................................................................................................................................................................................................................
25
Customer Service
.........................................................................................................................................................................................................
25
About WinningStreak
...........................................................................................................................................................................................
26
Contact
.......................................................................................................................................................................................................................
26
Credits
........................................................................................................................................................................................................................
26
Joomla CMS Casino Extensions Setup

2
Introduction
This document describes for Joomla web-masters, casino affiliates and casino service providers the installation and configuration of the
Joomla CMS Casino extensions and related templates. With the Joomla based CMS Casino you can install an online casino package with
more than
80 professional casino games
into nearly any existing Joomla 2.5 website (min. required version is 2.5.4).
The installation and configuration of the extension package requires less than 1 hour of your time, what makes the Joomla CMS Casino
your highway to run an own, custom branded online casino. If you are looking for casino games which can be embedded into any website
(not only into Joomla CMS based sites) please take a look here
http://whitelabelcasino.com/index.php/casino-products/widget-generator

and visit the demo website:
http:/gameserver.us.com
.
6 Steps to Your Own Joomla Casino
For having a fully operational Casino for Joomla you need to proceed through the following tasks:
1.
Download the Joomla CMS Casino package (pkg_cmscasino-2.5.1.zip or newer)
2.
Install the CMS Casino package (
PHP 5.3
and
Apache
on Linux/Unix/OS X required, Windows server support was not tested)
3.
Register an affiliate account

(cost-free) or
apply for a White Label Casino casino operator account
(requires a setup fee)
4.
Configure, customize and activate the CMS Casino extensions and gaming interface (
following this manual is imperative
)
5.
Add the CMS Casino component to a menu and if desired configure and activate the CMS Casino module
6.
Start your casino promotion and earn money. Please keep in mind that a well working website can generate a 5-digit revenue
number per month. That means, you can make a comfortable living by making your casino operating and converting well.
Casino Operator or Affiliate?
WinningStreak is offering
two partner plans
for using the Joomla CMS Casino to convert your gambling traffic into cash:
Casino2Go Affiliate Plan
This plan allows you to use the CMS Casino extensions on your Joomla website by simply
signing-up for an affiliate account
. Becoming an
affiliate is
free of charge
and requires not to sign a written agreement. We deliver to CMS Casino affiliates a games data feed with brand-
neutral games (no logo on the game tables) and a brandable gaming interface (your logo can be placed there). The URL from where the
games are served is
http://games.casinoserver.net
. You will access your affiliate account via
http://affiliate.casinoserver.net
. Casino2Go
affiliates are usually not entitled to register sub-affiliates. For more details please
click here
.
Premium and WLC Casino Operator Plan
Premium and White Label Casino (WLC) operators can deliver game-play from a custom domain name (e. g.
http://yourcasino.com
) and
get access to the casino management back-end which allows the creation of a customized casino game portfolio, a customized banner
farm and to operate an own affiliate network. This plan requires to pay a small setup fee and to sign a written casino operator agreement.
Requirements
All embeddable casino games are coming with a free-play mode and the source code of the extensions is open source (GNU/GPL v2).
Keep in mind that CMS Casino is representing a
commercial Joomla project
which doesn't provide free game-play on a broad scale.
Therefore the
most important requirement
for running these extensions is
your access to a sufficient volume of gambling traffic
.

If you can't manage to get a sufficient amount of targeted gambling traffic please do
NOT
proceed
.
1
For earning with the casino games an affiliate commission of up to 45 % of the casino profit you need to
register an affiliate account
or
apply for becoming an online casino operator. Please follow this link for
posting your casino operator request
.
As an affiliate or casino operator you get access to a XML games data feed. Usually you receive the games feed URL with the confirmation

of your affiliate or casino operator account. This feed is required to fill the CMS Casino extension with "life". Joomla casino affiliates can
use the preset data feed (defined in the CMS Casino system plug-in).
Here the technical requirements beside the general requirements which are needed to run Joomla:
1.
The Joomla CMS Casino package requires a functional Joomla version 2.5.4 installation (or newer)
.
Older Joomla versions (< 2.5.4) are
not
supported in a generic way but there exists a HTML based casino games widget
workaround for all older Joomla versions (see page
18
) or take a look here:

http://whitelabelcasino.com/index.php/casino-products/widget-generator
and
http://gameserver.us.com
2.
PHP version 5.3 or newer
Older version than PHP 5.3 are not supported and will cause errors.
3.
CURL required
Your hosting must support CURL if a casino template is used. For having CURL properly working the in PHP 5.3 deprecated "safe
mode" must be switched off.
4.
Apache required
The extensions have been tested with Apache 2.x only.
5.
X-based server OS
The extensions should work on all servers with a UNIX like operating system, so e. g. on servers with Linux, Mac OS X, BSD,
Solaris. Microsoft Windows servers weren't tested and are NOT recommended - especially not in combination with IIS.
1
An absolute minimum amount of traffic are 100 gambl ing oriented unique visitors per day.
Joomla CMS Casino Extensions Setup

3
Casino Installation
The downloaded package installs the
CMS Casino extensions
into an
existing
Joomla CMS based website.
If a
new
stand-alone casino is required then download and install the
Casino2Go package
which will have you up and running with a
complete online casino website within a couple of minutes:
http://documentation.whitelabelcasino.com/casino2go_joomla_manual.pdf

In the case that a CMS based version doesn't resonate well with you take a look to the
plain HTML/PHP version
of Casino2Go (no CMS).
Free Support
Please use for support requests the Joomla section in the
White Label Casino forum
. Using the forum has a great value for all Joomla
Casino users.
PLEASE DO NOT POST SUPPORT REQUESTS OR BUG REPORTS IN THE JOOMLA EXTENSIONS DIRECTORY!
I will sort out all issues to ensure that you will get your casino up and running.
In urgent cases contact me via Skype: haraldengels or email: info[at]winningstreak.biz.
Casino Extensions Download
If you decided to use the Casino2Go package please start to read the
Casino2Go Joomla manual
about the
download
and installation of
this convenient instant casino setup package.
If you want to use install the casino extensions into an already existing website you need first to
download
the CMS Casino package
"
pkg_cmscasino_2.5.x.zip
". This package contains all casino extensions which are required to install the casino game previews with direct
links to the gaming interface. The download requires an user registration on the website. For the installation of the downloaded package
file you need to start the Joomla Administration back-end (see the screen-shot below).
Installation of the Casino Extensions
The by WinningStreak developed casino extensions need to be installed into an already existing, functional Joomla CMS installation.
The installation of extensions takes place in the Joomla Extension Manager.
Since all other Joomla CMS versions are reaching their end of life-time until April 2012 the CMS Casino extensions
are supporting only Joomla version 2.5 which allows an easy updating of extensions during the CMS life-time.
In the Extension Manager use the option "Install" with selecting the downloaded package file "pkg_cmscasino.zip"
2
:
2
The file name may vary sli ghtly depending on the release number.
Joomla CMS Casino Extensions Setup

4
Use the Extension Manager for installing
the casino extensions into your Joomla
website.
Use the button "Choose File" for opening a file explorer window and
select the downloaded casino package file.
Clicking to the button "Upload & Install" starts the installation
process with the selected casino package file.
For the optional installation of a casino
template please use also the Extension
Manager. The provided templates
represent a perfect basis for the
presentation of the casino games.
If no error occurs a success message appears:
The installation process has now installed at least the following Joomla extensions and data files:

the CMS Casino component "com_cmscasino" (requires
configuration
)

the CMS Casino system plug-in "plg_cmscasino" (requires
configuration
)

the CMS Casino library "lib_cmscasino"

the CMS Casino module "mod_cmscasino" (requires
configuration
)

the CMS Casino content plug-in "plg_casinoid" (may require
configuration
in some special cases)

the Universal Joomla Template (UJT) system plug-in "plg_ujtpl" (a casino template needs to get installed separately, so far
desired/required, but the UJT plug-in is always required as a bridge to any chosen template)

the Universal Joomla Template library "lib_ujtpl" (the UJT library is always required by the casino extensions, even in cases where
no WinningStreak casino template is installed.)

sample games data (needs to be replaced later on with your own game portfolio data, see folder
/media/com_cmscasino
)
WinningStreak casino templates need to get installed separately. It is highly recommended to use the CMS Casino extensions in
combination with such an optimized casino template.
The next setup step is the configuration of the installed casino extensions (see page
6
).
Joomla Caching (see Global Configuration)
You need to disable the Joomla caching (so far active) for running the Joomla CMS Casino extensions. Using the Joomla
caching interferes with the dynamic substitution of variables (e. g. casino name, affiliate ID, profile ID).
Joomla CMS Casino Extensions Setup

5
If an error message occurs in this area please check first the permission settings on your server. Most
installation issues of Joomla extensions are caused by insufficient permissions to create files and folders
on the webserver. If you or your webmaster can't resolve the problem, please check the
forum
or contact
the
help-desk
.
Casino Configuration
Plug-in Check
The "CMS Casino" system plug-ins "
System - CMS Casino
", "
System - Universal Joomla Template
" and "
Content - Casino ID
" are playing a

central role in delivering game data and basic settings to the other casino extensions and to an additionally installed casino template
(installing a casino templates is optional). After the initial CMS Casino package installation these plug-ins should be enabled.
Without enabled plug-ins system errors (data access errors) will occur and the casino extension won't be operational.
The following configuration tasks are
mandatory
:
1.
Although the installation process should have enabled the plug-ins automatically please check the plug-in status
2.
Add your affiliate ID into the system plug-in "CMS-Casino"
3.
Add also your profile ID into the plug-in (for displaying your logo and casino name in the games)
4.
Define the casino name
The configuration of the plug-ins takes place in the Plug-in Manager:
-
For configuring a plug-in select the plug-in from the plug-in list (use the check-box on the left side of the table) and click then to the
"Edit" button in the Administrator tool-bar.
If these plug-ins are not enabled error messages will appear and the casino component and casino modules won't work.
The first step is to check if both plug-ins are enabled. Usually these aren't listed closely together (how it is displayed in the screen-shot
above). You need to locate those in the plug-in list. Open the CMS Casino plug-in for editing the settings which need to get adjusted:
For earning money with your new casino you need to configure at least the affiliate ID:
It is also recommended to define a casino
name which gets always displayed inside the
casino extensions when a casino name needs to get used.
After saving these settings the plug-in is functional and ready to deliver the games XML data to the casino component and casino
modules. A detailed description of the plug-in configuration can be found in the chapter "Plug-in Configuration" on page
15
.
The "Universal Joomla Template" plug-in doesn't require a configuration at the moment.
XML Data Settings
Some XML data settings should also be checked. Please make sure that the "Data file fallback" setting" is set to "On".
Branding
The branding of the gaming interface with your casino logo and your casino name takes place in the
affiliate back-end
software (see
My account > Website profiles
). You get access to the affiliate back-end and branding features if you have
registered an affiliate account
.
Without an affiliate account you can't benefit from our generous affiliate commission offer of up to 45 % of the casino profit.
Joomla CMS Casino Extensions Setup

6
For managing plug-ins Joomla comes with a so called Plug-in Manager. Plug-ins play
an important role in the architecture of Joomla and also in the CMS Casino. After the
installation the plug-ins need to be configured (affiliate ID) and enabled.
The CMS Casino component and module are not operational so long the plug-ins are
not enabled. Running the component or module without enabling the plug-ins will
cause an error-message.
After the installation the plug-ins
should be enabled already. If not,
please don't forget to enable those.
If not already enabled, changing the plug-in status
from "Disbled" to "Enabled" activates the plug-in.
Please enter here the affiliate ID which is displayed in your affiliate
account after you have signed-up for an affiliate account at:
http://affiliate.casinoserver.net/affiliates/sign-up
Adding your casino name is optional (recommended). This name
will get used then within your Joomla website as a variable.
The "Data file fallback" must be set to "On". If set to "Off" a local copy of the XML
data is used. The local XML data copy represents mainly a fall-back which gets
used if there is a problem to iniate a connection with the games data server. Local
XML data copies won't get updated with changes in the featured and new games.
The profile ID (PID) is required for the on-the-fly customization of
the gaming interface with your casino log and casino name.
The platform ID data need to be created in your affiliate account
(see affiliate back-end software).
Start of the Casino Component
After the installation the Joomla CMS Casino component should already be functional without any further configuration.
For testing the component please enter the following string in the browser address-bar:
http://yourjoomlawebsite.tld/index.php

?

option=com_cmscasino

This URL should display some game preview boxes (content and number may vary):
If an error message occurs please read the instructions of the chapter "Error List" on page
24
. Visiting the white label casino forum is the
next step to get support. Placing a ticket in the help-desk sends a message to the author of these extensions.
The component output can get configured with a broad range of options to ensure that the content fits into the style and appearance of
the host website (template). You can also download and install casino templates from the White Label Casino website.
Casino Component Configuration
The Joomla Casino component is displayed in the Joomla article content area and allows white label casino clients (casino operators) and
Joomla CMS Casino affiliates to display a selection of manually selected games in form of a casino games gallery. Components can be
linked to a menu entry and can be seen as a webpage by their own. Modules allow a more flexible way of content presentation but are
usually not linked to menu entries. The advantage of using the casino component is the ease of setup and the broad range of
configuration options. The installation and configuration of the CMS Casino requires only a few minutes and frees the casino website
developer from time-consuming layout and manual
link building tasks
.
The screen-shot above is an excerpt of an example page which was created the CMS Casino extensions
Joomla CMS Casino Extensions Setup

7
The casino component consists of three main
elements: an optional introduction text, a game
previews area, and an optional outro text (a
closing text). Components are usually bound to
get displayed in the main content area (article
area). Modules are more flexible to use and can
displayed in all module positions.
The game previews area can be configured in a
flexible manner. The size and the number of
games in a row are configurable. The games in
the content area are always "hand-picked" where
the module allow an automatic selection and
presentation of games (e. g. of new or featured
games).
The casino modules can be installed in any
suitable module position of the used template.
The standard casino template layout of the
optional to install template is coming with more
than 10 module positions which can host a
casino module.
The CMS Casino component displays casino
game preview boxes which are containing 4
main elements:
- the game title (name)
- a preview image (which is linked to the game
- a game description (truncated)
- two link buttons
Clicking to the preview image or to the "Play
for Fun" button opens the selected game in the
gaming interface which opens in a separate
browser window.
The "Play for Real" button sends visitors to the
account sign-up window.
Component Settings
All by WinningStreak provided White Label Casino and Casino2Go packages contain already the pre-installed casino component which is
configured after installation with the component presets. These presets can be changed for further customization purposes.
The presets can be accessed by opening the component in the website administration back-end:
Basic Settings
The CMS Casino component settings are completing the CMS

Casino plug-in settings. The plug-in contains basic settings

which are also relevant for the CMS Casino module(s).
The component identity settings are quick & easy to define:

Component title
This is the headline which is displayed on top of the

component content area.

Enable title
Allows to enable/disable the component title.
This component displays a by game ID hand-picked selection of casino games. The game data with all for the component display required
elements (game preview images, game description texts etc.) can be stored locally in form of a XML file (not recommended) or gets
loaded in real-time (data feed) from the casino server (recommended). The CMS Casino component and games module are using the
data source settings of the CMS Casino plug-in. In some special cases it may be helpful to edit a locally stored game XML file for
"manipulating" the component and/or module output.
The following data setting defines which games from the portfolio are displayed:
3

Game ID's
Each casino game has an unique ID which identifies it through the whole casino platform. The component display is controled by
the number of games which are listed by their ID in this field (each separated by a comma). A reasonable setup is an amount
between 6 and 12 games. The ID's can be found in the browser address bar of the gaming interface or in the XML file or feed.
Storing the XML data

locally

With your registration as a casino operator or casino affiliate you received next to your (master) affiliate ID the URL for accessing the XML

game data feed. Simply request the feed in a browser (Firefox, Safari or Chrome) and save the loaded content as "games.xml" to your
casino website (usually the folder media/com_cmscasino need to be used). If the locally stored file won't get edited (content changes) it
should be updated regularly to reflect changes which were made in the casino's portfolio (e. g. when new games were added to the game
portfolio).
Example of the XML game data feed (displayed in a browser)
One typical usage of the XML data can be found in the CMS Casino module. All games which are defined in the portfolio e. g. as "new"
(see XML tag "new_release") or featured (see XML tag "featured") can get displayed automatically by the module.
3
White Label Casino operators get access to the casino management back-end where they can define their own games portfol io and edit the preview i mages and preview texts.
Joomla CMS Casino Extensions Setup

8
The menu "Components" should contain the entry "CMS
Casino". The component settings can be reached by clicking
to the Options icon in the toolbar of the component:
The CMS Casino component toolbar contains the icon for
accessing the settings (Options). After clicking to it a modal
pop-up window opens (see excerpt below). This window has
three tabs with component settings.
The gaming interface, all components, all modules and all
similar tools are based on the game data which are
originally delivered from the game servers.
The XML feed contains all game portfolio information of a
the casino platform which generates the data feed. We
can see what is the casino domain and ...
... what is the casino name and ...
... we can access all game data (game name, game ID,
game categories, texts, images etc. ...
... and we "know" if a game is new or featured.
Text Settings
The text settings of the component define how text is displayed, e. g. the game preview texts:

Enable intro text
Components are displayed in the article area instead of an article. That has the consequence that no conventional article text can
get displayed. That is the reason why some users

may prefer the casino game module for displaying the

game previews. The game module can be positioned

in a flexible manner above or below an article text

(depending on the in the template available module

positions). As a simple alternative the casino

component allows to define an intro text above the

games (see screen-shot). To ensure that the text-
content can get displayed in several languages the

intro (and the outro) text have to be defined in the

language files of this component.
4

Game description
The game preview boxes can be displayed with or

without a game description text (promo text). The

game description text can be displayed in full or get

shortened (see next setting).

Description length
This field defines after how many characters the

game promo text gets truncated. The result may vary

by a few characters since this feature truncates

always after a full word only.

Description height
If the "CSS Overwriting" is active this field defines the height of the text paragraph. A consistent height of the text paragraph
ensures that the buttons below the text get equalized (don't "jump" up and down depending on the amount of displayed text-lines
in the text paragraph). The height setting can get (ab)used to define the vertical position (the amount of white-space) of the
game-play buttons below the text paragraph. For details about the CSS overwriting please proceed to the next page.

Description font size
If the "CSS Overwriting" is active the component settings will overwrite the CSS file values for the text font size of the game
preview descriptions.

Add play for fun link
The game preview image is linked to the displayed game. Additional to this link buttons with a link can be added. This setting
displays a link to the game (identical to the link of the preview image). The CSS file which controls the appearance of the game
box elements (and links) can be found in the folder: media/com_cmscasino/css

Add play for real link
This link setting allows to route a website visitor to the sign-up screen. The sign-up is required for using the extended fun-play and

for real money play modes of the games.

Enable outro text
This setting allows to display a closing text below the game boxes. Otherwise the explanations of the Intro text can get applied
here too.
Truncating Game Preview Texts
If texts get truncated it is important to test the result in different browsers. The text-flow may vary from browser to browser (yeah, we
are loving old Internet Explorer versions for that) and cause unpleasant results. It is recommended to truncate texts to a length which
breaks the text display in the horizontal middle of the text block. Then the different text-rendering of browsers won't have a negative
impact to the layout.
Adjusting Text Paragraph Height
Defining a fixed paragraph height is also helpful to avoid unpleasant results. If a text is shorter and won't fill-out the same amount of lines

than in other game boxes we avoid that way that the buttons or links "jump" upwards.
Game-play buttons
Due to restrictions in the usage of the HTML element BUTTON the
4
The language files are stored in this CMS folder: language/. In this language folder are language specific sub-folders, e. g. "en-GB" for English. Inside these sub-folders you can find the casino language
file, e. g. en-GB.com_cmscasino.ini for Engl ish. In this file are the text string identifiers: COM_CMSCASINO_INTRO and COM_CMSCASINO_OUTRO. Si mply replace the texts inside the quotes for getting

a customized component output.
Joomla CMS Casino Extensions Setup

9
The text settings provide several customization
features which allow casino clients to "tweak" the
component output according to their individual
website layout/design requirements. A typical
example for this is how the game description texts
are displayed.
For displaying games in an attractive form many
users may prefer to shorten the game descriptions.
The game box example demonstrates a truncated
text and the selection of the Play links as buttons
(instead of text links).
The casino component allows to display an intro
text above and an outro (closing) text below the
game boxes. For allowing a multi-lingual usage of
the component the intro and outro texts are
stored in the CMS language files.
this is a truncated game
description
Layout Settings
The component layout settings allow a quick setup of basic layout parameters. All CSS related component settings are overwriting the
values of the component's CSS file. Users who dislike this preset behavior can disable it and manage the layout solely in the CSS file.

Games per row
This setting is important to ensure that the last floated game box has no right side
margin which would destroy the game boxes layout. In combination with the "Games

container width", the "Game box width" and the "Game box gutter" settings the
game boxes can be positioned in a symmetric and expletive (all space consuming)
way within all common website formats.

Game name tag
Defines the HTML tag for the game name headline. If left empty no headline is
displayed.

CSS overwriting
The CSS settings of these component options are realized in form of inline styles.
That allows a quick setup of the basic layout parameters within the component
settings. If the CSS overwriting is disabled the values in the casino CSS file are used
instead of the component settings.
The CMS Casino CSS file is located here:
media/com_cmscasino/css/casino.css
The CSS file folder contains several CSS files which are defining a slightly different
appearance of the component and module. These files are the perfect basis for
further customizations and should get tried out first
.
The CSS file hosts also the styles for all CMS Casino modules. Many styles are shared

between the casino component and module. Overwriting the CSS file settings is
offering the easiest way to apply different settings to the component and module.
If a module gets copied for displaying new and featured games at the same time (with the same module) you need to copy the
module in the Module Manager and define the module content settings according to your preferences. Depending on the content
the CSS ID of the boxes container is changing what allows by using CSS child selectors to develop a finely granulated CSS based
module design.

Games container width
The container with the class "gameBoxes" is the parent container for all game preview boxes. The casino component enforces with
the setting "Games per row" that the game boxes are displayed in several rows. But some ancient browsers (e. g. IE 7) are
creating a rendering error of the boxes. The easiest cure is to define a fixed width for the parent container which comes close to
the width consumptions of the desired number of game boxes in a row. So if we have as an example 3 boxes with 240 px width
and a gutter of 30px we have a width consumption of 780px. Setting now the parent container to 780px (or a few pixels more)
solves the float problem of outdated browsers. If you take a look to the "casino.css" file you will discover an alternative approach
how this browser specific problem can get handled.

Game box width
Each by its ID selected and displayed casino game is placed into its own DIV container (with the class .gameBox). For allowing an
universal usage all game boxes are floated (float: left;). The game box containers need to be formatted with a width to ensure that

the games are positioned in a well formatted order. Since we can define the gutter between the boxes separately the game box
width should reflect the real content box width (and not chosen bigger to create a padding etc.).
If the game images have a border the box width should get calculated this way:
box width = game image width + (2 * image border width)
The border width needs to get defined in the CSS file.

Game box height
This setting overwrites the CSS file height setting of the class .gameBox.
Keep in mind that changes in the text settings influence the content height.

Game box gutter
The floating boxes allow a flexible positioning of the game boxes. This setting defines the right side gutter of a box. Technically
seen this is a margin. To avoid that the last game box in a row gets also applied the right side margin we need to define the
number of games in a row (see above). The typical gutter value would be a value in pixels (e. g. "10px").

Image width downsizing
In the game portfolio setup for each game a preview image is defined. This image will be used in a scaled down size as the game
preview image. The downsizing is performed via CSS what allows a pixel precise scaling. When the image width is defined and the
image shall fit into the game box it is important to consider also the width of image borders. If we have a game box with a width of

e. g. 220px and a border width of 1px then we have to set the image width to 218px.

Image height downsizing
The height setting CSS is not depending on the width. That means the original image ratio is not preserved if only one dimension
gets changed. For a correct scaling the original ratio should be reflected somehow (a +/- 5% aberration doesn't matter).

Source image width
A typical source image has a file size around 200 kilobyte (and a width of approximatly 900 pixels). The downsizing via CSS can't
reduce the file size of the source image. Each HTTP request for loading an image has to download this file size even if we display e.

g. only 180 x 150 pixels. To avoid this "overkill" we can shrink the image already on the server side to a handy download size.
Requested images are resized on-the-fly and then cached for saving server resources. For keeping the amount of cached files in a
reasonable range we are offering a limited range of dimensions (seen screen-shot). The fine-tuning is then applied with the CSS
based settings (see above). The presets in this field may vary.
Saving the Component Configuration
For making the component operational it is
mandatory
that the options are saved, even if no changes are applied. Otherwise several
settings might not be available in the system what will cause content display errors.
Joomla CMS Casino Extensions Setup

10
Saving the component settings after the installation is important to
ensure a correct function of the component, also in cases where no
changes in the configurations were applied.
If the options weren't saved at least once the component is inoperable.
Configuration Examples
The following component screen-shots are demonstrating some typical scenarios:
All Features
No Preview Text
No Buttons, No Preview Text
Linked Images (only)
The CMS Casino module is supporting identical settings.
Menu Assignment
The component needs to get assigned to a menu. The following link leads to an article which describes the menu features:
http://docs.joomla.org/Help17:Menus_Menu_Manager
For starting the component via the browser address bar please use this pattern:
.../index.php?option=com_cmscasino
Opening Games in a Centered Pop-up Window
The game links are opening games by preset in a new tab. If you are using a WinningStreak casino template (e. g. "Las Vegas") then you
can activate in the template settings a feature for centered pop-up windows. If you are using another template (not UJT based) then you
need to load a script file for this. For details see page
16
.
Pop-up windows have the advantage that they can get resized (even to a full screen) and moved on the desktop. The popular fancy modal

pop-up windows are usually lacking such features which are decisive for a good gaming experience.
Joomla CMS Casino Extensions Setup

11
This is the full-featured game box display. This setting is
good for portal sites.
The preview texts can get truncated and fully disabled.
For a kiosk style website that may be a better option.
Next to the preview text we can remove also the buttons.
Since the images are linked to the games this is a doable
option.
Finally we can display "naked" geme preview images only.
Casino Module
One strength of the Joomla Casino CMS is the extensibility with extensions, e. g. so called modules. Modules are building blocks which can

be placed in a module position where the component displays the content in the article area but usually not in the main content area.
Modules are configured in the Module Manager:
The Module Manager displays all available modules in form of a list. The CMS Casino comes with a multi-purpose module which allows the
automated display of games based on data in the XML feed/file. After the installation the Games module is still disabled and is not
assigned to a module position:
5
Games Module Configuration
The CMS Casino Games module can deliver two different kind of game selections:

New casino games (based on the XML file settings and data)

Featured casino games (based on the XML file settings and data)
Additional functions will be part of the next module update. For using both game selections parallel the module must be copied in the
Module Manager and configured each according to the intended selection.
The module settings are split into four parts:

Details

Menu Assignment

Content Settings

Layout Settings
Details
The Details settings are identical for all Joomla

modules and cover the general availability. The most

relevant settings are shown on the right side.
Menu Assignment
Modules can be displayed with a variety of settings. If

"no pages" is selected the module won't get displayed.
5
The avail able module positions depend on the structure of the used website template. Detai ls about the CMS Casino templates can be found in the Universal Joomla Templ ate Manual.
Joomla CMS Casino Extensions Setup

12
Use the Module Manager for the setup
and configuration of modules.
The Games module needs to
get assigned to a module
position. After the installation
no position is assigned.
The Games module needs to be enabled.
The module gets displayed only
if it is assigned to pages.
The module position is the most
important Details setting. It defines
where on the web-page the games
module gets displayed.
The module title needs to get
changed only if several
instances (module copies) are
used.
The module page assignment allows to display a
module on all pages or selected pages.
A note is helpful to specify the
module purpose (mainly for the
list display).
Content Settings
These module specific settings define the module content presentation:

Content type
Switches between in the Casino Manager (game portfolio settings) as "new"

or "featured" defined games or uses a game category number based

filtering. Additionally a random games selection (gets created every 5

minutes on basis of all games) is offered. If several content selection types

need to be displayed on a website the module must be copied. Then each

copy of the module gets used with an alternative setting.

Game category ID
If the content type "Category" was chosen a category ID needs to be

provided.

Number of games
Defines the number of displayed game preview boxes.

Game name on/off
Disables the game title (game name) display.

Game name tag
The game name HTML tag can be defined here. Recommended are the

HTML headline tags "h3" or "h4".

Game description
Three options can be used. If the setting "Preview" got chosen the length of the text preview can be configured (see next option).
The setting "Full" is perfect for game overview pages and "None" for the usage in smaller or decorative modules.

Text preview length
Defines the text preview length in characters. The finally resulting text length varies a little bit since this function doesn't truncate
words.

Add play for fun link
The game preview image is linked to the casino game in the gaming interface. Since this linking is not obvious additional game
play links provide more transparency and control.

Add play for real link
This link sends a visitor to the sign-up screen in the gaming interface.
Layout Settings
Similar to the casino component the module allows a partial CSS overwriting and

that way a direct layout customization of important game box parameters. This

comes in handy especially during the website development phase. The CSS

overwriting can get disabled and all CSS settings be applied in the file

"casino.css" (see folder media/com_cmscasino/css/). Developers who dislike

having inline CSS in the HTML code will prefer that way. From the functional

perspective both methods are working flawless.

CSS overwriting
Enables CSS overwriting with the below defined settings. Using "Off"

requires to define all layout settings in the CSS file (which comes with

some fall-back values and related file comments).

Games per row
The games are floated from the left to the right. Floating allows a flexible

usage of the module in many module positions. But if a box gutter is

used (see below) each game box gets a right-side margin. If this margin

would be applied also to the last game in a row layout problems may

occur. Defining the numbers of games in a row ensures that a defined

gutter won't get applied to the last game in a row.

Enforce new rows
The "Games per row" setting influences only how the gutter is handled.

All games still float in a sequential manner so that if there is more space

in the parent container than the defines games per row more games will

be displayed. That could be managed by defining the CSS width of the parent container or by defining an individual right margin
for the game boxes but it is easier to use this setting to enforce a "line-break" after the given number of games in a row. This
setting is module specific. The component enforces always a line-break.

Game box width
The game box width needs to defined in a way that the preview image width PLUS eventually applied borders will fit into the game
box. So if the image width is 200px and the images have a border of 1px the box width must be at least 202px.

Game box height
The game box height needs to be sized tall enough so that all elements inside the game box are displayed. Adding some more
pixels is an easy way to control the vertical box spacing.

Game box gutter
The game box gutter defines the horizontal space between the game preview boxes.

Image width downsizing
Defines the displayed image width via CSS.

Image height downsizing
Defines the displayed image height via CSS.

Source image width
Defines the physical size of the preview image. The chosen value must be higher than the above defined CSS width to avoid image
quality problems.

Description height
Defines the height of the description text paragraph.

Description font size
Defines the description text font size.
Saving the Settings
Saving the module settings stores the settings in the database. A page refresh should make the module now visible. If the module is not
visible please check first these settings:
Joomla CMS Casino Extensions Setup

13

The XML data source settings in the CMS Casino plug-in (if an XML data error is displayed)

If new or featured games are defined in the XML data feed (defined in the Casino Manager)

If the module is published

If the module is assigned to pages
Flexible Module Usage
The object oriented nature of Joomla allows an easy copying of modules and to apply to each copy different settings. That way we can
easily use the content type filtering "Category" for creating game preview modules which are then displaying only the games of one
category.
The example below was set to display 20 games from the game category ID 9 (card games):
Since we can assign in Joomla modules page specific different category selections can get used (in form of copied modules) on different
web-pages (e. g. in a module position below or above the normal page content).
Joomla CMS Casino Extensions Setup

14
Plug-in Configuration
The with the CMS Casino package installed plug-ins usually don't require a change of the configuration for making the CMS Casino
functional. But some settings are essential to ensure that Joomla CMS Casino affiliates can earn money with their casino promotion.
Most important is the change of the affiliate ID with your unique affiliate ID
which was provided within your affiliate sign-up
confirmation email. Most other settings shouldn't get changed if there is not an urgent requirement to do so.
The plug-in configuration takes place in the Plug-in Manager. Most important is the setup of the CMS Casino system plug-in. The settings
in this plug-in are used by the casino component and also by the casino module.
Plug-in System - CMS Casino
After opening this plug-in within the Plug-in manager the CMS Casino specific plug-in settings can be found in the right column:
Affiliate ID
It is
imperative
for affiliates to use their unique affiliate
ID for earning money with the CMS Casino. Only using the correct ID
ensures that game-play from your players can get tracked correctly and you get paid for your successful referrals. Affiliates receive their
ID with the affiliate account confirmation email after sign-up. Follow
this link
to sign-up as a Joomla CMS Casino master-affiliate.
Profile ID
Casino operators have access to fully branded casino games on a custom defined domain. Joomla Casino affiliates are using always the
games from the neutral domain
http://games.casinoserver.com
. These games are not custom-branded. In order to provide affiliates a
generic branding of the games the gaming interface is interpreting a so called profile Id (PID). If a website profile was created and the
gaming interface is called with the PID an "on-the-fly" customization takes place. Based on the logo and casino name settings of the
affiliate account the games appear then custom-branded. For further customization request please contact your affiliate manager.
XML Data Feed
Casino operators need to change the "Game data feed" URL with the URL string which was provided within their casino operator account
confirmation email. This task doesn't apply to Joomla CMS Casino affiliates. They can leave the "Data settings" just unchanged.
XML Data Cache
Requesting the XML feed for every page delivery is time and bandwidth consuming. The local caching of the XML games data ensures an
optimum of performance and reduces the bandwidth consumption significantly. The preset value of 1 day cache-lifetime is a reasonable
value which shouldn't get changed without a compelling reason.
In cases where the cache needs to get overwritten (e. g. when changes in the XML stream won't get displayed) with the current feed data

it should be sufficient to set the value to "0" (zero) and the refresh the page with the CMC Casino component in a browser. After that the
original value should be restored. Alternatively delete the file "gcache.xml" in the folder /media/com_cmscasino.
Local XML File Usage
If a local XML data file exists (what is usually a locally stored copy of the real-time XML feed) and the "Date file fallback" setting is set to
"Off" then the locally stored XML data file has priority over the XML live feed
. If it is set to "On" this file acts only as a fall-back if the live
feed or the cache file can't get accessed.
This feature can also be used to work with manually modified (edited) and locally stored games XML data. If the local file exists and the
setting is "Off" then the local file has always priority over the XML stream and also over the XML cache file.
Joomla CMS Casino Extensions Setup

15
Fill-in the affiliate ID which was provided in the affiliate
account confirmation email. This is mandatory!
Define a casino name. This name is used as a variable
within the CMS Casino for content and messages.
This is the path to the locally stored copy of the
games XML data which is part of the package.
Change this setting to "On" if the local copy of the
XML data shall act only as a fall-back if the XML data
feed is temporarily not available.
The by a casino supported languages have to be
defined in form of ISO 639-1 2-digit codes (e.g. "de").
The first language value in the field defines the preset
language. If no languages are defined the value "en" is
chosen. Please read the manual section "Languages".
Select a CSS file for styling the component and
module. The preset casino.css is quiet generic only.
This is the path to the XML feed cache file.
The value in this field defines the XML data cache life-
time. The preset is 1 day (86400 seconds).
Defines the website profile ID for the game branding.
Preset bonus code setting. Bonus code information
should be provided via inbound links (already
contained in links which used to send traffic to the
website).
Only Casino operators need to update this field with
the games data XML feed URL which was provided in
the affiliate account confirmation email. CMS Casino
affiliates should leave this setting untouched.
Plug-In Content - Casino ID
The content plug-in "Casino ID" is routing CMS Casino settings to the CMS content (e. g. articles, menu entries, custom HTML modules).
The plug-in contains a pin-hole parser which is replacing content placeholders with dynamic extension data.
The following content placeholder:
{{casino}}
will get replaced by the casino name setting which is defined in the system plug-in "CMS Casino", so e. g. with:
Joomla Casino
So do NOT change the placeholder definition {{casino}}!!!
The main purpose of this plug-in is to support a dynamic and comfortable link building to the gaming interface. Especially Casino
Operators with sub-affiliates rely on the affiliate ID routing function of this plug-in.
Please make sure that the Joomla caching is disabled (see Global Configuration > System).
The caching interferes negatively with the dynamic substitution of the content placeholders.
Details about links and content placeholders can be found in the
Casino Link Manual
which is mandatory to read.
Plug-in System - Universal Joomla Template
The "Universal Joomla Template" (UJT) plug-in requires the adjustment of one setting for providing centered pop-up windows if no
WinningStreak casino template is used. WinningStreak casino templates are based on the "Universal Joomla Template" technology of
WinningStreak and are coming with several scripts which need to get substituted for a good gaming experience.
Centered Pop-up Windows Without Casino Template
For enabling centered pop-up windows (e. g. for a more consistent game loading) if no WinningStreak casino template is used you need
to enable the loading of a substitute JS file in the plug-in settings:
Once the script is enabled for templates which are not based on the Universal Joomla Template (UJT) then you need only to add to any
link the CSS class "cPopup". Do not use the link target which opens a new window, just let the link open in the parent frame (what is the
HTML preset). Here a simplified link example which opens a specific game in a JavaScript controlled pop-up window:
<a href="http://games.casinoserver.net/en/2024/?affiliate_id=777"
class="cPopup"
>this link opens now in a pop-up window</a>
If you have to define links in Joomla menus just define the field "Link CSS Style":
The setting displayed above is already sufficient to open the gaming interface in a centered pop-up window.
Joomla CMS Casino Extensions Setup

16
This setting applies ONLY to setups where NO casino
template from WinningStreak is used. If you are using a
WinningStreak casino template (e.g. Las Vegas) the
setting must be "Off".
If you want in other templates to open the casino gaming
interface in a pop-up window instead in a new tab use the
setting "Load JS". This setting enables a script which
allows to open centered pop-ups by just assigning a Link
CSS Style (see next screen-shot).
Just by adding the style "cPopup" to the Link CSS Style
field will open this link on a pop-up window. Do not chose
the Joomla setting which opens a new window. Just use
the setting "Parent".
Extension Updates
The Joomla CMS Casino package contains extensions which are supporting the Joomla update feature. CMS Casino users can use the one-
click update button in the Extension Manager. If an extension update is available it will be listed in the "Update" tab of the Extension
Manager:
The one-click-update feature of Joomla is fully supported by all CMS-Casino extensions. The extensions get updated individually and not in form of the package
which was used for the initial installation. A package update would also update the template what would overwrite all custom changes of the template files.
The extension updating process is based on updating all extensions individually. If several CMS Casino extensions are offered for an
update
all
offered extensions need to get installed. It is possible that there exist dependencies to new features between the extensions.
Usually more complex updates (stretching over several extensions) are provided in form of a package update. Package updates have the
advantage that all dependencies are correct and there won't occur incompatibilities between extensions coming from different releases. If
an update package AND one or more extensions are displayed in the Update Manager please update first the package. Then click to the
toolbar button "Purge Cache" followed by clicking to "Find Updates". In most cases the additionally displayed extensions should disappear.
The updating process itself is simple: Select the extension (tick the check-box) and press the button "Update". A message should appear
that the extension was installed correctly.
Sometimes the updates might not get found automatically. To enforce the update detection press "Purge Cache" and then "Find Updates".
This step refreshes the update cache and ensures that important updates don't get missed out.
Milestone updates are also offered separately in the Download section of
http://whitelabelcasino.com
.
Safe Overwriting
All CMS Casino extension are developed in a way that it is safe to re-install those all together or individually at any time. Most extension
settings are preserved during any form of updating but we recommend to take always a quick look to check that. Especially the game IDs
of the component may get overwritten.
Since the re-installation of the package is basically safe and requires only a tiny amount of re-configuration work you can update all
extensions by downloading the latest release and install it. That usually helps if there is something messed up with the extensions.
Template Installation
If a CMS Casino template needs to get installed please install always only the archive with the template. Don't install template packages
which contain additional casino extensions.
Extension Removal
The CMS Casino package can get removed without leaving any traces in your Joomla installation by using the "Uninstall" feature inside the

table "Manage" of the Extension Manager.
Life-time Affiliate Commissions
Removal of the CMS Casino extensions has no influence to your money earning as an affiliate with old players. The commission affiliates
get paid for players who are causing a casino profit is a life-time commission. So long the players who signed-up with your affiliate ID
tracking stay active and produce profitable results you get paid on a monthly basis your affiliate commission.
Embedding Alternatives (Custom HTML Modules)
Beside using the standard CMS Casino games module Joomla administrators can create alternatively or additionally Joomla custom HTML
modules with casino game previews. Using these embedding alternatives does
NOT
require the installation of any Joomla CMS Casino
extensions. Just follow the instructions below and a few minutes later things are ready to go.
If you are happy with the already installed standard CMS Casino component and module you can leave out this chapter and proceed to
the next chapter Gaming Interface (see page
19
).
The game widget embedding alternatives shouldn't be used as the preferred method to display the casino game previews in modern
Joomla installations. The custom HTML module based game embedding technology is meant to be a last resort if the standard component
and module can't be used. A typical scenario for that would be the integration into old Joomla 1.x versions.
The custom module implementation can be realized in two ways (Generic via PHP or HTML via IFRAME) which both will take place in a
Joomla HTML custom module.
The custom HTML modules should be created on basis of the command structure of the
Casino Widget Generator
. By embedding one line
of PHP code into a custom module a flexible amount of casino games can get implemented into virtually any Joomla website.
Joomla CMS Casino Extensions Setup

17
Embedding of HTML Code
(via IFRAME)
A no-headache implementation alternative is the embedding of HTML widgets into a
Joomla custom HTML module
. This method works in
all Joomla versions which allow the embedding of an IFRAME. Try out this link:
http://gameserver.us.com/embed.php?lang=en&format=html
Please take a look to the HTML source code. The widget represents a valid HTML page which can get embedded everywhere where an
IFRAME can get used. That means for Joomla users they can create a web-page with the Joomla IFRAME wrapper (for having the games
in the content area) or to define an IFRAME in a Joomla custom HTML module.
A typical instruction would look like this:
<iframe src="
http://gameserver.us.com/embed.php?affid=1&format=html
" frameborder="0" height="1100" width="890"></iframe>
Used in the Atomic template of Joomla 25 (module position "atomic-bottommiddle") this code is producing these game preview widgets:
The screen-shot is only an excerpt with 4 games of the web-page which is displaying 12 games in 3 rows.
All details about the syntax of the casino widget embedding instructions can be found in this
manual
.
Using an IFRAME is a viable option if there are SEO concerns regarding content duplication (caused by the game preview texts).
Embedding of Generic Code (via PHP)
Requirements
Since Joomla doesn't allow to enter and process directly PHP code (e. g. from a custom HTML module) you need to install first the
Sourcerer
extension. This extension is a sort of heavy but well designed and well maintained. After installation of the Sourcerer enter the
following code into an article:
{Source}<?php echo file_get_contents('
http://gameserver.us.com/embed.php?affid=1
'); ?>{/Source}
That's it! Easy, right?
The syntax of the casino widget embedding instructions can be taken from the
manual
.
The embedded game widgets are now a generic part of the Joomla website. The only thing what is now required is to add the required
CSS into your Joomla CSS file. The CSS can get downloaded from
here
. Feel free to adjust the embedded CSS to your liking. As an
example you may not want to use the "html", "body" and "a" instructions, because these are most probably already defined in your
existing CSS file. The customization opportunities are basically limitless.
Joomla CMS Casino Extensions Setup

18
Gaming Interface
Gaming Interface Links
It is mandatory that you get familiar with the structure of the links to the gaming interface and casino games. This structure is
described in a separate document:
http://documentation/whitelabelcasino.com/casino_links_aff_manual.pdf
Please follow strictly the instructions of this document. Using an invalid link structure may cause problems in tracking players or regarding

the "on-the-fly" customization of the gaming interface (with your logo and casino name).
This manual describes also the for the CMS content available placeholders which get exchanged during the website rendering with the
final values. Using these placeholders simplifies the creation of content and links tremendously.
Game Portfolio
Currently (August 2012) the CMS Casino is equipped with 90 games. New games will be added step by step to ensure a constant stream
of fresh games for players.
Gaming Interface Branding
Registered casino affiliates get access to the Affiliate Manager (affiliate back-end software). This software component comes with branding

features which allow the customization of the casino name and casino logo which are displayed in the Gaming Interface. For details see
the chapter "Website Profiles" on page
20
).
The branding of the gaming interface is managed by a so called "Profile ID". This profile ID refers to the website profile which get defined
in your affiliate account settings. Below an example where a website profile is used which displays the Logo "Joomla Casino" in the
gaming interface:
The gaming interface can get branded on-the-fly. Based on the profile ID in the link to the gaming interface the displayed casino identity is changing. This allows an easy
customization of your Joomla based casino. Just create in your affiliate account a website profile and enter the related profile ID into the settings of the plug-in "System
-CMS Casino".
Define in the website profile (in your affiliate account) also a color scheme for the gaming interface.
Joomla CMS Casino Extensions Setup

19
The casino name (see the messaging area at the
bottom) and the logo of the gaming interface can get
defined in the website profile settings of your affiliate
account. Each website profile defines a "Profile ID". If
this "PID" is used for calling the gaming interface
(see the entry in the browser address bar) the
custom branding takes place automatically.
Affiliate Back-end
The Joomla CMS Casino extensions and the Casino2Go packages are products for gambling affiliates and casino operators. Both client
categories have access to the affiliate back-end which plays an important role for the setup and management of your casino related
marketing activities:
http://affiliate.casinoserver.net/
Affiliate Account
For earning money with the casino games promotion and for getting access to the game customization features you need to create an
affiliate account.
This affiliate account serves several product families:

Joomla Casino

Wordpress Casino

Drupal Casino (coming soon)

Casino Widget Generator

and all related Casino2Go products
Website Profiles
Go to
My Account > Website profiles
for creating a website profile. How already mentioned a website profile is required for the "on-the-
fly" customization of the games (gaming interface) with your casino name and your casino logo. Below an example:
The example was taken from the authors affiliate account where 3 product lines are supported
Use the button "New" to create a new website profile. There are five data basic fields:

Name
Enter here the name which shall be displayed in the gaming interface as the casino name.

Description
This is an internal note only.

Url
Enter here the URL of your promotion website.

Logo
This field allows you to upload your casino logo. Casino logos must have a size of 300 x 170 pixels. The required file format is 24-
bit PNG with alpha channel transparency.

Analytics ua
Enter here your Google analytics ID. If you do so you will see specific statistics of your casino promotion automatically in your
Google Analytics account.
Beside the basic data fields we have some extended features. Some of the below listed features are experimental:
Joomla CMS Casino Extensions Setup

20
The standard gaminmg interface URL for Casino2Go clients is:
http://games.casinoserver.net
. We are planning to add a further
customization feature which allows you to replace the URL
subdomain part "games" with the name of your casino.
The gaming interface can use different color schemes to allow a
more flexible visual adaption to differently designed casino
websites.
If the gaming interface will get embedded into a web-page the GI
logo is only annoying because the web-page header will contain
on most websites already the logo. Disabling the logo label in
the gaming interface provides a cleaner presentation.
Marketing Materials
If you are using links to the casino games which are not coming from a Joomla extension or the Widget Generator you shouldn't use the
links from the banner farm. These links are marketing tools for affiliates of Premium and White Label Casino.
So please use solely the link structure how it is explained in this document:
http://documentation/whitelabelcasino.com/casino_links_aff_manual.pdf
Joomla CMS Casino Extensions Setup

21
Casino Templates
Template Structure
Template Elements
The casino templates consist of several elements:

the template package (e. g. tpl_lasvegas.zip)

the template plug-in (plg_ujtpl.zip - already part of the CMS Casino extension package)

the template library (lib_ujtpl.zip - already part of the CMS Casino extension package)
Template CSS
The templates consist mainly of three CSS files:

the core template skeleton (template.css) which holds all basic styles

the template layout (layout.css) which is providing a few styles which are layout specific (most users can ignore this file)

the template design (skin.css) which allows to create several template design variations.
The template skins can get selected in the template settings (edit the template in the Template Manager for access to the settings).
The standard template (tpl_lasvegas.zip) comes already with a few skins which may represent a good basis for further casino website
customizations.
The screen-shot above is a skin example of the LasVegas template (skin "atlantic").
Installing Templates
Casino templates are not part of the CMS Casino package and have to get installed separately. The CMS Casino package contains already
the template plug-in and template library so that only a template needs to get installed. The installation process follows the Joomla
standard installation process.
Template Configuration
The WinningStreak templates are equipped with several scripts and functions which are freeing you from searching and installing
additional extensions for adding basic website features (e. g. tabbed content, modal pop-ups, extended tool-tips, embedding Google Fonts

and Google Analytics).
The following features are usually supported by the WinningStreak templates:

Selection of a design skin

Selection of a different template layout file

Adding Google fonts to the template

Embedding Google Analytics with your profile ID

JavaScript compression

Emulation of HTML 5 elements for HTML 4 browsers (e. g. IE 7 and IE 8)
Joomla CMS Casino Extensions Setup

22

Adding a browser detection based class to the HTML element

Enable the Joomla core tool-tips for the casino website

Enable the Joomla core tabs function for the casino website

Enable the Joomla modal pop-ups function for the casino website

Enable centered pop-ups; when this feature is used then the gaming interface opens in a pop-up window

Enable the simple slide-show (doesn't require the installation of a slide-show extension)

Enable Javascript based image reflections (works only based on the physical image size, not on the CSS downsizing)

Disallow loading the website in a HTML frame (frame breaker)

Disable DCSS (dynamic CSS)
These features can get activated in the Joomla Template Manager by selecting the installed WinningStreak casino template and clicking to
"Edit" in the tool-bar. There are Basic Options and Advanced Options where the desired settings can get applied.
The casino templates contain several important settings which can get accessed via the Template Manager.
Information about the settings gets displayed when the mouse pointer will be moved over the label of a settings field.
Templates For Joomla 3.0
The implementation of the Bootstrap framework into Joomla 3.0 will affect also the template structure. Later in 2012 we will offer the
template(s) also for version 3.0 and will switch from MooTools to jQuery.
Joomla CMS Casino Extensions Setup

23
Appendix
Creating Game Portfolio Previews
Some Joomla CMS Casino users may like the idea to create a casino game overview page with the extensions. Such a page would require
that all casino games are provided for display in the article area. The bad news are that the current development stage of the Joomla
Casino component doesn't allow that. But there is hope although the solution is quiet hidden and more a feature for specialists.
The Joomla plug-in "Content - Casinoid" has a setting "Allow widgets". When this setting is enabled (set to "1") you can embed casino
games with the Casino Widget Generator which can be found here:
http://gameserver.us.com
You can embed all games from there by simply placing this placeholder into an article or module:
{{widgets}}
After reloading the page the games are embedded. The configuration of these games is static. For having a customer specific
configuration please contact your WinningStreak affiliate manager. He will create a customized configuration file which is then linked to
your affiliate ID and will get applied automatically for calls from your website.
In this configuration file can i. e. be defined:

if you want all games in the standard order or randomized

and all other settings which are described in the
manual
for the game embedding.
Building a Joomla Casino from Scratch
If you intend to build a casino website from scratch instead of embedding the Joomla CMS Casino extensions into an already existing
website or using a Casino2Go package the following task list may provide you some orientation:
1.
Download and install the newest Joomla 2.5.x version
2.
Download, install and setup the Joomla CMS Casino package
3.
Download, install and activate a CMS Casino template
4.
Remove in the Extension Manager > Manage all unused front-end templates (Atomic, Beez5, Beez20)
5.
Check in the Extension Manager > Update for updates and install pending updates
6.
Configure the plug-in "System - CMS Casino" (don't forget to define the affiliate ID and website profile ID)
7.
Configure the CMS Casino component and add the component to a Joomla menu.
8.
Configure and enable the CMS Casino module. Copy the module for displaying new games and featured games at the same time.
9.
Install and configure the following additional 3rd party Joomla 2.5 extensions:
Akeeba Backup
(best tool to backup your casino website)
10.
Configure Joomla (server settings, meta tags, contacts)
11.
Create the content structure (Joomla categories)
12.
Create the content (Joomla articles)
13.
Create the menu entries
14.
Launch your casino and start to earn money with your gambling traffic
Restrictions
Countries
WinningStreak rejects game-play from specific countries. The list of not supported countries varies depending on changes in the legal
situation and fraud occurrences. So please check regularly for updates. Real money game-play is e. g. not supported in these countries:
Afghanistan, China, Cyprus, Ethiopia, Iraq, Iran, Pakistan, USA and several other Asian, African and European countries.
All partners are obliged to respect the legislation and jurisdiction of the countries where they are promoting the Joomla CMS Casino.
Payment Methods
WinningStreak restricts the availability or maximum deposit amount of specific payment methods (e. g. payments with credit cards) to
specific countries and to specific affiliates who have proven to deliver high-quality traffic. Prepaid cards (e. g. Paysafecard) and E-wallets
like Skrill (Moneybookers) and Neteller have usually less restrictions. For details please contact your affiliate manager.
Joomla CMS Casino Extensions Setup

24
Error List
The following setup error messages are the result of configuration errors which can be resolved easily:

Component display is empty
Go to Components->CMS Casino and open the Options. Define your custom settings and save the settings. Even if no settings
have been applied an initial one time saving is required.

No preview texts
Go to the Joomla Plug-in Manager and configure the "CMS Casino" and "Universal Joomla Template" plug-ins. Save the settings
even if no changes were applied. Ensure that the plug-ins are enabled. Select in the casino plug-in only languages which have
corresponding language texts in the XML games data.

Error! Failed to open the games XML data source!
Check the provided data source settings if these are defined correctly.
Ensure that the "CMS Casino" plug-in is enabled and that the XML data source settings are correct. Copy the XML feed URL and
paste it into a browser address bar for checking the data feed availability. If the data is displayed in the browser the feed
availability is given.
A typical scenario when the error occurs is that a greater number of games is selected (e. g. in the module for featured or new
games) then is defined in the database. The XML parser is then running into nowhere during the recursive parsing of the XML feed.
So please analyze the XML feed if the requested amount of data is contained. If not, please correct your settings in the casino
component or module. If you have access to the Casino Manager Software you can alternatively adjust the settings in the XML feed

(by e. g. increasing the number of games which are defined as "featured" or "new").
When you are analyzing the XML games data feed please keep in mind that the XML data is cached locally for 24 hours. Therefore
changes in the XML feed won't show effect immediately. Setting the cache life-time in the system plug-in "CMS Casino"
temporarily to "0" eliminates the outdated cache file.
If you don't have access to the Casino Manager please adjust the settings in the component or module. Start with a small number
and increase then in steps the number of requested games data.
If all that doesn't help please check out the forum for more information or contact the help-desk.
Customer Service
Please visit first the
White Label Casino Forum
for checking out if your question was already a posted topic and got answered.
The second step would be to create a customer support ticket in the Casino Server help-desk system.
Joomla CMS Casino Extensions Setup

25
About WinningStreak
WinningStreak Ltd. is a Cyprus based joint venture of three experienced European gaming enterprises based on the vision to innovate the

white label casino business with highly customizable and easy to setup casino games (
The Art of Games
) and an easy to manage casino
back-end software.
With more than 8 years experience in the development of online gaming platforms we at WinningStreak can guarantee our casino clients
that they promote a gaming platform with excellent quality and proven reliability.
Without sacrificing well established methods we have a strong focus to innovation. Our white label casino clients can rely on our ongoing
efforts to modernize all parts of the gaming platform to ensure that they will retain always a competitive edge over other white label
casino operators.
Our commitment to cost effectiveness and an outstanding service experience makes WinningStreak products to a first choice for white
label casino partners in the crowded casino market. Our core competence is the development of online casino games combined with the
related casino management and casino affiliate software. That's it! We don’t develop sports-book, live table games or raked poker games.

We are traditional online casino specialists. Our modern platform and back-end technology allows the integration of other gaming
categories (e. g. sports-book) but we stay focused to our core competence of providing attractive online casino gaming on a global scale.
Contact
For detailed information or special requests please contact Harald Engels at WinningStreak via
email
, Skype or phone:
Email:
mailto:info@winningstreak.biz
Skype ID: haraldengels
Phone: +357 99 347085
WinningStreak Ltd.
Larnaca / Republic of Cyprus
Credits
We would like to thank the following individuals, organizations or entities for making this Joomla Casino project happen:

Open Source Matters

and all
Joomla! Developers
for creating with Joomla! the best CMS on this planet

Nicholas K. Dionysopoulos for the fantastic
Akeeba Backup
and
Akeeba Release
system

Petr Stanicek

for the most robust multi-column
website layout
which I have seen during the last 10 years (it still rocks)
Joomla CMS Casino Extensions Setup

26