Добавляем фильтр в wysiwyg в Drupal

Пример добавления обработчика (фильтра) текста в rich editor.

Требуется всего два шага для реализации нового фильтра:

имплементировать hook_filter_info(), и саму функцию фильтра;
прикрепить фильтр к нужному вам формату текста в админке сайта — /admin/config/content/formats.

Для примера рассмотрим как создать фильтр, добавляющий bootstrap css обертку для ваших таблиц. Если вы используете bootstrap фреймворк на вашем сайте, то, чтобы сделать таблицы <table> mobile-friendly, требуется обернуть их в специальный контейнер:

<div class="table-responsive">
  <table >
  ...
  </table>
</div>

...

</table>

</div>

<div class=»table-responsive» /> контейнер позволяет выполнять горизонтальный скролл таблицы, если её ширина на конечном устройстве больше ширины экрана.

Объявим фильтр в нашем модуле MYMODULE.

/**
 * Implements hook_filter_info().
 */
function MYMODULE_filter_info() {
  $filters['filter_tablewrap'] = array(
    'title' => t('Add table wrapper to make it responsive.'),
    // объявим обработчик (сам фильтр)
    'process callback' => '_mymodule_filter_process',
    // и функцию, которая возвращает подсказку для пользователя
    'tips callback' => '_mymodule_filter_tips',
    'weight' => 0,
  );
  return $filters;
}

/**

* Implements hook_filter_info().

function MYMODULE_filter_info() {

$filters['filter_tablewrap'] = array(

'title' => t('Add table wrapper to make it responsive.'),

// объявим обработчик (сам фильтр)

'process callback' => '_mymodule_filter_process',

// и функцию, которая возвращает подсказку для пользователя

'tips callback' => '_mymodule_filter_tips',

'weight' => 0,

);

return $filters;

}

В нашем случае фильтр очень простой, не требует настроек. Но зацепка (hook_filter_info) позволяет передать также параметры: settings callback и default settings. Так вы сможете создать форму для настроек фильтра.

Подсказка для фильтра выводится как описание возможностей выбранного формата текста.

/**
 * Callback for filter tips function.
 */
function _mymodule_filter_tips($filter, $format, $long = FALSE) {
  return t('Wraps tables by bootstrap container, to make it responsive.');
}

/**

* Callback for filter tips function.

function _mymodule_filter_tips($filter, $format, $long = FALSE) {

return t('Wraps tables by bootstrap container, to make it responsive.');

}

Осталось только реализовать сам фильтр.

/**
 * Callback for filter process function.
 */
function _mymodule_filter_process($text = '', $filter, $format) {
  $pairs = array(
    '<table' => '<div class="table-responsive"><table', 
    '</table>' => '</table></div>');
  return str_replace(array_keys($pairs), array_values($pairs), $text);
}

/**

* Callback for filter process function.

function _mymodule_filter_process($text = '', $filter, $format) {

$pairs = array(

'<table' => '<div class="table-responsive"><table',

'</table>' => '</table></div>');

return str_replace(array_keys($pairs), array_values($pairs), $text);

}

В нашем примере мы вставляем элементы разметки в текст. Не идеальная реализация, учитывая, что таблицы теоретически могут быть вложенными, но для примера вполне пойдет.

Остаётся только прикрепить фильтр у нужному формату текста.

Drupal 7

Написать комментарий

Данная запись опубликована в 05.09.2020 13:16 и размещена в рубрике Drupal. Вы можете перейти в конец страницы и оставить ваш комментарий.

Мало букафф? Читайте есчо !

Использование cache API Drupal 7

Май 14, 2019 г.

Изучение API удобно начинать с шаблонов кода, которые демонстрируют технику использования. Пример логики использования/создания элемента кеша [crayon-67e4d048760e0132340811/] Обратите внимание на дополнительные скобки вокруг $cache = cache_get($cache_id). ...

Читать

Программно выводим блок в Drupal

Февраль 7, 2019 г.

Если вы решили вывести блок, реализованный в каком либо модуле, программно, то следующие примеры кода помогут вам. Используя block API Запрашиваем данные блока через API, готовим массив для последующего рендеринга: [crayon-67e4d048763d3352609990/] ...

Читать

Комментарии к «Добавляем фильтр в wysiwyg в Drupal»

Понравилась статья? Есть вопросы? - пишите в комментариях.

Имя (обязательно)	Е-майл (не будет опубликован на сайте, обязательно для заполнения)
Комментарий: