Inhoudstafel

Genereert een inhoud boomstructuur van een opgegeven categorie.

#1. Installatie

1. Download de ZIP en pak het uitand unpack it.
2. Kopieer 'toc' naar je plugins folder.
3. Installeer het via Administratie / Extensies.

#2. Demo

Om de plugin in actie te zien kan je gaan naar Cotonti Documentatie. Zowel de documentatie index pagina als de balk aan de rechter zijkant op de standaard pagina's zoals deze zijn gegerereerd door deze plugin.

#3. Gebruik

De plugin voorziet een a callback/widget die kan gebruikt worden in page.list.tpl en page.tpl bestanden (categorie-specifieke bestanden inbegrepen).

Het volgende zal de totale inhoudstafel printen voor de categorie met als code 'docs':

{PHP|toc('docs')} 

Standaard wordt 'toc.tpl' gebruikt om de inhoudsopgave te genereren, maar je kan aangepaste TPL bestanden gebruiken voor verschillende widgets. Het volgende zal een inhoudstafel genereren aan de hand van toc.main.tpl:

{PHP|toc('docs', 'toc.main')} 

In subcategorieën en standaard pagina's zal ge geen volledige boomstructuur willen weergeven. Je kan de widget enkel de pagina's laten weergeven van de huidige categorie:

{PHP|toc('docs', 'toc', 1)} 

Dit zal er voor zorgen dat de niet-actieve categorieën ingevouwen zijn.

Gebruik CSS om de inhoudstafel stijl te geven. Hier is een voorbeeld:

ul.toc {
    list-style: none;
    margin: 10px 10px 10px 20px;
    display: block;
    clear: both;
}

ul.toc a.current {
    background-color: lightYellow;
}

ul.toc-main {
    list-style: none;
    margin: 10px 10px 10px 40px;
    display: block;
    clear: both;
}

ul.toc-main a.level-1.cat {
    font-size: 180%;
}

ul.toc-main a.level-2.cat {
    font-size: 150%;
}

ul.toc-main a.level-3.cat {
    font-size: 120%;
}

Meer informatie kan je vinden in de code van 'toc.php' en de PHPDoc blokken hierin.