Embed Chessboard

Description

Embed Chessboard is a plugin that allows for the insertion of a chessboard displaying chess games within worpress articles.

Warning: the wordpress.org platform announced some major changes will be included in the upcoming 5 version; at this point the pgn4web project has not been able to fully assess the impact of those changes on the embed-chessboard plugin and confirm the plugin compatibility with wordpress 5; as a result, if you are using or if you plan to use the embed-chessboard plugin for your site, please refrain from updating your site to wordpress.org 5 when available and wait for the pgn4web project to confirm compatibility of the embed-chessboard plugin with wordpress.org 5. Updated information will be posted here as soon as available.

Use following tag to insert a chessboard:

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

Tag parameters:

  • layout=horizontal|vertical
  • height=auto|number
  • showMoves=figurine|text|puzzle|hidden
  • initialGame=first|last|random|number
  • initialVariation=number
  • initialHalfmove=start|end|random|comment|number
  • autoplayMode=game|loop|none

Example:

[pgn height=500 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]

Any PGN header tag missing will not be displayed.

Note: 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.

Screenshots

  • chessboard with basic chess notation
  • chessboard with chess informant notation
  • chessboard with chess puzzle

Installation

Reccomended installation method is from the plugins section of the administration pages of your site, serching for the “Embed Chessboard” plugin.

Alternative manual install option:

  1. Download the Embed Chessboard plugin package from the WordPress plugin directory or from the pgn4web project site
  2. Unzip the plugin package to the ‘/wp-content/plugins’ directory of your site
  3. Activate the plugin from the wordpress.org administration pages of your site

You can find full details of installing a plugin on the plugin installation page.

The chessboard plugin can be configured by the site administrator from the “Embed Chessboard” submenu in the administrator “Settings” menu; here the horizontal or vertical position of the header/moves text respect to the chessboard can be configured, the colors of the chessboard can be changed to match the site template and the autoplay mode can be set (whether the chess games should be autoplayed on page load).

The plugin is based on the pgn4web tool; for more information, including updated troubleshooting notes, please refer to the plugin tutorial at the pgn4web wiki.

FAQ

Installation Instructions

Reccomended installation method is from the plugins section of the administration pages of your site, serching for the “Embed Chessboard” plugin.

Alternative manual install option:

  1. Download the Embed Chessboard plugin package from the WordPress plugin directory or from the pgn4web project site
  2. Unzip the plugin package to the ‘/wp-content/plugins’ directory of your site
  3. Activate the plugin from the wordpress.org administration pages of your site

You can find full details of installing a plugin on the plugin installation page.

The chessboard plugin can be configured by the site administrator from the “Embed Chessboard” submenu in the administrator “Settings” menu; here the horizontal or vertical position of the header/moves text respect to the chessboard can be configured, the colors of the chessboard can be changed to match the site template and the autoplay mode can be set (whether the chess games should be autoplayed on page load).

The plugin is based on the pgn4web tool; for more information, including updated troubleshooting notes, please refer to the plugin tutorial at the pgn4web wiki.

Reviews

Very good support

The team support very quick. what about plugin? it is very helpful for developers and have a lot of options that makes it flexible.

Read all 4 reviews

Contributors & Developers

“Embed Chessboard” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Embed Chessboard” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.