Add-On Releases - [PBPG] Chess

What does it do?
This is a chess plugin for my Play by post gaming mod. It allows members to play chess against each other within a forum thread.

What can I use it for?
The main aim of games is fun but you could also run tournaments as well

Live Demo
A live demo of this mod can be seen on my own forums here: http://www.giveupalready.com/forumdi...r-Gaming-Forum

Features

• Javascript powered chess game within a fourm thread.
• Admin options:
  • Board Rotation (play with white at top or bottom)
  • Force board rotation (decide if players can override the default setting)
  • Private mode (only players can comment while game is in progress)
  • Image directory
  • pbpg_path
• Admin help for chess specific options
• Interface for setting options by members
• Member options:
  • Board rotation (if allowed by admin)
  • White player username/userid
  • Black player username/userid
  • Private mode (only players can comment while game is in progress)
• Status changing commands (resign, stalemate,check,checkmate)
• Tournaments and ladders integration. (Requires T+L v 4.0-0.1 a3+)
• Member statistics (games played/won/lost/drawn)

Planned features
[s]Struck out[/s] items in this list are implemented in my latest development copy and will make the next release. *** items are planned for next release.

• Admin options:
  • Enforce rules on/off/ignore first
  • Input format (support for PGN and other standard input formats)
• User options: (all can be forced to a certain value by the admin)
  • Enforce rules on/off/ignore first
  • Input format (support for PGN and other standard input formats)
• Javascript move forward/backward through moves.
• Ajax updating of board
• Updated member FAQ
• Full phrasing of front + back end to help translations.

Installation
1. Install Play by post gaming core product
2. Upload contents of upload folder.
3. Import product file.
4. Select the Manage Plugin Configurations option from the play by post gaming menu
5. Against Chess, select the create new configuration option.
6. Fill out the settings and save.
7. Create or edit an existing forum and assign the configuration you just created to it.


Uninstallation
As of beta 1, the product will not allow you to uninstall it while it is still in use. (this would break your board.)
1. Edit the forums that have a configuration of this plugin assigned and remove it from the list.
2. Now uninstall the product.
3. Delete the chess directory in pbpg_plugins.

Changelog

• 4.0-0.1 b5
  • Fixed a number of minor issues.
  • Fixed issue with reset being hit half way through making a move.
  • Added comms support; this allows the plugin to share information with other plugins. Currently, this is used to provide automatic tournament results to the tournaments + ladders plugin.
  • Added statistics (wins, losses, draws and games played) These can be mapped to profile fields using the interface in the core product.
  • Now requires PBPG core b4
    
• 4.0-0.1 b4
  • Fixed bug with javascript paths
  • Fixed extra move exploit in stalemate code
  • UI enhancements
    • Comment and post move button now appear along side chess board
    • Reset button added to reset board to current game state.
    • move list prevented from growing to big
    • Check/checkmate statuses highlight king
    • Status buttons go green when selected; can be toggled on and off.
  • Status changing commands for check and checkmate
  • Admin help
• 4.0-0.1 b3
  • Added status changing commands, players can now resign and request a stalemate.
  • Added private mode; hides comments from none players while the game is in progress, once the game ends (stalemate or a player resigns) the comments are shown.
  • Private mode can be set/locked by admin
  • Directory for images can be set
• 4.0-0.1 b2
  • Fixed bug with javascript in IE + chrome.
  • Plugin will now not install if you do not have core product installed and upto date.
  • Added option hinting to option boxes.
  • Fixed bug with castling/en passant causing the game to skip the next players turn.
  • Added highly defensive install/uninstallation code.
  • Now requires version 4.0-0.1 b3 (Beta 3) of pbpg core.
• 4.0-0.1 b1
  • Added uninstall code with safety check to prevent you breaking your board.
  • Added JS interface for users to set game options and choose players. This only shows for the thread starter. (ajax autocomplete on usernames)
  • Fixed bug causing default value for white square to be transparent.
  • Numerous user interface improvments; now shows players who are playing, move number and who's turn it is next.
• 4.0-0.1 a3
  • Fixed aditional database error in install code
• 4.0-0.1 a2
  • Fixed database error in install code
• 4.0-0.1 a1
  • Initial release

Notes

• enforcing rules was a hot request for my vb3.6 chess mod. This version has INCOMPLETE rules enforcing that is disabled. You could enable it by editing the code, however this will probably render most games unplayable at some point.
• This version is quasi-compatible with the vb3.6 version; however it requires some messing around to get it to work. At some point in the future I will release /something/ to convert between the two, however I don't have an ETA on this. Anyone asking for one without making a donation is likely to be ignored. UPDATE: this wasn't needed on my board, as members weren't interested in saving their old games, I will only work on this if requested by a donator.

[TimberFloorAu]

Have fixed product file, now working your paths assume the mod is installed in root

So prefixed all /pbpg with /forum

[TimberFloorAu]

Decided to uninstall. Unable to do so.

All threads deleted.
All forums de-selected.

ANy suggestions.?

[Carnage]

delete the configurations then try.

If that fails and you've only got this installed, remove the core product first.

[TimberFloorAu]

You cannot Deselect the bloody game from forums, even using Ctrl+mouse click

Therefore configs cannot be deleted.
Mate I would pull this mod, until it is actually safe to install and uninstall. Waiting for updates to uninstall !

Removing core product first still makes no difference.

[Carnage]

I have just tested the ctrl+click to remove in 3 browsers: firefox, chrome and internet explorer it works in all of them. That said, I will update the core product to use checkboxes from now on since that'll work out easier for unselecting them. If you've removed the core product change the uninstall code to this

$q = $db->query_first("SELECT * FROM ". TABLE_PREFIX."pbpg_plugin WHERE dir='chess'"); 
$db->query_write("DELETE FROM ".TABLE_PREFIX."pbpg_pluginconfig WHERE pbpg_pluginid = $q[pbpg_pluginid]");
$db->query_write("DELETE FROM ". TABLE_PREFIX."pbpg_plugin WHERE pbpg_pluginid = $q[pbpg_pluginid]");

to forcibly remove the mod.

EDIT: Alternativly, you can update to the newest version of the core. Based on your feedback i've added tools to make removal much easier.

[TimberFloorAu]

Appreciate your reply.

However, still cannot get rid of the chess plugin. Now throwing up db errors.

Latest: An error occurred while attempting to execute your query. The following information was returned.
error number: 1064
error desc: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '$q = $db->query_first("SELECT * FROM ". TABLE_PREFIX."pbpg_plugin WHERE dir='che' at line 1

[Carnage]

You sure you used the exact code above? It seems you've tried to pass $q = $db->query_first("SELECT * FROM ". TABLE_PREFIX."pbpg_plugin WHERE dir='che into the database somewhere; thats teh only way it would have returned that.

[TimberFloorAu]

How about :

Doing a full explanation on removing "your" product.

[Carnage]

ok, manual uninstallation:

remove the uninstallation code.
remove product.
delete pbpg_plugins/chess
remove pbpg core product.
remove pbpg_plugin and pbpg_pluginconfig tables

I have just checked and double checked. The latest versions of all the products install/uninstall correctly.

[TimberFloorAu]

Ok, thankyou.

It will not allow removal of chess plugin. Stating it has to be removed from config of forums, but it isnt enabled in a single forum