RPB Chessboard Plugin

RPB Chessboard allows you to typeset and display chess games and diagrams in the posts and pages of your WordPress blog, using the standard FEN and PGN notations.

Links

• Ask for help or report a problem
• Documentation & examples
• GitHub repository (source code)

Features

• Customizable aspect for the chessboards (orientation, size, etc…).
• Support comments and sub-variations in PGN-encoded games.
• Support HTML formatting in PGN comments.
• Support several chess variants:
  • Chess960 (also known as Fischer Random Chess).
  • Antichess.
  • Horde chess.
• Colored square and arrow markers.
• Integration with the Gutenberg post/page editor.
• Multi-language support.

If you encounter some bugs with this plugin, or if you wish to get new features in the future versions, you can report/propose them in the GitHub bug tracker.

If you are interested in translating this plugin into your language, please contact the author.

Custom developments in relation with RPB Chessboard (e.g. specific feature, advanced customization…) can be realized by the author as a paid service. If you need to have such custom developments for your website, please feel free to contact the author.

Credits

Author

Yoann Le Montagner

Contributors

Marek Śmigielski, Paul Schreiber, Adam Silverstein, Paolo Fantozzi.

Translators

Jan Jílek (Czech), Markus Liebelt (German), Yoann Le Montagner (English and French), Martin Frith (Spanish), Atilla Szvetlik (Hungarian), Andrea Cuccarini (Italian), Ivan Deceuninck (Dutch), Dawid Ziółkowski (Polish), Rewbenio Frota (Brazilian Portuguese), Sergey Baravicov (Russian), Ali Nihat Yazıcı (Turkish).

Graphic resources

Pieceset CBurnett has been created by Colin M.L. Burnett, who shares it under the [CC-BY-SA] license on Wikimedia Commons; user Antonsusi has also contributed to this work. Piecesets Celtic, Eyes, Fantasy, Skulls and Spatial have been created by Maurizio Monge, who makes them freely available for chess programs. Colorsets Coral, Dusk, Emerald, Marine, Sandcastle and Wheat have been proposed in this blog post by Gorgonian.

The author would like to thank all these people for their highly valuable work.

1. Download rpb-chessboard.zip and upload its content to the /wp-content/plugins/ directory of your website.
2. Activate the plugin through the Plugins menu in WordPress.
3. When the plugin is installed and activated, two new blocks become available in the WordPress post/page editor: Chess diagram and Chess game.

For extensive details about plugin installation and management, please have a look to the general plugin management page.

For more details on how to use RPB Chessboard, please have a look to the quick start guide.

1. 

   Chess diagram in a post with the Twenty Fifteen theme.

2. 

   Chess game in a post with the Twenty Fifteen theme.

3. 

   When clicking on a move, a popup frame is displayed, showing the corresponding position.

4. 

   A navigation board can be added beside the move list.

5. 

   Chess games can have comments, sub-variations and diagrams. HTML formatting in text comments is supported.

6. 

   When the plugin is installed and activated, two new blocks become available in the Gutenberg post/page editor.

7. 

   Chess diagram block in the Gutenberg post/page editor.

8. 

   Chess game block in the Gutenberg post/page editor.

8.0.1 (July 18, 2024)

• Minor fixes.
• Tested up to WordPress 6.6.

8.0.0 (May 9, 2024)

• Add auto-play (see #91).
• Adapt button size in the navigation toolbar to the size of the board (see #274).

7.9.1 (April 7, 2024)

• Tested up to WordPress 6.5.
• Refactor build tools.

7.9.0 (March 9, 2024)

• Add support for NAGs 20 and 21 (see #280).

7.8.0 (January 1, 2024)

• Add an option to show/hide the turn flag in the diagrams (see #270).

7.7.1 (November 11, 2023)

• Tested up to WordPress 6.4.

7.7.0 (August 9, 2023)

• Tested up to WordPress 6.3.
• Fix size of the text area in the chess game block editor (see #267).

7.6.0 (June 3, 2023)

• Chess game block allows to upload a PGN file and use it as data source.

7.5.4 (May 26, 2023)

• Fix focus issue in the navigation frame (see #263).

7.5.3 (April 13, 2023)

• Minor fixes.

7.5.2 (April 13, 2023)

• Minor fixes.

7.5.1 (April 10, 2023)

• Fix comment parsing issue (see #260).

7.5.0 (April 9, 2023)

• The [fen][/fen] and [pgn][/pgn] shortcodes are no longer considered as deprecated (several people are still using the classic post/page editor).
• Add shortcode attribute initial_selection to [pgn][/pgn] to customize of the initial move (see #259).

7.4.1 (March 29, 2023)

• Tested up to WordPress 6.2.

7.4.0 (March 18, 2023)

• Add support for NAG 9 (see #255).

7.3.10 (March 11, 2023)

• Fix chess diagram block not properly rendered with starting position (see #256).

7.3.9 (March 5, 2023)

• Fix navigation popup display on mobile devices (see #253).

7.3.8 (February 1, 2023)

• Fix drag-drop not working in the diagram editor on mobile devices.

7.3.7 (January 8, 2023)

• Minor fixes.

7.3.6 (November 17, 2022)

• Fix scroll issue on iOS (see #250).

7.3.5 (November 10, 2022)

• Minor fixes on Hungarian translation.

7.3.4 (November 8, 2022)

• Hungarian translation (thanks to Atilla Szvetlik).

7.3.3 (November 6, 2022)

• Tested up to WordPress 6.1.
• Minor fixes.

7.3.2 (August 31, 2022)

• Minor fixes.

7.3.1 (June 29, 2022)

• Improve plugin resiliency + error reporting in presence of async/deferred JS loading (see #242).

7.3.0 (June 29, 2022)

• Add support for blue markers.
• Allow move arrow color customization.
• Minor fixes.

7.2.1 (June 14, 2022)

• Fix potential fatal error call to undefined function get_plugin_data() (see #240).

7.2.0 (June 13, 2022)

• Refactor the admin side of the plugin.
• Default options for standalone diagrams, for navigation board, and for PGN comment diagrams are now defined separately.

7.1.2 (June 7, 2022)

• Restore Czech translations.

7.1.1 (June 1, 2022)

• Fix <br> tags not working in PGN comments (see #238) and improve support of HTML tags (in particular: paragraphs, lists and images are now allowed in PGN comments).
• Minor fixes.

7.1.0 (May 24, 2022)

• Tested up to WordPress 6.0.
• Add support for NAGs 141, 143 and 145.
• Implement customization of the initial move shown by the navigation board (see #205 and #228).

7.0.1 (May 16, 2022)

• Minor fixes.

7.0.0 (May 16, 2022)

• Add chess game block with its editor to the Gutenberg-based WordPress post/page editor.
• Significant code refactoring of the chess game component, which is now released as a standalone NPM library (kokopu-react).
• The [fen][/fen] and [pgn][/pgn] shortcodes are now considered as deprecated: from now on, it is advised to use the chess diagram and chess game blocks to insert chess content in posts and pages.
• Remove the embedded help: documentation is now available on https://rpb-chessboard.yo35.org/.

6.4.1 (January 27, 2022)

• Tested up to WordPress 5.9.
• Upgrade dependencies.

6.4.0 (October 22, 2021)

• Add square annotations plus/times/dot/circle (see #218).

6.3.0 (September 27, 2021)

• Add support for Horde chess (see #167).

6.2.2 (September 19, 2021)

• Cleanup and upgrade dependencies.

6.2.1 (August 15, 2021)

• Support castling moves encoded with zeros (see #142).

6.2.0 (July 25, 2021)

• Tested up to WordPress 5.8.
• Add support for Antichess (see #187).

6.1.0 (June 26, 2021)

• Add text field to allow copy/paste FEN in the diagram editor (see #211).

6.0.2 (June 6, 2021)

• Fix navigation board size issue in popup frame on small-screen devices (see #208).

6.0.1 (May 30, 2021)

• Fix plugin crash encountered with old PHP versions (before PHP 7.3).

6.0.0 (May 30, 2021)

• Add chess diagram block with its editor to the Gutenberg-based WordPress post/page editor.
• Drop support for the old TinyMCE-based WordPress post/page editor.
• Significant code refactoring of the chess diagram widget, which is now released as a standalone NPM library (kokopu-react).

5.9.3 (May 17, 2021)

• Tested up to WordPress 5.7.
• Italian translation (thanks to Andrea Cuccarini).

5.9.2 (February 6, 2021)

• Rollback square marker rendering to plain square (as it used to be until version 5.9.0).

5.9.1 (January 10, 2021)

• Render square markers with a plain circle.

5.9.0 (January 3, 2021)

• Tested up to WordPress 5.6.
• Enable arrow/square marker color customization (see #190).
• Implement square annotation with letter/digit (see #192).
• Fix alignment issue with float-right navigation board (see #191).

5.8.1 (November 18, 2020)

• Fix arrow tip issue (see #185).

5.8.0 (August 22, 2020)

• Tested up to WordPress 5.5.
• Handle games with no king (see #171).

5.7.1 (July 30, 2020)

• Brazilian Portuguese translation (thanks to Rewbenio Frota).

5.7.0 (June 20, 2020)

• Tested up to WordPress 5.4.
• Implement lazy-loading for CSS assets (see #135) and introduce a compatibility option to disable this feature.

5.6.9 (February 9, 2020)

• Fix some typos in the Spanish translation.

5.6.8 (February 1, 2020)

• Fix some typos in the Spanish translation.

5.6.7 (February 1, 2020)

• Spanish translation (thanks to Martin Frith).

5.6.6 (December 22, 2019)

• Fix annotation arrows (regression from 5.6.5).

5.6.5 (December 20, 2019)

• Improve PGN parsing robustness to linebreak issues (see #155).

5.6.4 (November 24, 2019)

• Tested up to WordPress 5.3.
• Czech translation for frontend (thanks to Jan Jilek).

5.6.3 (June 8, 2019)

• Fix corner case issues occurring in PGN parsing.

5.6.2 (May 13, 2019)

• Tested up to WordPress 5.2.
• Fix diagrams/games not rendered with themes that do no include jQuery by default (see #154).

5.6.1 (April 21, 2019)

• Fix disambiguation issue on rook move (see #153).

5.6 (April 20, 2019)

• Fix PGN parsing error encountered with lichess syntax for %csl/%cal (see #151).
• Add support for advanced NAGs (see #152).

5.5.3 (March 23, 2019)

• Fix PGN parsing error encountered with games downloaded from lichess.org (see #149).

5.5.2 (March 10, 2019)

• Fix PGN parsing issue (see #146).

5.5.1 (February 23, 2019)

• Tested up to WordPress 5.1.
• Lazy-loading of CSS assets does not work with some themes (see #145): revert this feature.

5.5 (February 9, 2019)

• Load CSS/JS assets only when necessary in the frontend (see #135).

5.4.4 (January 1, 2019)

• Tested up to WordPress 5.0.
• Code cleanup.

5.4.3 (October 27, 2018)

• Fix (again) post/page rendering for Gutenberg (see #137).

5.4.2 (August 25, 2018)

• Fix scroll area sizing in hidden chessgames (see #141).

5.4.1 (August 12, 2018)

• Fix animation issue occurring on small-screen devices (see #136).
• Fix post/page rendering for Gutenberg (see #137).
• Fix diagrams not working in Chess960 games (see #138).

5.4 (July 22, 2018)

• Add support for Chess960, aka. Fischer Random Chess (see #15).

5.3.3 (July 9, 2018)

• Fix invalid move notation issue (see #134).

5.3.2 (July 8, 2018)

• Fix security issue (see #133).

5.3.1 (July 7, 2018)

• Fix security issue (see #132).

5.3 (May 26, 2018)

• Fix diagram issues (see #130 and #131): [pgndiagram] is no-longer available. From now on, the standard [#] should be used instead.
• Fix security issue (see #122): refactor DOM building process and set-up proper HTML sanitization where needed.
• Refactor move generation/validation + PGN parsing code as a standalone NPM library (Kokopu).

5.2.2 (May 1, 2018)

• Fix page jump issue (see #129).

5.2.1 (April 8, 2018)

• Fix scrolling issue (see #128).

5.2 (April 2, 2018)

• Fix several code security issues (see #116, #117, #118, #119, #120 and #121).
• Image size optimization.
• IE 8 not supported anymore.

5.1.6 (January 7, 2018)

• Fix scrolling issue (see #111).
• Enforce WP coding conventions and code cleanup.
• Chess font size optimization.

5.1.5 (January 1, 2018)

• Fix several issues affecting mobile devices (see #101, #104 and #105).

5.1.4 (December 3, 2017)

• Add the “Fix jQuery’s buttons” option as a workaround for conflicts with Bootstrap-based plugins and themes.

5.1.3 (November 26, 2017)

• Tested up to WordPress 4.9.
• Fix scrollLeft/scrollRight rendering on small-screen devices (see #101).

5.1.2 (October 26, 2017)

• Fix missing jQuery dependencies (possible cause of #99).

5.1.1 (October 15, 2017)

• Fix browser-related issue with the keyboard shortcut feature.

5.1 (October 15, 2017)

• Add keyboard shortcuts on the navigation board (see #48).
• Add a “Donate” button.

5.0.1 (October 14, 2017)

• Change the text domain to comply with WP.org recommendations.

5.0 (July 9, 2017)

• Tested up to WordPress 4.8.
• Allow navigation board flipping (see #70).
• Add a button to let readers download PGN data (see #78).
• Refactor file and CSS class naming.
• Improve memo/help pages to take into account theming and default settings.

4.8.1 (April 23, 2017)

• Workaround so that FEN works within bbPress content.

4.8 (April 23, 2017)

• Allow left/right alignment for diagrams (see #81).
• Minor fixes.

4.7 (January 16, 2017)

• Enable .pgn file uploading.
• Loading PGN data from a URL (see #50).

4.6.2 (January 2, 2017)

• Tested up to WordPress 4.7.
• Fix arrow refresh issue (see #76).

4.6.1 (November 12, 2016)

• Russian translation (thanks to Sergey Baravicov).

4.6 (November 6, 2016)

• Add scrollLeft/scrollRight positions for the navigation board.

4.5 (October 15, 2016)

• Add theming feature.

4.4 (August 31, 2016)

• Tested up to WordPress 4.6.
• Add keyboard shortcuts to the FEN editor (see #67).

4.3.3 (August 7, 2016)

• Fix animation not working when clicking on text moves (see #68).

4.3.2 (July 3, 2016)

• Fix wrong colorset/pieceset parameters in navigation frame (see #66).

4.3.1 (June 16, 2016)

• Tested up to WordPress 4.5.
• Minor fixes.

4.3 (March 10, 2016)

• Add colorset and pieceset customization parameters (see #13 and #29).

4.2.3 (January 21, 2016)

• Fix PGN parsing issue (see #53).

4.2.2 (December 20, 2015)

• Tested up to WordPress 4.4.
• Add cache for dynamic CSS.

4.2.1 (November 22, 2015)

• Fix rendering of NAG $11 (see #51).

4.2 (November 15, 2015)

• Add move animation and highlighting (see #39).
• Refactor organization of PHP classes.

4.1.4 (September 2, 2015)

• Tested up to WordPress 4.3.
• Turkish translation (thanks to Ali Nihat Yazıcı).

4.1.3 (August 15, 2015)

• Fix click-on-image-not-working issue in IE (see #43).

4.1.2 (August 1, 2015)

• Fix arrow-head issue in Chrome (see #40).

4.1.1 (July 27, 2015)

• Fix small-screen related issue (see #41).
• Fix navigation frame sizing issue occurring with some themes.

4.1 (July 7, 2015)

• Add: option to get navigation board above/below the move list.

4.0.2 (June 17, 2015)

• Fix syntax issue.

4.0.1 (June 17, 2015)

• Fix compatibility issue with PHP <= 5.3 (see #37).
• Force JS/CSS file reloading each time the version of the plugin changes.

4.0 (June 6, 2015)

• Add support for square highlights and arrow (see #27).
• Refactor the help pages.

3.6.2 (April 26, 2015)

• Tested up to WordPress 4.2.
• Add help on null moves.

3.6.1 (April 18, 2015)

• Null-move support (see #35).

3.6 (March 29, 2015)

• Significant code refactoring of the JavaScript chess library: do not use chess.js anymore.
• Improve FEN/PGN parsing error messages (see #11).

3.5.1 (March 15, 2015)

• Fix: make flip attribute work on tag [pgndiagram] (see #32).

3.5 (February 22, 2015)

• Add options to customize chessboard appearance on small-screen devices (see #26).

3.4.3 (January 26, 2015)

• Tested up to WordPress 4.1.
• Add: scroll the document to the selected move if it is not visible (see #28).

3.4.2 (November 23, 2014)

• Sprite system refactoring to allow responsive web design (see #26).
• Fix file-collapse issue (see #25).

3.4.1 (November 17, 2014)

• Fix localization not working on frontend.

3.4 (October 26, 2014)

• Refactor edit-FEN dialog and make it available in TinyMCE editor.

3.3 (September 6, 2014)

• Tested up to WordPress 4.0.
• Dutch translation (thanks to Ivan Deceuninck).
• Minor fixes.

3.2.3 (August 30, 2014)

• Fix issue with occurring with [pgn][/pgn] tags in non-post/page contexts.

3.2.2 (August 30, 2014)

• Fix issue with occurring with [fen][/fen] tags in non-post/page contexts.

3.2.1 (August 26, 2014)

• Fix plugin set-up for non-standard WordPress install configurations.

3.2 (August 13, 2014)

• Improve date rendering and localization.
• Minor fixes.

3.1 (July 27, 2014)

• Polish translation (thanks to Dawid Ziółkowski).
• Minor fixes.

3.0 (July 14, 2014)

• Add: cancel/reset buttons in the setting pages.
• Minor fixes.

2.99.1 (June 27, 2014)

• Fix compatibility issue with PHP <= 5.2.
• CSS classes for light- and dark-squares (see #13).

2.99 (June 16, 2014)

• Add: piece symbol customization.
• Add: navigation board next to the move list (not only in a popup frame).
• Fix several bugs related to PGN game parsing and rendering.
• Code refactoring (use the jQuery widget framework for PGN rendering in particular).
• Provide minified versions of the JS scripts.

2.4.3 (May 12, 2014)

• Plugin icon & banner.

2.4.2 (May 10, 2014)

• Update the documentation and add links toward Yo35.org.

2.4.1 (April 30, 2014)

• Improve code robustness with respect to dynamically loaded content (e.g. through AJAX requests).

2.4 (April 26, 2014)

• German translation (thanks to mliebelt).
• Fix browser compatibility issue (bug with the FEN dialog, reported as issue #5).
• PHP code refactoring (backend).

2.3.2 (April 19, 2014)

• Tested up to WordPress 3.9.
• Minor code cleaning.

2.3.1 (April 4, 2014)

• Fix warnings issued by WP in debug mode.

2.3 (March 16, 2014)

• Dialog to create/edit FEN chess diagrams in the text editor.

2.2.2 (March 13, 2014)

• Improve compatibility with IE <= 10.

2.2.1 (February 16, 2014)

• Fix parsing bug regarding castle moves with check (see #3).

2.2 (February 16, 2014)

• Faster rendering of the chess diagrams.

2.1 (January 3, 2014)

• Compatibility mode to avoid conflicts with other plugins that might use the [fen][/fen] and [pgn][/pgn] shortcodes.

2.0.1 (December 13, 2013)

• Tested up to WordPress 3.8.

2.0 (November 10, 2013)

• Add: flip attribute (to change the orientation of the chessboards).
• Auto-size the chessboard in the navigation frame generated with [pgn][/pgn].

1.99.6 (November 4, 2013)

• Documentation for the PGN tag.

1.99.5 (November 2, 2013)

• Fix issue #1.
• Documentation for the FEN tag.

1.99.4 (November 2, 2013)

• Clean the credits page in the backend.
• Fix: missing theming for the jQuery widgets in the backend.

1.99.3 (November 1, 2013)

• Fix: use the WP theming for jQuery dialogs to avoid conflicts between CSS.

1.99.2 (October 31, 2013)

• Fix: rpbchessboard.php is renamed as rpb-chessboard.php (allocated slug name on the WP repository).

1.99.1 (October 31, 2013)

• First public version.