Handleiding templates in phpRBM

Introductie

Templates zijn gemaakt om deze website verenigingsspecifieker te maken. Templates werken met velden, de velden zijn te herkennen aan: [% %]. Deze velden worden tijdens de uitvoering vervangen door de waarde, dus in feite mailmerge.

De volgende templates zijn beschikbaar, deze staan in de folder 'templates'.

briefpapier.html
opzegging.html
rekening.html
verenigingsinfo.html

briefpapier

Dit is de template voor de mailings en deze wordt ook gebruikt voor de rekeningen.

De volgende velden zijn beschikbaar.

[%FROM%]
[%TO%]
[%SUBJECT%]
[%MESSAGE%]

De namen spreken voor zich, bij from en to zijn het niet de e-mailadressen, maar de namen van de verzenders en ontvangers. Verder zijn er nog ruim 25 velden in de mailingsmodule zelf beschikbaar. Deze zijn op de ge-adresseerde geënt. Wat tussen ' en '' wordt verwijderd bij het versturen van de rekening. Dit om een dubbele aanhef te voorkomen.

opzegging

Deze template wordt gebruikt om het formulier voor het opzeggen van het lidmaatschap van de vereniging te regelen. Mocht u deze niet beschikbaar hebben dan wordt een standaardformulier gebruikt.

De volgende template-specifieke velden zijn beschikbaar.

[%FORMOPZEGGING%], mocht u deze niet gebruiken, zorg dan dat er een veld (input) in het formulier staat wat 'OpzeggingPer' heet die datum van opzeggen bevat.
[%OPZEGGENVANAF%]: rekening houdend met de opzegtermijn, vanaf welke datum mag het lid het lidmaatschap opzeggen.

rekening

Deze template wordt gebruikt om de rekening op te maken, zowel in het scherm als in een mailing. Door in de naam het seizoen te vermelden kan de template seizoen specifiek worden gemaakt. Bijvoorbeeld: rekening 2018.html. Zo kan je voorkomen dat als iemand een oude rekening opvraagt hij of zij ineens de aangepaste betalingsregels op die oude rekening ziet. Er zijn voorbeelden op GitHub beschikbaar.

De volgende template-specifieke velden zijn beschikbaar.

[%NAAMDEBITEUR%]
[%REKENINGDATUM%]: de datum van de rekening, opgemaakt als geschreven datum in het Nederlands
[%REKENINGOMSCHRIJVING%]
[%REKENINGNUMMER%]
[%SEIZOEN%]
[%REKENINGREGELS%]: de rekeningregels, opgemaakt als een rij in een tabel.
[%UITERSTEBETAALDATUM%]
[%VANAFADRES%]: het e-mailadres waarvan de rekeningen verzonden worden
[%VANAFNAAM%]: de naam die ook in de from van de e-mail gebruikt wordt
[%BANKREKENING%]: de bankrekening van het lid
[%REKENINGBEDRAG%]: het totaal bedrag van de rekening
[%BETAALD%]: het bedrag dat al betaald is op deze rekening
[%OPENSTAAND%]: het bedrag dat op deze rekening nog open staat

De volgende mogelijkheden om teksten variabel te maken zijn er.

De tekst tussen  en  wordt alleen getoond als het lid geen machtiging heeft afgegegeven.
De tekst tussen  en  wordt alleen getoond als het lid juist wel machtiging heeft afgegegeven.
De tekst tussen  en  wordt verwijderd als het totaal van de rekening nul is.
De tekst tussen  en  wordt verwijderd als het totaal van de rekening groter dan nul is.
De tekst tussen  en  wordt verwijderd als het totaal van de rekening kleiner dan nul is.
De tekst tussen  en  wordt verwijderd als de rekening volledig betaald is.
De tekst tussen  en  wordt verwijderd als er nog geen betaling op de rekening heeft plaats gevonden.

In de template kan ook nog een variable worden gezet, namelijk om te bepalen of regelnummers wel of niet moeten worden geprint. Dit kan je instellen door:  in de tekst te zetten. Hierdoor worden de regelnummers niet geprint, door dit weg te laten of door de 0 in een 1 te wijzigen, worden de regelnummers wel geprint.

verenigingsinfo

Dit is de inhoud van de introductiepagina. Hier kan bijvoorbeeld een vereniging iets over zichzelf of de website vertellen en hoe de ondersteuning is geregeld.

De volgende velden zijn beschikbaar.

Aantal leden: [%AANTALLEDEN%]
Aantal vrouwen: [%AANTALVROUWEN%]
Aantal mannen: [%AANTALMANNEN%]
Gemiddelde leeftijd: [%GEMIDDELDELEEFTIJD%]
Aantal kaderleden: [%AANTALKADERLEDEN%]
Nieuwste login: [%NIEUWSTELOGIN%]
Aantal aangemaakte logins: [%AANTALLOGINS%]
Nu ingelogd: [%NUINGELOGD%]
Database bijgewerkt t/m: [%LAATSTGEWIJZIGD%]
De laatste keer dat de upload vanuit de Access-database is gedaan: [%LAATSTEUPLOAD%]
Huidige gebruiker bijgewerkt t/m: [%INGELOGDEGEWIJZIGD%]
Verjaardagen met foto's: [%VERJAARFOTO%]
Verjaardagen zonder foto's: [%VERJAARDAGEN%]
Komende evenementen: [%KOMENDEEVENEMENTEN%]
Stukken die gewijzigd zijn sinds de vorige login of korter dan een week geleden: [%GEWIJZIGDESTUKKEN%]
Waarschuwing diploma's die recent vervallen zijn of binnenkort vervallen: [%VERVALLENDIPLOMAS%]

Bij verenigingsinfo is het mogelijk om bepaalde stukken tekst alleen aan bepaalde gebruikers te tonen. De volgende mogelijkheden zijn er.

Stukken tekst tussen  en  worden alleen aan ingelogde bezoekers getoond.
Stukken tekst tussen  en  zijn alleen zichtbaar voor een webmaster.
Ook kunnen stukken tekst alleen worden getoond aan leden van een onderdeel. Hiervoor moet je eerst het RecordID van het betreffende onderdeel opzoeken. In deze verdere uitleg is die 16. De begin- en eindtag zijn dan:  en .

Overzicht meerdere keren gebruikte velden

Hieronder volgt een overzicht van de velden die in meerdere templates gebruikt worden.

Naam veld/template	bevestiging_login	opzegging	rekening	verenigingsinfo
[%NAAMLID%]	Ja	Ja		Ja
[%ADRES%]			Ja
[%POSTCODE%]			Ja
[%WOONPLAATS%]			Ja
[%ROEPNAAM%]	Ja		Ja	Ja
[%LIDNR%]	Ja	Ja	Ja	Ja
[%NAAMVERENIGING%]	Ja	Ja	Ja
[%NAAMWEBSITE%]	Ja	Ja	Ja
[%URLWEBSITE%]	Ja	Ja	Ja

Tot slot

Mocht je meer velden nodig hebben, dan dit graag via GitHub aangeven.