The Joomla! Extensions Directory ™


EmbedChessboard Plugin

Plugin to embed a javascript chessboard in joomla articles for replaying chess games.

The plugin enables a new bbcode tag in joomla articles that translates in a graphical chessboard, using the following syntax:

[pgn parameter=value ...]
chess games notation in PGN format
[/pgn]

Example:

[pgn initialHalfmove=16 autoplayMode=none]

[Event "World championship"]
[Site "Moscow URS"]
[Date "1985.10.15"]
[Round "16"]
[White "Karpov"]
[Black "Kasparov"]
[Result "0-1"]

1. e4 c5 2. Nf3 e6 3. d4 cxd4 4. Nxd4 Nc6 5. Nb5 d6 6. c4 Nf6 7. N1c3 a6 8.
Na3 d5 9. cxd5 exd5 10. exd5 Nb4 11. Be2 Bc5 12. O-O O-O 13. Bf3 Bf5 14.
Bg5 Re8 15. Qd2 b5 16. Rad1 Nd3 17. Nab1 h6 18. Bh4 b4 19. Na4 Bd6 20. Bg3
Rc8 21. b3 g5 22. Bxd6 Qxd6 23. g3 Nd7 24. Bg2 Qf6 25. a3 a5 26. axb4 axb4
27. Qa2 Bg6 28. d6 g4 29. Qd2 Kg7 30. f3 Qxd6 31. fxg4 Qd4+ 32. Kh1 Nf6 33.
Rf4 Ne4 34. Qxd3 Nf2+ 35. Rxf2 Bxd3 36. Rfd2 Qe3 37. Rxd3 Rc1 38. Nb2 Qf2
39. Nd2 Rxd1+ 40. Nxd1 Re1+ 0-1

[/pgn]

Caveats:
- the main packages supports joomla 1.6 or later, while a separate package is available for joomla 1.5 and a user contributed package is available for joomla 1.0
- HTML tags are stripped from the PGN data, removing all text between < and > characters; please make sure your PGN data does not contain < and > characters

The plugin project is hosted at the joomlacode repository:
http://joomlacode.org/gf/project/embedchessboard/

The plugin is based on the pgn4web tool, a tutorial, including configuration options and tag parameters, is available at the pgn4web wiki:
http://code.google.com/p/pgn4web/wiki/User_Notes_joomla
The pgn4web wiki also provides guidelines how to extend the plugin functionality to Kunena forum posts.

The full pgn4web project is hosted at http://pgn4web.casaschi.net where donations are welcome.

Report Extension

 

Images

 

2013-06-26
Reviews: 1
Thanks for this excellent Plugin. I just have one problem, i would like to integrate it into Kunena, but I don't find any possibility. Does anyone have a link for a manual, how to integrate it?
Owner's reply

Full integration with Kunena is not officially supported.

There are some high level guidelines in the notes at the bottom of this wiki page, use at your own risk:
https://code.google.com/p/pgn4web/wiki/User_Notes_joomla

2012-10-31
Reviews: 2
I'm very happy to have found this. It works very well, and produces very nice interactive chess diagrams. It is actively maintained and developed, and it is a must have for any chess site.

The only - minor - issue that the letters for the pieces must be English. No biggie, as I added the correct letters for my language myself. There is no built-in support for this, though.
2012-10-26
Reviews: 1
It is the best plugin for the job if you would like to publish chess games.
-easy to install
-easy to configure
-easy to use
I had some problems with enlargeing board, but the wiki on the projects homepage was really usefull.
And one thing what I have to mention:
Support is great. I have sent an email, with my issue and questions, and the helpfull answer was in my inbox in less than half an hour!!!
Congratulations for developers! You made the hard thing.
Something bad if I really want to tell: ... no. I do not want... :-)
Perfect solution for a very special problem.

Thanks a lot!
Owner's reply

Thanks.

For everybody's information, the issues/questions were about a new technique to customize the chessboard size and other features, without the need of manually editing the extension files.

You can read all the details from the FAQ questions at the bottom of the pgn4web wiki page http://code.google.com/p/pgn4web/wiki/User_Notes_joomla

2010-12-26
Reviews: 1
Great plugin
Works fine in kunena.
Only one Problem in kunena Forum:
Tags like
autoplayMode=none
and others doesn't work
However, the best one available chess plugin. Many thanks to Dev...
2010-11-04
Reviews: 2
Great plugin. Would be good if it supplied detailed step by step intructions on how to change size of chess board or provide an easy way to change settings of board size. this plugin does provide easy settings to change colour, which is great.
Owner's reply

Thanks for the feedback.

As far as the size of the chessboard is concerned, I'm afraid this is hardcoded in the code at the moment.

In order to add chessboards of different sizes to your joomla articles you have two options:

1) tweak the plugin code.
Look at the file embedchessboard.php where the square size is set in the line:

$replacement .= "&ss=26&ps=d&pf=d";

Changing the square size number "26" to a larger number will make your chessboard larger. You will also have to change the portions of code where the variable $height is set in order to take into account the larger resulting board size (manually increase the height numeric values and check the results on different articles showing different chessboards). When increasing the square size, the plugin will also look for larger piece bitmaps that are not in the package and that you will have to add manually from the main pgn4web zipfile available at http://code.google.com/p/pgn4web/downloads/list

To help you in this complicated process, you might want to look at the work done by the user contributing a backport of the plugin for joomla 1.0; within the backport he also added the option for different board sizes. Look for the joomla 1.0 plugin at the joomlacode download page:
http://joomlacode.org/gf/project/embedchessboard/frs/

2) use a generic plugin to embed iframes.
Alternatively, lot more chessboard configuration options are available if you install a generic plugin to embed iframes in your joomla articles, such as this one:
http://extensions.joomla.org/extensions/style-a-design/popups-a-iframes/4144

Then you generate the iframe src parameter from the pgn4web board generator tool available at:
http://pgn4web-board-generator.casaschi.net

Be aware, neither of the 1) or 2) option is as straightforward as using the basic plugin, but both would give you the flexibility you want.

If I get a lot of user requests I might add the option to tune the chessboard size... but don't hold your breath.

Thanks again for the feedback.

2010-07-31
Reviews: 1
The difference between simply displayin algebraic notation that would require a board to follow along and an interface that would allow a user to scroll through the game is enormous and I couldn't be happier with this pgn game viewer.

Installed on my website and after a little tweaking it works like a treat!

Cheers!!
2010-05-14
Reviews: 1
This is a must-have plugin to display chessgames in pgn format in joomla! Last version seems to have fixed some issues of appearance on IE and a strange "memory" problem of the previous releases (i.e. when publishing a game on an article and then replacing it with another, the first game still appeared on the frontend and could be followed normally).
It is also safer to paste pgn code on html editor as mentioned. The only issue I face right now is that articles with EmbedChessboard plugin fail to validate.
Thanks a lot for your great job! ;)
2010-05-02
Reviews: 1
This works excellently, easy to install and pretty easy to use. Great for making your own chess games collection. Doesnt work 100% with the pgn format chessbase.com use when commenting on the Anand-Topalov matches, some { tags show up around comments, but that is a minor thing. Brilliant start to a fantastic project :-)
Owner's reply

Thanks for the feedback.

If you have PGN data that does not display 100% as you expect, please send them for review (to the email address you find on the homepage http://pgn4web.casaschi.net )

Also let me know the URL of your site!

pgn4web

2010-04-02
Reviews: 1
Fantastic plug in , very simple, very small, customizable colors, just a copy paste...no problem at all...very good job! I vote excellent! without second thought.
Thank you......
2010-03-13
Reviews: 1
This plugin was just what I was searching for last autumn, when I upgraded our chessclub's website to Joomla! 1.5. Until now I've had to deal with one pgn-file holding the games I wanted to display, one html-file holding the pgn-viewer, and a java-based pgn-viewer. The html-file was shown in a frame in the article. This plugin makes the task much easier; I just have to copy and paste the content of the pgn-file between the two [pgn] and [/pgn]-tags. This plugin displays a sharp and goodlooking chessboard anywhere you would like to place it in an article, and let readers play through the game(s). The font used for the moves are figure-based. Colors for the board and pieces are customizable.
If I may suggest a few minor improvements, I would like to display the player's ratings right next to their names, an edtable date format, and the result also shown after the last move.

Thanks a lot for providing this excellent plugin!
Owner's reply

Thanks for your feedback!

I'll keep your suggestions in mind for future updates.

For the time being there are a few workarounds you could try to manually achieve similar effects as your suggested improvements.

The plugin takes the standard PGN header tags (Date, Site, Event, Round, White, Black, Result) and displays their value. Other PGN header tags (like WhiteElo, BlackElo) are ignored. As a workaround to display Elo information, the PGN data could be modified manually, adding the Elo information to the White and Black header tag, such as [White "Kramnik, Vladimir (2790)"]. Far from ideal having to manually modify the PGN header values, but it would achieve the desired effect.

Same for changing the date format, anything found in the Date PGN header tag would be displayed; manually changing the date format in the PGN data would change the display.

The result information is currenlty (by design) displayed only in the header section; in order to display the result at the end of the moves, a PGN comment could be manually added at the end of the game, such as: ... 4.Qxf7 { 1-0 }

Thanks for the feedback and please send me the URL of your site (to the email address you find on the homepage http://pgn4web.casaschi.net )!

pgn4web