Създаване на модули за Joomla2

В интернет има много уроци за работа със CMS "Joomla", но повечето от тях са за начинаещи. Реших да създам урок за начинаещи разработчици за създаване на собствен модул за "Joomla". Нямам предвид модул "Custom HTML", а динамичен модул, който ще взаимодейства с базата данни и ще ни предостави списък с регистрирани потребители на сайта. Да започваме…

Създаване на структурата на модула – папки и файлове.

Важно: за да работи модулът, папката“mod_siteusers” трябва да се намира в папката“modules”, разположена в основата на вашия сайт. Засега обаче това не е необходимо, тъй като първо трябва да създадете модул, след което да опаковате файловете му в zip архив и да го инсталирате в административната част на Joomla CMS.

mod_siteusers

-mod_siteusers.xml
-mod_siteusers.php
-helper.php
-index.html
-en-GB.mod_siteusers.ini
-en-GB.mod_siteusers.ini
--tmpl (папка)
--tmpl/default.php
--tmpl/поръчан_списък.php
--tmpl/index.html

mod_siteusers.xml

Този файл съдържа всички данни за модула: информация за модула и неговите параметри, както и точната структура на файловете.

Вие сте свободни да промените личната си информация. Обърнете внимание на етикетите „ “. Те описват настройките, които можете да видите в "Мениджър на модули" на административната част на сайта на страницата с настройки на конкретен модул. В нашия модул има 4. Първо, това е параметърът „Суфикс на класа на модула“, който има всеки модул в системата. Потребителят може да добави свой собствен суфикс към това поле, който ще бъде прикрепен към името на CSS класа в кода на модула. Това ще помогне за промяна на външния видизглед на модула на страницата на сайта. Вторият параметър е само "разделител". Третият параметър е броят на показваните потребители в модула и накрая, четвъртият параметър е възможните опции за показване на списъка с потребители. Всяка опция за показване е шаблон, който трябва да бъде поставен в папката “tmpl ”. В настройките на нашия модул можете да изберете 2 опции за показване: като номериран списък без описание преди списъка и като неномериран списък с описание преди списъка. Разликите при избора на една от тези опции са незначителни, но аз просто искам да покажа тази възможност с прост пример. Освен това може да сте забелязали стойността на атрибута label, която е равна на LABEL_USER_COUNT. Използва се в езикови файлове, но повече за това по-късно.

mod_siteusers.php

Това е контролен файл, който управлява функциите и файловете на модула.

Този файл съдържа модела на работния кон, който управлява бизнес логиката.

Заявката в този файл избира "имената" на потребителите от таблицата #__users, ограничавайки броя на върнатите редове до стойността на параметъра "брой потребители", който потребителят задава в настройките на модула. Резултатите от тази заявка ще бъдат поставени с помощта на метода " loadObjectsList " в променливата $rows (това е масив от обекти). Можем да покажем стойностите на свойствата на обекти, съхранени в променлива в цикъл в шаблона (файлdefault.php ).

Този HTML файл се използва единствено за предотвратяване на директен достъп на потребителите до модулните файлове.

tmpl/по подразбиране.php

default.php е шаблонът на модула по подразбиране. По принцип това е HTML файл с вмъкнати PHP кодове. PHP кодът се състои от цикъл, който обработва масив, съдържащ потребителски имена. Данни отмасив се показват на страницата на сайта като неподреден списък.

tmpl/ordered_list.php

Този шаблон показва списък с потребители на сайта като номериран списък. Както е описано по-горе, тези 2 шаблона се различават само по това, че вторият шаблон няма стойността на параметъра „описание“ от настройките на модула и списъкът е номериран.

Точно като папката на модула, този HTML файл се използва единствено за предотвратяване на директен достъп на потребителите до модулните файлове.

Сега, когато всички файлове на вашия модул са създадени, цялото съдържание на папката "mod_siteusers " трябва да бъде поставено в ZIP файл с помощта на който и да е архиватор (WinZip, WinRar, 7zip и т.н.).

Честито! Вашият първи Joomla модул е създаден. Нека се опитаме да го инсталираме!

Влезте в административния панел на сайта и отворете "Extension Manager". Кликнете върху бутона "Преглед" в секцията "Инсталация" и изберете архива с вашия модул. След инсталирането ще видите съобщението „Инсталирането на модула завърши успешно“.

Отворете публичната част на сайта и ще видите вашия модул в действие.

Резултатът от модула не изглежда много привлекателен. Предлагам ви да го промените като домашна работа. Този модул е много прост. Можете да използвате рамката за извличане на всякакъв вид данни от базата данни като статии или нещо друго. Можете също така да извлечете от базата данни и да покажете в модула такива данни като: имейл потребители, вход и много други. Възможностите са безкрайни!