MeinTurnierplan

Description

MeinTurnierplan allows you to display tournament tables and match schedules from meinturnierplan.de 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.

External Services

MeinTurnierplan.de Service

This plugin uses MeinTurnierplan.de for both displaying tournament content and retrieving tournament configuration data.

What it does:

1. Frontend Display (Public-Facing):

   • Displays tournament tables and match schedules to site visitors via iframe embeds
   • Endpoints Used:
     • https://www.meinturnierplan.de/displayTable.php (for tournament standings)
     • https://www.meinturnierplan.de/displayMatches.php (for match schedules)
   • When: When a visitor loads a page with tournament content (shortcode, block, or widget)

2. Admin Configuration (Admin Area Only):

   • Provides tournament structure data via JSON API to help administrators configure displays
   • Endpoint Used:
     • https://www.meinturnierplan.de/json/json.php (tournament structure data)
   • When: Only in WordPress admin area when:
     • Administrator enters a Tournament ID in settings
     • Administrator clicks “Refresh Groups” or similar refresh buttons
     • Admin preview is loaded or refreshed
   • What it retrieves:
     • Tournament groups/divisions structure
     • Team lists and names
     • Tournament options (showCourts, showGroups, showReferees, finalMatches)
   • Purpose:
     • Auto-populate group selection dropdowns in admin interface
     • Determine which features are available for the tournament
     • Provide better admin user experience with automatic configuration
   • Data cached: Retrieved data is cached for 15 minutes to minimize API calls
   • NOT used on frontend: JSON API is only contacted from WordPress admin area, never from public-facing pages

• Data Sent: Tournament ID only (no personal data, no user information)
• Privacy Policy: https://www.meinturnierplan.de/legal.php?t=privacy&v=2019-04-20&l=en
• Terms of Service: https://www.meinturnierplan.de/legal.php?t=tou&v=2019-04-20&l=en

What the Embedded Widgets Collect:

The embedded widgets:

• NO tracking scripts – The embedded widgets do not use Google Analytics or any other analytics services
• NO cookies – The widgets do not set any cookies in users’ browsers
• NO third-party resources – The widgets only load CSS styling from meinturnierplan.de (no Google Fonts, AdSense, or other external services)
• Communication: The widgets only use JavaScript to send iframe dimensions to your page for proper display sizing (via postMessage API)

What Data May Be Collected:

When users view embedded tournament content, meinturnierplan.de’s web server may automatically log:

• IP addresses (standard web server logs)
• Browser type and version (from User-Agent header)
• Referrer URL (your website where the widget is embedded)
• Access timestamp

This is standard web server logging and does not involve cookies, tracking scripts, or persistent user identification.

Privacy Notice

This plugin itself does not:

• Track users
• Collect personal data
• Use cookies or localStorage
• Send personal or sensitive data to any server

Data Transmission:
The only data sent by this plugin is the Tournament ID to meinturnierplan.de when you explicitly add tournament content (via shortcode, block, or widget) to display on your pages.

Embedded Widget Behavior:
The embedded widgets from meinturnierplan.de:

• Do NOT use tracking scripts (no Google Analytics in widgets)
• Do NOT set cookies
• Do NOT load third-party services (no Google Fonts, AdSense, etc.)
• Only communicate iframe dimensions back to your page for proper display

Standard Web Server Logging:
Like any web resource, meinturnierplan.de’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.

Key Features

Two Custom Post Types:

• Tournament Tables – Display standings, rankings, and statistics
• Match Lists – Display scheduled matches and results

Multiple Display Methods:

• Gutenberg Blocks – Native block editor support for both tables and matches
• Shortcodes – [mtrn-table] and [mtrn-matches] with extensive customization options
• Widgets – Legacy widget support for both content types

Extensive Customization:

• Control colors, fonts, borders, and spacing
• Toggle visibility of specific columns (wins, losses, logos, etc.)
• Customize styling options (colors, fonts, spacing)
• Real-time preview while editing in the admin area

Additional Features:

• External integration with tournament management systems via IDs
• Responsive design – Mobile-friendly styling with automatic adjustments
• AJAX-powered live preview in admin area
• Automatic display on single custom post type pages

Usage

After activation, navigate to Tournament Tables or Matches in the admin menu to create your first content. You can then display your content using:

1. Gutenberg Blocks – Add the Tournament Table or Matches block to any post or page
2. Shortcodes – Use [mtrn-table id="123"] or [mtrn-matches id="456"]
3. Widgets – Add the Tournament Table or Matches widget to any widget area
4. Automatic Display – Visit single tournament table or match list pages directly

Shortcode Examples

Tournament Table:

• [mtrn-table id="external-id"]
• [mtrn-table post_id="123"]
• [mtrn-table id="external-id" lang="de" group="A"]

Matches:

• [mtrn-matches id="external-id"]
• [mtrn-matches post_id="456"]
• [mtrn-matches id="external-id" lang="de" group="A"]

Links

• GitHub Repository
• Plugin Website

Development

The plugin follows WordPress coding standards and best practices:

• Security – Proper sanitization, validation, and nonce verification
• Internationalization – Full i18n support with text domain meinturnierplan
• Modern WordPress – Support for Gutenberg blocks and REST API
• Clean Architecture – Separation of concerns with dedicated classes for each feature
• Object-Oriented – Class-based structure with singleton pattern
• AJAX Integration – Real-time preview functionality
• Responsive Design – Mobile-first approach with CSS breakpoints

Support

For issues, feature requests, and contributions, please visit:
GitHub Repository

Credits

Developed by Roman Perevala