Новости Joomla

👩‍💻 WT Otpravkapochtaru - библиотека сервиса Отправка Почты России для Joomla-разработчиков.

👩‍💻 WT Otpravkapochtaru - библиотека сервиса Отправка Почты России для Joomla-разработчиков.

Joomla 5+ пакет для интеграции с API Почты России: нормализация данных, расчёт доставки, создание отправлений, партии, документы, возвраты, поиск отделений, справочники и SOAP-отслеживание.

v.3.0.0. Что нового?
Это дальнейшее развитие ранее закрытой Joomla-библиотеки для работы с API сервиса Отправка (для бизнеса) Почты России. Поэтому версия не 1.0.0, а 3.0.0.

Сейчас эта библиотека ушла от собственных реализаций и стала Joomla-обёрткой известного PHP SDK от Lapay Group.

Возможности библиотеки.
- получение настроек аккаунта, точек сдачи и текущего остатка запросов к API;
- нормализация адресов, ФИО и телефонов перед созданием отправления;
- расчёт тарифа и срока доставки;
- создание, поиск, изменение, удаление и возврат заказов в состояние «Новые»;
- проверка надёжности получателя;
- создание партий, просмотр партий и заказов внутри партии;
- генерация пакета печатных документов и формы Ф103;
- создание, изменение и удаление возвратных отправлений;
- поиск отделений по индексу, адресу и координатам, получение сервисов отделения;
- локальный список стран;
- SOAP-отслеживание операций по РПО и работа с билетами пакетного трекинга.

👩‍💻 Joomla-возможности.
В пакете библиотеки WT Otpravkapochtaru есть поля Joomla Form для расширений. Они позволяют работать в интерфейсе Joomla с некоторыми типами данных, получаемых по API из вашего личного кабинета в ЛК Почты России для бизнеса.
На данный момент в библиотеке доступны 3 поля списков, которые отображают доступные в аккаунте ОПС, типы и категории отправлений.
Поддерживаются зависимые списки: значение одного поля обновляется при изменении другого.

Системные требования.
Системные требования в основном связаны с системными требованиями апстрима библиотеки - LapayGroup PHP SDK.
- Joomla 5+
- PHP 8.3+
- Расширения PHP:
-- ext-mbstring
-- ext-simplexml
-- ext-soap (опционально, для трекинга)
-- ext-zip

Ссылки:
- Страница расширения
- GitHub библиотеки и документация

@joomlafeed

0 Пользователей и 1 Гость просматривают эту тему.
  • 0 Ответов
  • 1615 Просмотров
*

zaboich

  • Осваиваюсь на форуме
  • 37
  • 11 / 0
Как известно валидация (проверка) данных формы состоит из двух повторяющих друг друга этапов:
1. проверка на клиенте возможностями javascript и/или браузера+HTML5
2. проверка на сервере

При валидации на клиенте мы можем красиво выводить пользователю подсказки, подсвечивать ошибочные поля и всячески вести его к заветной цели - отправке формы.
Да, сейчас практически у всех современные браузеры и включен JS, но это не повод полагаться только на них и бросать на произвол судьбы тех, у кого JS не работает.

Посмотрим, что происходит на стороне серевера (рассомтрим стандартный task mycontroller.save:
1. Контроллер mycontroller (extends JControllerForm) в методе mycontroller->save() получает данные из запроса вызывает метод проверки этих данных в модели mymodel(extends JModelAdmin extends JModelForm)
Код
$model = $this->getModel();
$form = $model->getForm($data, false);
$validData = $model->validate($form, $data);

2. метод модели validate() вызывает методы JForm фильтрации и валидации данных
Код
$data = $form->filter($data);
$return = $form->validate($data, $group);

3. Метод JForm->validate() последовательно прогоняет все поля формы через проверку
Код
$valid = $this->validateField($field, $group, $value, $input);
// Check for an error.
if ($valid instanceof Exception){
array_push($this->errors, $valid);
$return = false;
}

и возвращается по цепочке в контроллер либо массив отфильтрованных данных, либо false - что означает, что какое-то поле / несколько полей не прошли проверку.
Информация, об ошибках проверки всех полей возвращается только в виде массива
$errors = $model->getErrors();
В котором хранятся текстовые сообщения вида "Требуется поле: {Label} поля"

4. Пользователь возвращается на страницу формы с Warning Message о незаполненных полях.

Если форма больше 4-х полей и ошибки в нескольких полях сразу, возникает проблема - найти нужные поля и после понять что в них не так.
Штатных средств выделить поля с ошибками при возвращении на страницу формы я не нашел.

Вариантов решения проблемы вижу два:
1. Попытаться распарсить сообщения системы и по вхождению label поля их выделить. Делать это надо во View, но обращение к массиву
Цитировать
JFactory::getApplication()->getMessageQueue();
Приводит к его обнулению. Т.е. сразу придется брать на себя и дальнейшую обработку сообщений системы.
2. Перегрузить метод $model->validate() таким образом, что бы он самостоятельно валидировал данные, например, посылал поля на JForm->validateField($field, $group, $value, $input) и таким образом иметь возможность контроля каждого поля.

Но оба варианта замедляют разработку и создают потенциальные проблемы.

Занимался ли кто-нибудь подобной проблемой, есть ли более удобные пути?
« Последнее редактирование: 29.01.2015, 10:20:44 от zaboich »
Чтобы оставить сообщение,
Вам необходимо Войти или Зарегистрироваться
 

Счётчик полей в админке модуля

Автор zeus07

Ответов: 9
Просмотров: 1613
Последний ответ 28.06.2021, 13:40:31
от zeus07
Вызов формы компонента в pop-up, при клике по ссылке из любого места

Автор SkyAn

Ответов: 1
Просмотров: 1255
Последний ответ 01.03.2021, 04:08:48
от gartes
Pagination компонента и данные из формы модуля

Автор platonische

Ответов: 4
Просмотров: 1456
Последний ответ 29.01.2020, 11:32:43
от mardok
[РЕШЕНО] Сохранение значений полей добавленных динамически элементу

Автор platonische

Ответов: 30
Просмотров: 4483
Последний ответ 10.11.2019, 15:42:33
от platonische
Валидация формы

Автор tm2010

Ответов: 2
Просмотров: 1411
Последний ответ 28.12.2017, 12:06:49
от tm2010