Beschrijving
Deze WordPress plugin verzamelt gegevens van geplande kerkdiensten en uitzendingen uit verschillende bronnen die door Nederlandse kerken worden gebruikt en presenteert ze als een enkel overzicht. Bedoeld om te worden gebruikt op de site van een kerk om geplande en eerder uitgezonden kerkdiensten en andere evenementen weer te geven.
De volgende diensten worden gebruikt:
- Kerktijden.nl: een site waar kerken hun geplande kerkdiensten kunnen registreren
- Kerkomroep.nl: een site die kerken gebruiken om audio- en video-opnames van hun kerkdiensten uit te zenden
- Youtube.com: een site die kerken gebruiken om een video-opname van hun kerkdiensten uit te zenden
Externe diensten
Deze plugin maakt verbinding met in totaal drie APIs om gegevens van kerkdiensten en uitzendingen op te halen. Dit is nodig om de geplande en uitgezonden kerkdiensten en andere evenementen weer te geven op de site.
De eerste API, api.kerktijden.nl, bevat gegevens van hun eigen kerk van Kerktijden, zoals de datum en tijd van de kerkdienst en de naam van de voorganger van de kerkdienst. De plugin zal eens per 15 minuten één aanvraag sturen om toekomstige kerkdiensten te laden. Daarnaast zal het dagelijks het historische archief laden, tot het aantal weken dat is aangegeven op de configuratiepagina van de plugin, zodat wijzigingen in deze gegevens up-to-date blijven. Deze gegevens worden door de kerk zelf ingevoerd en zijn openbaar beschikbaar. Kerktijden.nl biedt lokale kerk communities de mogelijkheid om de ingevoerde gegevens te gebruiken op hun lokale site door middel van een widget. […] Er gelden twee voorwaarden: 1) Het logo van kerktijden moet zichtbaar blijven. 2) De link naar kerktijden.nl moet zichtbaar blijven.” (Vertaald van (https://www.kerktijden.nl/service/veelgestelde-vragen/).) De plugin zal automatisch het Kerktijden logo met URL toevoegen aan de Kerktijden.nl pagina van de kerk wanneer gegevens van deze dienst worden getoond. Deze dienst wordt geleverd door Kerktijden: Gebruiksvoorwaarden: niet beschikbaar, Privacybeleid, in het Nederlands.
De tweede API, www.kerkomroep.nl, bevat gegevens van uitzendingen, zowel video als audio, de datum en tijd van de uitzending, en mogelijk aanvullende gegevens zoals de naam van de voorganger van de kerkdienst. De plugin controleert elke keer dat iemand de webpagina met de gegevens van Sermons-NL bezoekt op live-uitzendingen. Bovendien wordt het archief elke 15 minuten geüpdatet. De plugin kan deze gegevens alleen ophalen wanneer ze openbaar beschikbaar zijn (een instelling in Kerkomroep die door de kerk wordt beheerd). “Het staat de kerk vrij om de eigen kerkdiensten te publiceren op de eigen site. Je archieven die op onze servers staan zijn en blijven jullie eigendom. Wat je ermee doet en hoe je deze diensten implementeert (via een link of een API of Plugin) maakt dus niet uit.” (Persoonlijke communicatie van Kerktijden.) Om de bron te vermelden en voor consistentie, toont de plugin het logo en de url van Kerkomroep als er gegevens van deze dienst worden getoond. Deze dienst wordt geleverd door Kerkomroep: Gebruiksvoorwaarden: niet beschikbaar, Privacybeleid, in het Nederlands.
De derde API, www.googleapis.com (YouTube Data API), bevat videogegevens. De plugin haalt video’s op van het kanaal dat is aangegeven op de instellingenpagina. De plugin laadt elke 15 minuten gegevens van de 10 meest recent uitgezonden of geplande video’s en haalt dagelijks het volledige archief op (tot het aantal weken dat is aangegeven op de instellingenpagina van de plugin). Wanneer een uitzending gepland is en nadert, vraagt de plugin elke minuut de status op, mits er een bezoeker is. Om de bron te bevestigen en voor consistentie, toont de plugin het YouTube logo met de URL naar het YouTube kanaal als er gegevens van deze dienst worden weergegeven. Deze dienst wordt aangeboden door Google: Gebruiksvoorwaarden, Privacybeleid.
Voor alle diensten zal de plugin alleen de instellingen die zijn ingevoerd op de configuratiepagina van de plugin naar de respectieve dienst verzenden om de vereiste gegevens aan te vragen.
Schermafbeeldingen

Op de site ingesloten lijst van preken terwijl er live wordt uitgezonden. Door op een van deze links te klikken, wordt de media (audio of video) afgespeeld. 
Op de site ingesloten lijst van preken, inclusief eerder uitgezonden audio- en videodiensten, een geplande YouTube uitzending en toekomstige preken. 
Op de beheerpagina in het WordPress Dashboard kunnen preken individueel worden aangepast indien nodig. Je kunt ook shortcodes vinden om individuele preken of uitzendingen aan je site toe te voegen. 
Er is een shortcode maker in het WordPress dashboard die je helpt de lijst met preken op je site in te sluiten volgens je wensen.
Installatie
Je kunt de Sermons-NL plugin installeren via het WordPress dashboard (door de plugin op te zoeken of door het zip-bestand te uploaden) of kopieer de bronbestanden naar de /wp-content/plugins/ map via FTP. Na het installeren kun je de plugin activeren.
Het instellen van de plugin is heel makkelijk. Ga naar Sermons-NL > Instellingen in het WP dashboard menu en volg de instructies. Ga dan naar Sermons-NL in het WP dashboard en gebruik de shortcode bouwer. Kopieer de shortcode naar een pagina of bericht van de site om lijst met (geplande) uitzendingen weer te geven. Je kunt ook een enkel evenement of een uitgezonden item weergeven. Dat kan nuttig zijn bij berichten over een specifiek evenement. Je kunt de shortcode hiervoor vinden in het Sermons-NL administratie menu. Zie de veelgestelde vragen voor meer tips.
FAQ
-
Hoe moet ik beginnen met de plugin te gebruiken?
-
Na het installeren en activeren van de plugin wordt een pagina “Sermons-NL” toegevoegd aan het hoofdmenu van je WP beheer. In het submenu “Instellingen” kun je de details invoeren van de diensten die je wil gebruiken. Specifieke instructies per dienst vind je daar.
-
Hoe voeg ik een lijst met (geplande) uitzendingen toe aan mijn site?
-
De plugin Sermons-NL gebruikt shortcodes om (geplande) uitzendingen toe te voegen aan je site. Voor een complete lijst van (geplande) uitzendingen, vind je de shortcode bouwer op de landingspagina van de plugin, via het WordPress beheer. Je kunt ook individuele evenementen of zelfs afzonderlijke uitzendingen op je site plaatsen. Hiervoor navigeer je naar het submenu Administratie, zoek je de relevante kerkdienst of item op, en kopieer je de shortcode. Je kunt de shortcode plakken op je pagina of in je bericht.
-
We hebben een evenement uitgezonden, maar ik wil niet dat deze wordt getoond onder de (geplande) uitzendingen. Hoe doe ik dat?
-
Je kunt dit doen door het evenement te vinden in het Administratie submenu en de optie “Aan lijst (geplande) uitzendingen toevoegen” uit te vinken. Vergeet niet op de Opslaan knop te drukken.
Als je wilt voorkomen dat een toekomstige uitzending bij de (geplande) uitzendingen wordt getoond, kun je handmatig een nieuw evenement aanmaken (optie “Maak een nieuw evenement” in het Beheer submenu) en de datum en tijd van de geplande uitzending invoeren. Vink de optie “Aan lijst (geplande) uitzendingen toevoegen” uit. Let op dat de optie “Bescherm tegen automatisch verwijderen” aanstaat, vooral als je het handmatige evenement al voor de dag van de uitzending maakt, anders wordt hij ’s nachts verwijderd. Zodra de nieuwe uitzending gedetecteerd wordt, zal de plugin deze koppelen aan het handmatige evenement, wat voorkomt dat hij wordt opgenomen in de lijst met (geplande) uitzendingen.
Let op: je kunt dit uitgezonden evenement aan je site toevoegen, bijvoorbeeld in een nieuwsbericht, met behulp van de evenement shortcode die je vind in de administratie pagina.
-
Het automatisch linken van items uit verschillende diensten is verkeerd gegaan. Wat moet ik doen?
-
Dit gebeurt soms, bijvoorbeeld als de uitzending veel eerder start zodat het koppelen aan een geplande dienst niet ondubbelzinnig is of als meerdere uitzendingen van hetzelfde type worden gedetecteerd, bijvoorbeeld als de uitzending onderbroken is. Het is makkelijk achteraf te repareren. Ga naar het Administratie submenu en vind het evenement waar een fout is opgetreden. Je kunt het item ontkoppelen dat niet correct gelinkt is (hij komt dan onder de “Losgekoppelde items”) of deze direct koppelen aan een ander evenement. Als de dienst geen andere gekoppelde items meer heeft, kun je deze nu verwijderen. Ga naar het losgekoppelde item als je deze wilt koppelen aan een ander evenement. Alleen diensten met dezelfde datum kunnen gekoppeld worden.
-
Waarom ondersteunt Sermons-NL Kerkdienst Gemist niet?
-
Kerkdienst Gemist is een dienst die vergelijkbaar is met Kerkomroep. Momenteel is alleen Kerkomroep opgenomen, omdat de kerk waarvoor de plugin oorspronkelijk is ontwikkeld, die dienst gebruikt. Ondersteuning voor Kerkdienst Gemist is echter mogelijk als een kerk die Kerkdienst Gemist gebruikt wil helpen met het testen en debuggen. Ga hiervoor naar de probleempagina en laat je reactie achter of stuur een e-mail naar de ontwikkelaar.
-
WordPress reageert soms erg traag sinds in Sermons-NL gebruik. Wat kan ik daaraan doen?
-
Controleer of je cron jobs gebruikt. Sermons-NL zal regelmatig gegevens op de achtergrond updaten. Dit kan je site vertragen. Om de prestaties te optimaliseren, controleer of je hostingserver je toestaat cron jobs te gebruiken. De aanbevolen frequentie van cron jobs voor deze plugin is eens per 15 minuten. Controleer bijvoorbeeld deze instructie om cron in WordPress uit te schakelen voor instructie. Als je al cron jobs gebruikt en deze correct zijn geconfigureerd, is het onwaarschijnlijk dat de Sermons-NL plugin je site vertraagt.
-
Ik krijg [Sermons-NL invalid shortcode] op mijn site waar een Sermons-NL shortcode is gebruikt
-
Shortcodes voor zelfstandige items kunnen om twee redenen de fout [invalid shortcode] opleveren. Als de fout (duplication) vermeldt, betekent dit dat er meerdere zelfstandige items op de pagina staan, waarvan er één dubbel voorkomt. De plugin staat niet toe dat je een zelfstandig item of evenement tweemaal op dezelfde pagina plaatst, omdat dit conflicten veroorzaakt. Een tweede mogelijke verklaring is dat het zelfstandige evenement of item dat je hebt toegevoegd, niet (meer) bestaat. Controleer het submenu Beheer in je WP beheer voor de juiste shortcode.
-
Ik kom een ander probleem tegen met mijn plugin. Wat kan ik doen om het op te lossen?
-
Ga eerst naar het Log submenu in je WP beheer om te zien of je de oorzaak van je probleem kunt achterhalen. Controleer de instellingen als de log fouten aangeeft bij het verkrijgen van gegevens. Als je het probleem niet kunt oplossen, meld het dan op de probleem pagina van de plugin of stuur een e-mail naar de ontwikkelaar met zoveel mogelijk details.
Beoordelingen
Er zijn geen beoordelingen voor deze plugin.
Bijdragers & ontwikkelaars
“Sermons-NL” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
Bijdragers“Sermons-NL” is vertaald in 1 locale. Dank voor de vertalers voor hun bijdragen.
Vertaal “Sermons-NL” in je eigen taal.
Interesse in ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
0.1
- Eerste release.
0.2
- Gebruik van _POST en _GET invoer geoptimaliseerd
- Bugfix: pagina verversen vereist na het oplossen van probleem in plugin dashboard
- Bugfix: kerkomroep live-uitzending kan worden verwijderd wanneer er niet meer wordt uitgezonden
0.3
- Gebruik van de ingebouwde WordPress HTTP API
- Juist gebruik van inline script
- Verwijderen van afhankelijkheid van extern script
- Documentatie van externe diensten toegevoegd
1.0
- Stabiele versie
- Lost het openen van scherm met niet-gekoppelde items op
- Verbeterde consistentie van de Nederlandse vertaling
1.1
- Toegevoegd: plugin instellingen voor de kleur van de audio/video iconen
1.2
- Het linken van meerdere items van hetzelfde type aan een evenement is uitgeschakeld
- Optie om een item van het ene evenement direct aan een ander of nieuw evenement te linken is toegevoegd
- Fout in shortcode bouwer is opgelost
1.3
- Toegevoegd functie: toestaan om het tijdsinterval dat toegestaan is om items met elkaar te linken in één evenement aan te passen.
- Verbeterde taal: in het bijzonder dat “sermons” wordt vervangen door “kerkdienst”, “uitzending” of “evenement”, waar dat passend is.
- Bug verholpen: indien kerkomroep uitzending is afgelopen en reeds is gearchiveerd, wordt de live uitzending eerst verwijderd uit het geheugen voordat het item uit het archief wordt toegevoegd, om te voorkomen dat een nieuw evenement wordt aangemaakt.
- Bug verholpen: type-casting van de functie “is_live” naar een integer loste een fout op.
- Bug opgelost: indien geplande YouTube uitzendingen worden verplaatst naar een ander evenement, treedt er geen fout op door het ontbreken van een einddatum.
