Хуки и фильтры: 5 ошибок, из-за которых тема WordPress ломается после правки

Хуки и фильтры: 5 ошибок, из-за которых тема WordPress ломается после правки

Хуки — это точки, куда вы встраиваете свой код, а фильтры — способ изменить данные до вывода. В темах WordPress именно они помогают не править ядро и не дублировать шаблоны.

• action используют, когда нужно выполнить действие: вывести блок, подключить скрипт, записать лог.
• filter применяют, когда нужно вернуть изменённое значение: заголовок, текст, атрибут, массив меню.
• add_action и add_filter пишут с понятным приоритетом, иначе порядок вызова сложно отлаживать.
• remove_action и remove_filter работают только если совпадают хук, callback и приоритет.

Типовая ошибка — цепляться за слишком общий хук и потом гадать, почему код срабатывает лишний раз. Вторая — менять данные в фильтре без return: тогда дальше по цепочке уйдёт не то, что ожидалось. Третья — объявлять callback внутри другого callback, а потом не иметь доступа к нему для удаления.

Если делаете тему, держите правило: вывод — через action, преобразование данных — через filter. Так код проще тестировать, переносить между шаблонами и поддерживать без сюрпризов.