# Tham Khảo Nhanh WordPress *Themes, hooks, queries, REST API, custom post types* > Source: WordPress Developer Resources (developer.wordpress.org) · MIT ## Cơ bản về Theme ### File bắt buộc | Command | Description | |---------|-------------| | `style.css` | Header metadata của theme + styles | | `index.php` | Template dự phòng (bắt buộc) | | `functions.php` | Cấu hình theme, hooks, enqueue | | `screenshot.png` | Ảnh xem trước theme (1200x900) | ### Header style.css ``` /* Theme Name: My Theme Theme URI: https://example.com Version: 1.0 Requires at least: 6.0 */ ``` ### Cấu hình functions.php ``` add_action('after_setup_theme', function() { add_theme_support('title-tag'); add_theme_support('post-thumbnails'); add_theme_support('html5', ['search-form', 'gallery']); register_nav_menus(['primary' => 'Main Nav']); }); ``` ## Hệ thống phân cấp Template ### Template trang | Command | Description | |---------|-------------| | `front-page.php` | Trang đầu tĩnh | | `home.php` | Danh sách bài đăng blog | | `single.php` | Bài đăng đơn | | `page.php` | Trang đơn | | `archive.php` | Lưu trữ bài đăng (ngày, danh mục) | | `category.php` | Lưu trữ danh mục | | `search.php` | Kết quả tìm kiếm | | `404.php` | Không tìm thấy | | `index.php` | Dự phòng cuối cùng | ### Template Parts ``` get_header(); // header.php get_footer(); // footer.php get_sidebar(); // sidebar.php get_template_part('parts/card'); // parts/card.php get_template_part('parts/card', 'featured'); ``` ### Thứ tự tra cứu (bài đăng đơn) | Command | Description | |---------|-------------| | `1` | single-{post_type}-{slug}.php | | `2` | single-{post_type}.php | | `3` | single.php | | `4` | singular.php | | `5` | index.php | ## Loop ### Loop tiêu chuẩn ```

``` ### Template Tags | Command | Description | |---------|-------------| | `the_title()` | Xuất tiêu đề bài đăng | | `the_content()` | Xuất nội dung bài đăng | | `the_excerpt()` | Xuất trích đoạn bài đăng | | `the_permalink()` | Xuất URL bài đăng | | `the_post_thumbnail()` | Xuất ảnh đặc trưng | | `the_date()` | Xuất ngày đăng | | `the_author()` | Xuất tên tác giả | | `the_category()` | Xuất link danh mục | ### Getters (trả về không xuất) ``` $title = get_the_title(); $url = get_permalink(); $id = get_the_ID(); $thumb = get_the_post_thumbnail_url(null, 'medium'); ``` ## Custom Post Types ### Đăng ký CPT ``` add_action('init', function() { register_post_type('product', [ 'labels' => ['name' => 'Products', 'singular_name' => 'Product'], 'public' => true, 'has_archive' => true, 'supports' => ['title', 'editor', 'thumbnail'], ]); }); ``` ### Phân loại tùy chỉnh ``` register_taxonomy('brand', 'product', [ 'labels' => ['name' => 'Brands'], 'hierarchical' => true, 'rewrite' => ['slug' => 'brand'], ]); ``` ### Tùy chọn supports | Command | Description | |---------|-------------| | `title` | Trường tiêu đề bài đăng | | `editor` | Trình soạn thảo nội dung | | `thumbnail` | Ảnh đặc trưng | | `excerpt` | Trường trích đoạn | | `custom-fields` | Meta box trường tùy chỉnh | | `page-attributes` | Thứ tự menu, cha | | `revisions` | Lịch sử sửa đổi | ## Hooks & Filters ### Actions (thực hiện gì đó) ``` // Register a hook add_action('wp_head', 'my_analytics', 20); function my_analytics() { echo ''; } ``` ### Filters (sửa đổi dữ liệu) ``` // Modify the excerpt length add_filter('excerpt_length', fn() => 30); // Append text to every post add_filter('the_content', function($c) { return is_single() ? $c . '

Thanks for reading!

' : $c; }); ``` ### Hooks chính | Command | Description | |---------|-------------| | `init` | WP đã khởi tạo; đăng ký CPT ở đây | | `wp_enqueue_scripts` | Enqueue CSS/JS | | `wp_head` | Xuất vào | | `wp_footer` | Xuất trước | | `save_post` | Sau khi lưu bài đăng | | `pre_get_posts` | Sửa đổi query chính trước khi thực thi | | `the_content` | Filter xuất nội dung bài đăng | | `the_title` | Filter xuất tiêu đề bài đăng | ## WP_Query ### Query tùy chỉnh ``` $q = new WP_Query([ 'post_type' => 'product', 'posts_per_page' => 10, 'orderby' => 'date', 'order' => 'DESC', ]); while ($q->have_posts()) : $q->the_post(); the_title('

', '

'); endwhile; wp_reset_postdata(); ``` ### Tham số phổ biến | Command | Description | |---------|-------------| | `post_type` | post, page, hoặc kiểu tùy chỉnh | | `posts_per_page` | Số kết quả (-1 cho tất cả) | | `category_name` | Lọc theo slug danh mục | | `tag` | Lọc theo slug tag | | `s` | Từ khóa tìm kiếm | | `meta_key / meta_value` | Lọc theo trường tùy chỉnh | | `tax_query` | Lọc phân loại nâng cao | | `date_query` | Lọc theo khoảng thời gian | ### Sửa đổi Query chính ``` add_action('pre_get_posts', function($q) { if (!is_admin() && $q->is_main_query() && is_home()) { $q->set('posts_per_page', 5); } }); ``` ## REST API ### Endpoints tích hợp | Command | Description | |---------|-------------| | `/wp-json/wp/v2/posts` | Liệt kê / tạo bài đăng | | `/wp-json/wp/v2/posts/{id}` | Lấy / cập nhật / xóa bài đăng | | `/wp-json/wp/v2/pages` | Endpoint trang | | `/wp-json/wp/v2/categories` | Endpoint danh mục | | `/wp-json/wp/v2/media` | Thư viện media | | `/wp-json/wp/v2/users` | Endpoint người dùng | ### Endpoint tùy chỉnh ``` add_action('rest_api_init', function() { register_rest_route('myplugin/v1', '/items', [ 'methods' => 'GET', 'callback' => fn($req) => new WP_REST_Response( get_posts(['post_type' => 'item', 'numberposts' => 20]) ), 'permission_callback' => '__return_true', ]); }); ``` ### Fetch từ JavaScript ``` const res = await fetch('/wp-json/wp/v2/posts?per_page=5'); const posts = await res.json(); posts.forEach(p => console.log(p.title.rendered)); ``` ## Hàm ### Hàm bài đăng | Command | Description | |---------|-------------| | `get_posts($args)` | Lấy mảng bài đăng | | `wp_insert_post($arr)` | Tạo hoặc cập nhật bài đăng | | `wp_delete_post($id)` | Đưa vào thùng rác hoặc xóa bài đăng | | `get_post_meta($id, $key)` | Lấy giá trị trường tùy chỉnh | | `update_post_meta($id, $k, $v)` | Thiết lập giá trị trường tùy chỉnh | ### Người dùng & Xác thực | Command | Description | |---------|-------------| | `wp_get_current_user()` | Người dùng đang đăng nhập | | `is_user_logged_in()` | Kiểm tra trạng thái đăng nhập | | `current_user_can($cap)` | Kiểm tra quyền | | `wp_create_nonce($action)` | Tạo nonce bảo mật | | `wp_verify_nonce($nonce, $a)` | Xác thực nonce | ### Hàm tiện ích | Command | Description | |---------|-------------| | `esc_html($str)` | Escape trong ngữ cảnh HTML | | `esc_attr($str)` | Escape trong ngữ cảnh thuộc tính | | `esc_url($url)` | Làm sạch URL | | `wp_kses_post($html)` | Chỉ cho phép HTML an toàn trong bài đăng | | `sanitize_text_field($s)` | Xóa thẻ và khoảng trắng dư thừa | | `absint($val)` | Số nguyên tuyệt đối | ## Enqueue ### Enqueue Styles & Scripts ``` add_action('wp_enqueue_scripts', function() { wp_enqueue_style('theme-style', get_stylesheet_uri(), [], '1.0'); wp_enqueue_script('theme-js', get_theme_file_uri('/js/app.js'), ['jquery'], '1.0', true); }); ``` ### Hàm Enqueue | Command | Description | |---------|-------------| | `wp_enqueue_style($h, $src)` | Đăng ký và enqueue CSS | | `wp_enqueue_script($h, $src)` | Đăng ký và enqueue JS | | `wp_localize_script($h, $n, $d)` | Truyền dữ liệu PHP sang JS | | `wp_dequeue_style($handle)` | Xóa style đã enqueue | | `wp_dequeue_script($handle)` | Xóa script đã enqueue | ### Truyền dữ liệu sang JavaScript ``` wp_enqueue_script('my-app', get_theme_file_uri('/js/app.js')); wp_localize_script('my-app', 'myData', [ 'ajaxUrl' => admin_url('admin-ajax.php'), 'nonce' => wp_create_nonce('my_action'), ]); // JS: console.log(myData.ajaxUrl) ``` ## Các mẫu thường dùng ### Template trang tùy chỉnh ```
``` ### AJAX Handler ``` add_action('wp_ajax_my_action', 'handle_my_action'); add_action('wp_ajax_nopriv_my_action', 'handle_my_action'); function handle_my_action() { check_ajax_referer('my_action', 'nonce'); wp_send_json_success(['msg' => 'OK']); } ``` ### Shortcodes ``` add_shortcode('greeting', function($atts) { $a = shortcode_atts(['name' => 'World'], $atts); return '

Hello, ' . esc_html($a['name']) . '!

'; }); // Usage: [greeting name="Zhi"] ```