Aktualna wersja na dzień 17:32, 17 sie 2011
Parametr typu filelist -
Parametr typu filelist udostępnia rozwijaną listę plików we wskazanym katalogu. Jeśli wartość parametru jest zapisana w pliku params.ini, wyświetlone zostaną pliki ze wskazanego katalogu. Jeśli wartość nie będzie zapisana, zostaną wyświetlone pliki z katalogu ustalonego przez JPATH_ROOT (macierzystego katalogu Joomla).
Domyślną pierwszą opcją na liście jest '- Do not use -' (można tłumaczyć), a jej wartość wynosi '-1', następną opcją jest '- Use default -' (można tłumaczyć), a jej wartość wynosi '0'.
- type (obowiązkowy): musi to być filelist.
- name (obowiązkowy): niepowtarzalne oznaczenie – nazwa parametru.
- label (obowiązkowy, można tłumaczyć) etykieta – tytuł opisujący parametr.
- directory (opcjonalny) ścieżka do katalogu, z którego będą listowane pliki. Jeśli opuszczona, zostaną wyświetlone pliki z katalogu ustalonego przez JPATH_ROOT.
- default (opcjonalny) nazwa domyślnego pliku.
- description (opcjonalny, można tłumaczyć) opis, wskazówka objaśniająca, wyświetlana gdy użytkownik umieści wskaźnik myszki nad nazwą - etykietą parametru.
- filter (opcjonalny) wyrażenie regularne filtrujące pliki, które zostaną umieszczone na liście rozwijanej. Jeśli jest opuszczone, wyświetlone zostaną wszystkie pliki z katalogu. Wyrażenie umieszczone w argumencie filter jest stosowane przed wyrażeniem umieszczonym w argumencie exclude. Więcej informacji na temat wyrażeń regularnych znajdziesz w Wyrażenia regularne w argumentach parametrów.
- exclude (opcjonalny) wyrażenie regularne decydujące o tym, których z plików na liście nie umieszczać. Wyrażenie umieszczone w argumencie exclude jest stosowane ppo wyrażeniu umieszczonym w argumencie filter. Więcej informacji na temat wyrażeń regularnych znajdziesz w Wyrażenia regularne w argumentach parametrów.
- stripext (opcjonalny) argument logiczny (boolean). Jeśli prawda (Tak), nazwy plików zostanie skrócone - będą wyświetlane bez rozszerzenia. Uwaga: W takim przypadku będą również zapisywane bez rozszerzenia!
- hide_none (opcjonalny) argument logiczny (boolean). Jeśli prawda (Tak), na liście zostanie opuszczona pozycja '- Do not use -'.
- hide_default (opcjonalny) argument logiczny (boolean).. Jeśli prawda (Tak), na liście zostanie opuszczona pozycja '- Use default -'.
Przykład definicji parametrów w pliku XML:
<param name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />
Pozostałe typy parametrów
Zobacz także