Rozwój motywów WordPress: poznaj podstawowe praktyki i najlepsze rozwiązania w pliku functions.php.

Definicja i kluczowa rola pliku `functions.php`

W temacie WordPress…functions.phpTo specjalny i potężny plik. W istocie jest to plik rozszerzenia (plugin) przyznaczony do konkretnego tematu (theme), który jest ładowany w momencie aktywacji tego tematu i wyłączany w momencie jego dezaktywacji. Głównym zadaniem tego pliku jest dodawanie dostosowanych funkcji do tematu oraz modyfikacja zachowania samego WordPressa, bez konieczności edycji jego źródłowych plików lub tworzenia osobnych rozszerzeń. Dzięki temu developerzy mogą centralnie zarządzać całą logiką dostosowań tematu – od włączenia prostych funkcji, takich jak zdjęcia przedstawiające temat, po tworzenie złożonych typów artykułów, budowę panelu opcji tematu oraz używanie hooków i filtrów.

Zrozumieniefunctions.phpZasięg działania tego pliku jest niezwykle istotny. Jest on ważny wyłącznie w odniesieniu do tematu, do którego należy, co gwarantuje portowalność funkcji oraz zachowanie integralności samego tematu. Poprzez pisanie kodu w tym pliku możesz bezpiecznie dodawać niemalże dowolne funkcje do swojego witryny, zachowując przy tym elastyczność podczas przyszłych aktualizacji i migracji tematów. Zarówno dla początkujących, jak i doświadczonych programistów gruntowne poznanie i opanowanie tego pliku jest koniecznym krokiem na drodze od modyfikacji podstawowych tematów do rozwijania zaawansowanych rozwiązań.

Počatkowa konfiguracja funkcji tematycznych oraz najczęściej używane funkcje

Włączenie funkcji obsługi tematów

Każdy współczesny temat WordPressa powinien wyraźnie określać, które funkcje core (podstawowe) wspiera. To wymaga ustawienia odpowiednich informacji w pliku konfiguracji tematu.add_theme_support()Funkcja służy do określenia możliwości twojego tematu w WordPress. Informuje platformę o tym, jakie funkcje twoje tema potrafi obsługiwać i wyświetlać – na przykład miniatury artykułów, kustomowe logo, obsługę znaków HTML5 itd.

Polecamy lekturę. Droga do zaawansowanego rozwoju tematów WordPress: budowanie profesjonalnych, responsywnych tematów od zera。

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' );

Zawij kod konfiguracji w…after_setup_themeW hookach upewnij się, że są wykonywane poprawnie podczas inicjalizacji tematu.

UltaHost – hostingu dla stron WordPress

Gwarancja zwrotu pieniędzy w ciągu 30 dni, nieograniczony przepustowość sieci i dostęp do bazy danych, bezpłatna ochrona przed atakami typu DDoS. Promocja: 50% przy zakupie na 3 lata.

strona dostępu

Menü nawigacyjne i panel boczny z funkcją rejestracji

Pełna tematyczna strona zawiera zwykle dostosowalny menu nawigacyjne oraz obszar z dodatkowymi funkcjami (boczna ramka). Aby to umożliwić, konieczne jest użycie odpowiednich elementów interfejsu.register_nav_menus()和register_sidebar()Funkcja.

// 注册主题菜单位置
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' );

Kwadransowanie skryptów i stylów

Aby stosować najlepsze praktyki rozwoju w WordPressie i uniknąć konfliktów, wszystkie pliki JavaScript i CSS powinny być dostępne poprzez…wp_enqueue_scriptsZaładowanie jest realizowane za pomocą „hooków”. WordPress oferuje taką możliwość.wp_enqueue_style()和wp_enqueue_script()Można stworzyć funkcję, aby osiągnąć ten cel.

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' );

Ten sposób gwarantuje poprawne obsługiwanie zależności (np. jQuery) oraz umożliwia łatwe kontrolowanie miejsca ładowania skryptów (w nagłówku lub w stopcu strony). Do zarządzania stylami i skryptami w panelu administracyjnym należy używać…admin_enqueue_scriptsHak.

Dokonanie głębokiej personalizacji za pomocą haków (hooks) i filtrów

Rozumienie działań i filtrów (Understanding Actions and Filters)

Podstawowa rozszerzalność WordPressu w dużej mierze jest zależna od jego architektury pluginów, a dokładniej od zwanych „hooków” (hooków). Hooki dzielą się na dwa typy: „actions” (akcje) i „filters” (filtry). Akcje umożliwiają wykonywanie własnego kodu w określonych momencach, natomiast filtry pozwalają modyfikować dane przekazywane w trakcie działania systemu.functions.phpTo doskonałe miejsce do stosowania tych haków.

Polecamy lekturę. Od zera do jednego: praktyczny przewodnik po całym procesie tworzenia motywu WordPress.。

Na przykład możesz użyć…wp_headAby dodać własny kod do określonej części strony lub go użyć, należy wykonać następujące kroki:the_contentFiltry zmieniają wygląd treści artykułów po ich wyświetleniu.

Tworzenie własnych typów artykułów

Aby stworzyć typy treści, które przewyższają standardowe typy “Artykuł” i “Strona”, konieczne jest zarejestrowanie własnych typów artykułów. To zwykle robi się w odpowiednim miejscu w systemie zarządzania treścią.initWykonuje się w związku z hookiem.

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' );

Zmiana standardowego zapytania i wyników wyświetlania

Filtry mogą być używane do precyzywnego kontrolowania różnych elementów wyświetlanych na stronie internetowej. Na przykład, jeśli chcesz, aby na stronie archiwów wyświetlały się tylko artykuły z określonej kategorii, lub chcesz zmienić długość ich opisów, to filtry mogą ci w tym pomóc.

hosting.com Hosting współdzielony

Wysoka wydajność dzięki procesorom AMD EPYC, pamięci masowej NVMe SSD i LiteSpeed, wewnętrzne wsparcie ekspertów 24/7, zaawansowane środki bezpieczeństwa, w tym SSL, brute force, ochrona przed złośliwym oprogramowaniem i DDoS, oszczędność do 73%

strona dostępu

// 修改主页查询，排除特定分类
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' );

Najlepsze praktyki dotyczące bezpieczeństwa, wydajności i konserwacji

Silnyfunctions.phpPliki nie tylko muszą spełniać określone funkcje, ale także należy zwrócić uwagę na ich bezpieczeństwo, wydajność oraz łatwość konserwacji.

Najpierw należy wykonać escape i sprawdzić wszystkie dane wprowadzone przez użytkowników. WordPress oferuje wiele funkcji bezpieczeństwa, np.esc_html()、esc_url()和sanitize_text_field()Upewnij się, że przy wyświetlaniu dowolnych dynamicznych danych na stronie klienta (frontend) używane są odpowiednie funkcje escape.

Następnie należy zwrócić uwagę na organizację kodu. Kod, który składa się z ponad setki linii, może być trudny do odczytywania i zarządzania.functions.phpPliki staną się trudne do utrzymania w porządku. Najlepszym rozwiązaniem jest użycie ich jako “loaderów” (elementów do ładowania kodu) i rozdzielenie kodu realizującego różne funkcje na osobne pliki PHP umieszczone w katalogach tematycznych. Następnie…functions.phpNastępnie należy przejść przez kontrolę bezpieczeństwa.require_onceWprowadzenie.

Polecamy lekturę. Szybkie poznanie tworzenia motywów w WordPressie: kompletny przewodnik od podstaw do praktycznego zastosowania.。

// 在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';

Jeśli chodzi o wydajność, należy unikać sytuacji, w których…functions.phpNie wykonywaj długotrwałych zapytań do bazy danych ani operacji na plikach wprost w kodzie, szczególnie w tym, który jest uruchamiany przy każdym otwarciu strony. Korzystaj z mechanizmów cache, rozplanuj czas wykonywania różnych procedur („hooków”) racjonalnie i usuwaj te procedury, które nie są już potrzebne.

Na koniec dodaj jasne komentarze w języku chińskim do swoich własnych funkcji i hooków, a także użyj pola tekstowego związanych z tematem (jak to było powyżej).mythemeZadbaj o to, aby wszystkie teksty wyświetlone użytkownikom były przygotowane z uwzględnieniem wymagań różnych języków. To znacząco ułatwi dalszą współpracę oraz lokalizację treści.

Hosting współdzielony InterServer

Hosting współdzielony $2.50 USD miesięcznie, pierwszy miesiąc $0.1 USD kod promocyjny tryinterserver, 461 skryptów aplikacji w chmurze, instalacja jednym kliknięciem.

strona dostępu

Podsumowanie.

functions.phpPlik ten stanowi „serce” i „centralny system nerwowy” rozwoju tematów dla WordPressa. Od podstawowej obsługi funkcji tematu, menu oraz możliwości rejestracji użytkowników, poprzez standardyzację formatów skryptów, aż po możliwości dostosowania tematu w sposób głęboki i bezinwazywny za pomocą akcji (actions) i filtrów (filters), ten plik daje programistom ogromne możliwości w kształtowaniu zachowania WordPressa. Dodanie zabezpieczonych metod programowania, optymalizacji wydajności oraz zorganizowania kodu według zasad modularności zapewni twoim projektom najwyższy poziom jakości i bezpieczeństwa.functions.phpTen plik nie tylko jest potężny, ale także wytrzymały i łatwy w utrzymaniu oraz rozszerzaniu. Opanowanie jego funkcji oznacza, że doszliśmy do kluczowego etapu na drodze od użytkownika gotowych tematów do prawdziwego twórcy tematów.

FAQ – najczęściej zadawane pytania.

Jak bezpiecznie modyfikować plik functions.php w kontekście subtematów?

Tworzenie podtematów to aktualnie najbezpieczniejszy i najzalecany sposób na modyfikację oraz rozszerzenie funkcji tematów rodzicielskich. Możesz tworzyć swoje własne elementy w katalogu związanym z danym podtematem.functions.phpPlik. Ten plik nie zostanie przywrócony po aktualizacji rodzinnego tematu i zostanie wyświetlony przed rodzinnym tematem.functions.phpPlik został załadowany. W tym pliku w ramach podtematu możesz bezpośrednio dodawać nowe funkcje lub modyfikować funkcje z tematu rodzicowego za pomocą „hooków”. Na przykład, jeśli chcesz tylko zmienić sposób ładowania stylów w temacie rodzicowym, możesz to zrobić w pliku swojego podtematu.functions.phpUsunąć hook z kolejki stylów tematu rodzicowego, a potem ponownie umieścić swoje własne style do tej kolejki.

Dlaczego dodany przez mnie kod nie funkcjonuje?

Istnieje kilka poważnych powodów, dla których kod nie działa tak, jak powinien. Najpierw sprawdź błędy gramatyczne – nawet najmniejszy błąd w składzie kodu PHP może uniemożliwić jego poprawne działanie.functions.phpWykonanie pliku nie udało się. Możesz to naprawić, włączając…WP_DEBUGSprawdź, czy w modułach nie występują żadne błędne informacje. Następnie upewnij się, że kod został umieszczony we właściwym miejscu (na przykład, czy funkcja jest definiowana wewnątrz hooka, a ten hook nie został aktywowany). Ponadto sprawdź, czy nie występują konfliktów nazw funkcji lub hooków; warto dodać unikalne prefiksy do nazw własnych funkcji. Na koniec upewnij się, że Twoje zmiany zostały rzeczywiście zapisane, a po otworzeniu strony wykasuj cache w przeglądarzu i w WordPress.

Jak dodać własny skrót kodu w pliku functions.php?

在functions.phpDodawanie krótkich kodów jest bardzo powszechnym wymogiem.add_shortcode()Można to łatwo zrealizować za pomocą funkcji. Najpierw musisz definiować funkcję zwrotną (callback), która będzie generować treść wyświetlaną w postaci krótkiego kodu, a potem użyć tej funkcji w odpowiednim miejscu.add_shortcode()Zarejestruj to.

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

// 返回安全的HTML输出
    return '<a href="/pl/' . esc_url( $atts['url'] ) . '/" class="contact-button">'`.esc_html($atts['text'])`.'</a>'// Rejestracja skróconego kodu
add_shortcode( 'contact_button', 'mytheme_contact_button_shortcode' );

Później możesz to użyć w artykułach, stronach internetowych lub narzędziach pomocniczych.[contact_button text="点击联系" url="/contact-us"]Pora użyć tego krótkiego kodu.

W porównaniu z niezależnymi pluginami, dodawanie funkcji w pliku functions.php ma swoje zalety i wady.

在functions.phpNajwiększymi zaletami dodawania funkcji w ramach tematów jest ich szczegółowa integracja z ich strukturą oraz wygodność obsługi. Wszystki kod jest połączony z danym tematem, co ułatwia zarządzanie i dystrybucję tych funkcji, szczególnie w przypadku, gdy stanowią one kluczową część wyglądu i funkcjonalności witryny. Minusem jest fakt, że te funkcje są powiązane z życiowym cyklem tematu – po zmianie tematu mogą zostać utracone, co może doprowadzić do braku niektórych elementów lub funkcji na stronie. Natomiast niezależne pluginy umożliwiają oddzielenie funkcji od wyglądu witryny, więc nie zmieniają się one podczas zmiany tematu, co czyni je lepszym wyborem dla funkcji ogólnego zastosowania (np. SEO, formularze, cache). Zgodnie z najlepszymi praktykami funkcje, które dotyczą wyłącznie elementów wyglądu (np. specjalne kontrole rozkładu strony, rozszerzenia stylu własne dla tematu), powinny być umieszczone w zewnętrznych modułach.functions.phpGdy funkcja dotyczy obszaru danych lub ogólnej logiki (np. tworzenia własnych typów artykułów, ulepszeń w zarządzaniu użytkownikami), szczególnie jeśli chcemy, aby te funkcje były dostępne we wszystkich tematach, należy stworzyć osobne pluginy.