|
Параметры компонента сложнее, чем у других расширений. При создании или редактировании подключаемых модулей, шаблонов, модулей и языковых расширений содержимое элемента разметки config считывается из XML-файла с целью определить параметры данного расширения. Набор параметров определяется для каждого экземпляра расширения. Для управления компонентом при его создании обычно требуется один или более пункт меню в административной части веб-сайта. Меню административной части веб-сайта на Joomla создаются иначе, чем меню пользовательской части. Пункты меню в пользовательской части определяются администратором веб-сайта с помощью административного компонента com_menus. А в административной части пункты добавляются в меню Components при установке компонентов. Если предполагается распространение модуля, его придется снабдить файлом экранной справки. С этой целью можно, например, ввести URL справки в XML-файл, как показано ниже. Как было показано ранее, когда пользователь вводит недействительное значение параметра count, выводится сообщение об ошибке "Invalid field: Number of Articles to Show". В нем пользователь уведомляется о том, что в поле ввода данных что-то не так, но не поясняется, что именно. Это сообщение об ошибке выводится по умолчанию, если не определить явно другое сообщение. Но это другое сообщение можно определить двумя способами. Применение специального класса JFormRuleЕще один способ состоит в создании специального правила для поля. Правила проверки достоверности доступны с помощью атрибута validate. В Joomla установлен целый ряд правил проверки достоверности вводимых данных, включая логические, электронную почту, равенство, варианты выбора, телефон, URL, а также имя пользователя. Этим правилам соответствуют классы из папки libraries/oomla/form/rules. Если ни одно из этих предварительно установленных правил не подходит для проверки достоверности вводимых данных, можно установить свои собственные специальные правила именно с таким кодом, какой требуется. Для этого в XML-файл необходимо внести следующие изменения: Итак, начнем разработку модуля с XML-файла. Этот файл выполняет несколько функций. Так, у элемента разметки extension имеются атрибуты для указания типа (type), версии (version), клиента (client); т.е. администратора веб-сайта и метода (method) разрабатываемого модуля. Эти атрибуты используются установщиком расширений Joomla в процессе их установки. В элементе разметки files предоставляется список файлов и папок (иначе называемый декларацией), откуда установщик расширений Joomla может выяснить, какие именно файлы и папки относятся к устанавливаемому расширению. Это дает возможность копировать файлы в процессе установки и удалять их по ходу удаления самого модуля. В листинге ниже приведен код исходной компоновки из файла default.php. Этот простой пример компоновки еще раз наглядно демонстрирует возможности сочетания кода РНР и HTML в одном файле. В XML-файле рассматриваемого здесь модуля содержатся сведения о файлах и папках, используемых для установки и удаления данного модуля, а также определения полей для любых параметров модуля. Файл mod_users_latest.xml по своему составу очень похож на XML-файлы подключаемых модулей, рассматривавшихся в главе 5, за исключением того, что атрибут type элемента разметки extension имеет значение "module". В приведенном ниже коде демонстрируется, каким образом элементы разметки files и languages определяются в файле mod_users_latest.xml. А теперь добавим параметр в наш подключаемый модуль. Допустим, требуется, чтобы пользователь мог выбирать появление или сокрытие второго флажка в регистрационной форме. Для реализации такой возможности потребуется следующее. Создание XML-файла для разметки формыВ рассматриваемом здесь примере класс JForm используется для добавления двух полей в регистрационную форму. Это можно сделать одним из следующих способов: |