首頁 > CMS教程 > &#&按 > 了解WordPress頁面和頁面API

了解WordPress頁面和頁面API

William Shakespeare
發布: 2025-02-09 09:25:40
原創
862 人瀏覽過

WordPress 頁面與文章:靜態內容的管理與 API 應用

Understanding WordPress Pages and the Pages API

WordPress 頁面和文章有所不同,它們適用於不同類型的網站內容。本文將闡述頁面的用途、與文章的區別,並講解如何在 WordPress 網站上管理頁面,最後探討 WordPress 頁面 API 的相關函數。

關鍵要點:

  • WordPress 頁面用於展示網站上的靜態、永久性信息,例如“聯繫我們”或“關於我們”頁面,與時間無關,這與 WordPress 文章不同。
  • 擁有編輯或管理員權限的用戶均可管理 WordPress 頁面,包括添加、編輯和刪除頁面,以及使用“頁面屬性”框組織頁面層級結構。
  • WordPress 頁面 API 允許自定義和過濾顯示的頁面,包括顯示頁面列表、限制顯示的頁面數量、自定義輸出以及檢索頁面。
  • get_pages() 函數可用於檢索頁面列表數組,而 get_post() 函數則用於檢索單個頁面。這些函數允許在顯示頁面之前對其進行進一步自定義和操作。

什麼是 WordPress 頁面?

WordPress 頁面是網站上的一個內容頁面,例如“聯繫我們”或“關於我們”頁面。我們經常在網站的主要導航、側邊欄或頁腳中看到這些頁面的鏈接。

頁面和文章的主要區別在於時間的關聯性:文章通常與時間相關,而頁面的內容通常是永久性的。

發布新聞或教程時,時間上下文非常重要。新功能不會永遠都是新的,在某些情況下幾年後可能就不存在了。這就是為什麼撰寫此類內容時更適合使用文章。

另一方面,如果您想描述網站的目的,或提供聯繫表單,則應使用頁面。這是不會隨時間變化的靜態內容類型。

如何管理 WordPress 頁面?

添加、編輯和刪除頁面

如果您擁有編輯或管理員權限,則可以管理 WordPress 中的頁面。為此,請轉到 WordPress 儀表板中的“頁面”,您將看到所有頁面的列表,或者可以通過“添加新頁面”按鈕創建一個新頁面。

Understanding WordPress Pages and the Pages API 此列表類似於“文章”列表,使用方法相同。您可以點擊頁面的標題進行編輯,當您將鼠標懸停在頁面的標題上時,還會出現其他一些有用的快捷鏈接。

當您點擊編輯或添加頁面或文章時,您可以指定標題、內容,如果您的主題支持,還可以添加特色圖片。 “發布”按鈕允許您發布頁面。否則,如果您尚未準備好上線,可以將其保存為草稿。

組織頁面

要組織文章,可以使用分類和標籤。但是,沒有類似的方法來組織頁面。頁面仍然可以按層次結構組織。實際上,您可以將頁面指定為其他頁面的子頁面。這就像為您的分類創建子分類一樣。

要創建子頁面,請轉到“頁面屬性”框,您將在其中找到一個名為“父頁面”的下拉列表。在此列表中,選擇您想要作為當前創建或編輯頁面的父頁面的頁面。請注意,您還可以創建子子頁面、子子子頁面等,以創建您自己的層次結構。

默認情況下,頁面按字母順序(按標題)排序。您可以通過“頁面屬性”部分中的“順序”字段自定義此順序。然後,頁面將按照您在此字段中指示的數字排序。例如,如果您有三個標題為“頁面 1”、“頁面 2”和“頁面 3”的頁面,則默認情況下它們將按此順序顯示。如果您想讓“頁面 3”首先出現,請將其順序指示為 0,並將其他頁面的順序指示為更大的數字(例如 1 和 2)。

WordPress 頁面 API

顯示頁面列表

要顯示頁面列表,WordPress 提供了 wp_list_pages() 函數。默認情況下,它顯示包含所有已發布頁面的無序列表的 HTML 代碼,該代碼封裝在一個 li 標籤中,並帶有指示“頁面”的 h2 標題。它還接受一個參數:一個關聯數組,其中列出了一些自定義輸出的選項。

過濾輸出

可以使用一些選項來限制顯示的頁面數量。我們將看到的第一個選項是 child_of。它允許我們顯示具有給定頁面作為父頁面的頁面。以下示例顯示頁面 ID 為 2 的子頁面:

<?php wp_list_pages(array(
    'child_of' => 2
)); ?>
登入後複製
登入後複製

當我們想要顯示由一個或多個作者撰寫的頁面時,authors 選項非常有用。此選項接受字符串作為值:用逗號分隔的作者 ID 列表。使用以下參數,該函數將顯示由兩位作者撰寫的頁面:

<?php wp_list_pages(array(
    'authors' => '2,7'
)); ?>
登入後複製
登入後複製

要僅顯示某些頁面,可以使用 include 選項。您可以為此選項提供用逗號分隔的頁面 ID 列表,您將獲得這些頁面的列表:

<?php wp_list_pages(array(
    'include' => '7,53,8'
)); ?>
登入後複製
登入後複製

相反,如果您想隱藏某些頁面,可以使用 exclude 選項,它接受相同類型的值:

<?php wp_list_pages(array(
    'exclude' => '2,4'
)); ?>
登入後複製

您還可以選擇按深度進行篩選。例如,如果您只想查看頂級頁面,可以使用 depth 選項。

默認情況下,它設置為 0,並且會顯示所有頁面。將其設置為任何正數,您將只獲得此深度的頁面。例如,指示 1 將僅顯示頂級頁面。以下示例顯示這些相同的頁面及其直接子頁面:

<?php wp_list_pages(array(
    'depth' => 2
)); ?>
登入後複製

默認情況下,wp_list_pages() 僅顯示已發布的頁面。但是,您可以使用 post_status 選項顯示其他頁面。

使用此選項顯示您想要看到的狀態,用逗號分隔。以下示例顯示已發布的頁面和草稿:

<?php wp_list_pages(array(
    'child_of' => 2
)); ?>
登入後複製
登入後複製

除了過濾檢索到的頁面列表外,您還可以使用 number 選項限制檢索到的頁面數量。如果您使用正數,您將只檢索有限數量的頁面。

自定義輸出

您可以使用 title_li 選項自定義標題,該選項接受字符串作為值。默認情況下,它設置為“頁面”,然後您可以選擇任何文本進行顯示。您也可以將其設置為空字符串。

這樣,wp_list_pages() 不會將您的頁面封裝到 li 標籤中,您將直接獲得頁面的 li 標籤。

檢索頁面

wp_list_pages() 函數允許您獲取頁面的 HTML 列表。如果您想創建您自己的 HTML,或者如果您需要在顯示頁面之前對頁面應用某些操作,則此函數不是最佳選擇。相反,您更傾向於使用 get_pages() 來檢索列出不同頁面的數組。

此函數也接受數組作為參數,列出所需的選項。好消息是您已經了解其中一些選項,因為我們在wp_list_pages() 函數的描述中已經介紹了它們:child_ofauthorsincludeexcludepost_statusnumbersort_columnsort_order

默認情況下,get_pages() 中會顯示頁面的層次結構:子頁面將出現在其父頁面之後。您可以通過將 hierarchical 選項設置為 false 來禁用此行為。這樣,所有頁面都將被平等對待,並且層次結構將被完全忽略。

檢索單個頁面

get_pages() 函數返回一個列出所需頁面的數組,每個頁面都由一個 WP_Post 對象表示。我們現在將通過僅檢索一個頁面來了解此對像中包含的內容。要檢索頁面,請使用 get_post() 函數。為此函數提供頁面的 ID,您將獲得表示此頁面的對象:

<?php wp_list_pages(array(
    'authors' => '2,7'
)); ?>
登入後複製
登入後複製

此對像中提供了多條信息,每條信息都是一個屬性。例如,可以使用 ID 屬性獲取頁面的 ID:

<?php wp_list_pages(array(
    'include' => '7,53,8'
)); ?>
登入後複製
登入後複製

post_content 允許您檢索頁面的內容,而其標題位於 post_title 屬性中。 post_name 屬性包含頁面的 slug(其 URL 中表示頁面標題的部分)。

頁面作者的 ID 由 post_author 屬性給出。您還可以使用 post_date 檢索其創建日期,使用 post_modified 檢索其最後修改日期。 post_status 屬性允許您了解頁面的狀態(例如已發布或草稿)。

父頁面的 ID 可以使用 post_parent 屬性獲得,menu_order 將為您提供在創建頁面時指示的順序。

結論

如果您想向您的網站添加一些靜態的、永久性的信息,那麼 WordPress 頁面是解決方案。

如果您正在開發主題,WordPress 頁面 API 的函數非常有用。例如,您可以列出頁腳中的某些頁面,或創建小部件來執行此操作,以便您的用戶可以在任何他們想要的地方列出頁面。

WordPress 頁面和頁面 API 的常見問題解答

WordPress 頁面和文章有什麼區別?

WordPress 頁面和文章是兩種不同類型的內容。頁面是靜態的,不受時間影響,而文章是與時間相關的,用於動態內容。頁面通常用於內容不會經常更改的內容,例如“關於我們”或“聯繫我們”頁面。另一方面,文章用於博客、新聞更新和其他定期更新的內容。

如何使用 WordPress REST API 檢索頁面內容?

WordPress REST API 提供了 WordPress 數據類型的端點,允許通過 HTTP 協議與您的 WordPress 網站進行交互。要檢索頁面內容,您可以向 /wp/v2/pages 端點發送 GET 請求。這將返回一個 JSON 對象,其中包含您網站上的所有頁面。您還可以通過將頁面 ID 附加到端點來檢索特定頁面,例如 /wp/v2/pages/<id></id>

如何使用 WordPress REST API 創建新頁面?

要使用 WordPress REST API 創建新頁面,您可以向 /wp/v2/pages 端點發送 POST 請求。請求應包含一個 JSON 對象,其中包含頁面的標題、內容和狀態。狀態可以是“發布”、“待定”、“草稿”或“私有”。 API 將返回一個 JSON 對象,其中包含新創建頁面的詳細信息。

如何使用 WordPress REST API 更新頁面?

要使用 WordPress REST API 更新頁面,您可以向 /wp/v2/pages/<id></id> 端點發送 POST 請求,其中 <id></id> 是您要更新的頁面的 ID。請求應包含一個 JSON 對象,其中包含更新的標題、內容或狀態。 API 將返回一個 JSON 對象,其中包含更新頁面的詳細信息。

如何使用 WordPress REST API 刪除頁面?

要使用 WordPress REST API 刪除頁面,您可以向 /wp/v2/pages/<id></id> 端點發送 DELETE 請求,其中 <id></id> 是您要刪除的頁面的 ID。 API 將返回一個 JSON 對象,其中包含已刪除頁面的詳細信息。

如何使用 WordPress REST API 檢索所有頁面的列表?

要使用 WordPress REST API 檢索所有頁面的列表,您可以向 /wp/v2/pages 端點發送 GET 請求。這將返回一個 JSON 對象,其中包含您網站上所有頁面的列表。

如何使用 WordPress REST API 檢索所有已發布頁面的列表?

要使用 WordPress REST API 檢索所有已發布頁面的列表,您可以向 /wp/v2/pages 端點發送 GET 請求,並將“status”參數設置為“publish”。這將返回一個 JSON 對象,其中包含您網站上所有已發布頁面的列表。

如何使用 WordPress REST API 檢索所有草稿頁面的列表?

要使用 WordPress REST API 檢索所有草稿頁面的列表,您可以向 /wp/v2/pages 端點發送 GET 請求,並將“status”參數設置為“draft”。這將返回一個 JSON 對象,其中包含您網站上所有草稿頁面的列表。

如何使用 WordPress REST API 檢索所有私有頁面的列表?

要使用 WordPress REST API 檢索所有私有頁面的列表,您可以向 /wp/v2/pages 端點發送 GET 請求,並將“status”參數設置為“private”。這將返回一個 JSON 對象,其中包含您網站上所有私有頁面的列表。

如何使用 WordPress REST API 檢索所有待定頁面的列表?

要使用 WordPress REST API 檢索所有待定頁面的列表,您可以向 /wp/v2/pages 端點發送 GET 請求,並將“status”參數設置為“pending”。這將返回一個 JSON 對象,其中包含您網站上所有待定頁面的列表。

以上是了解WordPress頁面和頁面API的詳細內容。更多資訊請關注PHP中文網其他相關文章!

本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
作者最新文章
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板