Перевод моей статьи опубликован в официальном журнале международного Joomla-сообщества - Joomla Community Magazine

https://magazine.joomla.org/all-issues/january-2025/connecting-third-party-php-libraries-in-joomla

E-mail шаблоны Joomla 5: добавление и просмотр своих переменных
В Joomla 5 появились настраиваемые email-шаблоны, как системные, так и сторонних компонентов. Их нельзя (пока что) добавить самостоятельно, они добавляются расширениями при установке. Но их можно отредактировать в Система - Шаблоны - Шаблоны писем. В настройках шаблонов писем (кнопка настроек компонента в верхнем правом углу) мы выбираем формат писем текст или HTML. Тогда становятся доступны настройки макетов шаблонов писем Joomla. Эти глобальные параметры можно переопределить в каждом конкретном email-шаблоне. Таким образом для каждого из email-шаблонов можно указать свою вёрстку и настройки логотипа.
Это, конечно, требует отдельной подробной статьи...

Для разработчиков: как добавить свои переменные для e-mail шаблонов Joomla?
Полезны окажутся 2 триггера для плагинов: onMailBeforeTagsRendering и onMailBeforeRendering.
onMailBeforeRendering - триггер, который позволяет добавлять свои шорт-коды для строковой замены в плагине. Отдать туда надо массив вида [ variable_name => variable_value ]. Из админки свои переменные нужно добавлять уже с фигурными скобками: {variable_name} заменится на variable_value. Аргументом $event плагина является экземпляр класса BeforeRenderingMailTemplateEvent, в котором есть кроме прочих 2 метода: getTemplate() (получение объекта мейлера, куда можно добавлять свои данные) и getTemplateId() (получение id шаблона письма вида com_users.registration.admin.new_notification), по которому мы определяем нужный ли это для нас email-шаблон или нет. Аналогично контексту в контент-плагинах.
Также полезное свойство класса для передачи данных из плагина в лейаут письма для рендера - $layoutTemplateData. Это ассоциативный массив.

// Получаем текущий мейлер 
$mailTemplate = $event->getTemplate();
$data = [
   'variable_name' => 'variable_value'
];
// с Joomla 4 для всех типов писем. 2-й аргумент - plain - текстовый формат письма 
$mailTemplate->addTemplateData($data, false);
// с Joomla 5.2 - для HTML-писем
$mailTemplate->addLayoutTemplateData($data);

// пример из ядра Joomla
// Add additional data to the layout template
$this->addLayoutTemplateData([
  'siteName' => $app->get('sitename'),
  'lang'     => substr($this->language, 0, 2),
]);

onMailBeforeTagsRendering - триггер, который добавляет ваши переменные в список доступных переменных для замены в окне редактирования email шаблона Joomla. Отдать туда нужно тот же самый массив, который отдавали в предыдущем триггере.

P.S. Выложил текст на сайт + немного дополнил скриншотами.

@webtolkru

#joomla #разработка #php #development #webdev

Плагин «Метатеги Open Graph на сайте» для Joomla 5

Плагин активирует создание метатегов Open Graph на сайте под управлением Joomla. Поддерживается работа с компонентами "Материалы" и Virtuemart. В плагине организована корректная работа с социальной сетью VK.COM, а также с Telegram и WhatsUp.

Расширение платное. Разработчик - участник нашего сообщества Владимир Егоров (@sitogon).

Страница расширения
Документация

#virtuemart #seo #opengraph

На память. Будем считать за отзыв.

Рабочие моменты. Больше мониторов богу мониторов ))

Как обновить плагин Joomla 3 до архитектуры Joomla 4 / Joomla 5. Челлендж: сделай это в блокноте!

На видео показывается как обновить старый плагин, созданный ещё для Joomla 2.5 или Joomla 3 до Joomla 4 / Joomla 5. Своеобразным челленджем стала попытка сделать это, имея на руках только блокнот (Notepad++). В время записи видео несколько раз процесс шёл не по плану, но тем интереснее было решить задачу, показав процесс поиска решения. Особенно не имея под рукой IDE (профессиональная среда разработки).

Автор к записи видео специально не готовился, поэтому заранее просит прощения за некоторую сумбурность и непоследовательность действий на экране.

Видео на YouTube
Видео на VK-видео

@joomlafeed

#php #joomla #разработка

10-й год работы с сайтом пошёл ))

Продолжение эпопеи с переопределением модели и паттерном "декоратор" в Joomla.
Чувствую себя шахтёром...

Краткое содержание предыдущих серий:
- если боишься, что этот же участок кода будет переопределять другой код - юзай паттерн декоратор
- чтоб его использовать в Joomla 4+ - юзай $container->extend()
- переопредели в нём MVCFactory и переопредели весь публичный контракт: createModel, createView, createController, createTable, так как ты должен вернуть новый класс фабрики
- в createModel() подсунь свою модель, вместо модели ядра
- пойми, что так не работает, так как точка входа в фабрику - createController, затем контроллер создаёт вью, а вью подтягивает модели.
- в createController в качестве MVCFactory для создания модели устанавливается $this и поэтому если использовать паттерн декоратор - проксировать все методы обёрнутого класса, кроме нужного - не работает. При создании контроллера создаётся новая фабрика без твоих переопределений
- значит мы должны переопределить и createController...

Эксперименты показали, что для переопределения createController нужно наподключать все нужные для него трейты (ок), а потом если проксировать createView (мы же должны всё-таки паттерн хоть чуть-чуть использовать), то всё падает, так как в обёрнутом экземпляре класса нет всего того, что мы уже проделали в переопределенном createController...

Итого:
- код плагина разрастается.
- ни один из методов нормально декорировать не получается - только переопределение всех (или почти всех) методов фабрики
- смысл использования паттерна улетучивается на глазах
- идея переопределять именно MVCFactory, наверное, не самая лучшая...

Задача простая - чуть-чуть изменить SQL-запрос в getListQuery стандартных моделей. Сделал это просто заменив метод getClassName. Отдаю там namespace своей модели. Но такая простая замена класса может привести к проблемам, если этот же фрагмент кода попытается заменить другой плагин. Попытка использования паттерна декоратор не приводит к успехам. Ещё немного поищем, но скорее всего будем опираться на ответственность вебмастеров, которые знают ЧТО у них стоит на сайте и мешает оно друг другу или нет...

WT Multicategories плагин мультикатегорий Joomla

Joomla плагин позволяет добавлять в категории статьи или контакты из других категорий (функционал мультикатегорий). id дополнительной категории берутся из пользовательского поля материалов или контактов.

Этот плагин добавляет возможность указать для материалов или контактов Joomla больше, чем одну категорию. Для этого нужно создать пользовательское поле, в котором будут указан id дополнительной категории. В настройках плагина нужно указать какое именно поле будет использоваться в качестве источника данных. Материалы и контакты из дополнительных категорий будут добавлены в общий список и будут отображаться среди материалов / контактов основной категории.

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

Для удобства указания дополнительных категорий Joomla вы можете использовать плагин пользовательского поля WT Category.

Joomla 4.2+. PHP 8+.

Страница расширения
GitHub расширения
Плагин WT Category

@joomlafeed

#php #joomla #расширения #плагин

JIntervention Image v.3.11.0
PHP-библиотека обработки изображений Intervention Image для Joomla 3 и Joomla 4
Список изменений
- Обновление библиотеки. Библиотека обновлена до версии 3.11.0. Обновление мажорной версии связано с изменениями API библиотеки. Проверьте работоспособность своего кода.
Подробнее

WT On fly image handler v.2.0.0
Обработка изображений товара JoomShopping при редактировании: одинаковые пропорции, конвертация в один формат, удаление прозрачности, именование файлов. Используется библиотека Intervention Image. Работает с Joomla 3 (JoomShopping 4) и Joomla 4 (JoomShopping 5)
Список изменений
- Поддержка Joomla 5. Плагин переписан на новую архитектуру расширений Joomla 4 / Joomla 5. Это означает, что он будет работать и в Joomla 6.
- Удалена поддержка Joomla 3. Окончательно удалена поддержка Joomla 3.
- Водяные знаки. Добавлена возможность наложения водяных знаков на изображения.
- JIntrevention Image 3.10+. Требуется библиотека JIntervention Image не ниже 3.10. PHP 8+....
Подробнее

Joomla Web Services Collection For Postman

Разработчикам мобильных и WEB-приложений (и не только) весьма и весьма пригодится готовая коллекция для Postman. В коллекцию добавлены endpoint для REST API Joomla, с параметрами и примерами запросов.

Коллекция составлена трудами французского Joomla-разработчика Alexandre J-S William ELISÉ.

Смотреть коллекцию

@jooomlafeed

#joomla #restapi #webdev #разработка

Отладка целей Яндекс.Метрики на сайте

Давно этим не занимался, а тут попросили. Яндекс сделал панельку, которой именно для отладки метрики я не пользовался. В url страницы нужно добавить GET-параметр _ym_debug=2, чтобы получилось вот так: https://example.com/?_ym_debug=2
Совершаем целевое действие и в панельке метрики внизу проверяем что и как работает.

Удобно.