+7 (499) 709-98-06

Система шаблонов всегда был одним из наиболее мощных возможностей Joomla, но до Joomla 1.5 было трудно для веб-дизайна компании корабля шаблонов с большим на пути встроенной гибкостью. Например, шаблон доступен в различных цветовых схем часто поставляется как набор отдельных файлов шаблона. Некоторые веб-дизайна компании создали свои собственные методы, позволяющие администратору сайта менять цветовые схемы и другие особенности шаблон в администратора, но эти методы не были стандартизированы и часто участвуют администратор сайта в редактирования конфигурационных файлов вручную, или установки пользовательских компонент Управлять шаблона.

Все изменилось с появлением Joomla 1.5, которые поддержали идею параметров шаблона. На самом деле было бы точнее называть их расширения параметров, как реализация общих для всех типов расширения: компоненты, модули, плагины и шаблоны. В этой главе вы узнаете о том, как создавать и использовать параметры в конструкции шаблона. Каждый из широкого спектра типов параметров непосредственно поддерживаются Joomla Рамочной подробно описано, но вы также узнаете, как создавать свои собственные типы параметров в соответствии с вашими особыми потребностями. Существует также краткая ссылка на регулярных выражений, как они используются в некоторых типах параметра шаблона.

Введение в параметры шаблона

Чтобы увидеть пример параметров шаблона в действии, перейдите в Расширения → Template Manager и нажмите на rhuk_milkyway шаблона. Вы увидите, на Шаблон: [Edit] экране, что существует группа параметров, содержащих пару полей называется Вариации цвета и фона вариации. См. рисунок ниже. Это типичные параметры шаблона и в этом случае они контролируют цветовую схему шаблона.

Шаблон параметры позволяют администратору настроить поведение шаблона, используя форму в администратора. Какие параметры доступны и что они делают это до шаблона дизайнера, но дизайнеры теперь есть набор простых в использовании инструментов для создания гибкости в свои шаблоны. Для дизайнера, это связано с внесением изменений в трех элементов:

* Добавление <param> элемент <params> разделе templateDetails.xml файл.
* Добавление линии params.ini файл, который будет проводить текущее значение параметра.
* Добавление код в файл шаблона PHP для получения текущего значения параметра и действовать по нему.

Определение параметров в templateDetails.xml

TemplateDetails.xml файл всегда находится в корневой каталог для шаблонов. Например, для шаблона Beez полный путь будет выглядеть так: [путь к Joomla] / шаблоны / Beez / templateDetails.xml

Обратите внимание, что письмо случае важно на регистр операционных систем, таких как Linux. Вы можете использовать стандартный текстовый редактор (не текстовый процессор) или редактор XML внести изменения в этот файл.

Найдите <params> элемент, как правило, ближе к концу файла. Если нет <params> элемента вам необходимо добавить еще один. Это должно быть непосредственно под <install> элемента в иерархии элементов XML. Не забудьте закрыть элемент с </ Params> тега. Заметим, что для Joomla 1,6 года <install> тег является устаревшим в пользу <Extension>.

* См. Создание основных templateDetails.xml файл введение в создание templateDetails.xml файла с нуля.
* См. Спецификация templateDetails.xml для детальной спецификации этого файла.

Для каждого параметра, который вы хотите определить, добавить <param> элемента. Этот элемент принимает ряд обязательных и необязательных аргументов, которые зависят от типа аргумента. Только по-настоящему обязательным аргумент типа, кроме названия, по умолчанию, описание и этикетки являются общими для большинства типов параметров и название является обязательным, если это происходит. Эти обязательные / общие аргументы:

* Тип определяет тип управления формы HTML используется в экран параметров шаблона в администратора, чтобы позволить пользователю изменять значение параметра.
* Имя уникальное имя параметра. Вы будете ссылаться на это имя при получении значения параметра в код шаблона.

Следующие аргументы не являются обязательными, но являются общими для почти всех типов параметров:

* По умолчанию По умолчанию значение параметра.
* Описание текста, который будет отображаться в качестве подсказки для поля на экране параметров шаблона в администратора. Это переводимые строки, см. Шаблон Переводы для информации о том, как добавить языковые переводы этой строки.
* Метка описательное название поля, которое будет показано пользователю в экран параметров шаблона в администратора. Это переводимые строки, см. Шаблон Переводы для информации о том, как добавить языковые переводы этой строки. Если на этикетке аргумент опущен, по умолчанию будет значение задается имя аргумента.

Необязательных аргументов зависит от типа параметра. Каждый из типов параметров подробно описана в Стандартные типы параметров. Если вы являетесь разработчиком это также возможность создавать свои собственные типы параметров, см. в разделе Создание пользовательских параметров XML-типов для получения дополнительной информации.

Например, следующий отрывок показывает <params> разделе определения двух параметров: один для раскрывающийся список изменения шаблона цвета, другой для переключатель, который позволит пользователю, чтобы показать или скрыть автора сообщения об авторских правах.

<params>
    <param name="templateColour" type="list" default="blue" 
            label="Template Colour" description="Choose the template colour.">
        <option value="blue">Blue</option>
        <option value="red">Red</option>
        <option value="green">Green</option>
        <option value="black">Black</option>
    </param>
    <param name="authorCopyright" type="radio" default="1" 
            label="Author Copyright" description="Show/Hide author copyright.">
        <option value="0">hide</option>
        <option value="1">show</option>
    </param>
</params>

На экране параметров шаблона для этого примера будет выглядеть следующим образом:.



Примечание: Параметр группы в настоящее время не поддерживается в параметры шаблона.

Совет: Чтобы включить HTML-теги в XML аргументы вы должны закодировать определенные специальные символы следующим образом:

Стандартные типы параметров

Есть много различных стандартных полей формы поддерживаемых типов в Joomla рамки для всех типов расширения (шаблоны, компоненты, модули и плагины). В этом разделе дается краткое описание каждого типа поля формы, в алфавитном порядке. Полная информация о каждом типе поля формы даны на следующих страницах.

Поля формы и JForm класса были введены в Joomla 1.6. До этого эти стандартные типы были переданы в качестве параметра типа и были обработаны, в настоящее время устарела, JParameter класса.

Тип	Описание	Доступность
accesslevel
cachehandler
calendar	обеспечивает текстовое поле для ввода даты. Значок рядом с текстовым полем обеспечивает ссылки на всплывающий календарь, который также может использоваться для ввода значения даты.
category	обеспечивает выпадающего списка категорий из данного раздела.
checkbox
checkboxes
combo
componentlayout
contentlanguage
editor
editors	обеспечивает выпадающего списка доступных редакторов WYSIWYG.
file
filelist	обеспечивает выпадающего списка файлов из указанного каталога.
folderlist	обеспечивает выпадающего списка папок из указанного каталога.
groupedlist
helpsite	обеспечивает выпадающего списка помочь сайтов для вашей установки Joomla.
helpsites	обеспечивает выпадающего списка помочь сайтов для вашей установки Joomla. Устарел, используйте helpsite в Joomla 1,6 года.
hidden	обеспечивает скрытое поле для сохранения параметров, значение которого не может быть изменен непосредственно на пользователя в администратора (это может быть изменено в коде или путем редактирования файла params.ini).
imagelist	обеспечивает выпадающего списка файлов изображений в указанный каталог.
imagelist
integer
language	обеспечивает выпадающего списка установленных языков для Фронтальный или Back-конца.
languages	обеспечивает выпадающего списка установленных языков для Фронтальный или Back-конца. Устарел, используйте языка в Joomla 1.6 года.
list	обеспечивает выпадающего списка определенных пользователем записи.
media
mediamanager
menu	обеспечивает выпадающего списка доступных меню с вашего сайта Joomla.
menuitem	обеспечивает выпадающего списка доступных элементов меню с вашего сайта Joomla.
modulelayout
password	обеспечивает текстовое поле для ввода пароля. Символы пароля будет Obscured по мере их ввода.
radio	обеспечивает переключатель для выбора различных вариантов.
rules
sessionhandler
section	обеспечивает выпадающего списка разделов с вашего сайта Joomla. Устарел, используйте категории в Joomla 1,6 года.
spacer	обеспечивает визуальный разделитель между элементами поля параметра. Это чисто наглядное пособие и не значение параметра хранится.
sql	обеспечивает выпадающего списка записей получить, выполнив запрос на Joomla базы данных. В первой колонке результатов, возвращенных запросом обеспечивает значения для выпадающего списка.
templatestyle
text	обеспечивает текстовое поле для ввода данных.
textarea	предоставляет текстовую область для ввода текста несколько строк.
timezone	обеспечивает выпадающего списка часовых поясов.
timezones	обеспечивает выпадающего списка часовых поясов. Устарел, используйте пояс в Joomla 1,6 года.
user
usergroup	обеспечивает выпадающего списка групп пользователей.

Стандартные типы параметров подробно

Календарь параметр типа

Тип календаря параметр обеспечивает текстовое поле для ввода даты. Значок
 рядом с текстовым полем обеспечивает ссылки на всплывающий календарь, 
который также может использоваться для ввода значения даты. Если параметр имеет значение сохранили это показано в текстовом поле. В противном случае значение по умолчанию, если таковые имеются, отображается.

    * Типа (обязательно) должны быть календарь.
    * Ваше имя (обязательно) это уникальное имя параметра.
    * Этикетки (обязательное) (переводимых) является описательным названием поля.
    * По умолчанию (необязательно): даты по умолчанию. Это должно быть дано в том же формате, как указано в формате аргумент.
    *
 Описание (необязательно) (переводимых) это текст, который будет показан
 в подсказке, когда пользователь перемещает курсор мыши на текстовом 
поле.
    * Формат (приобретается дополнительно) формат даты, которые будут использоваться. Это формат, используемый PHP для указания формата строки даты (см. ниже). Если формат не аргумент не задан, '% Y-% M-% D' предполагается (с указанием дат, как '2008-04-16 ').
    * Класс (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "InputBox.




Пример XML определения параметра:

<param name="mycalendar" type="calendar" default="5-10-2008" label="Select a date" description="" format="%d-%m-%Y" />


Формат поле определяет формат строки даты будут сохранены дюйма Кроме того, формат, введенные вручную даты должны быть 
в enterered; кроме того, что знак пунктуации игнорируются. Схема кодирования используется для определения формата даты так же, 
как формат строки даты PHP, полную информацию о которых можно найти на http://www.php.net/manual/en/function.date.php. 
Ниже приведены некоторые из наиболее часто используемых кодов строка даты:

Примечание: формат, в котором даты хранятся в params.ini файла является то, что указанный формат аргумента. Так не может быть на определенных языках и элементы в этом формате (например, спецификатор "% F"), вы должны быть осторожны, чтобы не использовать такие элементы, если есть возможность того, что внешний и фоновых языков может быть различны.

Примечание: тип календаря параметр не поддерживает, отличного от григорианского календарей. Если вам необходима поддержка, отличного от григорианского календарей то вам нужно будет создать пользовательский тип параметра для поддержки вашего календаря.

Категория параметр типа

Тип категории параметр обеспечивает выпадающего списка опубликованных категории из данного раздела. Если параметр имеет значение сохранили это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран. Первый вариант в списке всегда "- выберите категорию -" (что переводимые строки) и задается значение 0.

Обратите внимание, что рубрики будут показаны в выпадающем списке, даже если раздел они принадлежат не публикуется. Это сделать возможным создание областей проект содержания без необходимости сначала опубликовать разделе.

* Типа (обязательно) должны быть категории.
* Ваше имя (обязательно) это уникальное имя параметра.
* Этикетки (обязательное) (переводимых) является описательным названием поля.
* Раздел (дополнительное оборудование) идентификационный номер раздела, из которых категории в списке отображаются. Номер раздела ID можно найти в разделе Manager. Если этот аргумент опущен, все опубликованные категорий во всех разделах будут перечислены.
* Сферы (приобретается дополнительно) псевдоним для раздела.
* По умолчанию (необязательно) ID категории по умолчанию номер.
* Описание (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши на выпадающем списке.
* Класс (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "InputBox.

Пример XML определения параметра:

<param name="mycategory" type="category" label="Select a category" description="" section="3" />

Редакторы параметр типа

Типа редакторов параметр обеспечивает выпадающего списка доступных и включен редакторы WYSIWYG. Если параметр имеет значение сохранили это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

Первый вариант в списке всегда "- выберите Редактор - '(что переводимые строки) и задается значение 0.

    * Типа (обязательно) должны быть редакторов.
    * Ваше имя (обязательно) это уникальное имя параметра.
    * Этикетки (обязательное) (переводимых) является описательным названием поля.
    * По умолчанию (необязательно): название редактор по умолчанию. Это имя, указанное в колонке файла на экране диспетчера 
       подключаемых модулей.
    * Описание (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор 
      мыши на выпадающем списке.




Пример XML определения параметра:

<param name="myeditor" type="editors" default="none" label="Select an editor" />


Список файлов типа параметра

Список файлов типа параметра обеспечивает выпадающего списка файлов из указанного каталога. Если параметр имеет значение 
сохранили это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

По умолчанию, первый пункт в списке "- не использовать - '(что переводимые) и задается значение' -1 ', и это следует' - использовать по
 умолчанию -" (также переводимых) с учетом стоимости " 0 '.

    * Типа (обязательный) должен быть список файлов.
    * Ваше имя (обязательно) это уникальное имя параметра.
    * Этикетки (обязательное) (переводимых) является описательным названием поля.
    * Каталога (приобретается дополнительно) файловая система путь к каталогу, содержащему файлы, которые будут перечислены. 
     Если опустить каталога задается JPATH_ROOT предполагается.
    * По умолчанию (необязательно): имя файла по умолчанию.
    * Описание (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор 
      мыши на выпадающем списке.
    * Фильтром (приобретается дополнительно) регулярных выражений в строках, который используется для фильтрации списка файлов, 
       выбранных для включения в раскрывающемся списке. Если опущен, все файлы в каталоге включены. Фильтра аргумент применяется 
        перед исключить аргумента выражение. Для получения информации о построении регулярных выражениях см. 
       Регулярные выражения в параметре аргументы.
    * Исключить (приобретается дополнительно) регулярных выражений в строках, который используется для исключения файлов из списка. 
        Исключить аргумент выражение применяется после фильтра аргумент. Для получения информации о построении регулярных 
          выражениях см. Регулярные выражения в параметре аргументы.
    * Stripext (приобретается дополнительно) логический аргумент. Если так, то расширения имен файлов будут вырезаны из имен файлов в 
          списке. Отметим также, что имя файла будет сохранен без расширения тоже.
    * Hide_none (приобретается дополнительно) логический аргумент. Если это правда, "- не использовать -" пункт исключается из 
      раскрывающегося списка.
    * Hide_default (приобретается дополнительно) логический аргумент. Если это правда, '- использовать по умолчанию -
        "пункт исключается из раскрывающегося списка.




Пример XML определения параметра:

<param name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />


Folderlist параметр типа

Folderlist параметр типа обеспечивает выпадающий список папок с specfied каталога. Если параметр имеет значение сохранили это 
выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

По умолчанию, первый пункт в списке "- не использовать - '(что переводимые) и задается значение' -1 ', и это следует' - использовать по
 умолчанию -" (также переводимых) с учетом стоимости " 0 '.

    * Типа (обязательно) должны быть folderlist.
    * Ваше имя (обязательно) это уникальное имя параметра.
    * Этикетки (обязательное) (переводимых) является описательным названием поля.
    * Каталог (обязательно) является файловая система путь к каталогу, содержащему папки, которые будут перечислены.
    * По умолчанию (необязательно): имя папки по умолчанию.
    *
 Описание (необязательно) (переводимых) это текст, который будет показан
 в подсказке, когда пользователь перемещает курсор мыши на выпадающем 
списке.
    * Фильтром (приобретается дополнительно) регулярных выражений в строках, который используется для фильтрации списка папки, 
       выбранные для включения в раскрывающемся списке. Если опустить все папки в каталоге включены. Фильтра аргумент применяется 
        перед исключить аргумента выражение. Для получения информации о построении регулярных выражениях см. Регулярные выражения 
       в параметре аргументы.
    * Исключить (приобретается дополнительно) регулярных выражений в строках,  которая используется, чтобы исключить папки из списка.
       Исключить аргумент выражение применяется после фильтра аргумент. Для получения информации о построении регулярных
       выражениях см. Регулярные выражения в параметре аргументы.
    * Hide_none (приобретается дополнительно) логический аргумент. Если это правда, "- не использовать -" пункт исключается из 
     раскрывающегося списка.
    * Hide_default (приобретается дополнительно) логический аргумент. Если это правда, '- использовать по умолчанию - 
      "пункт исключается из раскрывающегося списка.




Пример XML определения параметра:

<param name="myfolder" type="folderlist" default="" label="Select a folder" directory="administrator" filter="" exclude="" stripext="" />

Helpsites параметр типа

Тип helpsites параметр обеспечивает выпадающего списка помочь сайтов в вашей установки Joomla. Если параметр имеет значение 
сохранили это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран. 
За исключением "местного" запись, которая всегда добавляется, список помочь сайтов создается из файла:

[Путь-к-Joomla] / administrator/help/helpsites-15.xml

"Местного" строка переводимые. "Местного" URL возвращается пустая строка.

    * Типа (обязательно) должны быть helpsites.
    * Ваше имя (обязательно) это уникальное имя параметра.
    * Этикетки (обязательное) (переводимых) является описательным названием поля.
    * По умолчанию (необязательно): сайт по умолчанию помощью URL (не видимые имя сайта помощь).
    * Описание (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши
      на выпадающем списке.



Пример XML определения параметра:

<param name="myhelpsite" type="helpsites" default="" label="Select a help site" description="" />


Скрытый параметр типа

Скрытый параметр типа обеспечивает скрытое поле для сохранения параметров, значение которого не может быть изменен 
непосредственно на пользователя в администратора (это может быть изменено в коде или путем редактирования файла params.ini). 
Если параметр имеет значение сохранено этого вводится в текстовое поле. Если нет, то значение по умолчанию (если таковые имеются) 
вводится. Как поле скрыто нет видимого поля в администратора.

    * type  (обязательно) должны быть скрыты.
    * name (обязательно) это уникальное имя параметра.
    * default (обязательно) это данные, которые необходимо собрать.
    * class (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "text_area.

Пример XML определения параметра:

<param name="mysecretvariable" type="hidden" default="" />



Imagelist параметр типа

Типа ImageList параметр обеспечивает выпадающего списка файлов изображений в указанный каталог. Только файлы с расширением. 
PNG,. GIF,. JPG,. BMP,. ICO расширения перечислены. Если параметр имеет значение сохранили это выбранного при первой загрузке 
страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

По умолчанию, первый пункт в списке "- не использовать - '(что переводимые) и задается значение' -1 ', и это следует' - использовать по
 умолчанию -" (также переводимых) с учетом стоимости " 0 '.

    * type (обязательно) должны быть ImageList.
    * name (обязательно) это уникальное имя параметра.
    * label  (обязательное) (переводимых) является описательным названием поля.
    * directory  (приобретается дополнительно) файловая система путь к каталогу, содержащему файлы изображений должны быть перечислены. 
Если опустить каталога задается JPATH_ROOT предполагается.
    * default (необязательно): файл изображения по умолчанию имя.
    * description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши
      на выпадающем списке.
    * filter (приобретается дополнительно) регулярных выражений в строках, который используется для фильтрации списка файлов 
изображений, выбранных для включения в 
раскрывающемся списке. Если опущен, все графические файлы в каталог включены. Фильтра аргумент применяется перед исключить 
аргумента выражение. Для получения информации о построении регулярных выражениях см. Регулярные выражения в параметре аргументы.
    * exclude (приобретается дополнительно) регулярных выражений в строках, которая используется, чтобы исключить файлы из списка.
      Исключить аргумент выражение применяется после фильтра аргумент. Для получения информации о построении регулярных 
     выражениях см. Регулярные выражения в параметре аргументы.
    * Stripext (приобретается дополнительно) логический аргумент. Если так, то расширения имен файлов будут вырезаны из файла список 
     имен. Отметим также, что имя файла будет сохранен без расширения тоже.
    * Hide_none (приобретается дополнительно) логический аргумент. Если это правда, "- не использовать -" пункт исключается из 
      раскрывающегося списка.
    * Hide_default (приобретается дополнительно) логический аргумент. Если это правда, '- использовать по умолчанию - 
       "пункт исключается из раскрывающегося списка.

Пример XML определения параметра:

<param name="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" />


Языки типа параметра

Тип языков параметр обеспечивает выпадающего списка установленных языков для Фронтальный или Back-конца. 
Если параметр имеет значение сохранили это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию 
(если таковые имеются) выбран. Значение, сохраненное является тег языка. Например, для английского (Великобритания), это будет 
"EN-GB".

Первый вариант в списке всегда "- Выберите язык -" (что переводимые строки) и задается значение 0.

    * type (обязательно) должны быть языках.
    * name (обязательно) это уникальное имя параметра.
    * label (обязательное) (переводимых) является описательным названием поля.
    * client  (обязательный) является применение которых установлены языки будут перечислены. Использование
 информации сайта, если вы хотите, чтобы список Фронтальный языков или 
администратором, если вы хотите, чтобы список Админцентр языках.
    * default (необязательно): тег языка по умолчанию. Например, "EN-GB".
    * description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши
   на выпадающем списке.



Пример XML определения параметра:

<param name="mylanguage" type="languages" client="site" default="en-GB" label="Select a language" description="" />

Список типов параметров

Списке параметров типа обеспечивает выпадающего списка определенных пользователем записи. Если параметр имеет значение сохранили это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

    * type  (обязательный) должен быть список.
    * name  (обязательно) это уникальное имя параметра.
    * label  (обязательное) (переводимых) является описательным названием поля.
    * default (необязательно): пункт списка по умолчанию значение.
    * description  (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши 
     на выпадающем списке.
    * class (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "InputBox.

Элемент XML <param> должны включать один или несколько <option> элементы, которые определяют элементы списка. 
Текст между <option> и </ опции> теги это то, что будет показано в выпадающем списке и переводимые строки. <option> Теги 
принимает следующие аргументы:

    * value (обязательный) является значение, которое будет сохранено для параметра, если этот пункт выбран.

Совет: Не забудьте закрыть определения параметра с </ param>.



Пример XML определения параметра:


<param name="mylistvalue" type="list" default="" label="Select an option" description="">
  <option value="0">Option 1</option>
  <option value="1">Option 2</option>
</param>

Меню параметр типа

Тип меню параметр обеспечивает выпадающего списка доступных меню с вашего сайта Joomla. Если параметр имеет значение сохранили 
это выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

Первый вариант в списке всегда "- выберите меню -" (что переводимые строки) и задается значение 0.

    * type (обязательный) должно быть меню.
    * name   (обязательно) это уникальное имя параметра.
    *  label   (обязательное) (переводимых) является описательным названием поля.
    * default (необязательно): меню по умолчанию. Отметим, что это имя меню показано в столбце "Тип на экране меню менеджера, 
       а не число меню ID.
    * description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши
     на выпадающем списке.





Пример XML определения параметра:

<param name="mymenuitem" type="menuitem" default="45" label="Select a menu item" description="Select a menu item" />


Пароль тип параметра

Введите пароль параметр обеспечивает текстовое поле для ввода пароля. Символы пароля будет Obscured по мере их ввода. 
Если параметр имеет значение сохранено этого вводится (в Obscured форме) в текстовое поле. Если нет, то значение по умолчанию 
(если таковые имеются) вводится.

Обратите внимание, что строка пароля хранится в params.ini в открытом виде, хранится значение не закрывались любой хеш-функции. 
Поскольку большинство веб-серверов, по умолчанию, служат params.ini файл, если URL-адрес введен в веб-браузере, это не может 
считаться безопасным методом проведения пароль.

    * type (обязательный) должен быть пароль.
    * name (обязательно) это уникальное имя параметра.
    * label (обязательное) (переводимых) является описательным названием поля.
    * size (приобретается дополнительно) ширина текстового поля в символах. Если опустить ширина определяется браузера. 
       Значение размера не ограничивает количество символов, которые могут быть введены.
    * default (необязательно) пароль по умолчанию.
    * description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор 
   мыши на выпадающем списке.
    * class  (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "text_area.



Пример XML определения параметра:

<param name="mypassword" type="password" default="secret" label="Enter a password" description="" size="5" />


Радио параметр типа

Типа радио параметр обеспечивает переключатель для выбора различных вариантов. Если параметр имеет значение сохранили это
 выбранного при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

type (обязательно) должны быть радио.
 name   (обязательно) это уникальное имя параметра.     
label  (обязательное) (переводимых) является описательным названием поля. 
default (необязательно): по умолчанию переключатель значения элемента. 
description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши 
 на выпадающем списке.


Элемент XML <param> должны включать один или несколько <option> элементы, которые определяют отдельные элементы переключатель. 
Текст между <option> и </ optio n> теги показано, как ярлык для переключатель и переводимые строки. <option> Теги принимает 
  следующие аргументы:


 value  (обязательный) является значение, которое будет сохранено для параметра, если этот пункт выбран.

Совет: Не забудьте закрыть определения параметра с </ param>.

Пример XML определения параметра:

<param name="myradiovalue" type="radio" default="0" label="Select an option" description="">
  <option value="0">1</option>
  <option value="1">2</option>
</param>


Раздел параметр типа

Тип раздела параметр обеспечивает выпадающего списка опубликованных разделов вашего сайта Joomla. 
Если параметр имеет значение сохранены, это значение выбранного при первой загрузке страницы. Если нет, то значение по умолчанию
 (если таковые имеются) выбран.

Первый вариант в списке всегда "- Выберите раздел - '(что переводимые строки) и задается значение 0.

 
 * type (обязательный) должен быть раздел.
 * name (обязательно) это уникальное имя параметра.
 * label (обязательное) (переводимых) является описательным названием поля. 
 * default (необязательно) (переводимых) является ID умолчанию номер раздела.
 * description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор 
 мыши на выпадающем списке.




Пример XML определения параметра:

<param name="mysection" type="section" default="" label="Select a section" description="" /> 

Spacer параметр типа

Тип Spacer параметр обеспечивает визуальный разделитель между элементами поля параметра. Это чисто наглядное пособие и не значение параметра хранится.

• type (обязательно) должны быть прослойкой spacer.
• default (необязательно) (переводимых) является строка, которая будет использоваться вместо <hr />, который вставляется по умолчанию.

Пример XML определения параметра:

<param type="spacer" />

Вы можете заменить основной горизонтальной линии с названием, которое может быть использовано для группы параметров. Например,

<param type="spacer" default="Advanced parameters" />

Обратите внимание, что вы можете также включить HTML разметку, но он должен быть закодирован. Например, чтобы поместить текст в смелых вы можете использовать:

<param type="spacer" default="&lt;b&gt;Advanced parameters&lt;/b&gt;" />

Sql параметр типа

SQL параметр типа обеспечивает выпадающего списка записей получить, выполнив запрос к базе данных Joomla. 
Если параметр имеет значение сохранены, это значение выбранного при первой загрузке страницы. Если нет, то значение по умолчанию 
(если таковые имеются) выбран.

    * type (обязательный) должен быть SQL.
    * name (обязательно) это уникальное имя параметра. Это должно совпадать с именем запроса столбца результатов, который содержит    
 значения, которые будут показаны пользователю в выпадающем списке, если иное не указано имя в value_field атрибута.
    * label  (обязательное) (переводимых) является описательным названием поля.
    * query  (обязательно) является запросов SQL который будет предоставлять данные для раскрывающегося списка. Запрос    
 должен возвращать двумя колоннами, одна называется "стоимость" (если не заменится key_field атрибутов), который проведет значений 
  элементов списка, другие называют так же, как значение имени атрибута (если не заменится value_field атрибут) содержащие текст, 
    который будет показан в раскрывающемся списке.
    * default (необязательно) значение по умолчанию. Это значение поля "стоимость", если не заменится key_field атрибута.
    * description(необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор 
   мыши на выпадающем списке.
    * Key_field (приобретается дополнительно) имя столбца, который будет содержать значения для параметра. Если этот аргумент опущен, 
       то столбец "значение" будет использоваться, если он существует.
    * Value_field (приобретается дополнительно) имя столбца, который будет содержать значения, который будет передаваться пользователю 
  в раскрывающемся списке. Если этот аргумент опущен, то столбец с таким же именем, как имя атрибута будет использоваться, если он 
 существует.





Пример XML определения параметра:

<param name="title" type="sql" default="10" label="Select an article" query="SELECT id AS value, title FROM #__content" />


Обратите
 внимание, что предложение как это было использовано в этом примере, 
потому jos_content таблица не имеет столбец "значение". На самом деле очень мало таблиц в базе данных Joomla есть столбец "значение". 
Кроме того, вы можете использовать key_field атрибут для определения столбца, вместо value':

<param name="title" type="sql" default="10" label="Select an article" query="SELECT id, title FROM #__content" key_field=”id” />


Это даст одинаковый результат в предыдущем примере.

И имена столбцов может потребоваться псевдонимом. Например, предположим, вы хотите, чтобы ваши поля, чтобы называться "MyField"
 вместо "title" в предыдущем примере. Тогда вы можете сделать следующее:

<param name="myfield" type="sql" default="10" label="Select an article" query="SELECT id AS value, title AS myfield FROM #__content" />

Или альтернативный вариант:

<param name="myfield" type="sql" default="10" label="Select an article" query="SELECT id, title FROM #__content" key_field=”id” value_field=”title” />

Вы также можете собрать или расчета полей в заявлении SQL. Например, предположим, вы хотели добавить создан дата / время каждой статьи на название статьи в списке. Тогда вы сможете использовать эту инструкцию SQL:

SELECT id, concat( title, ' (', created, ')') AS title FROM #__content

Примечание: SQL заявления необходимо будет правильным для тип и версию основной базы данных, что Joomla работает. Это, скорее всего, версия MySQL, но это может быть что-то другое. Существует не возможность для запросов к базам данных других, чем тот, Joomla сам работает.

Примечание: Как показано в этих примерах, префикс базы данных могут быть введены в '_ #' вид (хэш-подчеркивание), в этом случае он будет автоматически заменен префикс базы данных используется Joomla.

Текст параметр типа

Тип текста параметр обеспечивает текстовое поле для ввода данных. Если параметр имеет значение сохранены, это значение отображается при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

• type (обязательный) должен быть текст text.
• name (обязательно) это уникальное имя параметра.
• label (обязательное) (переводимых) является описательным названием поля.
• size (приобретается дополнительно) ширина текстового поля в символах. Если опустить ширина определяется браузера. Значение размера не ограничивает количество символов, которые могут быть введены.
• default (необязательно) (переводимых) значение по умолчанию.
• description(необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши на выпадающем списке.
• class(приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "text_area.
  
  Пример XML определения параметра:

<param name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />

Textarea параметр типа

Тип текстовой параметр обеспечивает текстовое поле для ввода текста несколько строк. Если параметр имеет значение сохранены, это значение отображается при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

• type (обязательно) должны быть текстовой textarea.
• name (обязательно) это уникальное имя параметра.
• label (обязательное) (переводимых) является описательным названием поля.
• rows (обязательно) является высота видимой области текста в строках. Если опустить ширина определяется браузера. Значение строки не ограничивает количество строк, которые могут быть введены.
• cols (обязательно) является ширина видимой области текста в символах. Если опустить ширина определяется браузера. Значение столбцов не ограничивает количество символов, которые могут быть введены.
• default (необязательно) (переводимых) значение по умолчанию.
• description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши на выпадающем списке.
• class (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "text_area.
  
  Пример XML определения параметра:

<param name="mytextarea" type="textarea" default="default" label="Enter some text" description="" rows="10" cols="5" />

Часовые пояса параметр типа

Типа часовых поясов параметр обеспечивает выпадающего списка часовых поясов. Если параметр имеет значение сохранены, это значение отображается при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

• type (обязательно) должны быть часовых поясов timezones.
• name (обязательно) это уникальное имя параметра.
• label (обязательное) (переводимых) является описательным названием поля.
• default (необязательно) (переводимых) является Часовой пояс по умолчанию. Например, можно использовать "-10" за "(UTC -10:00) Гавайи".
• description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши на выпадающем списке.

Пример XML определения параметра:

<param name="mytimezone" type="timezones" default="-10" label="Select a timezone" description="" />

Группа параметр типа

Группа параметр типа обеспечивает выпадающего списка групп пользователей. Если параметр имеет значение сохранены, это значение отображается при первой загрузке страницы. Если нет, то значение по умолчанию (если таковые имеются) выбран.

• type (обязательно) должны быть группе пользователей usergroup.
• name (обязательно) это уникальное имя параметра.
• label (обязательное) (переводимых) является описательным названием поля.
• default (необязательно): по умолчанию для группы пользователей. Это идентификатор пользователя номер группы.
• size (приобретается дополнительно) количество строк списка для отображения. Если Есть несколько элементов в списке превышает указанный размер, то выделите-бар появится. Если нет размер атрибутов, список будет показано, как в раскрывающемся списке, если несколько не установлен. Если несколько верно и размер не установлен, по умолчанию размер количество элементов в списке.
• multiple(опционально) указывает, является ли выбор нескольких элементов не допускается. Если несколько атрибут присутствует (например, несколько = "YES"), то несколько элементов может быть выбран из раскрывающегося списка. Если этот аргумент опущен, то только один пункт может быть выбран. Заметим, что если несколько используется, выбранные значения возвращаются в виде массива. Кроме того, если несколько используется, вы должны установить размер атрибута для управления размером списка.
• description (необязательно) (переводимых) это текст, который будет показан в подсказке, когда пользователь перемещает курсор мыши на выпадающем списке.
• class (приобретается дополнительно) Название класса для поля формы HTML. Если опустить это будет по умолчанию "InputBox.

Пример XML определения параметра:

<param name="myusergroups" type="usergroup" default="" label="Select a user group" description="" />

 

 

Хранение значений параметров

Текущие значения параметров шаблона хранятся в файле [path-to-Joomla]/templates/[template-name]/params.ini

Если шаблон имеет параметры, и Вы намерены создать установочный пакет для него, то вы должны добавить этот файл <files> раздел templateDetails.xml file.

<files>
        ........
 
        <filename>params.ini</filename>
 
        ........
 
</files>

Установки будет гарантировать, что params.ini файл имеет правильный собственности и разрешений и поэтому записи.

Params.ini файл распространяется в пакете установки шаблон действительно может быть пустой, как значения по умолчанию параметры могут быть установлены в <param> элементов в templateDetails.xml файл. Наличие пустого файла шаблона во время установки просто гарантирует, что это записи. Однако, если вы хотите распространять params.ini файл с параметров по умолчанию значения, установленные в ней, это простая процедура для создания одного:

1. На тестовой системе, создайте пустой файл params.ini, убедившись, что это записи на веб-сервере.
2. Войти в заднюю администратора конца и перейти к экрану параметров шаблона для вашего шаблона.
3. Установите все параметры к значениям, которые вы хотите в качестве значения по умолчанию.
4. Нажмите кнопку Сохранить.
5. Возьмите копию params.ini файл положить в пакет шаблонов. Это теперь содержит все значения параметров по умолчанию.

Кроме того, как формат очень просто, вы можете создать params.ini файл вручную. Именно в стандартный формат файла INI с одним параметром в строке. Имя параметра и его значение, разделенных знаком равенства. Например:

templateColour=blue
authorCopyright=1

Получение данных параметров в файл шаблона

Определив параметр в templateDetails.xml файл и сохранить значение для него в params.ini файл, он еще предстоит выяснить, как получить текущее значение параметра, чтобы он мог быть использован в код шаблона.

Чтобы получить значение параметра в код шаблона использовать вызов функции:

<?php $myParam = $this->params->get( 'parameterName' ); ?>

Отметим, что $thisобъект в шаблон всегда текущий экземпляр объекта JDocument. Также отметим, что $this->params является объект типа JParameter.

Например, предположим, что шаблон имеет параметр, называемый templateColour которая принимает различные значения строки, которые определяют цветовые схемы, которые будут использоваться. Цветовые схемы сами определяются в CSS файлах, которые включают название цвета в качестве части их имена. Следующий код извлекает параметр добавляет соответствующей таблицы стилей для отображения страницы в нужном цветовой гамме.

<?php
$tplColour = $this->params->get( 'templateColour' );
$this->addStyleSheet( $this->baseurl  . '/templates/'
                    . $this->template . '/css/' . $tplColour .'.css' );
?>

В качестве другого примера, предположим, что шаблон имеет параметр, называемый authorCopyright которая принимает значение 0, чтобы скрыть уведомление об авторском праве, или 1, чтобы показать его. Следующий код извлекает параметр затем выводит уведомление об авторских правах в условный оператор PHP:

<?php if ($this->params->get( 'authorCopyright' )) : ?>   
     <div class="copyright">
         Copyright &copy; 2008 Fat Pigeon Templates
     </div>
<?php endif; ?>

Создание пользовательских параметров XML-типов

Можно расширить типы параметров, что Joomla может поддерживать за рамки стандартных типов, доступных в установки по умолчанию. Чтобы понять, как это сделать, сначала рассмотрим, как стандартные типы реализуются.

Расположение стандартный код типы параметров

Код для стандартных типов параметров можно найти в каталоге

[path-to-Joomla]/libraries/joomla/html/parameter/element/

Каждый параметр типа определен в отдельном файле, который должен иметь то же имя в качестве параметра типа. Например, категории типа кодируется в

[path-to-Joomla]/libraries/joomla/html/parameter/element/category.php

Этот файл содержит один класс, называемый JElementCategory которая простирается JElement. Именования файлов и классов, используемых здесь это не просто конвенции. Файл должен иметь то же имя, тип параметра и он должен содержать класс, называемый JElement элемента [имя] в противном случае Joomla Рамочной не будет в состоянии признать и поддержать параметр типа.

Начиная новый пользовательский тип параметра

Чтобы создать пользовательский тип параметра, который в первую очередь необходимо выбрать для него имя. Предположим, вы хотите назвать это newparm. Тогда вы будете создавать новый файл с именем newparm.php содержащий один класс, называемый JElementNewparm которая простирается JElement.

Код для нового параметра могут существовать практически в любом месте, но он всегда должен быть помещен в подкаталог по своей инициативе или с кодом для других пользовательских типов параметров.

Новый параметр типа, скорее всего, связано с определенным расширением, и в этом случае вам нужно будет расслоение код для параметра типа с кодом для расширения.

Где вы поместите этот файл несколько гибкая и зависит до некоторой степени от типа расширения, которое вы разрабатываете. Для шаблонов рекомендуется поместить его здесь

path-to-Joomla]/templates/[template-name]/elements/newparm.php

 

Изменения в файле XML для пользовательских типов параметров

Вам необходимо сделать два конкретных поправок в файл конфигурации XML. Во-первых, необходимо убедиться, что файл включен в список <files>:

<files>
    ........
    <filename>elements/index.html</filename>
    <filename>elements/newparm.php</filename>
    ........
</files>

Совет: Хорошей практикой является также включать пустой файл index.html в каталоге элементы, как дополнительные меры предосторожности, безопасности, чтобы предотвратить списки каталогов возвращаются на веб-сервере.

Кроме того, можно просто включить весь каталог элементов, используя <folders> элемента:

<files>
    ........
    <folder>elements</folder>
    ........
</files>

Вторая поправка, что вам нужно сделать, чтобы файл конфигурации XML является пусть Joomla Рамочной знаю, что вы добавили новый параметр типа и где найти код для его поддержки. Для этого вам добавить addpath аргумент <params> теги:

<params addpath=”[path]/elements”>
   ...... list of <param> elements ......
</params>

Обратите внимание, что вы добавляете путь к директории, содержащей код параметра типа, а не код самого файла. Отметим также, что у вас только один аргумент addpath так что если вы добавляете несколько типов параметров необходимо собрать их в тот же подкаталог, и что суб-каталог должен содержать только код параметра определения типа.

Например, это будет типичный элемент <params> в templeDetails.xml файл:

<params addpath=”[path-Joomla]/templates/mytemplate/elements”>
    <param type=”newparm” name=”setting1” default=”12” />
    <param type=”text” name=”setting2” value=”Some text” />
</params>

Кодирование пользовательский тип параметра

Самый простой способ, чтобы написать код для нового типа параметра взять код для существующего типа параметра, который похож на то, что вы хотите создать и адаптировать его в соответствии с вашими требованиями. Базовый класс JElement содержит почти все, что вам нужно, и для большинства типов параметров вам нужно будет только для переопределения fetchElement метод в класс расширений.

FetchElement метод возвращает код HTML, необходимые для визуализации поля, которые будут использоваться для ввода значения параметра. Он принимает четыре аргумента:

fetchElement( $name, $value, &$node, $control_name )

где:

$name	уникальное имя параметра, от названия аргумента.
$value	текущее значение параметра.
$node	JSimpleXMLElement объект, представляющий <param> элемен
$control_name	является параметром типа от типа аргумента ("категории" например, или "newparm)

To obtain the value of an argument in the <param> element you use the attribute method of the JSimpleXMLElement object passed in $node. For example, to obtain the value of the class argument you could use code like this

$class = $node->attributes( 'class' );

Чтобы получить значение аргумента в <param> элемент вы используете атрибут метод объекта JSimpleXMLElement прошло в $ узла. Например, чтобы получить значение класса аргумент можно использовать такой код

function fetchElement( $name, $value, &$node, $control_name )
{ 
    $class = $node->attributes( 'class' ) ? $node->attributes( 'class' ) : "text_area";
 
    $return = '<input type="text"' .
                     'name="' . $control_name . '[' . $name . ']"' .
                     'id="'   . $control_name . '[' . $name . ']"' .
                     'value="' . $value . '"' .
                     'class="' . $class . '" />'; 
    return $return;
}

Обратите внимание, что поля параметра должны иметь атрибут со значением показано в этом примере, так что элемент <label> HTML производства умолчанию fetchTooltip метод будет совпадать с его правильно.

Единственный способ от JElement, что Вы могли бы предположительно хотите переопределить это fetchTooltip метод. Этот метод возвращает код HTML, необходимых для оказания подсказка для поля. В большинстве случаев по умолчанию код будет полностью подходящий и вам не нужно будет, чтобы переопределить этот метод. Это займет пять аргументов:

fetchTooltip( $label, $description, &$node, $control_name=,$name= )

где:

$label	i строки приведены в этикетке аргумент <param> определение. Он должен быть пропущен через систему перевода языка перед использованием.
$description	в описании аргумента <param> определение. Он должен быть пропущен через систему перевода языка перед использованием.
$node	JSimpleXMLElement объект, представляющий <param> элемента.
$control_name	является параметром типа от типа аргумента ("категории" например, или "newparm ').
$name	уникальное имя параметра, от названия аргумента.

Чтобы передать строку с помощью системы перевода вам просто необходимо использовать JText статического класса, как это

$output = JText::_( 'string to be translated' );

Регулярные выражения в параметре аргументы

Некоторые параметра аргументы принимать регулярные выражения в качестве значения. Например, фильтр и исключить аргументы для файлов и типы ImageList параметра. Это чрезвычайно мощный, но она требует, чтобы вы знали по крайней мере немного синтаксис регулярных выражений, чтобы иметь возможность использовать его эффективно.

Описанные здесь некоторые примеры простых регулярных выражений, которые вы можете использовать в контексте параметров шаблона. Полная ссылка на синтаксисе регулярных выражений выходит за рамки этой книги, но их можно найти в Интернете по адресу http://www.php.net/manual/en/book.pcre.php

Простые строки фильтра

Предположим, вы хотите использовать параметр типа файлов в список файлов в заданной директории. Есть много файлов в каталоге, но вы только хотите, чтобы эти с. PHP-расширения должны быть перечислены. Тогда вы будете использовать этот аргумент в <param> элемент

filter = “\.php”

Первое, что нужно отметить, ведущий характер обратную косую черту. Это необходимо, потому что "." Имеет специальное значение в регулярных выражениях, и это не то, что предназначено здесь. Косая черта говорит регулярное выражение анализатор для лечения следующий символ (который является ".") Просто как обычный символ и не дать ему особое значение, что он обычно делает.

Эффект этого фильтра строка включать только те файлы, которые имеют символы ".", "Р", "з" и "Р", именно в таком порядке, в любом месте в имени файла.

Закрепление в конце строки

В приведенном выше примере, если есть файл с именем configuration.php-расстояние, то он будет включен в список, потому что ". PHP" происходит в середине строки. Возможно, вы не хотите, что в этом случае вы можете использовать вместо этого

filter = “\.php$”

“$”Рассказывает регулярных анализатор выражение, строку ". PHP" должно произойти в конце имени файла. Так configuration.php будет включен, но configuration.php-расстояние не будет.

Закрепление в начало строки

Предположим, вы хотите, чтобы список тех файлов, которые начинаются со строки "Joomla", то вы должны использовать

filter = “^joomla”

“^”Рассказывает регулярных анализатор выражение, строку следующим должно произойти в начале названия файла.

Закрепление в оба конца строки

Предположим, вы хотите, чтобы перечислить все те файлы, имена которых начинаются с "Joomla" и заканчивается ". PHP", но вы не заботитесь о том, что между ними. Затем вы можете использовать

filter = “^joomla(.*)\.php$”

Здесь вы узнаете "^" характер, как якорь начала строки, и "$", как якорь конца строки. "(.*)" Указывает, что любое количество символов, включая символы не на всех, приемлемы в этом положении. "." Нарушение этого немного вниз, будет соответствовать любому символу, "*" указывает, что предыдущий символ (в данном случае ".") Может возникнуть в любое количество раз, включая ноль, и скобки служат в качестве разделителей подстрока от остальной части строки.

Чувствительность к регистру

Важно отметить, что регулярные выражения строк с учетом регистра. Предположим, у вас есть какой-то файл, имена которых начинаются с "Joomla" вместо "Joomla". Они не будут включены, если вы использовали строку в предыдущем примере. Для обеспечения первого символа имени файла будет верхнем или нижнем регистре можно использовать

filter = “^[Jj]oomla”

Здесь "[Jj]" означает, что либо "J" или "J" должны быть согласованы. Скобках указывают ("[]") "класс знаков" и должен содержать список персонажей, которые должны быть согласованы. Если вы хотите, чтобы включить все имена, начинающиеся с буквы "S", "T", "U" или "V", то вы могли бы использовать

filter = “^[stuv]”

На самом деле вы можете сократить этот маленький, используя диапазон спецификации

filter = “^[s-v]”

Если вы хотите, чтобы сделать это без учета регистра затем использовать

filter = “^[s-vS-V]”

Фильтрация список расширений

Предположим, вы хотите фильтровать список файлов так, что только те файлы с определенными расширениями включены. Для одного расширения, которое вы можете просто использовать

filter = “\.php$”

Но что, если вы хотите, чтобы фильтр несколько расширений? Например, чтобы включать только имена файлов с расширением ". PHP", ". HTML" или ". Txt" можно использовать

filter = “\.php$|\.html$|\.txt$”

"|" Характер указывает альтернативный, так что "этот | тот" будет матч с "этой" или "что".

Вы могли заметить, что типа ImageList параметра точно так же, как параметр типа файлов с этой строки фильтра

filter = “\.png$|\.gif$|\.jpg$|\.bmp$|\.ico$”