Filelist formulierveld type
From Joomla! Documentation
Het filelist formulierveld type biedt een drop-down lijst met bestanden 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 filelist zijn.
- name (verplicht) is de unieke naam van het veld.
- label (verplicht) (vertaalbaar) is de beschrijvende titel van het veld.
- directory (optioneel) is het filesysteem-pad naar de map die de bestanden bevat die getoond moeten worden. Indien weggelaten wordt de map opgegeven door JPATH_ROOT aangenomen.
- default (optioneel) is de standaard bestandsnaam.
- description (optioneel) (vertaalbaar) is tekst die getoond wordt als tooltip als de gebruiker de muis beweegt over de drop-down box.
- filter (
) of fileFilter (
en daarna) (optioneel) is een reguliere expressie string welke gebruikt wordt om de lijst met bestanden 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 bestanden 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.
- stripext (optioneel) is een Boolean argument. indien waar ('true') wordt de extensie van de bestandsnaam verwijderd van de weergegeven bestanden. Merk ook op dat de bestandsnaam ook opgeslagen wordt zonder de extensie.
- 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.
Voorbeeld XML-velddefinitie:
<field name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />