Popis
ChessPairings — Tournament Showcase je plugin typu „showcase“, který do vašeho webu WordPress integruje turnaje spravované na platformě SaaS my.chesspairings.org.
Plugin nespravuje turnaje přímo ve WordPressu: generování párů, zadávání výsledků, správu hráčů, oznámení v Telegramu, automatické zveřejňování na chess-results.com ani žádné další funkce – to vše zůstává na my.chesspairings.org. Plugin pouze zobrazuje data o vašich turnajích na vašem webu WP, a to pomocí nativního HTML, které přebírá styly vašeho šablony.
Co můžete s tímto pluginem dělat:
- Zobrazit tabulku s rozstřely
- Zobrazit dvojice podle kol
- Zobrazit seznam registrovaných hráčů (nebo týmy + soupisky v případě týmových turnajů)
- Zobrazit oznámení o turnaji / pravidla
- Přidejte tlačítko „Registrovat“ s odkazem na online registrační formulář
- Zveřejněte kalendář svých turnajů nebo komunitní kalendář (podle federace)
- Zobrazit seznam všech vašich turnajů s kartami – stav, termíny, tlačítko pro registraci
- Zobrazit kompletní stránku turnaje s kartami (informace / přihlášení / losování / pořadí)
- 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
Výhody oproti iframe nebo snímku obrazovky:
- Nativní HTML, které přebírá styly motivu (písma, barvy, mezery)
- Optimalizováno pro SEO (obsah, který lze indexovat, není vložen do iframe)
- Ve výchozím nastavení přizpůsobeno pro mobilní zařízení
- Automatické ukládání do mezipaměti, aby se zabránilo přetížení API (nastavitelné v rozmezí 30–300 s)
Účet ChessPairings: plugin vyžaduje bezplatný účet na my.chesspairings.org a bezplatný API klíč vygenerovaný z vašeho profilu. Tato SaaS platforma je zcela zdarma.
Jazyky: plugin je přeložen do 7 jazyků: angličtina, italština, španělština, francouzština, němčina, ruština, čeština.
Dostupné zkrácené kódy
Jednotlivé turnaje:
[chesspairings_torneo id="N"]— kompletní stránka turnaje s kartami[chesspairings_classifica id="N"]— pouze tabulka[chesspairings_abbinamenti id="N" turno="ultimo"]— rozlosování pro dané kolo[chesspairings_iscritti id="N"]— seznam registrovaných hráčů[chesspairings_turni id="N"]— published round schedule and progress[chesspairings_bando id="N"]— oznámení o turnaji[chesspairings_iscriviti id="N"]— tlačítko pro registraci[chesspairings_tornei]— přehled turnajů s kartami (stav, termíny, registrace)[chesspairings_calendario type="miei"]— kalendář turnajů (miei | komunita)
Týmové turnaje:
[chesspairings_torneo_squadre id="N"]— stránka s kompletním přehledem turnaje družstev[chesspairings_classifica_squadre id="N"]— tabulka týmů[chesspairings_abbinamenti_squadre id="N" turno="ultimo"]— rozlosování týmů[chesspairings_squadre id="N"]— týmy + soupisky[chesspairings_bando_squadre id="N"]— team tournament announcement[chesspairings_iscriviti_squadre id="N"]— team registration button
All shortcodes are also available as the Gutenberg block „ChessPairings Tournament„, including the tournament list. The block provides a searchable tournament selector, automatic selection modes, advanced filters and a real API preview in the editor.
To keep a page automatically connected to the most relevant event, use for example:
[chesspairings_torneo selezione="automatico" tipo="auto"]<h3>External services</h3>
Tento plugin se připojuje k API služby ChessPairings (my.chesspairings.org/api/v1) za účelem načtení turnajových údajů (tabulky, rozlosování, registrovaní hráči, kalendář). Veškerá volání API probíhají na straně serveru z vaší instalace WordPressu – z prohlížečů vašich návštěvníků se neodesílají žádná data.
Kdy se data odesílají: při každém načtení stránky obsahující zkrácený kód nebo blok ChessPairings (v závislosti na místním ukládání do mezipaměti, nastavitelné v rozmezí 30–300 sekund).
Jaká data se odesílají: váš API klíč (prostřednictvím hlavičky Authorization), ID požadovaného turnaje a adresa URL webu WordPress (prostřednictvím hlavičky User-Agent).
Žádné osobní údaje návštěvníků (IP adresa, soubory cookie, informace o prohlížeči) nejsou této službě předávány.
Tuto službu poskytuje Stefano Loberti (chesspairings.org):
Snímky obrazovky
Bloky
Tento plugin poskytuje 1 blok.
- ChessPairings Tournament Mostra un torneo o un calendario tornei gestito su my.chesspairings.org.
Instalace
- Nahrajte složku
chesspairingsdo adresářewp-content/plugins/(nebo nainstalujte soubor ZIP z administrátorského panelu WordPressu). - Plugin aktivujte v nabídce Pluginy.
- Přejděte na Nastavení Šachové párování.
- Vytvořte si API klíč ve svém profilu na my.chesspairings.org (karta API Vytvořit token).
- Vložte token na stránku nastavení a klikněte na Ověřit připojení.
Vložte zkrácený kód na libovolnou stránku nebo do libovolného příspěvku:
[chesspairings_torneo id=“123″]
Nejčastější dotazy
-
Potřebuji si založit účet na ChessPairings?
-
Ano, je to zdarma. Zaregistrujte se na my.chesspairings.org, vytvořte si tam své turnaje a poté si nainstalujte plugin, abyste je mohli zobrazit na svém webu WordPress.
-
Mohu si přizpůsobit vzhled tabulek?
-
Ano, a to dvěma způsoby:
1. Plugin využívá proměnné CSS, které se automaticky přizpůsobují šabloně. Můžete je přepsat vlastním CSS.
2. Každou šablonu lze přepsat přímo v šabloně: zkopírujte soubor ze složkychesspairings/templates/do složkyyour-theme/chesspairings/a upravte jej. -
Jak velká je zátěž API na jedno zobrazení stránky?
-
Odpovědi se ve výchozím nastavení ukládají do mezipaměti na 60 sekund (lze nastavit v rozmezí 30–300 sekund). I při 100 návštěvách za minutu tedy API přijímá přibližně 1 volání za minutu na jeden zkrácený kód.
-
Mohu zobrazit soukromé turnaje?
-
Ano, pokud je turnaj přiřazen majiteli API klíče. Nastavení viditelnosti (veřejné/soukromé) určuje pouze to, zda se turnaj zobrazí v kalendáři komunity.
-
Co se stane, když bude stránka my.chesspairings.org dočasně nedostupná?
-
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.
-
Odesílá tento plugin data mým návštěvníkům?
-
Ne. Plugin volá API na straně serveru přímo z WordPressu – nedochází k žádnému načítání skriptů JavaScriptu na straně klienta. Žádné soubory cookie, žádné sledovací nástroje.
Recenze
Pro tento plugin nejsou žádné recenze.
Autoři
ChessPairings — Tournament Showcase je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
Spolupracovníci
Plugin „ChessPairings — Tournament Showcase“ byl přeložen do 1 jazyku. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “ChessPairings — Tournament Showcase” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
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+.
0.1.2
- 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.
0.1.1
- Opraveno: skripty vložené přímo do kódu se nyní správně zařazují do fronty pomocí funkce wp_enqueue_script.
- Opraveno: doména textu byla přizpůsobena slugu pluginu.
- Byla přidána sekce „Externí služby“ s odkazy na Podmínky používání a Zásady ochrany osobních údajů.
0.1.0
- První vydání: 12 zkratek + blok pro Gutenberg + šablony s možností přepsání + 7 jazyků.