mliebelt

<p>Integration of @mliebelt/pgn-viewer into WordPress (formarly named PGNViewerJS).</p>
<h3>Using Shortcodes</h3>
<p>To use a shortcode, do the following steps:</p>
<ol>
<li>Enter on a new element <code>/shortcode</code>.</li>
<li>Enterinside the element then the shortcode including the content of the following sections.</li>
</ol>
<h3>Basic View</h3>
<pre><code> [pgnv]1. e4 e5 2. ...[/pgnv]
</code></pre>
<p>This is the PgnViewer (mostly needed): allows to play through a game (including variations), printing the comments, NAGs, …</p>
<h3>Edit Mode</h3>
<pre><code> [pgne]1. e4 ...[/pgne]
</code></pre>
<p>Allows to edit and view a game. At the end, you may use the PGN button to display the notation,  that then may be copied again in the WordPress post entry.</p>
<h3>Single Position (or Board)</h3>
<pre><code> [pgnb fen=<a FEN string>][/pgnb]
</code></pre>
<p>Just to display a board (only), no moves. Leave out the pgn, if possible. If pgn is included, it will be checked and has to be correct (but not shown at the end).</p>
<h3>Print View</h3>
<pre><code> [pgnp]1. e4 e5D 2. Nf3 Nc6D ...[/pgnp]
</code></pre>
<p>Allows to print a game in a format similar to magazines and books. For that purpose, the notation  of PGN was expanded by the “D” at the end of a move, that stands for the diagram. (Caveat: “D” is currently not working, and leading to an error. See issue <a href="https://github.com/mliebelt/pgn-viewer/issues/580" rel="nofollow ugc">#580</a> about that.)</p>
<p>For a list of available parameters, look into the Frequently Asked Questions.</p>
<h3>Using Block Level Element</h3>
<p>You can use instead the following:</p>
<ol>
<li>Enter as block element <code>/PGN Viewer Block Editor</code>, in the variants <code>View</code>, <code>Edit</code>, <code>Board</code> or <code>Print</code>.</li>
<li>You will then have a form with all options that are possible with the shortcode as well.</li>
<li>Depending on the kind of element you want to have, different values are needed:
<ul>
<li>View: all possible</li>
<li>Edit: same as view</li>
<li>Board: only FEN and layout elements of the board</li>
<li>Print: most not needed.</li>
</ul>
</li>
</ol>


PgnViewerJS

Integration of @mliebelt/pgn-viewer into WordPress (formarly named PGNViewerJS).

<p>Integrate  the chess board of ChessTempo for some of the options).</p>
<p>See <a href="http://chesstempo.com/pgn-usage.html" rel="nofollow ugc">ChessTempo PGN Viewer Usage</a> for all the parameters available, this plugin<br />
 only translates them to WordPress.</p>
<p>Use following tag to insert a chessboard:</p>
<pre><code>[ctpgn parameter=value ...]
... chess games in PGN format ...
[/ctpgn]
</code></pre>
<p>Tag parameters:</p>
<ul>
<li>pgnFile: URL to the pgn file. If you want to embed the PGN directly, embed it like the example below. <strong>(This parameter is not implemented yet)</strong></li>
<li>pieceSet: possible are ‘merida’ (the default), ‘leipzig’, ‘maya’, ‘condal’, ‘case’ and ‘kingdom’</li>
<li>pieceSize: The size of the pieces to use in pixels, currently supported sizes are ’20’, ’24’, ’29’, ’35’, ’40’ and ’46’. Default size is 46</li>
<li>fen: The fen string if the game does not start from the beginning position</li>
<li>movesFormat: The style of formatting for the moves display, either “default” or “main_on_own_line” for a<br />
 display which puts the main line moves on their own line with the annotations/variations indented below the main line.</li>
<li>layout: top (default), bottom, left or right. top means board is on top, moves below, bottom vice versae. left<br />
 sets the board on the top left, and the moves flow on the right and below, right sets the board on the right, and moves<br />
 flow on the left and below.</li>
<li>id: name of the board on the page. Only necessary, if there is more than one board on the page. The names<br />
 have to be unique per page, not globally.</li>
</ul>
<p>Example:</p>
<pre><code>[ctpgn id=fen fen="r5k1/ppqb2pp/2n1pr2/3pN1QP/2pP2B1/P1P5/2P2PP1/R3R1K1 w - - 0 23"]
    23. Nxd7 {verwundert schlug Schwarz den Springer} Qxd7 24. Qxf6 {Schwarz fällt aus allen Wolken!} gxf6
    25. Bxe6+ Qxe6 26. Rxe6 {der Rest ist Sache der Technik} Kf7 27. Rd6 Rd8 28. Rxd8 Nxd8 29. f4 Ne6
    30. g3 Ng7 31. g4 f5 32. h6 Ne6 33. gxf5 Nxf4 34. Kf2 Kf6 35. Kf3 Kxf5 36. a4 Ng6 37. a5 Kg5
    38. Rb1 b6 39. Rxb6 Kxh6 40. Ra6 Kg5 41. Rxa7 h5 42. Rg7 {und Schwarz gibt auf} * [/ctpgn]
</code></pre>
<h3>Examples</h3>
<p>The following examples show most of the features that are available.</p>
<p>First example with using a FEN string for the situation, and starting from there. Comments are given in braces.</p>
<pre><code>[ctpgn id=fen fen="r5k1/ppqb2pp/2n1pr2/3pN1QP/2pP2B1/P1P5/2P2PP1/R3R1K1 w - - 0 23"]
   23. Nxd7 {verwundert schlug Schwarz den Springer} Qxd7 24. Qxf6 {Schwarz fällt aus allen Wolken!} gxf6
   25. Bxe6+ Qxe6 26. Rxe6 {der Rest ist Sache der Technik} Kf7 27. Rd6 Rd8 28. Rxd8 Nxd8 29. f4 Ne6
   30. g3 Ng7 31. g4 f5 32. h6 Ne6 33. gxf5 Nxf4 34. Kf2 Kf6 35. Kf3 Kxf5 36. a4 Ng6 37. a5 Kg5
   38. Rb1 b6 39. Rxb6 Kxh6 40. Ra6 Kg5 41. Rxa7 h5 42. Rg7 {und Schwarz gibt auf} * [/ctpgn]
</code></pre>
<p>Now a whole game, with only some comments.</p>
<pre><code>[ctpgn id=demo] 1. e4 c5 2. Nf3 d6 3. c3 g6 4. d4 Bg7 {richtig wäre cxd4} 5. dxc5 dxc5 $2 6. Qxd8+ Kxd8 7. Be3 b6
8. Bc4 Be6 $4 9. Bxe6 fxe6 10. Ng5 Kc8 {Qualitäts- oder Firgurenverlust ist nicht zu vermeiden}
11. Nf7 Nc6 12. Nd2 Nf6 13. Nxh8 Bxh8 14. f3 e5 $2 {sperrt seinen Läufer ein, der erst einmal nicht mehr mitspielt}
15. a4 Kb7 16. Ke2 Nh5 17. g3 Ng7 18. Rhd1 Rd8 19. Nc4 Ne6 20. Rxd8 Nexd8 21. Bf2 Kc7 22. a5 Nb7 23. axb6+ axb6
24. Ra8 Bf6 25. Ne3 e6 26. Rf8 Be7 27. Rh8 h5 28. Rh6 Bg5 29. Rxg6 Bxe3 {Schwarz gibt in hoffnungsloser Stellung auf} * [/ctpgn]
</code></pre>
<p>Again the finish of a game with the result. See the variations with their syntax, they are tricky (at the moment).</p>
<pre><code>[ctpgn id=markus fen="4r1k1/1p1q3p/p5r1/3n4/3p4/bP1P3P/P1R2BP1/3Q1RK1 b - - 0 36"]
36. .. Ne3 ( 36. .. Qxh3 37. Bxd4 (37. Bg3 Rxg3 {typische Fritz-Züge}) 37. .. Bd6 38. Re1
(38.  g4 Rxg4+ {gewinnt schneller}) 38. .. Qh2+ 39. Kf1 Qh1+ 40. Bg1 Rf8+ 41. Qf3 Rxf3+ 42. gxf3 Qxg1+
43. Ke2 Re6+ 44. Kd2 Qxe1#) 37. Bxe3 Rxe3 38. Qh5 Rxh3 39.  Qxg6+ {Verzweifelung} hxg6
40. gxh3 Qxh3 41. Rcf2 Qxd3 42. Rf7 Qg3+ 43. Kh1 d3 (43. .. Qh3+ 44. Kg1 d3 {geht noch schneller})
44. R7f3 Qh4+ 45. Kg2 d2 46. Rd3 Qe4+ 47. Rff3 Qe2+ 48. Kg3 d1=Q {sollte reichen, Weiß gibt auf} 0-1 [/ctpgn]
</code></pre>


Chess Tempo Viewer

Integrates the chess board of ChessTempo into WordPress. Pure implementation with most of the features of ChessTempo.

PgnViewerJS vs Chess Tempo Viewer