Audiostreamen WordPress modules – installatie, gebruik & FAQ

Audiostreamen WordPress modules – installatie, gebruik & FAQ

Deze handleiding is bedoeld voor klanten die de Audiostreamen WordPress modules gebruiken, eventueel in combinatie met ProRadio / QTMPlayer (1 vaste speler op de site).

1) Welke modules zijn er?

• Audiostreamen Core – centrale instellingen (station/kanaal, API’s, styling/JS voor tiles).
• Song History v2 – “Laatst gedraaid” + weekoverzicht (op basis van History API).
• Playlist (Standalone) – volledige playlist-pagina met kanaalkeuze, datum en paginering.
• Cartwall – compacte “Luister live” module (cover + laatst gedraaid + link naar playlist).
• ProRadio / QTMPlayer (optioneel, bestaand) – de daadwerkelijke audio-speler (1 speler onderaan de site).

2) Benodigdheden (checklist)

• WordPress + (bij voorkeur) Elementor
• Audiostreamen plugins geïnstalleerd en geactiveerd
• Werkende stream URL (MP3/AAC)
• Werkende Audiostreamen API URL(s) voor “Now Playing” en “History”
• Gebruik je cache (WordPress cache-plugin / Cloudflare)? Houd rekening met cache legen na wijzigingen

3) Basisinstellingen (1x instellen)

Ga naar: WordPress Admin ? Settings ? Audiostreamen

• Stationnaam: bijv. Jouw Radio
• Station slug (kanaal): bijv. {station_slug}
• History API base: bijv. https://api.audiostreamen.nl/api/v1/history/
• Now Playing API URL: bijv. https://api.audiostreamen.nl/api/v1/{station_slug}/playing/{station_slug}
• Stream URL: bijv. {stream_url}

4) ProRadio / QTMPlayer instellingen (als je die gebruikt)

Ga naar: WordPress Admin ? Radio channels ? (jouw kanaal)

• MP3 Stream URL: {stream_url}
• MP3 Stream URL mobile: {stream_url}
• Server type: Audiostreamen API
• Audiostreamen API URL: https://api.audiostreamen.nl/api/v1/{station_slug}/playing/{station_slug}
• Use proxy (optioneel): aanvinken als je CORS/caching problemen ervaart

Resultaat: klik je op play (in tile of header), dan speelt de vaste QTMPlayer onderaan. Titel/artist/cover komen uit de Audiostreamen API.

5) Shortcodes (meest gebruikt)

5.1 Laatst gedraaid (1 item)

[song_history channel="{station_slug}" limit="1" show_cover="1"]

5.2 Laatst gedraaid (bijv. 10 items)

[song_history channel="{station_slug}" limit="10" show_cover="1"]

5.3 Weekoverzicht (7 dagen)

[song_history_week channel="{station_slug}" days="7"]

5.4 Playlist (volledige lijst)

[audiostreamen_playlist]

5.5 Playlist met meerdere kanalen

[audiostreamen_playlist channels="{station_slug}:Jouw Radio,teamfm:TeamFM" default="{station_slug}"]

5.6 Cartwall (compacte luistermodule)

[audiostreamen_cartwall channel="{station_slug}" label="Jouw Radio"]

6) Handige URL parameters (Playlist)

• ?ch={station_slug} – kanaal kiezen
• &date=YYYY-MM-DD – dag kiezen
• &pg=2 – paginering

7) Veelvoorkomende problemen (FAQ)

7.1 Ik zie geen titel/artist info in de player

1. Controleer bij Radio channels: Servertype = Audiostreamen API en API URL is ingevuld.
2. Leeg cache (WordPress cache-plugin / Cloudflare) + hard refresh (Ctrl+F5).
3. Werkt het nog niet? Vink Use proxy aan in het Radio channel.

7.2 Elementor laat wijzigingen niet zien

• Elementor ? Tools ? Regenerate CSS & Data
• Cache legen + hard refresh

7.3 Tijden kloppen niet / lopen achter

• Controleer WordPress tijdzone: Settings ? General ? Timezone

7.4 Cover-artwork ontbreekt

• Controleer of de Now Playing API daadwerkelijk cover/artwork teruggeeft.
• Als je tiles/cover-refresh gebruikt: controleer de Now Playing API URL in Audiostreamen Core.

7.5 Na updates werkt iets niet meer

• Cache legen + Elementor CSS regenereren
• Controleer of alle plugins geactiveerd zijn
• Controleer API URL’s en station slug

8) Support

Kom je er niet uit? Mail ons via support@audiostreamen.com met:

• De URL van je pagina
• Je station slug
• De gebruikte shortcode(s)
• (Indien mogelijk) screenshots van:
  • Settings ? Audiostreamen
  • Radio channels