Drupal 8: Пишем Filter Plugin
Объявляем собственные текстовые форматы.
преобразовывать или выдерать из текста для каких-то иных целей. В Drupal для этого есть «фильтры» содержимого, благодаря которым, текст после сохранения проходит некие обработки, после которых на выходе получается содержимое для вывода на странице.
Обзор ¶
В Drupal 8 фильтры стали плагинами, соответственно и реализуются как плагины. Реализуется это всё созданием собственного класса, в котором достаточно реализовать 1 метод:
Также есть и другие методы, которые могут оказаться полезными:
Практика ¶
Простой пример ¶
Давайте реализуем простой пример. Допустим нам нужен фильтр, который будет искать в тексте словосочетание Hello World (с учетом регистра) и делать данный текст жирным курсивом.
Всё, теперь если включите модуль, и перейдете в «Текстовые форматы и редакторы» то должны увидеть фильтр:
Также содержимое tips() будет доступно в подробной информации о фильтрах.
Давайте включим наш фильтр для какого-нибудь формата ввода, я буду делать для Basic HTML. А затем добавим содержимое или отредактируем уже существующее используя формат ввода которому вы добавили наш фильтр.
Допустим наше содержимое:
Hello World, today is a good day.
После сохранения на странице с содержимым вы должны получить результат:
Пример с настройками ¶
Давайте рассмотрим более комплексный пример. Сейчас наш фильтр ищет слово Hello World и делает его жирным курсивом. Давайте сделаем еще один фильтр, который будет выполнять примерно тоже самое. Только на этот раз задача будет следующая. Мы сделаем для нашего фильтра настройки из двух данных, что будем заменять и на что. Допустим, заменять словосочетание Hello World, на просто Hello.
Теперь проверим что получилось. Первым делом нам необходимо включить наш фильтр для какого-нибудь формата ввода. Если вы все сделали верно, то новый фильтр должен появиться в списке, а при его выборе (установки галочки) снизу появятся настройки с значениями по умолчанию.
И если мы введем следующий текст:
Hello World, today is a good day
в содержимое материала с использованием формата ввода, у которого активирован наш фильтр, то на выходе мы получим следующий результат:
Вот и всё. Так вот просто объявляется фильтр в Drupal 8, впрочем, как и в Drupal 7. Только сделано это намного удобнее, хранится в одном файле и все разложено по полочкам.
Drupal 8. Обучающие материалы и не только
Друзья, вы мне, конечно [1] [2], не поверите, но вышел Drupal 8. В последнее время поступает достаточно много вопросов на тему того, что почитать, посмотреть, послушать для изучения восьмерки. Очень многие чувствуют себя не вполне уверенно и задаются вопросами: переходить на неё или не переходить, жив Drupal или нет, и всем прочим.
В данной статье я выскажу своё мнение на эту наболевшую и злободневную тему, а также поделюсь с вами в качестве бонуса списком полезных материалов, которые собирались по мотивам всех предыдущих выпусков Drupal-дайджеста, и которые, надеюсь, вам помогут.
Я думаю, что мало кто будет спорить на тему того, что восьмерка очевидно более сложная система нежели семерка. И это неудивительно, если вспомнить, что одной из архитектурных задач изначально являлась преемственность современных РHP-практик в то время, в виду желания угодить тем людям, которые жаловались на то, что Drupal — это каменный век и вообще.
В этом плане, конечно, новая версия системы — это несомненно шаг вперед к другим enterprise-решениям, но явно не прорыв. Порог вхождения в Drupal 8 настолько больший по сравнению с плюсами, которые даёт система, что мне абсолютно понятна лень людей в изучении восьмерки.
Над новой версией была проделана просто титаническая работа, которая могла бы быть закончена гораздо раньше при правильно выбранном релиз-менеджменте, а также экономии усилий контрибьюторов при более точном позиционировании системы: или это должна была система для сайтопостроителей и “кликеров”, или enterprise-система управления содержимым с гибкой версионностью, наследованием, процессами и бесконечной возможностью для расширения. Хотели усидеть на всех стульях сразу и в итоге получили долгий релиз из-за гигантской регрессии, отставание от конкурентов и некоторый функционал, который непонятно кому на самом деле нужен.
Можно самокритично отметить, что это так легко, конечно рассуждать, смотря за процессами по большей части со стороны, и являясь на 90% лишь её потребителем. А где я раньше был? Ну да, на самом деле!
Но не стоит, наверное, здесь винить сообщество: для большинства людей которого Друпал является лишь инструментом. Вся система является настолько огромной, что уследить за текущим её состоянием для внятного контрибьюта практически нереально без посвящения её значительной части своей жизни буквально в еженедельном режиме, если не ежедневном. Я не говорю про багфиксы, тестирование и документацию, конечно. Лично я с трудом представляю, как это всё совмещать с работой в полный рабочий день.
Но ведь нашлись герои, которые всё это вынесли на своих плечах и 19-го ноября нам всем сделали подарок. И знаете, по-хорошему, дарёному коню в зубы не смотрят.
Просто задумайтесь о том, что сделает клиент через год или более того при выборе одного из двух подрядчиков, когда один будет предлагать делать сайт только на семерке, а другой — на обеих версиях.
Но хватит философствовать! Давайте о конкретном. Ниже, как я и обещал, находится сгруппированный список материалов для изучения системы. Очень надеюсь, что он вам поможет разобраться, что к чему. Уж поверьте: от того, что вы изучите Drupal 8, хуже не будет.