Как создать модульную позицию в материале? Не модуль вставить! — Joomla 3.x: Шаблоны, разметка и макеты вывода
Сегодня важный день для проекта Joomla! Мы отмечаем два года напряженной работы наших добровольцев, решивших выпускать новую основную версию каждые два года. После большого количества обсуждений, спринтов по написанию кода и устранения ошибок этот день наконец настал и мы с гордостью объявляем о выпуске новой мажорной ( major ) версии Joomla 5.0, наряду с Joomla 4.4.
В Joomla Extensions Directory появился тег совместимости с Joomla 5.
Joomla-разработчики, проверившие совместимость своих расширений с Joomla 5 могут поставить галочку ��
JoomlaDay Spain, Madrid.
В Мадриде, Испания 5-6 октября 2023 года проходит Joomla Day — конференция, посвящённая как новичкам, так и профессионалам, работающим с Joomla.
Как добавить свою позицию модуля в шаблон Joomla 3
Часто CMS Joomla называют сложной системой со сложным кодом и сложным построением шаблонов. Это на самом деле так и Joomla несколько сложнее WordPress, но значительно проще Drupal. Главное понять, какой файл за что «отвечает» и как их безопасно редактировать.
Сегодня, я начну развенчивать сложность кода Joomla и покажу, как быстро и просто добавить свою, назовем её пользовательскую, позицию для модулей в любое место шаблона. Причем данный способ универсальный и работает на любом шаблоне Joomla, включая шаблоны для Интернет магазина.
- 5 Лучших Фреймворков для Joomla шаблонов
- Joomla шаблон – структура, каталоги, файлы, формат
- Где скачать шаблон Joomla – 39 реальных авторов Joomla шаблонов
- Использование двух шаблонов на Joomla 3
- Как копировать шаблон Joomla 3
- Одностраничные шаблоны Joomla: назначение, особенности использования
- Создаем шаблон Joomla самостоятельно, часть 1: каталог шаблона, файлы templateDetails.xml и index.php
Постановка задачи
Для начала ставим четкую задачу. Необходимо, добавить в рабочий шаблон сайта дополнительную позицию для модулей. Опережая повествование, таких позиций можно добавить, столько сколько нужно, в конце статьи я добавлю две.
Вместо предисловия
- Напомню, в Joomla 3 редактировать файлы шаблона можно на вкладке Расширения→Менеджер шаблонов→Шаблоны.
- Для безопасного редактирования, редактируемый файл шаблона копируется, переносится в текстовой редактор и там редактируется. При этом оставляется первоначальная копия файла на случай неудачного редактирования.
- И на всякий случай, любое редактирование кода нужно начинать, имея под рукой полную копию сайта.
Решение задачи, добавить свою позицию модуля в шаблон Joomla 3
Для редактирования нам нужны два файла рабочего шаблона: index.php и templateDetails.xml.
Идем в Расширения→Менеджер шаблонов. В столбце «Шаблоны» выбираем рабочий шаблон и жмем для редактирования.
добавить свою позицию модуля в шаблон Joomla 3 — joomla3 custom position modul 1
На странице редактора ищем файл index.php– основной файл шаблона.
joomla3 custom position modul 2
Выбираем место, куда хотим вставить пользовательский модуль, и вставляем строку:
Примечание: Как видите в строке не указано значение атрибута style. Это значит, что при создании модуля в меню «дополнительные параметры» вы можете указать любой стиль модуля из рабочего шаблона или из стилей system.
На фото вы видите, что я задал единственный стиль для этой позиции sidebar. Поэтому при создании модуля в дополнительных настройках указываем «унаследовано» или «sidebar» рабочего шаблона.
joomla3 custom position modul 3
Далее открываем файл: templateDetails.xml.
joomla3 custom position modul 4
В конце списка с позициями модулей вставляем строку:
custom-position 
joomla3 custom position modul 5
Опять не забываем сохраняться.
В принципе все. Чистим кеш сайта, идем в менеджер модулей и создаем любой модуль в пользовательской позиции. Пользовательская позиция Custom-position появляется в списке позиций.
Добавляем две новые позиции для модулей
Для примера я создал еще одну позицию для модулей. Делаем все тоже самое, только позиции даем другое название, например custom-positionA. Эту позицию я вынес за формы добавления модулей и разместил ее сразу после закрывающего тега
, чтобы позиция появилась сразу после заголовка сайта.
joomla3 custom position modul 13
joomla3 custom position modul 7
joomla3 custom position modul 9
Теперь вы знаете, как добавить свою позицию модуля в шаблон Joomla 3
Кстати, когда я делал примеры для статьи, на демонстрационном шаблоне нашел вирусный код, который успешно удалил, чего и вам желаю.
joomla3 custom position modul 12
Другие статьи
- SP Page Builder Light — конструктор для верстки шаблонов Joomla
- Адаптация сайта Joomla под мобильные устройства
- Дизайн сайта Joomla
- Как добавить свою позицию модуля в шаблон Joomla 3
- Листинг php.ini
- Основные понятия локального сайтостроения
- Что такое php.ini
Добавить позицию модуля в шаблон joomla
Итак, мы хотим добавить позицию модуля на страницу шаблона joomla. Как вы уже знаете, что каждый модуль связан с определенной позицией. Самый часто используемый способ добавления модулей на страницу — делать это с помощью jdoc с указанием типа modules:
Если у нас много позиций, просто добавляйте их в желаемых местах страниц: Часть можно поместить до компонента, а часть после:
Ваши модули и компоненты будут выведены на страницу последовательно в форме одного длинного столбца. Позднее мы вернемся к этому вопросу и создадим более привлекательный макет. Поскольку стили CSS отсутствуют, все содержимое выводится в один столбец. Вы видите два меню, потому что мы создали два соответствующих модуля — исходный в позиции position-7 и новый в позиции position-1.
Также вам необходимо добавить строку , которая отвечает за вывод на страницу таких сообщений, как «Материал успешно сохранен». Чаще всего ее помещают над компонентом, чтобы сообщение было хорошо видно посетителям сайта.
Следующие два типа jdoc используются реже. Первый, type=»installation», применяется только во время установки. Второй, type=»module», загружает один модуль по имени, а не по позиции. Таким образом, если вы знаете, что модуль с названием Search всегда должен отображаться в определенной позиции, вы можете добавить такую строку: < jdoc: include type="module" name="search" />.
Как добавить новую позицию модуля в Joomla 3
Для опытных разработчиков Joomla добавить новую позицию модуля в шаблон — простая задача, а как насчет начинающих пользователей Joomla? Эта статья была создана для тех, кто только начинает работать с Joomla и пытается настроить шаблон для своих нужд. В этом уроке я покажу вам как добавить позицию модуля и ее настроить.
Итак, вы скачали красивый шаблон Joomla и вы установили на вашу систему Joomla. Вы понимаете, что чего-то все еще не хватает, хотите добавить слайдшоу, но доступная позиция модуля находится не в нужном месте.
Найдите и измените файлы шаблона
Прежде всего вам нужно найти файл index.php шаблона, который вы хотите изменить. Найти его можно в следующей папке: joomla_root/templates/ваш-шаблон/index.php, если Вы просматриваете файлы через FTP, или вы можете редактировать этот файл напрямую из панели администратора по ссылкам:
Расширения > Менеджер шаблонов > Шаблоны > Ваш шаблон. После этого вы увидите файлы и данные вашего шаблона.
Нажмите на файл index.php и вы сможете изменить этот файл во встроенном редакторе PHP Joomla, как на скриншоте:
Допустим, вы хотите добавить в слайд-шоу под меню навигации; найдите код, который выводит меню, и добавить код нового модуля позиции под ним.
Вероятно, код меню будет выглядеть немного иначе в шаблоне, который вы используете. Чтобы безошибочно найти нужную позицию — выясните, под какой позицией модуля должна находится ваша новая позиция модуля. Например, если ваше навигационное меню находится в позиции navigation, то вам стоит искать такое название. Если позиция называется main_menu, то вам нужно искать это название.
Теперь добавьте код вашей новой установки модуля:
Теперь при добавлении нового модуля в панели администратора Joomla “slideshow” позиция станет доступной в редакторе модулей.
Поздравляем! Вы проделали большую работу!
Если вы хотите задать стиль модуля, есть еще одна вещь, которую вам нужно сделать. Найти файл styles.css, который обычно находится в следующей папке: joomla_root/templates/yourtemplate/css/styles.css
Этот файл также можно редактировать в административной панели Joomla как вышеупомянутые файлы. Добавьте код CSS стилей в файл css и сохраните его.
#slideshow img
Если шаблон является адаптивным, убедитесь, что новый стиль, который вы создали для модуля, будет также автоматически изменять размер, если вход на сайт осуществляется с устройства с меньшим экраном.
Надеемся, что эта статья пригодится вам в работе! Если у вас есть какие-либо вопросы, мы будем счастливы ответить на них в нашей группе ВКонтакте!