Is_page_template () so sánh với cái gì?

Nhìn qua tài liệu Wordpress , nó nói rằng is_page_template()so sánh với "tên mẫu", nếu được cung cấp.

Tôi có một mẫu được lưu trữ trong page-homepage.phpđược gọi là Homepage:

/*
 * Template Name: Homepage
 * Description: The template for displaying the homepage
 */

Và tôi có một số mã tôi muốn chạy trong hàm.php của mình khi tôi đang sử dụng mẫu đó:

if (is_page_template('Homepage')) { 
   ...

Nhưng nó không được kích hoạt khi tôi ở trên một trang sử dụng mẫu đó.

Khi tôi nhìn vào mã mà Wordpress thực thi is_page_template(), có vẻ như nó thực sự kiểm tra tên tài liệu, không phải tên mẫu ...?

function is_page_template( $template = '' ) {

    $page_template = get_page_template_slug( get_queried_object_id() );

    if ( $template == $page_template )
        return true;

Trong trường hợp của tôi có vẻ như $page_templatelà page-homepage.php- không phải là tên mẫu, như các tài liệu cho thấy ...?

Tôi có làm điều gì sai?

Điều kiện của bạn nên được viết như thế này:

if (is_page_template('path/file.php')) { 
    // Do stuff
}

Tôi tin rằng sự nhầm lẫn là kết quả của hai điều:

1. Các tài liệu đề cập đến "tên" một cách mơ hồ. Chỉ định "tên tệp" sẽ làm cho tài liệu rõ ràng hơn nhiều.
2. Mã phía sau is_page_template()cho thấy get_page_template_slug()chức năng ở cốt lõi của nó. Hàm này thực sự trả về một tên tệp chứ không phải sên mẫu. https://codex.wordpress.org/Function_Reference/get_page_template_slug

Khi chỉ định một đối số cho is_page_template()hàm (như trong ví dụ trên), đường dẫn tệp có liên quan đến gốc chủ đề.

Chức năng này sẽ không hoạt động bên trong vòng lặp.

Tôi nghĩ điều tốt nhất để nói là, nó kiểm tra tên TẬP_TIN và trong trường hợp của bạn, nó sẽ là trang-page.php. vì thế:

if (is_page_template('page-homepage.php')) { 
  ...

Những điều khác cần nghĩ đến là nếu tệp mẫu thực sự được lưu trữ trong một thư mục khác bên trong chủ đề. đọc thêm

Một điều nữa, đó Template Name: Homepagelà những gì được sử dụng để xác định mẫu khi tạo trang hoặc bài đăng.