Chessdiagram

chessdiagram plugin by Michael Arlt
Format a chess board using FEN notation or an alternative 8x8-layout

Last updated on 2008-02-24. Provides Syntax.
Compatible with DokuWiki 2006-11-06, 2007-06-26b.

Similar to godiag, weiqi.

Tagged with diagram, game, images, media.

    Description

    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 http://www.vyvy.org/ 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. It was primarily developed for b2evolution.

    Syntax

    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)

    <chessdiagram>
    # FEN
    7k/6p1/3r1pPp/pp2pP2/2p1P1R1/2P1q3/PQ4RK/3r4
    </chessdiagram>
    <chessdiagram>
    # Alternative 8x8 version
    r---k--r
    -q---ppp
    p---p---
    --b-P---
    p--N-Q--
    P-------
    -PP---PP
    ---R-R-K
    </chessdiagram>
    <chessdiagram>
    # options: light(white) corner in the upper left, 4 columns, borders top, bottom=unten, right
    (l4TRB)3k/4/4/4/4/4/2R1/3R
    </chessdiagram>

    German version (default installation)

    <schachdiagramm>
    # FEN - only the start- and endpattern is localized
    7k/6p1/3r1pPp/pp2pP2/2p1P1R1/2P1q3/PQ4RK/3r4
    </schachdiagramm>
    <schachdiagramm>
    # Alternative 8x8 version - even the figures are localized (you decide)
    t---k--t
    -d---bbb
    b---b---
    --l-B---
    b--S-D--
    B-------
    -BB---BB
    ---T-T-K
    </schachdiagramm>
    <schachdiagramm>
    # options: white corner in the upper left, 4 columns, borders top=oben, bottom=unten, right=rechts
    (w4ORU)3k/4/4/4/4/4/2R1/3R
    </schachdiagramm>

    Localisation

    $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 ()

    Screenshot

    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:
      • make a backup of this file
      • add one of the diffs to this file
    • cleanup cache

    Change History

    2008-02-24

    • Added security (thanks to Andy Webber)

    2007-10-18

    • Removed FEN diagnostic output

    2006-11-16

    • 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

    2006-11-15

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

    License

    This product is released under the GPL 2

    Discussion

    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: 2009/10/07 16:40 by laynee
     
    Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
    Imprint Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
    WikiForumIRCBugsGitXRefTranslate