Если вы имели дело с дочерними темами в WordPress, то, вероятно, знаете, что файлы шаблонов дочерней темы могут заменять соответствующие файлы из родительской. К примеру, если в родительской теме есть файл single.php, и в дочерней теме вы также создаете файл с таким же именем, WordPress будет применять файл дочерней темы для вывода одиночной записи.
Однако среди новичков в WordPress существует мнение, что и с файлом functions.php все работает аналогичным образом. Например, если в родительской теме определена функция disable_emojis_tinymce(), и вы хотите изменить ее в дочерней теме. Если вы добавите в дочернюю тему функцию с тем же названием в файле functions.php, возникнет ошибка:
Cannot redeclare disable_emojis_tinymce()
Этот нюанс указывает на то, что в одном пространстве имен не может существовать две функции с одинаковыми именами.
Тем не менее, в WordPress есть различные методики, позволяющие использовать одни и те же имена функций как в родительских, так и в дочерних темах. Вот три способа, как это можно сделать:
- использование подключаемых функций;
- установка приоритета функций;
- удаление функции с хука.
Каждый из этих методов имеет свои особенности и может быть использован в зависимости от конкретной ситуации. Например, чтобы удалить функцию родительской темы, вы можете использовать функцию remove_function(), передав ей имя хука, на который была зарегистрирована функция. Это позволит вам избежать конфликта имен и изменить поведение функции.
Также при использовании подключаемых функций вы можете создать свою функцию, которая будет вызывать оригинальную функцию при помощи условного оператора, добавляя новый функционал, не заменяя весь код родительской функции. Таким образом, вы сможете расширить функциональность, сохраняя при этом все исходные возможности.
При установке приоритета функций важно помнить, что функции, которые определены позже, могут переопределять функции, зарегистрированные ранее. Это может помочь в тех случаях, когда вам нужно изменить поведение функции родительской темы, не удаляя ее полностью.
Работа с дочерними темами в WordPress открывает широкие возможности для кастомизации и улучшения уже существующих решений, что позволяет создавать уникальные и адаптированные под ваши нужды сайты.
Как работают функции в родительских и дочерних темах WordPress?
Перед тем как углубиться в способы переопределения функций в дочерних темах, важно разобраться, как это функционирует.
Прежде всего, стоит отметить, что использование дочерней темы подразумевает выполнение всех функций из родительской. И не требуется ничего добавлять в functions.php дочерней темы для этого.
При этом все функции дочерней темы будут загружены до функций родительской. Это означает, что если и в родительской, и в дочерней теме присутствует функция с названием disable_emojis_tinymce(), приоритет будет отдан дочерней функции, которая перезапишет функцию родительской темы. Тем не менее, вы можете изменять порядок вызова функций, о чем поговорим дальше.
Также следует учитывать, что некоторые функции могут быть зарегистрированы с помощью планировщиков событий или хуков, что дает возможность изменять их поведение, не переопределяя саму функцию. Например, вы можете использовать add_action() или add_filter() для добавления или изменения функциональности элементов, созданных родительской темой.
Важно помнить, что в дочерних темах вы можете добавлять новые функции, используя тот же файл functions.php, а также подключать файлы стилей и скриптов, которые могут улучшить интерфейс или функциональность вашего сайта, не затрагивая при этом родительскую тему.
Однако при изменении функций необходимо уделять внимание совместимости с будущими обновлениями родительской темы, так как изменения в ее функционале могут повлиять на работу вашего сайта, если дочерняя тема не будет обновлена соответствующим образом. Рекомендуется регулярно проверять документацию WordPress и следить за изменениями, чтобы гарантировать, что ваша дочерняя тема остается актуальной и функциональной.
Как переписать функции родительской темы с помощью дочерней?
Переопределение через подключаемые функции
Подключаемыми называются функции, которые размещены в родительской теме и могут быть удобно переопределены в дочерней.
Если же вы хотите модифицировать функциональность используемой темы или разрабатываете собственную, целесообразно предусмотреть возможность переопределения функций в дочерней теме.
Для создания подключаемой функции ее следует заключить в условный тег, чтобы WordPress мог проверить, была ли уже вызвана функция с аналогичным именем.
if ( ! function_exists ( 'disable_emojis_tinymce' ) ) < function disable_emojis_tinymce() < // Содержимое функции. >
Теперь в дочерней теме вы можете спокойно ее переопределить.
function disable_emojis_tinymce() < // Содержимое функции. >
Переопределение через приоритет функций
Если вы не работаете с собственной темой, и функция, которую вы хотите изменить, не является подключаемой (не содержит условного тега), то вам понадобится прибегнуть к другому подходу.
Когда вы пишете функции, можно задать им приоритет, который указывает WordPress, в каком порядке их запускать. Это делается через привязку функции к хуку. Мы подробно обсуждали хуки и их использование в предыдущих статьях.
Таким образом, система выполняет функции в порядке возрастания их приоритета: чем меньше число, тем раньше вызов функции.
function disable_emojis_tinymce() < // Содержимое функции. >add_action( 'init', 'disable_emojis_tinymce' );
В этом примере функция disable_emojis_tinymce() закреплена за хуком init, и приоритет ей не назначен. В таком случае WordPress автоматически назначит ей приоритет 10. Разработчики часто назначают приоритет не меньше 15, чтобы упростить добавление других функций между ними.
Таким образом, ваша функция будет выглядеть следующим образом:
function disable_emojis_tinymce() < // Содержимое функции. >add_action( 'init', 'disable_emojis_tinymce', 15 );
Предположим, что нужная функция в родительской теме имеет приоритет 20:
function disable_emojis_tinymce() < // Содержимое функции. >add_action( 'init', 'disable_emojis_tinymce', 20 );
Чтобы переопределить ее в дочерней теме, достаточно уменьшить приоритет (увеличить число) ее выполнения:
function disable_emojis_tinymce() < // Содержимое функции. >add_action( 'init', 'disable_emojis_tinymce', 25 );
Переопределение через удаление функции с хука
Существует вероятность, что описанные выше методы не сработают. Если это так, вам нужно убедиться, что функция из родительской темы не выполняется. Это достигается через отвязку функции от хука с помощью remove_action() или remove_filter(). Рассмотрим на примере функции disable_emojis_tinymce().
function disable_emojis_tinymce() < // Содержимое функции. >add_action( 'init', 'disable_emojis_tinymce' );
Для отвязки ее от init необходимо применять remove_action():
remove_action( 'init', 'disable_emojis_tinymce' );
Однако это не сработает сразу. Нужно прикрепить функцию к хуку, выполняемому сразу после того, к которому присоединена функция родительской темы, так как удалить действие можно только после его выполнения. Поэтому:
function remove_disable_emojis_tinymce() < remove_action( 'init', 'disable_emojis_tinymce' ); >add_action( 'wp_loaded', 'remove_disable_emojis_tinymce' );
После этого вы можете написать альтернативную функцию в файле functions.php дочерней темы, чтобы заменить функцию из родительской темы. Если же ваша цель заключается в удалении функциональности родительской темы, можно ничего не добавлять.
Немного о приоритетах
Имейте в виду, если вы намерены отвязать функцию с назначением приоритета, вам необходимо указать этот приоритет. Например, если есть функция:
function disable_emojis_tinymce() < // Содержимое функции. >add_action( 'init', 'disable_emojis_tinymce', 15 );
Для ее отвязки используйте следующий код:
function remove_disable_emojis_tinymce() < remove_action( 'init', 'disable_emojis_tinymce' ); >add_action( 'wp_loaded', 'remove_disable_emojis_tinymce', 15 );
Также ознакомьтесь с информацией о том, как добавить код в заголовок WordPress.
