Phát triển chủ đề WordPress: Nắm vững các thực hành cốt lõi và giải pháp tối ưu trong tệp `functions.php`

Định nghĩa và vai trò cốt lõi của tệp `functions.php`

Trong các chủ đề WordPress,functions.phpĐây là một tệp tin đặc biệt và mạnh mẽ. Về bản chất, đây là một tệp plugin dành riêng cho từng chủ đề (theme), được tải vào khi chủ đề đó được kích hoạt và bị gỡ bỏ khi chủ đề đó bị vô hiệu hóa. Chức năng chính của tệp tin này là bổ sung các tính năng tùy chỉnh cho chủ đề và thay đổi cách hoạt động của phần cốt lõi của WordPress (WordPress core), mà không cần phải sửa đổi các tệp cốt lõi hay tạo ra các plugin riêng biệt. Điều này cho phép các nhà phát triển quản lý toàn bộ logic tùy chỉnh của chủ đề một cách tập trung, từ những tính năng đơn giản như hiển thị hình ảnh đại diện, cho đến những tính năng phức tạp hơn như đăng ký các loại bài viết tùy chỉnh, xây dựng bảng điều khiển tùy chọn của chủ đề, cũng như sử dụng các hook (cơ chế kết nối giữa các thành phần của hệ thống) và filter (bộ lọc dữ liệu).

Hiểu rồi.functions.phpPhạm vi hoạt động của tệp này (scope of this file) là vô cùng quan trọng. Nó chỉ có hiệu lực đối với chủ đề (theme) mà nó thuộc về, điều này giúp đảm bảo tính di động (portability) của các chức năng và tính toàn vẹn (integrity) của chủ đề đó. Bằng cách viết mã trong tệp này, bạn có thể an toàn bổ sung hầu như bất kỳ chức năng nào cho trang web của mình, đồng thời vẫn giữ được tính linh hoạt trong các bản cập nhật sau này hoặc việc chuyển đổi sang các chủ đề khác. Đối với cả người mới bắt đầu lẫn các nhà phát triển có kinh nghiệm, việc nghiên cứu kỹ lưỡng và làm chủ tệp này là con đường bắt buộc để từ việc chỉnh sửa các chủ đề cơ bản tiến lên phát triển các chủ đ

Cấu hình ban đầu cho các tính năng chủ đề và các hàm thường được sử dụng

Enabling the theme support feature

Mỗi chủ đề WordPress hiện đại đều nên công bố rõ ràng những tính năng cốt lõi mà chúng hỗ trợ; điều này cần được thực hiện thông qua…add_theme_support()Bạn cần sử dụng một hàm để thực hiện điều này. Hàm này sẽ thông báo cho WordPress rằng chủ đề của bạn có thể xử lý và hiển thị những tính năng nào, chẳng hạn như ảnh thu nhỏ của bài viết, Logo tùy chỉnh, hỗ trợ các thẻ HTML5, v.v.

Đọc thêm Hướng dẫn nâng cao phát triển chủ đề WordPress: Xây dựng chủ đề chuyên nghiệp đáp ứng từ con số không。

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

Hãy đặt đoạn mã cấu hình bên trong một khối lồng như sau:after_setup_themeTrong các “hook” (các đoạn mã được thực thi tại những thời điểm nhất định trong quá trình chạy ứng dụng), hãy đảm bảo rằng chúng được thực thi đúng cách khi chủ đề (theme) được khởi tạo.

UltaHost – Nhà cung cấp dịch vụ máy chủ WordPress chuyên nghiệp

Bảo đảm hoàn tiền trong 30 ngày, băng thông và cơ sở dữ liệu không giới hạn, bảo vệ DDoS miễn phí, mua 3 năm ưu đãi 50%

Truy cập trang

Menu điều hướng và thanh bên cạnh dùng để đăng ký

Một chủ đề hoàn chỉnh thường bao gồm một menu điều hướng có thể tùy chỉnh và khu vực công cụ nhỏ (bảng điều khiển bên cạnh). Điều này đòi hỏi sử dụng công cụ phát triển web phù hợp.register_nav_menus()和register_sidebar()Hàm.

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

Quản lý hàng đợi cho các script và kiểu dáng (styles)

Để tuân theo các thực hành tốt nhất trong việc phát triển WordPress và tránh xung đột, tất cả các tệp JavaScript và CSS đều nên được lưu trữ và sử dụng thông qua các kênh được WordPress khuyến nghị.wp_enqueue_scriptsCác hook được sử dụng để thực hiện quá trình tải dữ liệu. WordPress cung cấp nhiều hook khác nhau để bạn có thể tùy chỉnh hành vi của hệ thống.wp_enqueue_style()和wp_enqueue_script()Có một hàm được thiết kế để thực hiện mục đích này.

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

Phương pháp này đảm bảo rằng các phụ thuộc (chẳng hạn như jQuery) được xử lý một cách chính xác, và cho phép kiểm soát dễ dàng vị trí tải các tập tin script (ở phần đầu trang hoặc phần chân trang). Đối với các tập tin thiết lập giao diện (styles) và script dùng cho phần quản trị nội bộ (backend), nên sử dụng cách tiếp cận tươngadmin_enqueue_scriptsMóc.

Tùy chỉnh sâu bằng cách sử dụng các hook (móc) và filter (bộ lọc)

Hiểu về các hành động (actions) và bộ lọc (filters)

Khả năng mở rộng cốt lõi của WordPress phụ thuộc rất nhiều vào cấu trúc plugin của nó, đó là các Hook (khớp nối). Các Hook được chia thành hai loại: Action (Hành động) và Filter (Bộ lọc). Hook Action cho phép bạn thực thi mã tùy chỉnh vào những thời điểm nhất định, trong khi Hook Filter cho phép bạn thay đổi dữ liệu được truyền qua trong quá trình thực thi chương trình.functions.phpĐây thực sự là địa điểm lý tưởng để sử dụng những công cụ/khóa (hooks) này.

Đọc thêm Từ con số không đến con số một: Hướng dẫn thực hành toàn diện về quá trình phát triển theme WordPress。

Ví dụ, bạn có thể sử dụng…wp_headBạn có thể thêm mã tùy chỉnh vào các phần trên trang web, hoặc sử dụng các công cụ có sẵn để thực hiện các thao tác cần thiết.the_contentBộ lọc thay đổi nội dung bài viết được hiển thị.

Tạo loại bài viết tùy chỉnh

Để tạo ra các loại nội dung vượt ra ngoài các loại mặc định là “Bài viết” (Article) và “Trang” (Page), bạn cần đăng ký các loại bài viết tùy chỉnh. Việc này thường được thực hiện thông qua các bước quy định cụ thể trong hệ thống quản lý nội dung.initThực thi trong hook.

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

Thay đổi truy vấn mặc định và cách hiển thị kết quả.

Các bộ lọc (filters) có thể được sử dụng để kiểm soát chính xác nội dung được hiển thị trên trang web. Ví dụ, nếu bạn muốn chỉ hiển thị các bài viết thuộc một danh mục cụ thể trên trang lưu trữ, hoặc muốn thay đổi độ dài của phần tóm tắt (abstract) của các bài viết.

Hosting.com - lưu trữ chia sẻ

Hiệu năng cao, được trang bị CPU AMD EPYC, lưu trữ SSD NVMe và LiteSpeed, hỗ trợ chuyên gia nội bộ 24 giờ/ngày, các biện pháp bảo mật tiên tiến bao gồm SSL, chống brute force, phần mềm độc hại và bảo vệ DDoS, tiết kiệm tới 73%.

Truy cập trang

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

Các thực hành tốt nhất về bảo mật, hiệu suất và bảo trì

Một cơ thể khỏe mạnhfunctions.phpCác tệp tin không chỉ cần thực hiện được chức năng được yêu cầu, mà còn phải được chú trọng đến yếu tố bảo mật, hiệu suất và khả năng bảo trì.

Trước hết, cần tiến hành đánh dấu ký tự đặc biệt (escape) và xác thực tất cả dữ liệu do người dùng nhập vào. WordPress cung cấp nhiều hàm bảo mật hữu ích, chẳng hạn như…esc_html()、esc_url()和sanitize_text_field()Hãy đảm bảo rằng khi truyền bất kỳ dữ liệu động nào đến phía trước (frontend), bạn đều sử dụng các hàm thoát (escape functions) phù hợp.

Thứ hai, hãy chú ý đến cách tổ chức mã nguồn. Một đoạn mã có hơn hàng trăm dòng…functions.phpCác tệp tin sẽ trở nên khó bảo trì hơn nếu không được quản lý đúng cách. Giải pháp tốt nhất là sử dụng chúng như những “trình tải” (loaders), và chia mã nguồn cho các chức năng khác nhau thành các tệp PHP riêng biệt, được lưu trữ trong các thư mục tương ứng (themes). Sau đó, bạn cófunctions.phphãy tải bản dịch thông qua hàmrequire_onceĐưa vào (introduce).

Đọc thêm Nắm vững phát triển chủ đề WordPress nhanh chóng: Hướng dẫn toàn diện từ cơ bản đến thực chiến。

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

Về mặt hiệu năng, nên tránh việc… (The sentence is incomplete; the exact meaning depends on the context.)functions.phpTránh thực hiện các truy vấn cơ sở dữ liệu tốn thời gian hoặc thao tác với tệp tin trực tiếp trong phần mã nguồn, đặc biệt là những thao tác được thực hiện mỗi khi trang web được tải. Hãy sử dụng cơ chế lưu trữ đệm (cache), tận dụng hợp lý thời điểm thực hiện các thao tác nhất định (nhờ các “hook”), và loại bỏ ngay những thành phần không

Cuối cùng, hãy thêm những ghi chú bằng tiếng Trung rõ ràng cho các hàm tùy chỉnh và các “hook” (chức năng được gọi tự động) của bạn, đồng thời sử dụng các ô văn bản theo chủ đề (theme text fields) như đã được minh họa ở trên.mythemeHãy chuẩn bị sẵn các chuỗi ký tự được hiển thị cho người dùng theo tiêu chuẩn quốc tế; điều này sẽ rất hữu ích cho việc hợp tác cũng như việc dịch nội dung theo ngôn ngữ cụ thể sau này.

Máy chủ chia sẻ của InterServer

Lưu trữ chia sẻ với mức phí $2,50 USD mỗi tháng, giảm giá $0,1 USD trong tháng đầu tiên, mã giảm giá tryinterserver, với 461 ứng dụng đám mây và cài đặt chỉ bằng một cú nhấp chuột.

Truy cập trang

Tóm lại

functions.phpFile là trái tim và hệ thần kinh trung ương trong quá trình phát triển các chủ đề (theme) cho WordPress. Từ việc hỗ trợ các tính năng cơ bản của chủ đề, quản lý menu và bảng điều khiển bên cạnh (sidebar), đến việc áp dụng các tiêu chuẩn hóa cho các định dạng script, và cuối cùng là khả năng tùy chỉnh sâu rộng mà không ảnh hưởng đến cấu trúc chính của hệ thống thông qua các action (hành động) và filter (bộ lọc), file này mang lại cho nhà phát triển quyền lực lớn trong việc định hình cách WordPress hoạt động. Việc tuân theo các thực hành phát triển hiện đại như lập trình an toàn, tối ưu hóa hiệu năng và tổ chức mã nguồn theo nguyên tắc mô-đun (modularization) sẽ giúp bạn tạo ra những chủ đề chất lượng cafunctions.phpCác tệp tin này không chỉ mạnh mẽ mà còn rất ổn định, dễ bảo trì và mở rộng. Việc nắm vững chúng đồng nghĩa với việc bạn đã bước từ một người sử dụng các chủ đề có sẵn sang một nhà tạo ra chủ đề thực thụ.

FAQ 常见问题

Làm thế nào để chỉnh sửa an toàn tệp functions.php trong các chủ đề con (sub-templates)?

Việc tạo ra các chủ đề con (sub-themes) hiện là phương pháp an toàn và được khuyến nghị nhất để chỉnh sửa cũng như mở rộng chức năng của các chủ đề mẹ (parent themes). Bạn có thể tạo các chủ đề con của mình trong thư mục tương ứng.functions.phpFile: This file will not be overwritten by updates to the parent theme, and it will be applied before the parent theme’s changes.functions.phpTệp đã được tải vào hệ thống. Trong tệp này thuộc chủ đề con, bạn có thể thêm các hàm mới trực tiếp, hoặc ghi đè các hàm của chủ đề cha bằng cách sử dụng các “hook” (cơ chế kết nối giữa các thành phần của hệ thống). Ví dụ, nếu bạn chỉ muốn thay đổi cách chủ đề cha tải các phong cách (styles), bạn có thể làm điều đó trong tệp thuộc chủ đề con.functions.phpHãy gỡ bỏ các liên kết (hooks) liên quan đến hàng đợi định dạng (style queue) của chủ đề cha, sau đó xếp lại các định dạng của riêng bạn vào hàng đợi đó.

Tại sao đoạn mã mà tôi thêm vào không hoạt động?

Có một số lý do phổ biến khiến mã không hoạt động như mong đợi. Đầu tiên, hãy kiểm tra xem có lỗi ngữ pháp không; một lỗi ngữ pháp nhỏ trong PHP cũng có thể khiến toàn bộ chương trình không thể chạy được.functions.phpThao tác thực thi tệp đã thất bại. Bạn có thể khắc phục điều này bằng cách bật tính năng tương ứng.WP_DEBUGTrước hết, hãy kiểm tra xem có thông báo lỗi nào trong chế độ xem mẫu (mode view) không. Tiếp theo, xác nhận xem đoạn mã có được thêm vào đúng vị trí hay không (ví dụ: hàm có được định nghĩa bên trong một hook, và hook đó có được kích hoạt hay không). Thứ ba, kiểm tra xem có xảy ra xung đột tên hàm hoặc tên hook hay không; tốt nhất là nên thêm một tiền tố độc đáo cho các hàm tùy chỉnh. Cuối cùng, đảm bảo rằng những thay đổi của bạn đã được lưu lại, và hãy xóa bộ nhớ đệm (cache) của trình duyệt cũng như của WordPress trước khi xem trang.

Làm thế nào để thêm các mã ngắn tùy chỉnh vào tệp `functions.php`?

在functions.phpViệc thêm shortcode vào là nhu cầu rất phổ biến. Sử dụngadd_shortcode()Chức năng này có thể được thực hiện một cách dễ dàng. Đầu tiên, bạn cần định nghĩa một hàm gọi lại (callback function) để tạo ra nội dung đầu ra của đoạn mã ngắn, sau đó sử dụng nó.add_shortcode()Hãy đăng ký nó.

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

// 返回安全的HTML输出
    return '<a href="/vi/' . esc_url( $atts['url'] ) . '/" class="contact-button">'`.esc_html($atts['text'])`.'</a>'// Đăng ký mã ngắn (shortcode)
add_shortcode( 'contact_button', 'mytheme_contact_button_shortcode' );

Sau đó, bạn có thể sử dụng nó trong các bài viết, trang web hoặc công cụ nhỏ (widgets).[contact_button text="点击联系" url="/contact-us"]Đã đến lúc gọi đoạn mã ngắn này rồi.

So với các plugin độc lập, việc thêm chức năng vào tệp functions.php có những ưu và nhược điểm như sau:

在functions.phpLợi thế lớn nhất của việc tích hợp các tính năng trực tiếp vào giao diện thiết kế (theme) là sự tích hợp chặt chẽ và tính tiện lợi trong quá trình sử dụng. Toàn bộ mã nguồn liên quan đến các tính năng này đều được kết hợp sẵn với theme, giúp việc quản lý và phân phối trở nên dễ dàng hơn, đặc biệt là khi những tính năng đó là những thành phần cốt lõi tạo nên giao diện và trải nghiệm người dùng của theme. Tuy nhiên, nhược điểm của phương pháp này là các tính năng này bị ràng buộc bởi vòng đời (lifecycle) của theme; nếu người dùng thay đổi theme, các tính năng đó có thể bị mất đi, dẫn đến tình trạng nội dung trang web hoặc chức năng không còn hoạt động như mong muốn. Ngược lại, các plugin độc lập cho phép tách biệt giữa các tính năng và giao diện, giúp chúng vẫn hoạt động bình thường bất kể người dùng chọn theme nào. Điều này là lựa chọn tốt hơn đối với những tính năng mang tính chất chung (như SEO, các biểu mẫu, bộ đệm – cache). Thực hành tốt nhất là: nếu một tính năng chỉ thuộc về lớp hiển thị (như các kiểm sofunctions.phpTrong trường hợp các tính năng thuộc về lớp dữ liệu hoặc logic tổng quát (chẳng hạn như việc tạo loại bài viết tùy chỉnh, cải thiện quản lý người dùng), đặc biệt là khi muốn duy trì những tính năng đó giữa các chủ đề khác nhau, bạn nên tạo ra các plugin riêng biệt.