PgnViewerJS

Beschreibung

Integration of PgnViewerJS into WordPress. This is a small layer around the original PgnViewerJS, but is needed to use it in a WordPress installation. At the end, it should provide the following interfaces:

 [pgnv]1. e4 e5 2. ...[/pgnv]

This is the PgnViewer (mostly needed): allows to play through a game (including variations), printing the comments, NAGs, …

 [pgne]1. e4 ...[/pgne]

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.

 [pgnb fen=<a FEN string>][/pgnb]

Just to display a board (only), no moves.

 [pgnp]1. e4 e5D 2. Nf3 Nc6D ...[/pgnp]

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.

Für die Liste der verfügbaren Parameter, siehe das Kapitel Häufig gestellte Fragen.

Screenshots

  • Example for use of pgnView (shortcode pgnv).
  • Example for use of pgnEdit (shortcode pgne).
  • Example for use of pgnBoard (shortcode pgnb).
  • Example for use of pgnPrint (shortcode pgnp).

Installation

  1. Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‚Plugins‘ screen in WordPress

FAQ

What parameters are available?

Die Parameter, die der Viewer versteht, sind:

  • id: May be set by the user or generated automatically by the system.
  • locale: the locale to use for displaying the moves, default is ‚en‘. Available are: cs, da, de, en, es, et, fi, fr, hu, is, it, nb, nl, pl, pt, ro, sv.
  • fen: the position where the game starts, default is the initial position.
  • showcoords: default true, if false, hides the ranks and columns on the board.
  • piecestyle: the pieces to use, default is ‚merida‘. Availabe are: ‚wikipedia‘, ‚alpha‘, ‚uscf‘, ‚case‘, ‚condal‘, ‚leipzig‘, ‚chesscom‘, ‚maya‘, ‚merida‘, and ‚beyer‘.
  • orientation: ‚white‘ or ‚black‘, default is ‚white‘.
  • theme: the theme defines the overall board, color, pieces, … Current are: green, zeit, chesscom, informator, sportverlag, beyer, falken, blue
  • boardsize: die Größe des Bretts, falls unabhängig von der Gesamtgröße gesetzt.
  • size: the size of the column to print the board, the buttons, the moves, …
  • moveswidth: used to size the width of the moves section. Needed for layout == left | right
  • movesheight: used to size the height of the moves section. Needed for layout == left | right
  • layout: top, bottom, left, right, top-left, top-right, bottom-left, bottom-right
  • startplay: der Zug, von dem das Spiel aus gestartet werden soll
  • showresult: true, if the result of the game should be shown inside the notation, default false
  • colormarker: default none, options are: cm, cm-big, cm-small, circle, circle-big, circle-small
  • notation: default short, option is: long
  • notationlayout: default inline, option is: list
  • showfen: default false, option: true. Shows an additional text editor for the FEN of the current position.
  • coordsfactor: default 1, by using a different number, coords font is grown or shrunk.
  • coordsfontsize: alternative, set the size of the font in pixel
  • timertime: default 700, number of milliseconds between moves
  • hidemovesbefore: default false, if set to true, hide the moves before move denoted by startplay

Das folgende Beispiel zeigt, wie Parameter auf einer Seite benutzt werden:

[pgnv locale=fr piecestyle=uscf orientation=black theme=zeit size=500px]1. e4 e5 2. Nf3 Nc6[/pgnv]

What if I want to use most of the parameters the same all the time?

There is a Javascript variable PgnBaseDefaults that you could set. Do the following:

  • Go as admin of your WordPress site to Appearance > Theme Editor
  • Search on the right the theme file named Theme Header (== header.php).
  • Search inside that file the section that begins with <head>.
  • Insert somewhere before the plugins are loaded the following: <script>const PgnBaseDefaults = { locale: 'de', layout: 'left', size: '720px' }</script> (of course with the defaults you like).

When you now create new pages, you can leave out the parameters you have already set per default. And you can of course overwrite them by having individual parameters set in the call.

Where can I find more information about the implementation?

Have a look at the GitHub repository https://github.com/mliebelt/PgnViewerJS-WP and the sister repository https://github.com/mliebelt/PgnViewerJS (which contains the implementation in Javascript).

Rezensionen

Für dieses Plugin gibt es keine Rezensionen.

Mitwirkende & Entwickler

„PgnViewerJS“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

„PgnViewerJS“ wurde in 1 Sprache übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „PgnViewerJS“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

1.5.13

  • Upgarde to version 1.5.13 of PgnViewerJS (so the big change in version number).
  • Remove some of the defaults, so that those defaults may be overwritten by setting PgnBaseDefault. See the FAQ to that topic.

1.1.5

  • Upgraded to version 1.5.6 of PgnViewerJS.

1.1.4

  • Updated PHP file with version as well.

1.1.3

  • Added all known parameters of PgnViewerJS of version 1.5.3
  • Ensure that all parameters are written in the correct format

1.1.2

  • Upgrade the implementation to the latest version of PgnViewerJS 1.5.3 that fixes the Fontawesome problem on theme 2021.
  • Fixed some of the whitespace bugs.

1.1.0

  • Upgrade the implementation to the latest version of PgnViewerJS.
  • Fixed some of the whitespace bugs.

0.9.8

  • Allow starting a game from a defined move.
  • Added notation for circles and arrows, with creating them in editing mode.
  • Add color marker for the player at move.
  • Show result in move list.
  • Some small bug fixes of previous versions.

0.9.7

  • Added some parameters that were now available from PgnViewerJS.
  • Replace chessboard.js by Chessground (from lichess.org)

0.9.5

  • Current version of PgnViewerJS as published on GitHub.
  • Fixed minor things by adding CSS file for WordPress only.
  • Added generation of ID if it is missing

0.9.4

  • First version made public