Opis widgetu

Widget pozwala wyświetlać aktualne, nadchodzące imprezy zespołów bezpośrednio na Twojej stronie internetowej.

Dane są pobierane automatycznie z publicznego API Śląskiego Radia Top Sender i mogą być filtrowane dla jednego lub kilku zespołów.

Możesz wyświetlić:

  • wszystkie imprezy,
  • tylko imprezy wybranych zespołów,
  • dowolną liczbę wydarzeń.

Ważne informacje

Plik JavaScript trzeba dodać tylko raz na stronie.

Najlepiej dodać go na końcu strony, bezpośrednio przed znacznikiem </body>.

Jeśli nie podasz parametru bands, wyświetlone zostaną wszystkie nadchodzące imprezy.

Jeśli nie podasz data-counter, domyślnie pokazanych zostanie 20 imprez.

Parametr bands przyjmuje nazwę zespołu widoczną w adresie profilu zespołu na stronie slaskieradio.pl.

Jest to część adresu po /zespol/, zapisana bez polskich znaków, małymi literami, a spacje są zastąpione znakiem -.

Przykład: jeżeli profil zespołu ma adres https://slaskieradio.pl/zespol/baciary, to w parametrze bands należy użyć wartości baciary.

Kilka zespołów należy oddzielić przecinkiem, bez spacji.

Plik event-calendar-widget.js należy pobrać i umieścić w katalogu /js/ na swojej stronie.

Jeśli używasz innej lokalizacji, zmień ścieżkę w znaczniku <script src="..."> tak, aby wskazywała poprawne miejsce pliku.

Powered by Śląskie Radio Top Sender

Instrukcja instalacji

Aby umieścić widget na swojej stronie:

  1. Wklej kontener HTML tam, gdzie mają pojawić się imprezy.
  2. <div class="top-sender-event-root" data-api="https://api.slaskieradio.pl/public/events?bands=baciary" data-counter="8" ></div>
  3. Ustaw parametry według potrzeb.
  4. Skopiuj plik event-calendar-widget.js do katalogu /js/ na swoim serwerze, a następnie dodaj na końcu strony (tuż przed </body>) poniższy kod:
  5. <script src="./js/event-calendar-widget.js"></script>
Kod do wklejenia
Zmiana parametrów
data-api Pełny adres API pobierający imprezy.
bands= Nazwa zespołu z adresu profilu na stronie slaskieradio.pl. Jest to część adresu po /zespol/, np. baciary.
data-counter Liczba wyświetlanych imprez.
Przykłady parametru data-api
Wszystkie zespoły
https://api.slaskieradio.pl/public/events
Jeden zespół
https://api.slaskieradio.pl/public/events?bands=baciary
Kilka zespołów
https://api.slaskieradio.pl/public/events?bands=baciary,teresa-werner,mariusz-kalaga
Ograniczenie liczby wyników
https://api.slaskieradio.pl/public/events?bands=baciary&limit=5
Przykładowe imprezy

Poniżej widoczny jest działający przykład widgetu.

Ładowanie imprez...
Przykład: kontener 50%

Widget w połowie szerokości treści strony.

Ładowanie imprez...
Przykład: kontener 100%

Widget rozciągnięty na pełną szerokość bloku treści.

Ładowanie imprez...