It's better when it's simple

User Tools

Site Tools


Chessdiagram Plugin

Compatible with DokuWiki

2006-11-06, 2007-06-26b

plugin Format a chess board using FEN notation or an alternative 8x8-layout

Last updated on

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with diagram, game, images, media


Chessdiagram converts FEN notation or an alternative 8×8-layout to a chess diagram using HTML with 8×8 images. The syntax can be localized - completely. English and German is available.

Thanks to ...

To achieve this i embedded PHP code from vyvy at (obsolete) which completely renders the chess diagram. The rest was simply a plugin template extended with the localization features and optimizing the chess images.

Many thanks to this really great plugin. Further information is available on the original website (obsolete). It was primarily developed for b2evolution.


Copy the FEN syntax between <chessdiagram></chessdiagram> or simply add an 8×8 ASCII board with the English abbreviations (kqrbnp).

You can add advanced options with “(flags)” before the chessdiagram (in both variants). Flags can be:

  • Borders: T B L R for top, bottom, left and right borders
  • Number of fields (width): positive integer
  • Colour of upper left corner: l d for light(white) or dark(black)

Fields can be marked with the character “x”.

In the german translation TBLR can be achived with OULR (oben, unten, links, rechts) and “w” or “s” is used instead of l or d (weiss, schwarz). It is up to the administrator of your site.

English version (default installation)

# Alternative 8x8 version
# options: light(white) corner in the upper left, 4 columns, borders top, bottom=unten, right

German version (default installation)

# FEN - only the start- and endpattern is localized
# Alternative 8x8 version - even the figures are localized (you decide)
# options: white corner in the upper left, 4 columns, borders top=oben, bottom=unten, right=rechts


$lang['kwpattern'] = 'schachdiagramm'; // Your Wikisyntax for chessdiagram (German example)
$lang['kwpieces']  = 'kdtlsbKDTLSBT';  // Your Wikisyntax for king, queen, rock, bishop, knight, pawn
                                       // Lower case is black upper is white
$lang['kwoptions'] = 'OULRws';         // Your Wikisyntax for top bottom left right white black - concerns options in ()


This is a screenshot of the first FEN diagram above.

This is a screenshot of the second FEN diagram above.

Download / Installation

Install the current release with the plugin manager.

Adding a button to the toolbar

I included a folder “toolbar” with an image and a localized diff for the toolbar.php.

  • mv chessdiagram.png to lib/images/toolbar
  • inc/toolbar.php
    • make a backup of this file
    • add one of the diffs to this file
  • cleanup cache

Change History


  • Added security (thanks to Andy Webber)


  • Removed FEN diagnostic output


  • Second public release - Mea culpa! :-)
  • Path-through of code to the forgotten features of the original PHP implementation → additional features:
    • Mark fieds
    • Draw only parts of a diagram


  • First public release
  • All desired features of the author are implemented
  • Embedded version 1.0 of chessboard from vyvy


This product is released under the GPL 2


Is there an easy way to suppress the FEN notation? In the standard installation, the string describing the board is always displayed before the board!

–> download the new release

plugin/chessdiagram.txt · Last modified: 2014-05-03 13:11 by