Dokumentation der StringParser_BBCode-Klasse

7. Maximales Auftreten von Elementen

7.1 Codes gruppieren

Die Klasse bietet auch eine Möglichkeit, zu beschränken, wie oft ein Code auftreten darf. Dazu muss man Codes erst zu Gruppen zusammen fassen und dann kann man festlegen, wie oft eine Gruppe auftreten darf. Der erste Code über der maximalen Anzahl wird dann schlichtweg ignoriert und als normaler Text angefügt. Wenn man nur einen einzelnen Code beschränken will, muss man dennoch eine Gruppe erstellen. Man weist einem Code eine Gruppe mit Hilfe der Methode setOccurrenceType zu:

$bbcode->setOccurrenceType ('url', 'link');

Dieser Codeabschnitt würde den Code [url] der Gruppe link zuweisen. Die Benennung der Gruppe ist vollkommen willkürlich. Man muss die Gruppe vorher nicht erstellen oder sonst etwas in dieser Art, man muss sie lediglich beim Funktionsaufruf angeben.

7.2 Limits festlegen

Mit Hilfe der Methode setMaxOccurrences kann man festlegen, wie oft eine Gruppe vorkommen kann. Der Aufruf erfolgt so:

$bbcode->setMaxOccurrences ('link', 15);

Dies würde für die Gruppe link eine Beschränkung von 15 maximalen Auftreten definieren. Alle weiteren würden ignoriert werden.