Как правильно дорабатывать Drupal 8

Drupal: 
Уровень сложности: 

Для новичков, недавно открывших сайт на Drupal 8, есть несколько рекомендаций.

  1. Изучите официальную документацию:
    Введение в Drupal 8, гид на английском читать в формате pdf: https://www.acquia.com/sites/default/files/library/attachment/ultimate-g...
    Документация по API Drupal 8: https://api.drupal.org/api/drupal/8
  2. Задавайте вопросы на форуме http://drupal.ru
  3. При отладке модуля или темы необходимо отключить кэш Твиг
  4. Пользуйтесь модулем Devel, чтобы выводить переменные и техническую информацию разработчика
  5. Соблюдайте следующие правила при работе с CMS Drupal.

1. Не редактируйте файлы ядра

Ядро постоянно обновляется, и его код написан лучшим образом. Если вам нужно изменить работу сайта, то это делается с помощью модулей и хуков.

2. Не редактируйте файлы стандартных шаблонов

Если вы используете Bartik на своём сайте и хотите изменить внешний вид сайта и функции темы, то правильным решением будет использовать любой другой шаблон. Обзор шаблонов для Drupal 8.

3. Лучше не патчить ядро для обеспечения работы модулей

Ядро само по себе работает лучшим образом. Если вы установили модуль, который вызывает ошибки, а в Интернете предлагают патчить ядро, лучше отказаться от такого модуля или исправить этот модуль. Лучше написать хук или модуль, который переопределит неправильно работающую функцию или исправить код модуля.
Функции из контрибных модулей или ваши собственные модули, которые неправильно взаимодействуют с ядром не должны побуждать вас патчить ядро.

4. Используйте только три папки modules, themes, libraries

Не держите на сайте другие папки. Ну разве только images в корне, если вам так удобно. Тогда вам будет проще выполнять обновления Drupal.

5. Скачивайте модули только с официального сайта drupal.org

Чужие коды, размещённые в Интернете, даже покупные модули, могут повлиять на безопасность сайта. Поэтому скачивайте только проверенные контрибные модули или проекты из песочницы на drupal.org.

6. Не используйте сборки

Сборки - это обучающие материалы, в которых вы можете узнать как правильно настроить сайт. Если вы оставите проект из готовой сборки, тогда он будет взломан хакерами или, возможно, автором сборки.

7. Проверяйте чужой код сниппетов, читая документацию по функциям

В Интернете есть множество сниппетов (кусков php-кода), с помощью которых решаются те или иные задачи. Тщательно изучайте коды. Не вставляйте на сайт то, что вам не понятно. Читайте документацию Drupal 8 API

8. Документируйте код

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

9. Создавайте php-код по стандартам

Существуют готовые рекомендации на английском, которых должны придерживаться разработчики. Читайте Drupal Coding standards тут https://www.drupal.org/coding-standards . Эти правила обеспечат лучшее понимание кода другими разработчиками, если вы будете делиться.