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


Please refer to the documentation and support links for further information and usage guidelines.

The full pgn4web project is hosted at where donations are welcome.

I use it everywhere on my website where I can now show hundreds of beautiful Chess Endgamestudies which otherwise are in pdf
Ease of use
95 Just use [pgn] and [/pgn] as tags and you have a playable game !
I used this to:

Excellent plugin

Posted on 14 December 2015
Agreat plugin and by far the best way to embed a chessboard on a Joomla website.
Ease of use
Very easy to use, especially if you first take the time to read on the website and look at the wonderful demo-sites
It looks great especially in combination with the demo-sites
I used this to: A chess-website based on Joomla.
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: The project has been moved, hence the new URL for the wiki page is:


Posted on 31 October 2012
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.

Just fantastic

Posted on 26 October 2012
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: The project has been moved, hence the new URL for the wiki page is:


Posted on 26 December 2010
Great plugin

Works fine in kunena.

Only one Problem in kunena Forum:

Tags like


and others doesn't work

However, the best one available chess plugin. Many thanks to Dev...

Size of board

Posted on 04 November 2010
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

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:

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:

Then you generate the iframe src parameter from the pgn4web board generator tool available at:

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

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

Also let me know the URL of your site!



Paolo Casaschi
Last updated:
Jul 06 2024
2 weeks ago
Date added:
Mar 10 2010
GPLv2 or later
Free download
J3 J4 J5

Uses Joomla! Update System


Write a review