Новости Joomla

Свои типы полей в Joomla.

Свои типы полей в Joomla.Это большая тема, о которой можно говорить очень много

Это большая тема, о которой можно говорить очень много. Самое главное, что возможности применения ограничиваются только вашей больной фантазией. Вы строите интерфейс своего модуля или плагина и вам нужно подтянуть данные из сторонней системы (список чего-нибудь по какому-нибудь API), чтобы сохранить выбранный id в Joomla. Или сделать какую-то проверку и в зависимости от неё показать то или иное сообщение пользователю. Для этого подойдут свои пользовательские типы полей. Интерфейс Joomla по большей части описан в XML-файлах. У каждого из них свои параметры. Некоторые не описаны в документации (manual.joomla.org), поэтому самым любопытным будет полезно заглянуть в собственно файлы фреймворка по пути libraries/src/Form/FormField.php, а так же в libraries/src/Form/Fields. У каждого класса поля перечислены его специфические свойства, которые можно описывать в XML. А в своём типе поля вы можете устанавливать эти значения программно. В моём модуле WT Quick links под капотом происходят изменения. Теперь для работы (в админке) ему нужен вспомогательный плагин. А в самом модуле нам бы проверить, а не выключен ли он? В Joomla есть тип поля Note - заметка. Его можно использовать для вывода примечаний.

<field type="note"
     name="your_note_for_user"
     label="Заголовок примечания"
     title="Альтернативный способ для заголовка"
     description="Текст примечания"
     class="col-12 alert alert-info"
     heading="h1"
     close="true"
/>

heading - указывать уровень заголовка. close - позволяет закрыть это примечание. В классе поля libraries/src/Form/Field/NoteField.php описана логика вывода. И в принципе оно нам подходит для нашей задачи. Но оно будет выводить сообщение всегда, а нам нужно только тогда, когда плагин отключён. Поэтому берём и создаём свой класс поля, который мы унаследуем от NoteField. Это значит, что у нас в руках будет весь инструментарий стандартного поля Note + то, что мы сами добавим. В XML-манифест добавляем наше поле

<field type="systempluginstatus" 
     name="systempluginstatus"
     addfieldprefix="Joomla\Module\Wtquicklinks\Site\Fields"/>

- type - имя файла и класса,- addfieldprefix - указываем namespace к нашему классу, может быть любой нам нужный- name - нельзя полю без имени...Это означает, что Joomla будет использовать класс поля из файла modules/mod_wt_quick_links/src/Fields/SystempluginstatusField.php.А в классе поля будет написано следующее:

<?php
// namespace для атрибута addfieldprefix
namespace Joomla\Module\Wtquicklinks\Site\Fields;
// нельзя напрямую обращаться к этому файлу
defined('_JEXEC') or die;
// подключаем родительский класс для переопределения
use Joomla\CMS\Form\Field\NoteField;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Plugin\PluginHelper;

// имя класса и имя файла точь-в-точь
class SystempluginstatusField extends NoteField
{
     protected $type = 'Systempluginstatus';

     protected function getLabel()
          {
               // если плагин не включён
               if(PluginHelper::isEnabled('system','wtquicklinks')) {
                    // меняем свойства родительского класса
                    $this->class = 'alert alert-danger w-100';
                    $this->element['label'] = '⚠️ А-а-а-а!';
                    $this->element['description'] = 'Плагин не включён!!';
                    // и просто рендерим его с нашими свойствами
                    return parent::getLabel();
               }
          // А иначе всё хорошо, скрываем поле из виду.
          $this->parentclass = 'd-none';
          return '';
     }
}

Просто и удобно. И людям приятно, что о них позаботились и рассказали почему что-то не работает. @webtolkru#joomla #php #webdev #разработка

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

Nikaspb

  • Новичок
  • 3
  • 0 / 0
Сразу хочу попросить прощения, если нечетко выражаю свои мысли. Я не просто новичок в Joomla, но и вообще в любых вопросах создания сайтов. Вопрос  в следующем: как сделать, чтобы на главной странице сайта была активная кнопка "скачать", при нажатии на которую начиналось скачивание дистрибутива. Как его закачать на сайт и в какое место? И главное как сделать его безопасным для пользователей?
*

AlekVolsk

  • Гуру
  • 6913
  • 416 / 4
Дистрибутив чего? Как именно закачать?
*

Nikaspb

  • Новичок
  • 3
  • 0 / 0
Программы для расчетов токов короткого замыкания. Я вот и не знаю куда. Важно, чтобы ее можно было скачать с нашего сайта
*

robert

  • Живу я здесь
  • 4974
  • 457 / 20
Как его закачать на сайт и в какое место? И главное как сделать его безопасным для пользователей?
Закачать с помощью FTP клиента (это программы такие, например FileZilla) или панели управления сервером. Место выбираете сами, это может быть любой папкой, самое главное - путь к ней.
И главное как сделать его безопасным для пользователей?
Для каких пользователей? Пользователям вашего сайта ничего не грозит.
как сделать, чтобы на главной странице сайта была активная кнопка "скачать", при нажатии на которую начиналось скачивание дистрибутива.
Вставьте в желаемом месте такой код
Код: html4strict
<a href="путь к файлу">Скачать</a>
и у вас появится ссылка "Скачать" (не кнопка, но суть от этого не изменится).

P.S. Исправил. Спасибо AlekVolsk.
« Последнее редактирование: 06.08.2014, 10:17:58 от robert »
Не будь паразитом, сделай что-нибудь самостоятельно!
*

AlekVolsk

  • Гуру
  • 6913
  • 416 / 4
Код
"путь к папке, где лежит файл"
Скорее: путь к файлу с дистрибутивом относительно корня сайта.
*

AlekVolsk

  • Гуру
  • 6913
  • 416 / 4
Сам файл дистрибутива лучше закачивать по ftp, в папку, специально предназначенную для хранения скачиваемых файлов, обчно она называется downloads или dwnl, создавать ее надо самому - штатно в J она отсутствует.
*

Nikaspb

  • Новичок
  • 3
  • 0 / 0
Код
"путь к папке, где лежит файл"
Скорее: путь к файлу с дистрибутивом относительно корня сайта.
Я вот совсем совсем чайник. Относительно корня сайта, это как? 
*

AlekVolsk

  • Гуру
  • 6913
  • 416 / 4
Эээ, учите мат.часть, азы работы с хостингом. Я Вам сейчас отвечу, а у Вас после этого еще 10 вопросов появится.
"Гуглите - и обгуглины будете" ©
Чтобы оставить сообщение,
Вам необходимо Войти или Зарегистрироваться