Розробка тем для WordPress: вивчення основних практик і кращих рішень для файлу functions.php.

Файл `functions.php` містить визначення різних функцій, які використовуються у вашому веб-проєкті. Його основна роль полягає у створенні модульності та уніфікації коду, що дозволяє легше керувати різними частинами сайту та розши

У темах WordPress…functions.phpЦе особливий та потужний файл. По суті, це плагін, призначений для конкретної теми; він завантажується під час її активації та видаляється під час її деактивації. Основна функція цього файлу – додавання до теми користувацьких функцій та зміна поведінки основної частини системи WordPress без необхідності модифікації основних файлів системи чи створення окремих плагінів. Це дозволяє розробникам централізовано керувати всією налаштувальною логікою теми: від простого увімкнення функцій (наприклад, використання фірмових зображень) до складного створення власних типів статей, розробки панелей налаштувань теми, а також використання хуків та фільтрів.

Розумінняfunctions.phpОбласть дії цього файлу є надзвичайно важливою. Він діє лише у межах теми, до якої належить, що забезпечує портативність функцій та цілісність самої теми. Завдяки написанню коду у цьому файлі ви можете безпечно додати до свого веб-сайту майже будь-які функції, зберігаючи при цьому гнучкість для майбутніх оновлень та міграції тем. Для початківців та досвідчених розробників глибоке вивчення та відмінне опанування цього файлу є обов’язковим кроком на шляху від модифікацій базових тем до розробки більш складних тем.

Початкова налаштування функцій теми та поширені функції

Увімкнення функції підтримки тем

Кожен сучасний тематичний пакет для WordPress має чітко вказувати, які основні функції він підтримує. Це потрібно зробити шляхом належного опису в документації до теми чи на власній сторінці продукту. Такий опис допомагає корadd_theme_support()Функція призначена для виконання певних завдань у системі WordPress. Вона інформує систему про те, які можливості підтримує ваш тематичний дизайн: наявність зображень-прев’ю статей, можливість використання власного логотипу, підтримка HTML5-тегів тощо.

Рекомендуємо до прочитання. Посібник з розробки тем для WordPress: створення професійної адаптивної теми з нуля.。

if ( ! function_exists( 'mytheme_setup' ) ) {
    function mytheme_setup() {
        // 支持文章和评论的Feed链接
        add_theme_support( 'automatic-feed-links' );
        // 启用文章特色图像功能
        add_theme_support( 'post-thumbnails' );
        // 启用自定义Logo功能
        add_theme_support( 'custom-logo', array(
            'height'      => 100,
            'width'       => 400,
            'flex-height' => true,
            'flex-width'  => true,
        ) );
        // 对文章格式和页面标题的HTML5标记支持
        add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
        add_theme_support( 'title-tag' );
    }
}
add_action( 'after_setup_theme', 'mytheme_setup' );

Обгорніть конфігураційний код у відповідні блоки чи фрагменти коду.after_setup_themeУ функціях-«хвостках» (hooks) переконайтеся, що вони виконуються правильно під час ініціалізації теми (theme).

UltaHost – хостинг для сайтів, побудованих на платформі WordPress

Гарантія повернення грошей протягом 30 днів, необмежена пропускна здатність мережі та доступ до баз даних, безкоштовний захист від DDoS-атак; знижка 50% при покупці на термін 3 роки (варіанти об’ємів трафіку: 4 ТБ/5

сторінка доступу

Навігаційний меню та бічна панель для реєстрації користувачів

Повна тема зазвичай містить налаштовуваний навігаційний меню та область інструментів (бічну панель). Для цього необхідно використовувати відповідні функції та інструменти розробки.register_nav_menus()和register_sidebar()Функція.

// 注册主题菜单位置
function mytheme_register_menus() {
    register_nav_menus( array(
        'primary' => __( '主导航菜单', 'mytheme' ),
        'footer'  => __( '底部菜单', 'mytheme' ),
    ) );
}
add_action( 'after_setup_theme', 'mytheme_register_menus' );

// 注册一个小工具区域
function mytheme_widgets_init() {
    register_sidebar( array(
        'name'          => __( '主侧边栏', 'mytheme' ),
        'id'            => 'sidebar-1',
        'description'   => __( '在此添加主侧边栏的小工具。', 'mytheme' ),
        'before_widget' =&gt; '<section id="%1$s" class="widget %2$s">',
        'after_widget' =&gt; '</section>',
        'before_title' =&gt; '<h2 class="widget-title">',
        'after_title' =&gt; '</h2>',
    ) );
}
add_action( 'widgets_init', 'mytheme_widgets_init' );

Колективне управління скриптами та шаблонами

Щоб дотримуватися найкращих практик розробки для WordPress та уникати конфліктів, всі файли JavaScript та CSS мають завантажуватися через…wp_enqueue_scriptsЗавантаження виконується за допомогою спеціальних „хвиль“ (hooks). WordPress надає можливість створювати та використовувати ці „хвилі“ для розширення функціоналу системи.wp_enqueue_style()和wp_enqueue_script()Існують функції, які можна використовувати для досягнення цієї мети.

function mytheme_scripts() {
    // 引入主题的主样式表
    wp_enqueue_style( 'mytheme-style', get_stylesheet_uri(), array(), wp_get_theme()->get( 'Version' ) );

// 引入Google Fonts
    wp_enqueue_style( 'mytheme-google-fonts', 'https://fonts.example.com/family=Open+Sans&display=swap', array(), null );

// 引入自定义JavaScript文件，并依赖jQuery
    wp_enqueue_script( 'mytheme-navigation', get_template_directory_uri() . '/js/navigation.js', array( 'jquery' ), wp_get_theme()->get( 'Version' ), true );

// 为脚本局部化数据，将PHP变量安全传递到JavaScript
    wp_localize_script( 'mytheme-navigation', 'mythemeScreenReaderText', array(
        'expand'   => __( '展开子菜单', 'mytheme' ),
        'collapse' => __( '收起子菜单', 'mytheme' ),
    ) );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );

Цей підхід забезпечує правильне оброблення залежностей (наприклад, jQuery) та дозволяє легко керувати місцем завантаження скриптів (у верхній чи нижній частині сторінки). Для стилів та скриптів, які використовуються у системі керування, слід використовувати вadmin_enqueue_scriptsХук.

Глибоке налаштування за допомогою хуків та фільтрів

Розуміння дій та фільтрів

Коренева розширюваність WordPress значною мірою залежить від його архітектури плагінів, а саме від механізмів, що називаються „хвостиками“ (Hooks). Хвостики поділяються на два типи: дії (Actions) та фільтри (Filters). Дії дозволяють виконувати власний код у певний момент часу, а фільтри – модифікувати дані, які передаються під час виконання програми.functions.phpЦе ідеальне місце для використання цих хуків.

Рекомендуємо до прочитання. Від нуля до одиниці: практичний посібник із розробки теми для WordPress від А до Я.。

Наприклад, ви можете використовувати…wp_headДія полягає в тому, щоб додати власний код до частини сторінки або використатиthe_contentФільтри змінюють вихідний текст статей.

Створення власних типів статей

Щоб створити типи контенту, які виходять за межі стандартних типів “статті” та “сторінки”, необхідно зареєструвати власні типи статей. Це зазвичай робиться у відповідних налаштуваннях системи управління контентом.initВиконується у функції-хвилі (hook function).

function mytheme_register_portfolio() {
    $labels = array(
        'name'               => _x( '作品集', '作品集通用名称', 'mytheme' ),
        'singular_name'      => _x( '作品', '作品单数名称', 'mytheme' ),
        'menu_name'          => __( '作品集', 'mytheme' ),
    );
    $args = array(
        'labels'             => $labels,
        'public'             => true,
        'publicly_queryable' => true,
        'show_ui'            => true,
        'show_in_menu'       => true,
        'query_var'          => true,
        'rewrite'            => array( 'slug' => 'portfolio' ),
        'capability_type'    => 'post',
        'has_archive'        => true,
        'hierarchical'       => false,
        'menu_position'      => 5,
        'supports'           => array( 'title', 'editor', 'thumbnail', 'excerpt', 'comments' ),
    );
    register_post_type( 'portfolio', $args );
}
add_action( 'init', 'mytheme_register_portfolio' );

Зміна параметрів за замовчуванням для запиту та відображення результатів

Фільтри можна використовувати для детального керування різними аспектами вихідної інформації на веб-сайті. Наприклад, якщо ви хочете, щоб на сторінці архіву відображалися лише статті певної категорії, або щоб змінити

hosting.com Віртуальний хостинг

Висока продуктивність завдяки процесорам AMD EPYC, SSD-накопичувачам NVMe і технології LiteSpeed, цілодобова експертна підтримка, розширені заходи безпеки, включаючи SSL, грубу силу, захист від шкідливих програм і DDoS, економія до 73%.

сторінка доступу

// 修改主页查询，排除特定分类
function mytheme_exclude_category_home( $query ) {
    if ( $query->is_home() && $query->is_main_query() ) {
        $query->set( 'cat', '-5, -9' ); // 排除ID为5和9的分类
    }
}
add_action( 'pre_get_posts', 'mytheme_exclude_category_home' );

// 修改摘录长度
function mytheme_excerpt_length( $length ) {
    return 30; // 将默认的55词改为30词
}
add_filter( 'excerpt_length', 'mytheme_excerpt_length' );

Найкращі практики забезпечення безпеки, продуктивності та обслуговування

Міцнийfunctions.phpФайли мають не лише виконувати свої функції, а й враховувати аспекти безпеки, продуктивності та зручності обслуговування.

По-перше, необхідно ескапувати та перевіряти всі дані, введені користувачами. WordPress надає багато функцій для забезпечення безпеки, таких як…esc_html()、esc_url()和sanitize_text_field()Переконайтеся, що під час відправки будь-яких динамічних даних на фронтенд використовуються відповідні функції ескапування.

По-друге, зверніть увагу на організацію коду. Код, який містить понад сотню рядків, потребує ретельного планування та структуриризації, щоб бути легким для розуміння та управління.functions.phpФайли стануть складними для обслуговування. Найкращим рішенням буде використовувати їх як “лодери” (loaderи), розділивши код для різних функцій на окремі PHP-файли у папках тем (theme directories), а потім…functions.phpчерезrequire_onceВпровадження.

Рекомендуємо до прочитання. Швидке освоєння розробки тем для WordPress: повне керівництво від початківця до професіонала.。

// 在functions.php中组织代码
require_once get_template_directory() . '/inc/theme-setup.php';
require_once get_template_directory() . '/inc/enqueue-scripts.php';
require_once get_template_directory() . '/inc/custom-post-types.php';
require_once get_template_directory() . '/inc/custom-functions.php';

Що стосується продуктивності, слід уникати ситуацій, коли…functions.phpНе виконуйте тривалих запитів до баз даних чи операцій з файлами безпосередньо на сторінці, особливо у коді, який виконується під час завантаження кожної сторінки. Використовуйте кеш для зберігання результатів операцій, розумно плануйте моменти виконання певних дій (за допомогою хуків), а також сво

Наостанок, додайте чіткі коментарі до своїх власних функцій та хуків (hooks), а також використовуйте поля для тексту, присвятовані конкретним темам (як показано вище).mythemeПідготуйте всі рядки, які виводяться користувачам, до інтернаціоналізації. Це значно полегшить подальшу співпрацю та локалізацію контенту.

Міжсерверний віртуальний хостинг

Віртуальний хостинг $2.50 USD на місяць, перший місяць $0.1 USD за промокодом tryinterserver, 461 скрипт хмарних додатків, встановлення в один клік.

сторінка доступу

підсумок

functions.phpФайл є серцем та центральною нервовою системою розробки тем для WordPress. Від підтримки початкових функцій теми, налаштування меню та бічних панелей, до стандартизованого впровадження скриптів та стилів, а також можливостей глибокого, непомітного для користувача налаштування за допомогою дій (actions) та фільтрів (filters), цей файл надає розробникам величезні можливості для формування поведінки WordPress. Дотримання сучасних практик розробки, таких як безпечне програмування, оптимізація продуктивності та модульне підход до створення коду, допоможе вам створити якісні та надійні теми для вашого сайтуfunctions.phpЦей файл не лише потужний, а й надійний у використанні, легкий у обслуговуванні та розширенні. Оволодіння ним означає, що ви здатні перейти від ролі користувача готових тем до справжнього творця тем.

Часті запитання

Як безпечно змінювати файл functions.php у підтемі?

Створення підтем є наразі найбезпечнішим та найкращим способом модифікації та розширення функцій батьківської теми. Ви можете створювати власні підтеми у відповідному каталозі.functions.phpФайл. Цей файл не буде перезаписаний під час оновлення батьківської теми, і він буде виконуватися перед батьківською темою.functions.phpФайл було завантажено. У цьому файлі підтеми ви можете безпосередньо додавати нові функції або перевизначати функції батьківської теми за допомогою хуків (hooks). Наприклад, якщо ви хочете лише змінити спосіб завантаження стилів у батьківській темі, ви можете це зробити у файліfunctions.phpСпочатку видаліть зв’язок (хук) вашого стилю зі списком очікування стилів батьківської теми, а потім знову додайте свій стиль до цього списку.

Чому код, який я додав, не спрацював?

Існує кілька поширених причин, чому код не працює. По-перше, перевірте наявність синтаксичних помилок – навіть дрібна помилка в PHP-синтаксисі може призвести до того, що весь код перестане функціонувати коректно.functions.phpВиконання файлу зазнало невдачі. Ви можете спробувати вирішити цю проблему, увімкнувши певні параметри чи налаштування.WP_DEBUGПереконайтеся, що під час перегляду модуля немає жодних помилкових повідомлень. Далі, перевірте, чи код був доданий у правильне місце (наприклад, чи функція визначена всередині відповідного хука, а сам хук не був активований). Третє – переконайтеся, що імена функцій чи хуків не перетинаються; краще додати унікальні префікси до імен власних функцій. Нарешті, переконайтеся, що ваші зміни були збережені, а також очистіть кеш браузера та системи WordPress під час перегляду сторінки.

Як додати власний короткий код у файл functions.php?

在functions.phpДодавання коротких кодів є дуже поширеним запитом. Використання таких кодів полегшує роботу та підвищує ефективність систем.add_shortcode()Це можна легко зробити за допомогою функцій. Спочатку вам потрібно визначити функцію-повернення (коректор), яка буде генерувати вихідний код короткого формату, а потім використовувати цю функцію для отримання бажаного результату.add_shortcode()Зареєструйте його.

// 定义短代码回调函数
function mytheme_contact_button_shortcode( $atts ) {
    // 解析短代码属性
    $atts = shortcode_atts( array(
        'text' => '联系我们',
        'url'  => '/contact',
    ), $atts, 'contact_button' );

// 返回安全的HTML输出
    return '<a href="/uk/' . esc_url( $atts['url'] ) . '/" class="contact-button">'`.esc_html($atts['text'])`.'</a>'// Реєстрація скороченого коду
add_shortcode( 'contact_button', 'mytheme_contact_button_shortcode' );

Після цього ви зможете використовувати цей матеріал у статтях, на сторінках чи в додатках/інструментах.[contact_button text="点击联系" url="/contact-us"]Нарешті час використати цей короткий код.

Які переваги та недоліки використання функцій, доданих у файл functions.php, порівняно з використанням незалежних плагінів?

在functions.phpНайбільшою перевагою додавання функцій безпосередньо до теми є їхнє тісне інтегрування та зручність використання. Весь код поєднується з темою, що полегшує її управління та розповсюдження, особливо якщо ці функції є ключовими елементами зовнішнього вигляду та користувацького досвіду сайту. Однак недоліком є те, що ці функції прив’язані до життєвого циклу теми: при зміні теми вони також зникають, що може призвести до втрати частини вмісту або функціоналу сайту. Незалежні плагіни, навпаки, дозволяють розділити функції від зовнішнього вигляду, тому вони залишаються активними незалежно від обраної теми, що робить їх кращим варіантом для універсальних функцій (наприклад, SEO, форми, кешування). Оптимальною практикою є розміщення функцій, які стосуються лише візуального аспекту (наприкладfunctions.phpЯкщо функція стосується роботи з даними або загальної логіки (наприклад, налаштування типів статей чи покращення функцій управління користувачами), особливо якщо потрібно зберегти її однаковою для різних тематик, слід створит