MeinTurnierplan

Opis

MeinTurnierplan pozwala wyświetlać tabele turniejowe i harmonogramy meczów z meinturnierplan.de na twojej witrynie WordPress. Idealne dla klubów sportowych, lig i organizatorów turniejów – łatwo pokażesz wyniki, rankingi i mecze na swojej witrynie.

Usługi serwisów zewnętrznych

Serwis MeinTurnierplan.de

Ta wtyczka korzysta z MeinTurnierplan.de do wyświetlania treści turniejowych oraz pobierania danych konfiguracyjnych turniejów.

Jak to działa:

1. Wyświetlenia na stronie (odwiedzający):

   • Wyświetla tabele wyników i terminarz meczów odwiedzającym stronę w ramkach (iframe).
   • Używany adres końcowy:
     • https://www.meinturnierplan.de/displayTable.php (dla wyników turnieju)
     • https://www.meinturnierplan.de/displayMatches.php (dla terminarza meczów)
   • Kiedy: Gdy odwiedzający wczytuje stronę z treściami turnieju (shortcode, blok lub widżet)

2. Ustawienia Admina (tylko panel admina):

   • Udostępnia dane struktury turnieju przez API w formacie JSON, to pomaga administratorom w wyświetlaniu strony.
   • Używany adres końcowy:
     • https://www.meinturnierplan.de/json/json.php (dane struktury turnieju)
   • Kiedy: Tylko w panelu administracyjnym WordPressa, gdy:
     • Administrator wpisuje identyfikator turnieju w ustawieniach
     • Administrator klika „Odśwież grupy” lub podobny przycisk odświeżania
     • Podgląd w panelu admina jest widoczny lub odświeżony.
   • Co pobiera:
     • Struktura grup/dywizji turnieju
     • Nazwy i lista drużyn
     • Opcje turnieju (showCourts, showGroups, showReferees, finalMatches)
   • Cel:
     • Automatycznie uzupełnia listy wyboru grup w panelu admina
     • Ustala, które funkcje są dostępne dla danego turnieju
     • Łatwiejsze zarządzanie w panelu admina dzięki automatycznej konfiguracji
   • Dane z pamięci podręcznej: Pobrane dane są buforowane przez 15 minut, aby ograniczyć liczbę zapytań do API
   • Nie używane na froncie: JSON API działa tylko w panelu admina WordPress, nigdy na publicznych stronach

• Wysyłane dane: Tylko identyfikator turnieju (bez danych osobowych, bez informacji o użytkowniku)
• Polityka prywatności
• Warunki korzystania z usługi

Co zbierają widżety:

Osadzone widgety:

• Bez śledzenia – Wbudowane widżety nie używają Google Analytics ani żadnych innych usług analitycznych
• Brak plików ciasteczek – Widżety nie ustawiają żadnych plików ciasteczek w przeglądarkach użytkowników
• Bez zewnętrznych usług – Widżety wczytują tylko style CSS z meinturnierplan.de (bez Google Fonts, AdSense ani innych zewnętrznych usług)
• Komunikacja: Widżety używają tylko JavaScript, aby wysłać rozmiar ramki (iframe) do twojej strony i poprawnie ją wyświetlić (przez API postMessage)

Jakie dane mogą być zbierane:

Gdy użytkownicy przeglądają osadzone treści turniejowe, serwer meinturnierplan.de może automatycznie zapisywać:

• Adresy IP (standardowe logi serwera)
• Typ i wersja przeglądarki (z nagłówka User-Agent)
• Adres URL strony odsyłającej (twoja witryna internetowa, na której umieszczono widżet)
• Znacznik czasu dostępu

To standardowe logowanie serwera www – bez plików ciasteczek, skryptów śledzących ani identyfikacji użytkowników.

Polityka prywatności

Ta wtyczka nie:

• Śledzenie użytkowników
• Gromadzone dane osobowe
• Używa plików ciasteczek lub localStorage
• Wysyła danych osobowych lub wrażliwych na zewnętrzne serwery

Przesyłanie danych:
Wtyczka wysyła tylko identyfikator turnieju na meinturnierplan.de, gdy dodasz treść turniejową (shortcode, blok, widżet), by ją pokazać na stronie.

Działanie osadzonego widgetu:
Osadzone widgety z meinturnierplan.de:

• Nie używa skryptów śledzących (brak Google Analytics w widgetach)
• Nie ustawia plików ciasteczek
• Nie wczytuje usług zewnętrznych (bez Google Fonts, AdSense itp.)
• Widget komunikuje tylko rozmiar ramki (iframe) do prawidłowego wyświetlania na stronie.

Standardowe logi serwera:
Jak każda strona internetowa, serwery meinturnierplan.de mogą zapisywać podstawowe dane z żądań HTTP (adres IP, rodzaj przeglądarki, źródło, data) podczas wyświetlania treści. To normalna praktyka dla wszystkich serwerów www – bez śledzenia użytkowników czy plików ciasteczek.

Nie potrzeba zgody:
Wbudowane widżety nie używają plików ciasteczek, skryptów śledzących ani trwałej identyfikacji użytkownika, nie potrzeba dodatkowej zgody na pliki ciasteczek – wystarczy standardowa informacja o logach serwera w polityce prywatności.

Dostępne języki

Wtyczka dostępna w następujących językach:

• Angielski (English)
• Niemiecki (Deutsch)
• Hiszpański (Español)
• Francuski (Français)
• Włoski (Italiano)
• Polski

Główne funkcje

Dwa typy treści:

• Tabele turniejowe – pokazują klasyfikację, rankingi i statystyki.
• Listy meczów – Wyświetlaj zaplanowane spotkania i wyniki

Sposoby wyświetlania:

• Bloki Gutenberga – Natywne wsparcie bloków edytora dla tabel i meczów
• Kody – [mtrn-table] i [mtrn-matches] z ogromnymi możliwościami personalizacji
• Widżety – wsparcie dla starszych widżetów w obu typach treści

Rozbudowana personalizacja:

• Zarządzaj kolorami, czcionkami, ramkami i odstępami
• Zmieniaj widoczność wybranych kolumn (zwycięstwa, porażki, loga itp.)
• Personalizacja stylu (kolory, czcionki, odstępy)
• Podgląd w czasie rzeczywistym podczas edycji w panelu admina

Dodatkowe funkcje:

• Zewnętrzna integracja z systemami zarządzania turniejami za pomocą identyfikatorów
• Responsywny design – automatycznie dostosowuje się do urządzeń mobilnych
• Podgląd na żywo oparty na technologii AJAX w panelu administracyjnym
• Automatyczne wyświetlanie na stronach pojedynczych typów treści

Zastosowanie

Po aktywacji kliknij w menu admina Tabele turniejowe lub Listy meczów turniejowych aby utworzyć pierwsze treści. Następnie możesz je wyświetlić za pomocą:

1. Bloki Gutenberga – dodaj blok „Tabela turniejowa” lub „Lista meczów turniejowych” do dowolnego wpisu lub strony
2. Kody – Użyj [mtrn-table id="123"] lub [mtrn-matches id="456"]
3. Widżety – dodaj widżet „Tabela turniejowa” lub „Lista meczów turnieju” do wybranego miejsca na stronie
4. Automatyczne wyświetlanie – Przejdź na strony pojedynczej tabeli turniejowej lub listy meczów

Przykłady shortcode

Tabela turniejowa:

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

Mecze:

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

Odnośniki

• Repozytorium GitHub
• Strona wtyczki

Rozwój

Wtyczka przestrzega standardów WordPress i najlepszych praktyk:

• Zabezpieczenia – właściwa sanitacja, walidacja i weryfikacja kodu jednorazowego
• Internacjonalizacja – pełne wsparcie i18n z domeną tekstowąmeinturnierplan
• Nowoczesny WordPress – obsługa bloków Gutenberg i REST API
• Czysta architektura – Rozdzielność obowiązków z dedykowanymi klasami dla każdej funkcji
• Obiektowy – struktura oparta na klasach z wzorcem singletona
• Integracja AJAX – funkcja podglądu w czasie rzeczywistym

Pomoc

W razie problemów, sugestii funkcji i wkładu, odwiedź:
GitHub Repository