Folderlist formulierveld type
From Joomla! Documentation
Het folderlist formulierveld type biedt een drop-down lijst met mappen uit een bepaalde map. Indien het veld een opgeslagen waarde heeft, wordt deze geselecteerd als de pagina voor het eerst geladen wordt. Indien niet, wordt de standaard waarde (als die er is) geselecteerd.
Standaard is het eerste item in de lijst '- Niet gebruiken -' (wat vertaalbaar is) en krijgt de waarde '-1' en dit wordt gevolgd door '- Gebruik standaard -' (ook vertaalbaar) dat de waarde '0' krijgt.
- type (verplicht) moet folderlist zijn.
- name (verplicht) is de unieke naam van het veld.
- label (verplicht) (vertaalbaar) is de beschrijvende titel van het veld.
- directory (verplicht) is het filesysteem pad naar de map die de mappen bevat die getoond moeten worden.
- default (optioneel) is de standaard mapnaam.
- description (optioneel) (vertaalbaar) is tekst die getoond wordt als tooltip als de gebruiker de muis beweegt over de drop-down box.
- filter (
) of folderFilter (
en daarna) (optioneel) is een reguliere expressie string welke gebruikt wordt om de lijst met mappen geselecteerd om op te nemen, te filteren. Indien niet opgenomen worden alle bestanden in de map opgenomen. Het 'filter' argument wordt toegepast voor de 'exclude' expressie. Zie voor informatie over het maken van reguliere expressies Reguliere expressies in parameter argumenten.
- exclude (optioneel) is een reguliere expressie string die gebruikt wordt om mappen uit te sluiten van de lijst. De 'exclude' argument expressie wordt toegepast na de 'filter' expressie. Zie, voor informatie over het maken van reguliere expressies Reguliere expressies in parameter argumenten.
- hide_none (optioneel) is een boolean argument. Indien waar, wordt het '- None selected -' item weggelaten uit de drop-down lijst.
- hide_default (optioneel) is een boolean argument. Indien waar wordt het '- Use default -' item weggelaten uit de drop-down lijst.
- recursive (optioneel) is een boolean argument. Indien waar, dan bevat de lijst met mappen recursief alle gevonden sub-mappen. Let op: Als u een groot aantal sub-mappen heeft kan dat het pagina laden vertragen.
Voorbeeld XML-velddefinitie:
<field name="myfolder" type="folderlist" default="" label="Select a folder" directory="administrator" filter="" exclude="" stripext="" />