ChessPairings — Tournament Showcase
| 开发者 | stefanoloberti |
|---|---|
| 更新时间 | 2026年8月15日 23:19 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
ChessPairings — Tournament Showcase is a "showcase" plugin that integrates tournaments managed on the SaaS platform my.chesspairings.org into your WordPress site.
The plugin does not manage tournaments inside WordPress: pairing generation, result entry, player management, Telegram notifications, auto-publishing to chess-results.com and everything else stays on my.chesspairings.org. The plugin simply displays your tournament data on your WP site, using native HTML that inherits your theme's styles.
What you can do with the plugin:
- Show standings with tiebreaks
- Show pairings by round
- Show the registered players list (or teams + roster for team tournaments)
- Show the tournament announcement / regulations
- Add a "Register" button linking to the online registration form
- Publish a calendar of your tournaments or the community calendar (by federation)
- List all your tournaments with cards — status, dates, registration button
- Display a full tournament page with tabs (info / registered / pairings / standings)
- Select a tournament by name in Gutenberg, with a real editor preview
- Automatically show the current, next or most recently completed tournament
- Show the published round schedule and progress
- Search and sort frontend tables, print views and optionally auto-refresh them
- Download tournament dates in iCalendar format
- Keep showing the last valid data during temporary API outages
- Native HTML that inherits the theme's styles (fonts, colors, spacing)
- SEO-friendly (indexable content, not in an iframe)
- Mobile responsive by default
- Automatic caching to avoid overloading the API (configurable 30–300s)
安装:
- Upload the
chesspairingsfolder towp-content/plugins/(or install the zip from the WordPress admin panel). - Activate the plugin from the Plugins menu.
- Go to Settings → ChessPairings.
- Generate an API key from your my.chesspairings.org profile (API tab → Generate token).
- Paste the token in the settings page and click Verify connection.
- Add a shortcode to any page or post:
[chesspairings_torneo id="123"]屏幕截图:
常见问题:
Do I need a ChessPairings account?
Yes, it's free. Register on my.chesspairings.org, create your tournaments there, then install the plugin to display them on your WP site.
Can I customize the look of the tables?
Yes, in two ways:
- The plugin uses CSS variables that auto-adapt to the theme. You can override them with custom CSS.
- Every template is override-able from the theme: copy a file from
chesspairings/templates/toyour-theme/chesspairings/and modify it.
How heavy is the API load per page view?
Responses are cached for 60s by default (configurable 30–300s). So even with 100 visits per minute, the API receives ~1 call per minute per shortcode.
Can I show private tournaments?
Yes, as long as the tournament belongs to the API key owner. Visibility (public/private) only controls whether it appears in the community calendar.
What happens if my.chesspairings.org is temporarily unreachable?
With resilient cache enabled (the default), the plugin displays the last valid response for up to 24 hours and marks it with its update time. If no previous response exists, it shows an inline error message. The rest of your WP site is unaffected.
Does the plugin send data to my visitors?
No. The plugin calls the API server-side from WordPress — no client-side JS fetch. No cookies, no trackers.
更新日志:
0.2.0
- Added: searchable tournament selector and real API preview in the Gutenberg editor.
- Added: Gutenberg views and controls for tournament lists, round schedules, filters, limits, layouts and initial tabs.
- Added: automatic selection of the current, next or most recently completed tournament.
- Added:
[chesspairings_turni]round schedule shortcode for individual and team tournaments. - Added: progressive frontend search, sortable tables, print controls and optional timed refresh.
- Added: signed iCalendar downloads and SportsEvent structured data.
- Added: resilient 24-hour last-known-good cache for temporary API failures.
- Added: shortcode generator and API/cache diagnostics in Settings.
- Security: editor REST endpoints require editing permissions and never return the API key.
- Compatibility: all enhancements retain a complete server-rendered fallback for WordPress 5.8+.
- Fixed: public and registration links now use the complete tokenized URLs returned by the API.
- Fixed: registration buttons respect the online-registration setting and fail closed on API errors.
- Fixed: team registration and announcement blocks now use their team-specific endpoints.
- Fixed: team match scores support both current and legacy API response shapes.
- Fixed: public links preserve the WordPress site language.
- Fixed: tab and round navigation no longer collides when multiple tournament blocks share a page.
- Security: API messages are rendered as text in the admin page and cache keys hash the complete API token.
- Changed: Gutenberg asset versions now match the plugin version.
- Fixed: inline scripts now properly enqueued via wp_enqueue_script.
- Fixed: text domain aligned to plugin slug.
- Added: external services section with Terms of Service and Privacy Policy links.
- First release: 12 shortcodes + Gutenberg block + overridable templates + 7 languages.