XML файл на модула CMS Joomla 2
И така, нека започнем да разработваме модул с XML файл. Този файл служи за няколко цели. И така, елементът за маркиране на разширението има атрибути за указване на типа (типа), версията (версията), клиента (клиента); тези. администратора на уебсайта и метода на модула, който се разработва. Тези атрибути се използват от Joomla Extension Installer по време на инсталационния процес. Елементът за маркиране на файлове предоставя списък с файлове и папки (иначе наричани декларация), откъдето инсталаторът на разширение Joomla може да разбере кои файлове и папки са специфични за инсталираното разширение. Това прави възможно копирането на файлове по време на инсталацията и изтриването им, докато деинсталирате самия модул.
Първата част на изходния код от XML файла на разработвания модул е показана в списъка по-долу.
Изходен код от mod_joompro_articles_author .xml файл (част 1)
Този код е подобен на кода в модула moduserslatest. xml. По-специално, елементът за маркиране на име обозначава името на папката, както и името на основния PHP файл и XML файла на самия този модул. И файлът за поддръжка на системния език .sys.ini съдържа ключ за превръщане на това име в нещо по-четливо и описателно, когато модулът се появи в компонента Module Manager. Пример за такъв ключ е даден по-долу.
Този ключ също е посочен в описателния елемент на маркировката, като по този начин предоставя описанието на този модул. Ключът за описание на модула е дефиниран и в двата езикови файла за поддръжка.
Елементът за маркиране на файлове се различава малко по своето съдържание от подобния елемент за маркиране на модула mod_users_latest. Първият вложен елемент за маркиране на име на файл има атрибут на модул, който указва името на модула и указва файла, който да се зареди, когато модулът бъде изпълнен. Както в модула mod_users_latest, в този случай е посочена папката tmpl, където е поставен файлът за изграждане на модула. След това изброява helper.php, index.html файловете и самия XML файл. За напомняне, изброяването на XML файла не е задължително, но все пак е желателно.
Разликата между този примерен модул от предишния се крие по-специално във факта, че елементът за маркиране на папка се добавя към разглеждания тук XML файл, в който е посочена папката за поддръжка на езика на модула. Тази папка ще съдържа подпапка с два файла с разширението. ini, за всеки език, включен в модула.
Втората част на изходния код от XML файла на разработвания модул е показана в листинг 6.5.
Изходен код от файла mod_joompro_articles_author.xml (част 2)
Тази част от XML файла определя специалните параметри на модула, който се разработва. Има три такива параметъра. Първият се нарича count и се използва за въвеждане на броя статии за показване. По подразбиране този номер е 5, но потребителят може да посочи произволен брой статии. Обърнете внимание как е зададен този параметър: от потребителя не се изисква да въведе валидна целочислена стойност; той може да въведе и текст. По-нататък в тази глава ще обсъдим някои подходи за подобряване на валидирането на дадено поле на параметър.