home | sitemap

Macro's

Soms is het nodig dat bepaalde inhoud wel op een pagina getoond moet worden, maar dat het (voor het cms nog) niet mogelijk is het resultaat direct te tonen.
In dat geval wordt gebruik gemaakt van een zogenaamde macro: een 'commando' tussen blokhaken ([...]) dat het cms pas bij het publiceren van de pagina verwerkt en vervangt met de daadwerkelijke inhoud.
Ook modules maken waar nodig gebruik van macro's om inhoud te tonen.

Hieronder volgt een overzicht van de verschillende macro's die het cms ondersteund.
Waar mogelijk wordt verwezen naar de module waar de macro voor is.
'...' betekent dat er opties aan de macro mee kunnen worden gegeven. Deze opties worden bij de module beschreven.

NB: Om macro's in deze helpwebsite te kunnen tonen zonder dat het cms ze verwerkt zijn ze speciaal opgemaakt. De voorbeelden kunnen daarom niet via knippen en plakken toegepast worden!
Typ een macro dus over, in plaats van deze te kopieëren!

[­INCLUDE NEWS] en [­INCLUDE NEWSHOME]

Deze twee macro's zijn voor de nieuwsitems-module en kunnen worden gebruikt om overzichten van nieuwsitems te tonen. [­INCLUDE NEWS] toont het complete overzicht inclusief zoek-optie. [­INCLUDE NEWSHOME] toont een verkort overzicht (aantal getoonde items is afhankelijk van de instellingen bij de nieuwsitems-module).
Deze macro's dienen vooralsnog handmatig ingevoerd te worden.

[­INCLUDE NEWSLETTER] en [­INCLUDE NEWSLETTERS]

Deze macro is van de nieuwsbrieven-module en kan worden gebruikt om een overzicht/archief van alle nieuwsbrieven te tonen (inclusief zoek-optie). De eerste macro toont direct de meest actuele nieuwsbrief gevolgd door een link naar het archief. De tweede macro toont direct het archief.
Deze macro's dienen vooralsnog handmatig ingevoerd te worden.

[­INCUDE SUBS]

Met deze macro kan het huidige submenu op een pagina worden weergegeven. Handig om op een tussenpagina (bijv. de pagina van een hoofdmenu-item) alvast een overzicht te tonen van de vervolgpagina's, namelijk de inhoud van het submenu.
Deze macro dient vooralsnog handmatig ingevoerd te worden.

[­LIST ...]

Deze macro is van de labels/paginalijsten-module en zal worden vervangen met de uitvoer van de opgegeven lijst.
Een lijst kan via de 'wizard' ingevoegd worden via Invoegen > Lijst...
De macro kan ook handmatig ingevoerd worden.

[­POLL ...]

Deze macro kan via de poll-module worden ingevoegd als een poll op een pagina moet worden getoond.
Indien gewenst kan de macro ook handmatig worden ingevoerd.

[­FORM ...]

Deze macro wordt door de formulieren-module ingevoegd als een formulier op een pagina wordt geplaatst. Deze macro is (op dit moment) de enige macro die ook in het cms de daadwerkelijke uitvoer toont, namelijk het formulier zelf.
Handmatig invoegen van deze macro is mogelijk, maar is niet nodig. De macro zal ook nooit direct zichtbaar zijn in het cms omdat het formulier direct wordt getoond.

[­RSS ...]

Met deze macro kan de inhoud van een rss-feed van een andere website/bron worden getoond op een pagina.
De macro dient vooralsnog handmatig worden ingevoerd. Op termijn zal de macro direct via de rss-module ingevoegd kunnen worden.

[­TAGCLOUD ...]

Via deze macro kan een zogenaamde tagcloud worden ingevoegd. Indien u een tagcloud op uw website wenst, neem dan graag even contact op.

[­INCLUDE SITEMAP]

Deze macro zal door het cms worden vervangen met de sitemap. Deze macro hoeft niet expliciet ergens op een pagina gezet te worden: het cms maakt altijd een sitemap-pagina aan. Deze kan te allen tijde worden aangeroepen door een hyperlink te maken naar <websitenaam>/sitemap.

[­CONTENT]

Deze macro is met name bedoeld voor gebruik in combinatie met modules. Door de parameter conpag=<paginanummer> aan de hyperlink van een module toe te voegen zal de module zijn uitvoer op die pagina tonen. De complete inhoud van het tekstvlak wordt dan vervangen met de uitvoer van de module. Indien dat niet is gewenst (bijv. omdat eigen tekst voor/na de uitvoer getoond moet worden), kan de [CONTENT]-macro worden gebruikt. In plaats van het hele tekstvlak wordt alleen de macro vervangen met de uitvoer van de module. 

[­SCRIPT ...] en [­/SCRIPT]

Soms kan het nodig/wenselijk zijn om direct javascript in het tekstvlak op te nemen, bijvoorbeeld om inhoud van andere websites/applicaties/bronnen te tonen. Javascript kan niet direct in het tekstvlak worden opgenomen aangezien het direct door de browser uitgevoerd zal worden wat tot ongewenste effecten kan leiden.

De SCRIPT-macro is bedoeld om toch javascript in het tekstvlak op te kunnen nemen. Normaal ziet javascript-code er bijvoorbeeld als volgt uit:

Direct, met programma-code:

<script type="text/javascript">var mijn_var=123</script>

Indirect, door te verwijzen naar een url:

<script type="text/javascript" s­rc="ht­tp://url.naar.de/javascript-code"></script> 

 In beide gevallen dient <script ...> en </script> vervangen te worden door [­SCRIPT ...] resp. [­/SCRIPT].

Voor bovenstaande voorbeelden:

[­SCRIPT type="text/javascript"]var mijn_var=123[­/SCRIPT]

en:

[­SCRIPT type="text/javascript" sr­c="ht­tp://url.naar.de/javascript-code"][/­SCRIPT] 

[­SNIPPET url=...]

Om de uitvoer van een module direct ergens op een pagina te tonen kan de SNIPPET-macro worden gebruikt. De macro kent één parameter, namelijk de url (url=) van de module die moet worden aangeroepen. De module dient in dat geval wel geschikte html op te leveren die op de plaats van de macro kan worden ingevoegd (en mag bijv. geen <head>- of <body>-tag bevatten!). Voor de meeste modules kan dat worden bewerkstelligd door een geschikte template mee te geven (raadpleeg de mogelijkheden van de verschillende modules).

Voorbeeld:

[­SNIPPET url=cgi/objects.cgi?site=website;field=3;template=snippet_xyz] 

De url hoeft overigens niet naar een module van het cms zelf te wijzen! Laat de url beginnen met http://... en het cms zal die url aanroepen om de html op te halen.

Tip: Voor het tonen van (dynamische) content van eigen of externe content op (statische of dynamische) websites zijn overigens vele mogelijkheden beschikbaar, bijv. AJAX, RSS, etc. Vraag naar de mogelijkheden!

 

Via de INSERT-macro kan momenteel een CSV-bestand als tabel op een pagina worden ingevoegd.

Met

[­INSERT /help/download/common/voorbeeld.csv]

Wordt het bestand voorbeeld.csv direct als tabel in de pagina geplaatst (pas zichtbaar als de pagina opnieuw wordt geopend):

emailadres aanhef naam huisdier inentingsdatum
a.jansen@hotmial.com Dhr. Jansen kat 01-05-2005
test123@planet.nl Mevr. Smid hond 21-06-2005

De tabel wordt eenmalig ingevoegd. De tabel kan vervolgens worden bewerkt en opgemaakt met de standaard cms-functies. Bij wijzigingen aan het bestand dient de tabel opnieuw te worden aangemaakt door de tabel te verwijderen en de macro in te voegen.