Cấu trúc đường dẫn (URL) là yếu tố then chốt quyết định cách công cụ tìm kiếm đánh giá và người dùng tương tác với nội dung trang web của bạn. Việc triển khai Custom Post Type (CPT) và Custom Taxonomy (CT) với cấu trúc URL chuẩn mực, đặc biệt là khi tích hợp slug của taxonomy vào đường dẫn CPT, không chỉ cải thiện đáng kể SEO mà còn mang lại trải nghiệm điều hướng mạch lạc cho người dùng.

Tại sao cấu trúc URL này lại quan trọng đến vậy?

Cấu trúc URL truyền thống cho CPT thường bỏ qua thông tin danh mục, dẫn đến đường dẫn như /san-pham/ten-san-pham. Tuy nhiên, việc nhúng slug của taxonomy vào, tạo thành /san-pham/dien-thoai/iphone-7-64G-trang, mang lại nhiều lợi ích chiến lược:

• Tăng cường SEO và Từ khóa: Đường dẫn trở nên giàu từ khóa hơn, giúp công cụ tìm kiếm hiểu rõ ngữ cảnh của bài viết. Từ “dien-thoai” trong URL san-pham/dien-thoai/iphone-7-64G-trang ngay lập tức báo hiệu nội dung liên quan đến điện thoại, cải thiện khả năng xếp hạng cho các truy vấn cụ thể.
• Cải thiện Trải nghiệm Người dùng (UX): Người dùng có thể dễ dàng nhận biết vị trí của mình trên trang web và hiểu mối quan hệ phân cấp giữa các nội dung. Cấu trúc này giúp họ dự đoán nội dung và điều hướng trực quan hơn.
• Tổ chức nội dung mạch lạc: Nó phản ánh cấu trúc phân loại nội dung một cách logic, đặc biệt hữu ích cho các trang web có nhiều sản phẩm hoặc dịch vụ đa dạng.

Phân tích chuyên sâu các thành phần code và ý nghĩa của chúng

Để đạt được cấu trúc URL tối ưu này, chúng ta cần phối hợp ba phần code chính trong file functions.php của theme WordPress.

Đăng ký Custom Post Type "san_pham"

Khi đăng ký CPT “san_pham”, điểm mấu chốt nằm ở đối số rewrite và has_archive.

$rewrite = array(
    'slug' => _x('san-pham/%danhmuc_sanpham%', 'slug', 'devvn'), // Slug của trang chi tiết sản phẩm
    'with_front' => true,
    'pages' => true,
    'feeds' => true,
);
$args = array(
    // ... các đối số khác ...
    'has_archive' => 'san-pham', // Đường dẫn của archive
    'rewrite' => $rewrite,
    // ...
);
register_post_type('san_pham', $args);

• 'slug' => 'san-pham/%danhmuc_sanpham%': Đây là nơi chúng ta định nghĩa placeholder %danhmuc_sanpham%. WordPress sẽ hiểu rằng phần này cần được thay thế động. Việc sử dụng placeholder này là bắt buộc để có thể chèn slug của taxonomy vào URL của từng bài viết.
• 'has_archive' => 'san-pham': Đảm bảo trang lưu trữ (archive) của tất cả các “sản phẩm” sẽ có đường dẫn cơ sở là /san-pham/. Điều này tạo sự nhất quán với phần đầu của URL chi tiết sản phẩm.

Đăng ký Custom Taxonomy "danhmuc_sanpham"

Taxonomy “danhmuc_sanpham” được liên kết với CPT “san_pham”. Cấu hình rewrite của taxonomy cũng đóng vai trò quan trọng.

$rewrite = array(
    'slug' => _x('san-pham', 'slug', 'devvn'),
    'with_front' => true,
    'hierarchical' => true,
);
$args = array(
    // ... các đối số khác ...
    'rewrite' => $rewrite,
);
register_taxonomy('danhmuc_sanpham', array('san_pham'), $args);

• 'slug' => 'san-pham': Đặt slug của taxonomy này giống hệt với has_archive của CPT là một thủ thuật quan trọng. Nó giúp các trang danh mục sản phẩm (ví dụ: /san-pham/dien-thoai/) có cùng base URL với trang lưu trữ CPT, duy trì sự đồng nhất và dễ hiểu cho cả người dùng lẫn công cụ tìm kiếm.
• 'hierarchical' => true: Cho phép tạo các danh mục con (ví dụ: “iPhone” là con của “Điện thoại”), hỗ trợ cấu trúc URL phân cấp như /san-pham/dien-thoai/iphone/.

Xử lý Rewrite Permalinks cho CPT và Taxonomy

Đây là phần phức tạp nhất, nơi các placeholder được thay thế và các quy tắc rewrite tùy chỉnh được thêm vào.

1. Thay thế Placeholder %danhmuc_sanpham%

Hook post_type_link được sử dụng để can thiệp vào quá trình tạo permalink của CPT.

function devvn_cpt_sanpham_post_type_link( $permalink, $post ) {
    if ( 'san_pham' !== $post->post_type || false === strpos( $permalink, '%' ) ) {
        return $permalink;
    }
    $terms = get_the_terms( $post->ID, 'danhmuc_sanpham' );
    if ( ! empty( $terms ) ) {
        // Lấy term đầu tiên và xử lý danh mục cha để tạo slug đầy đủ
        $category_object = apply_filters( 'devvn_cpt_sanpham_post_type_link_product_cat', $terms[0], $terms, $post );
        $category_object = get_term( $category_object, 'danhmuc_sanpham' );
        $product_cat = $category_object->slug;
        if ( $category_object->parent ) {
            $ancestors = get_ancestors( $category_object->term_id, 'danhmuc_sanpham' );
            foreach ( $ancestors as $ancestor ) {
                $ancestor_object = get_term( $ancestor, 'danhmuc_sanpham' );
                $product_cat = $ancestor_object->slug . '/' . $product_cat;
            }
        }
    } else {
        $product_cat = _x( 'khong-phan-loai', 'slug', 'devvn' ); // Xử lý trường hợp không có taxonomy
    }
    $permalink = str_replace( '%danhmuc_sanpham%', $product_cat, $permalink );
    return $permalink;
}
add_filter( 'post_type_link', 'devvn_cpt_sanpham_post_type_link', 10, 2 );

• post_type_link filter: Bộ lọc này được kích hoạt mỗi khi WordPress cố gắng tạo đường dẫn cho một bài viết.
• get_the_terms và get_ancestors: Code này truy xuất các danh mục được gán cho sản phẩm. Nếu có danh mục cha, nó sẽ xây dựng chuỗi slug phân cấp (ví dụ: dien-thoai/iphone) để đảm bảo đường dẫn chính xác.
• Xử lý trường hợp không có danh mục: Nếu sản phẩm không được gán vào bất kỳ danh mục nào, nó sẽ tự động sử dụng slug “khong-phan-loai”, tránh lỗi 404 và duy trì tính nhất quán.

2. Đồng bộ hóa Base URL cho Danh mục sản phẩm

Để các đường dẫn danh mục như /san-pham/dien-thoai hoạt động chính xác và có cùng base với CPT archive, cần thêm các quy tắc rewrite tùy chỉnh.

function devvn_cpt_sanpham_category_base_same_shop_base( $flash = false ){
    $terms = get_terms(array(
        'taxonomy' => 'danhmuc_sanpham',
        'hide_empty' => false,
    ));
    if ($terms && !is_wp_error($terms)) {
        foreach ($terms as $term) {
            $term_slug = $term->slug;
            $baseterm = str_replace(esc_url(home_url('/')), '', get_term_link($term->term_id, 'danhmuc_sanpham'));
            add_rewrite_rule($baseterm . '?$', 'index.php?danhmuc_sanpham=' . $term_slug, 'top');
            add_rewrite_rule($baseterm . 'page/([0-9]{1,})/?$', 'index.php?danhmuc_sanpham=' . $term_slug . '&paged=$matches[1]', 'top');
            add_rewrite_rule($baseterm . '(?:feed/)?(feed|rdf|rss|rss2|atom)/?$', 'index.php?danhmuc_sanpham=' . $term_slug . '&feed=$matches[1]', 'top');
        }
    }
    if ($flash == true) flush_rewrite_rules(false);
}
add_filter( 'init', 'devvn_cpt_sanpham_category_base_same_shop_base');
add_action( 'created_term', 'devvn_cpt_sanpham_cat_same_shop_edit_success', 10, 2 );
add_action( 'created_danhmuc_sanpham', 'devvn_cpt_sanpham_cat_same_shop_edit_success', 10, 2 );
function devvn_cpt_sanpham_cat_same_shop_edit_success( $term_id, $taxonomy ) {
    devvn_cpt_sanpham_category_base_same_shop_base(true);
}

• add_rewrite_rule: Đây là hàm quan trọng để tạo các quy tắc rewrite tùy chỉnh. Nó ánh xạ các đường dẫn thân thiện (ví dụ: /san-pham/dien-thoai) về các truy vấn nội bộ của WordPress (ví dụ: index.php?danhmuc_sanpham=dien-thoai). Các quy tắc này được thêm vào cho từng danh mục, bao gồm cả phân trang và feed.
• flush_rewrite_rules(false): Hàm này cực kỳ quan trọng. Mỗi khi bạn thêm hoặc chỉnh sửa một danh mục mới, các quy tắc rewrite cần được làm mới để WordPress nhận diện chúng. Việc gọi flush_rewrite_rules(false) thông qua hook created_term (hoặc created_danhmuc_sanpham) đảm bảo rằng các đường dẫn mới sẽ không bị lỗi 404 ngay sau khi tạo.

Lựa chọn công cụ hỗ trợ và triển khai hiệu quả

Việc tạo CPT và CT có thể bắt đầu dễ dàng với các công cụ trực tuyến như GenerateWP.com và GenerateWP.com/taxonomy/. Chúng cung cấp mã cơ bản, giúp bạn tiết kiệm thời gian khởi tạo.

Khi nào nên dùng code và khi nào nên dùng plugin?

• Sử dụng code (như hướng dẫn này):

  • Ưu điểm: Kiểm soát tối đa, không phụ thuộc vào plugin bên thứ ba, tối ưu hóa hiệu suất vì không tải thêm tài nguyên không cần thiết, lý tưởng cho các nhà phát triển theme hoặc dự án yêu cầu tùy biến sâu.
  • Nhược điểm: Yêu cầu kiến thức về PHP và WordPress API, việc cập nhật hoặc bảo trì có thể phức tạp hơn nếu không có tài liệu rõ ràng.

• Sử dụng plugin (ví dụ: Custom Post Type UI, Advanced Custom Fields):

  • Ưu điểm: Dễ sử dụng qua giao diện người dùng, nhanh chóng triển khai, phù hợp cho người không chuyên về code.
  • Nhược điểm: Có thể thêm overhead không cần thiết, phụ thuộc vào bản cập nhật của plugin, ít linh hoạt hơn trong các trường hợp tùy biến cực kỳ đặc biệt.

Kết luận

Việc xây dựng Custom Post Type và Custom Taxonomy với cấu trúc URL chuẩn SEO và tối ưu trải nghiệm người dùng như đã phân tích là một bước tiến quan trọng trong việc quản lý nội dung WordPress. Bằng cách hiểu rõ ý nghĩa của từng dòng code và cách chúng tương tác, bạn có thể tạo ra một nền tảng website mạnh mẽ, dễ dàng mở rộng và thân thiện với công cụ tìm kiếm. Sau khi triển khai, hãy luôn truy cập Cài đặt > Đường dẫn tĩnh và lưu lại một lần nữa để làm mới các quy tắc rewrite của WordPress.