Как создать и использовать собственные короткие функции в WordPress

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

Что такое короткие функции и зачем они нужны в WordPress

Короткие функции — это небольшие функции-обёртки, которые скрывают сложный или громоздкий код за простым и понятным интерфейсом. Они позволяют:

• Уменьшить дублирование кода;
• Упростить вызов сложных операций;
• Обеспечить централизованное изменение логики;
• Повысить читаемость и поддержку кода.

Например, вместо того чтобы каждый раз писать длинный вызов, вы можете создать функцию wpcoder_get_custom_field(), которая будет возвращать нужное значение мета-поля по ключу.

Где размещать собственные функции в WordPress

Для правильной организации кода и избежания конфликтов лучше всего размещать свои функции в:

• файле functions.php активной темы;
• отдельном подключаемом файле и подключать его из functions.php;
• собственном плагине — идеальный вариант для функционала, который не зависит от темы.

Если ваша задача — создать переиспользуемый функционал, рекомендуем оформить функции в плагин. Это обеспечит независимость от темы и сохранность функций при смене оформления.

Пример: создание короткой функции для вывода кастомного поля

Предположим, что для записей у вас есть кастомное поле с ключом product_code, и вы часто хотите вывести его значение. Вместо повторяющегося кода echo get_post_meta(get_the_ID(), 'product_code', true); создадим функцию-обёртку:

function wpcoder_get_product_code($post_id = null) {
    if (!$post_id) {
        $post_id = get_the_ID();
    }
    return get_post_meta($post_id, 'product_code', true);
}

Теперь в любом шаблоне или плагине достаточно вызвать:

echo wpcoder_get_product_code();

Если нужно получить код для другого поста, передаём ID явно:

$code = wpcoder_get_product_code(123);

Создание короткой функции с параметрами для обработки данных

Короткие функции могут принимать параметры и возвращать данные с дополнительной логикой. Например, функция для форматирования цены с валютой:

function wpcoder_format_price($price, $currency = '₽') {
    return number_format((float)$price, 2, ',', ' ') . ' ' . $currency;
}

Пример использования:

echo wpcoder_format_price(12345.678); // 12 345,68 ₽

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

Работа с плагинами: пример короткой функции для интеграции с WPRemark

Если вы используете плагин WPRemark для сбора отзывов, можно создать короткую функцию для вывода средней оценки по текущей записи:

function wpcoder_get_wpremark_average_rating($post_id = null) {
    if (!$post_id) {
        $post_id = get_the_ID();
    }
    if (function_exists('wpremark_get_average_rating')) {
        return wpremark_get_average_rating($post_id);
    }
    return 0;
}

Вывод оценки в шаблоне:

echo 'Средняя оценка: ' . wpcoder_get_wpremark_average_rating();

Такой обёрткой удобно пользоваться, если плагин обновится или изменит логику — достаточно поправить функцию в одном месте.

Полезные рекомендации по созданию коротких функций

• Давайте функциям осмысленные имена с префиксом (например, wpcoder_), чтобы избежать конфликтов с другими плагинами и темами.
• Не создавайте слишком общие имена — это повысит риск коллизий.
• Добавляйте комментарии и PHPDoc для описания назначения и параметров функций.
• Если функция выводит HTML, можно предусмотреть параметр, чтобы возвращать данные вместо вывода, повышая гибкость.
• Тестируйте функции отдельно, чтобы избежать ошибок на сайте.

Как подключить собственный файл с короткими функциями

Если функций много, лучше вынести их в отдельный файл. Создайте файл inc/wpcoder-functions.php в папке темы и подключите его в functions.php:

require_once get_template_directory() . '/inc/wpcoder-functions.php';

В файле wpcoder-functions.php разместите все короткие функции. Это структурирует код и упростит поддержку.

Вывод

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

Если хотите расширить функционал с помощью готовых решений, рекомендуем ознакомиться с плагином WPRemark для сбора отзывов и темой Reboot для современного оформления сайта.