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

  • Favourite
  • Report

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!


just unique

Posted on 02 April 2010
Fantastic plug in , very simple, very small, customizable colors, just a copy problem at all...very good job! I vote excellent! without second thought.

Thank you......
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 )!



Paolo Casaschi
Last updated:
Mar 13 2019
Date added:
Mar 10 2010
GPLv2 or later
Free download

Uses Joomla! Update System


Write a review