Tetris_XH - a CMSimple_XH Plugin

Plugin Icon

Tetris_XH is an implementation of the famous Tetris game for inclusion on a CMSimple_XH website.

Please do read this documentation before you encounter any problems!

Requirements

Tetris_XH is a plugin for CMSimple_XH. It requires an UTF-8 encoded version and the jQuery4CMSimple plugin which is already bundled with CMSimple_XH since 1.4.2.

back to top

Installation

The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

  1. Backup the data on your server.
  2. Unzip the distribution on your computer.
  3. Upload the whole directory tetris/ to your server into CMSimple_XH's plugins directory.
  4. Set write permissions to the subdirectories config/, css/, languages/ and to the plugin's data folder.
  5. Switch to "Tetris" in the back-end to check if all requirements are fulfilled.
back to top

Settings

The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Tetris" from "Plugins".

You can change the default settings of Tetris_XH under "Config". Hints for the options will be displayed when hovering over the help icons with your mouse.

Localization is done under "Language". You can translate the character strings to your own language, or customize them according to your needs.

The style of Tetris_XH can be customized under "Stylesheet". If you want to style the jQueryUI elements to fit to your template, you should consider to add jQueryUI theming support to your template. How this can be done is explained in the CMSimple forum.

back to top

Usage

To display the tetris game on a page, insert:

{{{PLUGIN:tetris();}}}
back to top

Limitations

To play tetris, JavaScript has to be enabled in the visitor's browser.

jQuery

Tetris_XH may not work in installations with jQuery dependent plugins, addons or templates that don't use jQuery4CMSimple, but import their own jQuery library. This won't get fixed (as it's not possible to fix it in all cases), because all developers are advised to use only jQuery4CMSimple together with all their jQuery based code for CMSimple_XH. So offending extensions should be updated!

Vulnerability of highscores

It is not very hard for hackers to manipulate the highscores without actually scoring them through game play. But this poses no real security issue, as the size of the highscore database is restricted.

CSS validation

As the plugin makes use of jQueryUI themes, the generated output might not be valid CSS 2.1.

back to top

License

Tetris_XH is licensed under GPLv3.

© 2011-2013 Christoph M. Becker

Polish translation © 2012 Kamil Kresz
Czech translation © 2012 Josef Němec
Slovak translation © 2012 Dr. Martin Sereday

back to top

Credits

Tetris_XH is based on Tetris with jQuery by Franck Marcia. Many thanks to him for developing this nice and simple implementation of Tetris and releasing the code under an open source license.

The plugin icon is designed by AtuX. Many thanks for publishing this icon under a liberal license.

This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.

Many thanks to the community at the CMSimple forum for tips, suggestions and testing. Particularly I want to thank Gert and oldnema for their suggestions to improve Tetris_XH. And I have to apologize to bca, who tested the online demo first, but wasn't able to save his highscore because of a bug in the plugin.

Many thanks to Luda Wieland who pointed out that the highscores couldn't be written on installations in a UserDir and helped with debugging the problem.

And last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.

back to top