Tekst źródłowy strony Parametr typu imagelist

'''Parametr typu imagelist''' - {{j_15}}
[[Grafika:params_imagelist.png|right]]
Parametr typu '''imagelist''' udostępnia rozwijaną listę plików we wskazanym katalogu. Na liście znajdą się jedynie pliki z rozszerzeniem: .png, .gif, .jpg, .bmp, .ico. 
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ć ''imagelist''.
* '''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:
<source lang="xml"><param name="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" /></source>
<noinclude>
=== Pozostałe typy parametrów ===
{{NTP}}
{{NTPF}}

=== Zobacz także ===
{{NTPL}}
<noinclude>
[[Kategoria:Typy parametrów|Imagelist]]
</noinclude>