- Gutenberg block to integrate a ranking from a SAMS source
- Gutenberg block to integrate a fixtures from a SAMS source
I administrated the homepage of my hometown volleyball club for nearly two decades and for a long time there was no official way to integrate up-to-date results and fixtures. So one had to update the information by hand or scrape the content from the leagues official results service.
Some years ago now we got access to the official XML API of the national german volleyball confederation DVV (Deutscher Volleyballverband) of their league management tool SAMS.
Because we just migrated the site to WordPress I headed straight into developing a WordPress plugin to integrate the results and fixtures for our teams. In the first version (before Gutenberg editor released) the Integration was using a shortcode - but it had some flaws and was not that intuitive.
So I decided to change the plugin to migrate to Gutenberg blocks one can integrate just right into the WYSIWYG editor.
The current version is still in a early stage and there are plans to make it more user-friendly and intuitive. Anyhow with this first refactored version I decided to publish the SAMS Integration Plugin to the official WordPress Plugin Directory so it will become as easy as possible to integrate the plugin in your WordPress environment.
Will be documented when the release acknoledged by the WordPress Plugins team.
- Download the latest release from the Release page here at GitHub
- Login to your WordPress Admin Control Panel and browse to
Plugins->Install Plugin - Click
Upload Pluginand select the downloaded Release zip-file
Will be updated when the entry in the plugin directory is ready
The SAMS XML-interface is described in the following wiki: XML Schnittstelle
Since version 1.2.0 you are able to override the default representation of the ranking and the fixtures view.
Just add a new template file to the folder of your currently used theme:
- Ranking:
sams-integration/ranking-template.php - Fixtures:
sams-integration/fixtures-template.php
You can find the default implementation in the sams-integration/build/php/templates/ folder to get a starting point how things are working.
Perhaps some additional customizations will be added in the future (e.g. the format of the fixtures venues).
This piece of modern art is published with a GNU GPLv2 license. I will not take charge of any harm, damages or data losses that could be caused by this plugin. Use it on your own risk.
Feel free to create an issue, pull request or get in contact with me.