meinturnierplan

Roman Perevala

Matchday Blocks integrates with the MeinTurnierplan platform to let you embed live tournament data — match schedules, group standings and results — anywhere on your site using native Gutenberg blocks.
Features:
<ul>
<li>Match Schedule block — list all matches grouped by round and date</li>
<li>Standings block — show live group standings</li>
<li>Latest Matches block — display the most recently played fixtures</li>
<li>Upcoming Matches block — show the next scheduled fixtures</li>
<li>Configurable cache to reduce external API requests</li>
<li>Team logos downloaded and served locally (no third-party image requests from visitor browsers)</li>
</ul>
<h3>External Services</h3>
This plugin connects to MeinTurnierplan (<a href="https://www.meinturnierplan.de" rel="nofollow ugc">https://www.meinturnierplan.de</a>) to retrieve tournament data.
<ul>
<li>Data sent: The Tournament ID you configured in the plugin settings.</li>
<li>Data received: Match results, team names, group standings, final round fixtures and team logo URLs.</li>
<li>When: Only on the server side — when the cache is empty or expired, or when you manually clear the cache. Visitor browsers are never used to contact MeinTurnierplan.</li>
<li>Logo images: Team logos are downloaded to your WordPress uploads directory (<code>/uploads/matchday-blocks/logos/</code>) and served from your own server.</li>
</ul>
Service terms of use: <a href="https://www.meinturnierplan.de/legal.php" rel="nofollow ugc">https://www.meinturnierplan.de/legal.php</a> 
Privacy policy: <a href="https://www.meinturnierplan.de/legal.php" rel="nofollow ugc">https://www.meinturnierplan.de/legal.php</a>
<h3>Development</h3>
Source code and build tools are available at <a href="https://github.com/danfisher85/matchday-blocks" rel="nofollow ugc">GitHub Repository</a>
Prerequisites: Node.js and npm. Blocks are compiled using <code>@wordpress/scripts</code> (webpack-based). CSS is processed using PostCSS with Tailwind CSS.
To install dependencies:
<pre><code>npm install
</code></pre>
To build the plugin:
<pre><code>npm run build
</code></pre>
To watch for changes during development:
<pre><code>npm run start
</code></pre>
The <code>build/</code> directory and <code>assets/css/blocks.css</code> are generated by these commands and should not be edited directly.

Matchday Blocks

Display tournament schedules, standings and match results from MeinTurnierplan directly in your WordPress site using Gutenberg blocks.

MeinTurnierplan allows you to display tournament tables and match schedules from the MeinTurnierplan language-specific service domains on your WordPress site. Perfect for sports clubs, leagues, and tournament organizers who want to showcase standings, rankings, and match schedules on their WordPress website.
<h3>External Services</h3>
MeinTurnierplan Service (Language Mirrors)
This plugin uses language-specific service domains for both displaying tournament content and retrieving tournament configuration data.
Domain selection by language:
<ul>
<li>German (<code>de</code>) -> <code>https://www.meinturnierplan.de</code></li>
<li>English (<code>en</code>) -> <code>https://tournamentbase.com</code></li>
<li>French (<code>fr</code>) -> <code>https://tournoiplus.fr</code></li>
<li>Polish (<code>pl</code>) -> <code>https://turniej.pl</code></li>
<li>Spanish (<code>es</code>) -> <code>https://torneo.es</code></li>
<li>Italian (<code>it</code>) -> <code>https://torneo.it</code></li>
<li>Slovenian (<code>sl</code>) -> fallback <code>https://www.meinturnierplan.de</code></li>
<li>Croatian (<code>hr</code>) -> fallback <code>https://www.meinturnierplan.de</code></li>
<li>Turkish (<code>tr</code>) -> fallback <code>https://www.meinturnierplan.de</code></li>
</ul>
What it does:
<ol>
<li>
Frontend Display (Public-Facing):
<ul>
<li>Displays tournament tables and match schedules to site visitors via iframe embeds</li>
<li>Endpoints Used:</li>
<li><code>https://{language-domain}/displayTable.php</code> (for tournament standings)</li>
<li><code>https://{language-domain}/displayMatches.php</code> (for match schedules)</li>
<li>When: When a visitor loads a page with tournament content (shortcode, block, or widget)</li>
</ul>
</li>
<li>
Admin Configuration (Admin Area Only):
<ul>
<li>Provides tournament structure data via JSON API to help administrators configure displays</li>
<li>Endpoint Used:</li>
<li><code>https://{language-domain}/json/json.php</code> (tournament structure data)</li>
<li>When: Only in WordPress admin area when:
<ul>
<li>Administrator enters a Tournament ID in settings</li>
<li>Administrator clicks “Refresh Groups” or similar refresh buttons</li>
<li>Admin preview is loaded or refreshed</li>
</ul>
</li>
<li>What it retrieves:
<ul>
<li>Tournament groups/divisions structure</li>
<li>Team lists and names</li>
<li>Tournament options (showCourts, showGroups, showReferees, finalMatches)</li>
</ul>
</li>
<li>Purpose:
<ul>
<li>Auto-populate group selection dropdowns in admin interface</li>
<li>Determine which features are available for the tournament</li>
<li>Provide better admin user experience with automatic configuration</li>
</ul>
</li>
<li>Data cached: Retrieved data is cached for 15 minutes to minimize API calls</li>
<li>NOT used on frontend: JSON API is only contacted from WordPress admin area, never from public-facing pages</li>
</ul>
</li>
</ol>
<ul>
<li>Data Sent: Tournament ID only (no personal data, no user information)</li>
<li>Privacy Policy and Terms are available on the selected language domain under <code>/legal.php</code>, e.g. <code>https://www.meinturnierplan.de/legal.php</code></li>
</ul>
What the Embedded Widgets Collect:
The embedded widgets:
<ul>
<li>NO tracking scripts – The embedded widgets do not use Google Analytics or any other analytics services</li>
<li>NO cookies – The widgets do not set any cookies in users’ browsers</li>
<li>NO third-party resources – The widgets only load CSS styling from the selected service domain (no Google Fonts, AdSense, or other external services)</li>
<li>Communication: The widgets only use JavaScript to send iframe dimensions to your page for proper display sizing (via postMessage API)</li>
</ul>
What Data May Be Collected:
When users view embedded tournament content, the selected service domain’s web server may automatically log:
<ul>
<li>IP addresses (standard web server logs)</li>
<li>Browser type and version (from User-Agent header)</li>
<li>Referrer URL (your website where the widget is embedded)</li>
<li>Access timestamp</li>
</ul>
This is standard web server logging and does not involve cookies, tracking scripts, or persistent user identification.
<h3>Privacy Notice</h3>
This plugin itself does not:
<ul>
<li>Track users</li>
<li>Collect personal data</li>
<li>Use cookies or localStorage</li>
<li>Send personal or sensitive data to any server</li>
</ul>
Data Transmission: 
The only data sent by this plugin is the Tournament ID to the selected service domain when you explicitly add tournament content (via shortcode, block, or widget) to display on your pages.
Embedded Widget Behavior: 
The embedded widgets from the selected service domain:
<ul>
<li>Do NOT use tracking scripts (no Google Analytics in widgets)</li>
<li>Do NOT set cookies</li>
<li>Do NOT load third-party services (no Google Fonts, AdSense, etc.)</li>
<li>Only communicate iframe dimensions back to your page for proper display</li>
</ul>
Standard Web Server Logging: 
Like any web resource, the selected service domain’s servers may log standard HTTP request data (IP address, browser type, referrer, timestamp) when serving the embedded content. This is standard practice for all web servers and does not involve user tracking or cookies.
No Consent Required: 
Because the embedded widgets do not use cookies, tracking scripts, or persistent user identification, no additional cookie consent is required beyond standard web server logging disclosure in your privacy policy.
<h4>Available Languages</h4>
The plugin is available in the following languages:
<ul>
<li>English</li>
<li>German (Deutsch)</li>
<li>Spanish (Español)</li>
<li>French (Français)</li>
<li>Italian (Italiano)</li>
<li>Polish (Polski)</li>
<li>Croatian (Hrvatski)</li>
<li>Slovenian (Slovenščina)</li>
<li>Turkish (Türkçe)</li>
</ul>
<h4>Key Features</h4>
Two Custom Post Types:
<ul>
<li>Tournament Tables – Display standings, rankings, and statistics</li>
<li>Match Lists – Display scheduled matches and results</li>
</ul>
Multiple Display Methods:
<ul>
<li>Gutenberg Blocks – Native block editor support for both tables and matches</li>
<li>Shortcodes – <code>[mtrn-table]</code> and <code>[mtrn-matches]</code> with extensive customization options</li>
<li>Widgets – Legacy widget support for both content types</li>
</ul>
Extensive Customization:
<ul>
<li>Control colors, fonts, borders, and spacing</li>
<li>Toggle visibility of specific columns (wins, losses, logos, etc.)</li>
<li>Customize styling options (colors, fonts, spacing)</li>
<li>Real-time preview while editing in the admin area</li>
</ul>
Additional Features:
<ul>
<li>External integration with tournament management systems via IDs</li>
<li>Responsive design – Mobile-friendly styling with automatic adjustments</li>
<li>AJAX-powered live preview in admin area</li>
<li>Automatic display on single custom post type pages</li>
</ul>
<h4>Usage</h4>
After activation, navigate to Tournament Tables or Tournament Match Lists in the admin menu to create your first content. You can then display your content using:
<ol>
<li>Gutenberg Blocks – Add the Tournament Table or Tournament Match List block to any post or page</li>
<li>Shortcodes – Use <code>[mtrn-table id="123"]</code> or <code>[mtrn-matches id="456"]</code></li>
<li>Widgets – Add the Tournament Table or Tournament Match List widget to any widget area</li>
<li>Automatic Display – Visit single tournament table or match list pages directly</li>
</ol>
<h4>Shortcode Examples</h4>
Tournament Table:
<ul>
<li><code>[mtrn-table id="external-id"]</code></li>
<li><code>[mtrn-table post_id="123"]</code></li>
<li><code>[mtrn-table id="external-id" lang="de" group="A"]</code></li>
</ul>
Matches:
<ul>
<li><code>[mtrn-matches id="external-id"]</code></li>
<li><code>[mtrn-matches post_id="456"]</code></li>
<li><code>[mtrn-matches id="external-id" lang="de" group="A"]</code></li>
</ul>
<h4>Links</h4>
<ul>
<li><a href="https://github.com/AL1337/meinturnierplan" rel="nofollow ugc">GitHub Repository</a></li>
<li><a href="https://www.meinturnierplan.de" rel="nofollow ugc">Plugin Website</a></li>
</ul>
<h3>Development</h3>
The plugin follows WordPress coding standards and best practices:
<ul>
<li>Security – Proper sanitization, validation, and nonce verification</li>
<li>Internationalization – Full i18n support with text domain <code>meinturnierplan</code></li>
<li>Modern WordPress – Support for Gutenberg blocks and REST API</li>
<li>Clean Architecture – Separation of concerns with dedicated classes for each feature</li>
<li>Object-Oriented – Class-based structure with singleton pattern</li>
<li>AJAX Integration – Real-time preview functionality</li>
</ul>
<h3>Support</h3>
For issues, feature requests, and contributions, please visit: 
<a href="https://github.com/AL1337/meinturnierplan" rel="nofollow ugc">GitHub Repository</a>

MeinTurnierplan


Macht was es soll und zeigt Tabellen und/oder Ergebnislisten live auf der Seite an. Sehr einfach zu bedienen, man braucht nur die Turnier-ID die man von MeinTurnierplan hat. Easy!


MeinTurnierplan macht was es soll!

Display tournament tables and match lists using custom post types, supporting Gutenberg blocks, widgets, and shortcodes.

Matchday Blocks vs MeinTurnierplan