WT SM Otpravka.pochta.ru - обновление расчета стоимости доставки Почтой России для JoomShopping
Расширение для расчета стоимости доставки и интеграции интернет-магазина Joomla JoomShopping с личным кабинетом сервиса Отправка Почты России для бизнеса. Расчет стоимости происходит по тарифам согласно Вашему договору с Почтой России. Автоматическое создание заказов в Личном кабинете Почты России после успешной оплаты или при смене статуса заказа (как вручную, так и программно).
В историю заказа сохраняется созданный трек-номер и расчетное время доставки.
👩‍💻 Что нового?
Joomla 4 / Joomla 5
Пакет расширений переписан под архитектуру Joomla 4 / Joomla 5. Это означает, что он без проблем будет работать и на Joomla 6.
Габариты отправления и платный вес Почты России
С лета 2024 года Почта России начинает учитывать не только вес отправления при рассчете стоимости, но и объём. Поэтому необходимо указать минимальные габариты отправления для корректного расчета стоимости доставки. Настройки габаритов находятся в настройках цены на способ доставки JoomShopping.
Рефакторинг кода
Большая работа по рефакторингу и чистке кода.

Страница расширения
#расширения #JoomShopping

@joomlafeed

👩‍💻 Совет по Joomla: Выбор группы для плагина Joomla.
В Joomla развитая система плагинов. Во время работы Приложения Joomla в разные моменты его жизненного цикла вызываются разные события. Эти события "слушают" плагины, получают данные для работы и возвращают их обратно, если это необходимо или выполняют любую необходимую в данный момент времени работу.
Плагины группы system вызываются всегда и раньше, чем плагины конкретных групп. Если ваш плагин работает всегда и везде и решает разные задачи в разных местах сайта - делаем системный плагин, но учитываем, что к нему будет обращение даже тогда, когда он не нужен.
Плагины конкретных групп вызываются в определенный момент времени, в определенном контексте и не создают дополнительную нагрузку, так как необходимый код выполняется только в нужный момент времени. Но это накладывает определенные ограничения и порой нужно создавать 2-3 плагина, которые можно было бы объединить в одном системном. 

@webtolkru

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

👩‍💻 Совет по Joomla: использовать класс Joomla\Uri\Uri для создания URL.
При построении url в коде можно собрать всё строками с конкатенацией вида

$url = $domain.'/index.php?option='.$option.'&view='.$view.'&param1='.$value1;

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

Для задач стандартизации и единообразия получения url в Joomla есть класс Joomla\Uri\Uri. Раньше, с Joomla 1.6 и старше он назывался JUri. Этот класс обеспечивает работу с url по стандарту RFC3986 и берет на себя работу по разбору url на запчасти или по сборке url из запчастей ))
Пример: получить конкретный параметр из url.

 use Joomla\Uri\Uri;

$url = 'https://web-tolk.ru/dev/biblioteki?param=value';
$uri = new Uri($url);
// здесь выведет строку 'value'
echo $uri->getVar('param');

Да, есть же нативная PHP функция parse_url, скажете вы... Но класс Uri обеспечивает безопасную работу с UTF-8 в url, в том числе с кириллическими доменами. Дабы не писать различные проверки самостоятельно - можно воспользоваться возможностями ядра Joomla.

Как собрать нужный url
Тут тоже все просто:

use Joomla\Uri\Uri;

$uri = new Uri;
$uri->setHost('web-tolk.ru');
$uri->setScheme('https');
// setPath() начинаем со слеша
$uri->setPath('/dev/biblioteki');
// GET-параметры можно передать массивом
$vars = [
        'param1' => 'value1',
        'param2' => 'value2',
        'param3' => 'value3',
];
$uri->setQuery($vars);
// выводим в строку наш url
echo $uri->toString();

Иерархия классов Uri в Joomla сделана так, что методы-геттеры находятся в классе AbstractUri, а сеттеры - в классе Uri. Сеттеры можно посмотреть в файле libraries/vendor/joomla/uri/src/Uri.php. Геттеры смотрим в файле libraries/vendor/joomla/uri/src/AbstractUri.php.

Если у вас есть PHP Storm, то он прекрасно знает Joomla и подсказывает всё, что нужно.
Ну и можно дать ссылку на страницу старой документации, которая до сих пор в большей своей части актуальна с поправкой на использование неймспейсов.

@webtolkru

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

👩‍💻 Совет по Joomla: использование методов плагинов в любом месте Joomla 4 / Joomla 5.
Нередко расширения Joomla в готовом виде состоят из пакета - комплекта плагинов, модулей, библиотек. Расширения из одного пакета могут нуждаться в одном и том же методе и раньше было несколько путей:
- копировать код везде (выкидываем принцип DRY - don't repeat yourself)
- делать простой трейт в одном плагине и обращаться к нему (в Joomla 3 так обычно не делали)
- делать библиотеку отдельным расширением пакета. Но как-то странно так заморачиваться ради одного метода

В Joomla 4 и старше новая (хм-м, 2 года уже прошло...) архитектура плагинов позволяет обращаться к методам плагина откуда угодно.

use Joomla\CMS\Factory;

// Указываем группу плагина и element
$myPlugin = Factory::getApplication()->bootPlugin('system','myplugin');
// И вызываем нужный нам метод плагина "Сделать хорошо"
$result = $myPlugin->doItWell();

Такой подход можно использовать везде: в компонентах, плагинах, библиотеках, модулях и т.д. Например, если в настройках компонента можно переключить источник данных - плагин-провайдер, то один путь - триггерить событие для группы этих плагинов. А можно вызвать нужный метод напрямую.

use Joomla\CMS\Factory;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\CMS\Plugin\PluginHelper;

// Получим параметры компонента
$component_params = ComponentHelper::getParams('com_mycomponent');
// Получим имя плагина-провайдера
$plugin_name = $component_params->get('data_provider');
// Проверим, а включён ли плагин?
if(PluginHelper::isEnabled('system',$plugin_name))
{
     // Загрузим плагин
     $plugin_provider = Factory::getApplication()->bootPlugin($plugin_name,'system');
     // Получим данные из него напрямую
     $external_data = $plugin_provider->getExternalData($any_id);
}

@webtolkru

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

👩‍💻 Совет по Joomla: скрыть часть строки за многоточием
Если вы хотите скрыть часть строки, в Joomla есть метод StringHelper::abridge(), который маскирует часть строки с помощью многоточия. Этот метод похож на метод #laravel Str::mask().

use Joomla\CMS\HTML\Helpers\StringHelper;

$str = 'Длинная строка, весьма и весьма длинная';
echo StringHelper::abridge($str, 20,5);

Класс находится в файле libraries/src/HTML/Helpers/StringHelper.php.

Также в этом классе находится метод StringHelper::truncate(). Он обрезает текстовые блоки с превышением указанного лимита символов и закрывает все открытые HTML-теги. При необходимости метод не будет усекать отдельные слова, он найдет первый пробел, который находится в пределах указанного лимита, и выполнит обрезку в этом месте. Этот метод UTF-8 безопасен.

use Joomla\CMS\HTML\Helpers\StringHelper;

$str = 'Длинная строка, весьма и весьма длинная';
echo StringHelper::truncate($str, 10, true);

Другой метод этого класса StringHelper::truncateComplex() является продолжением метода truncate(), но для более сложных ситуаций. Его задача заключается в том, чтобы получить строку обычного текста нужной длины с сохранением как можно большей части html-кода, при этом все теги должны быть правильно закрыты.

Ещё один StringHelper...
Поскольку в Joomla 4 "под капот" влит Joomla Framework (php фрейм), много лет бывший отдельным проектом, то часть функционала Joomla переведена на классы фреймворка, а часть ещё использует старые классы CMS. Процесс постепенно идёт. Поэтому сейчас (Joomla 5.1.2) в ядре есть 2 стринг хелпера.

2-й хелпер - Joomla\String\StringHelper.
Часть его методов - обёртки для нативных функций PHP - trim(), str_split(), strtolower(), strrpos() и т.д., но с безопасной работой с UTF-8. Также в нём есть метод increment(), работу которого мы видим при сохранении материалов, название и алиас которых уже существуют (при копировании) - к ним автоматически добавляются цифры в скобках (1) в заголовок и через дефис в алиас - -1.
Посмотреть что в нём есть можно в файле libraries/vendor/joomla/string/src/StringHelper.php.

@webtolkru

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