WordPress儀表板小部件API允許主題和插件添加，刪除或重新位置WordPress儀表板小部件。 WordPress儀表板是我們登錄WordPress管理屏幕時(shí)看到的第一件事。 WordPress儀表板窗口小部件API已從WordPress 2.7開(kāi)始。 在本教程中，我們將研究API提供的不同動(dòng)作和功能。並且，如何使用此API添加，刪除和定位儀表板小部件。

鑰匙要點(diǎn)

• > WordPress儀表板窗口小部件API允許主題和插件在WordPress儀表板上添加，或重新位置小部件。自WordPress 2.7以來(lái)，此API已可用，並且是WordPress開(kāi)發(fā)人員的關(guān)鍵工具。
添加一個(gè)小部件涉及使用WP_ADD_DASHBOOD_WIDGET函數(shù)，該功能需要三個(gè)參數(shù)：窗口小部件的唯一ID，窗口小部件的標(biāo)題和顯示窗口小部件內(nèi)容的回調(diào)。刪除小部件是通過(guò)remove_meta_box函數(shù)完成的。
> API沒(méi)有提供更改小部件位置的方法，但可以通過(guò)操縱WordPress Core $ WP_META_BOX變量來(lái)實(shí)現(xiàn)解決方法?？梢詫⒆远x數(shù)據(jù)添加到小部件中，並且可以使用CSS自定義它們的外觀。
• WordPress儀表板窗口小部件的場(chǎng)景後面 在內(nèi)部，WordPress儀表板小部件是WordPress Meta框。儀表板窗口小部件API使用WordPress Meta Box API添加，刪除和定位儀表板小部件。
添加儀表板窗口小部件

我們可以使用wp_add_dashboard_widget函數(shù)在WordPress儀表板上添加一個(gè)小部件。我們需要將此功能包裝在WP_DASHBOOD_SETUP鉤中。 這是一些有關(guān)如何使用WP_ADD_DASHBOOD_WIDGET的示例代碼：

在這裡，我們?cè)赼dd_dashboard_widget中調(diào)用WP_ADD_DASHBOOD_WIDGET，該WIDGET是由WP_DASHBOOD_SETUP HONK觸發(fā)的。 wp_add_dashboard_widget 採(cǎi)取三個(gè)論點(diǎn)。這是參數(shù)：

$ id：每個(gè)儀表板小部件都必須具有唯一的ID。確保您的插件或主題名稱將其前綴以避免覆蓋。

>

<span>function add_dashboard_widget()
</span><span>{
</span><span>wp_add_dashboard_widget("sitepoint", "SitePoint Videos", "display_sitepoint_dashboard_widget");
</span><span>}
</span>
<span>function display_sitepoint_dashboard_widget()
</span><span>{
</span><span>echo "Watch Video Courses at <a >Learnable</a>";
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "add_dashboard_widget");</span>

$標(biāo)題：要顯示的小部件的標(biāo)題。

>
1. $ callback：一個(gè)回調(diào)，顯示了窗口小部件的內(nèi)容。
>

小部件的外觀如下：

卸下儀表板小部件

我們可以使用remove_meta_box函數(shù)刪除默認(rèn)或自定義儀表板小部件。我們需要在wp_dashboard_setup函數(shù)中包裝此功能。 這是我們將如何使用remove_meta_box：

<span>function add_dashboard_widget()
</span><span>{
</span><span>wp_add_dashboard_widget("sitepoint", "SitePoint Videos", "display_sitepoint_dashboard_widget");
</span><span>}
</span>
<span>function display_sitepoint_dashboard_widget()
</span><span>{
</span><span>echo "Watch Video Courses at <a >Learnable</a>";
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "add_dashboard_widget");</span>

在這裡，我們?cè)趓emove_dashboard_widget函數(shù)中調(diào)用remove_meta_box函數(shù)，該功能的確是由WP_DASHBOOD_SETUP操作觸發(fā)的。 remove_meta_box進(jìn)行了三個(gè)參數(shù)，它們是：

1. $ id：小部件的唯一ID。這是默認(rèn)小部件的ID列表：dashboard_activity ，dashboard_right_now_now ，dashboard_recent_comments dashboard_quick_press ，dashboard_secondary ， dashboard_primaryand dashboard_incoming_links 。 $ location：刪除儀表板時(shí)，這將始終具有“儀表板”的值。 $位置：如果您要?jiǎng)h除由WordPress Core默認(rèn)創(chuàng)建的窗口小部件，或使用WP_ADD_DASHBOOD_WIDGEG創(chuàng)建的窗口

>在儀表板中定位小部件

默認(rèn)情況下，新小部件將添加到儀表板頁(yè)面的左下方。 WordPress儀表板小部件API無(wú)法提供更改小部件位置的方法。但是，我們可以將WordPress Core $ WP_META_BOX變量作為解決方法。 這是我們?nèi)绾螌⑿〔考浦另敳康氖纠?

<span>function add_dashboard_widget()
</span><span>{
</span><span>wp_add_dashboard_widget("sitepoint", "SitePoint Videos", "display_sitepoint_dashboard_widget");
</span><span>}
</span>
<span>function display_sitepoint_dashboard_widget()
</span><span>{
</span><span>echo "Watch Video Courses at <a >Learnable</a>";
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "add_dashboard_widget");</span>

您可以更改此數(shù)組並根據(jù)需要更改小部件的位置。

>在儀表板窗口小部件中顯示RSS feed

讓我們創(chuàng)建一個(gè)儀表板小部件，該小部件可以檢索SitePoint的RSS feed，然後顯示它。我們將使用WordPress的API獲取和解析RSS feed。 這是我們小部件的代碼：

<span>function remove_dashboard_widget()
</span><span>{
</span><span>remove_meta_box("sitepoint", "dashboard", "normal");
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "remove_dashboard_widget");</span>

在這裡，我們包括文件“ feed.php”，該文件揭示了與WordPress中RSS一起使用所需的所有API。然後，我們使用fetch_feed下載和解析RSS feed，最後顯示10個(gè)RSS項(xiàng)目。 這是我們的RSS儀表板小部件的外觀：

結(jié)論

許多WordPress插件，例如分析，WooCommerce插件和各種監(jiān)視擴(kuò)展程序，都使用儀表板小部件API。 WordPress儀表板窗口小部件API是WordPress開(kāi)發(fā)人員最重要的API之一，在此示例中，我們介紹了一些基本示例。請(qǐng)隨時(shí)評(píng)論您對(duì)下面API的經(jīng)歷。

經(jīng)常詢問(wèn)有關(guān)WordPress儀表板小部件API

的問(wèn)題

如何在WordPress儀表板中添加一個(gè)新的小部件？

>在WordPress儀表板中添加一個(gè)新的小部件是一個(gè)簡(jiǎn)單的過(guò)程。首先，您需要?jiǎng)?chuàng)建一個(gè)輸出小部件內(nèi)容的函數(shù)。然後，您需要使用WP_ADD_DASHBOOD_WIDGET函數(shù)向WordPress註冊(cè)此功能。此功能採(cǎi)用三個(gè)參數(shù)：小部件的ID，其名稱以及輸出其內(nèi)容的功能。完成此操作後，您的小部件將出現(xiàn)在您的儀表板上。

我可以從WordPress儀表板上刪除現(xiàn)有的小部件嗎？可以使用remove_meta_box函數(shù)完成此操作。此函數(shù)採(cǎi)用三個(gè)參數(shù)：要?jiǎng)h除的小部件的ID，顯示小部件的屏幕以及顯示小部件的上下文?？梢允褂肅SS自定義儀表板小部件的窗口小部件？您可以將自定義CSS添加到主題的樣式.css文件或使用自定義CSS插件。您可以通過(guò)將其ID用作CSS選擇器來(lái)定位特定的小部件。

我可以控制儀表板小部件的位置嗎？可以使用WP_DASHBOOD_SETUP ACTION HONK完成此操作。此鉤子允許您指定小部件在儀表板上的位置。

>

>如何將自定義數(shù)據(jù)添加到我的儀表板窗口小部件？

您可以通過(guò)創(chuàng)建一個(gè)輸出數(shù)據(jù)並使用wp_add_dashboard_widget函數(shù)的WordPress註冊(cè)該功能的函數(shù)來(lái)將自定義數(shù)據(jù)添加到儀表板窗口小部件中。數(shù)據(jù)可以是您想要的任何東西，例如統(tǒng)計(jì)，圖形甚至自定義表單。

>我可以在儀表板窗口小部件中使用ajax嗎？

是的，您可以在儀表板窗口窗口中使用ajax 。這可以通過(guò)啟用必要的JavaScript文件並使用WP_AJAX_ ACTION鉤在服務(wù)器端處理AJAX請(qǐng)求來(lái)完成。

>如何使我的儀表板窗口互動(dòng)？您的儀表板小部件通過(guò)使用JavaScript進(jìn)行交互。您可以使用WP_ENQUEUE_SCRIPT函數(shù)加入JavaScript文件，然後使用JavaScript將交互性添加到您的小部件中。

我可以在我的儀表板上添加同一小部件??的多個(gè)實(shí)例嗎？將同一小部件??的多個(gè)實(shí)例添加到儀表板中。每個(gè)小部件必須具有唯一的ID，因此，如果要添加同一小部件??的多個(gè)實(shí)例，則需要將每個(gè)實(shí)例註冊(cè)為具有唯一ID的單獨(dú)的窗口小部件。

我可以將儀表板窗口小部件添加到其他WordPress中的屏幕？可以使用add_meta_box函數(shù)完成此操作。此功能使您允許您在WordPress的任何屏幕上添加小部件，而不僅僅是儀表板。

>如何使我的儀表板窗口小部件響應(yīng)良好？

>您可以通過(guò)使用CSS Media通過(guò)CSS Media來(lái)響應(yīng)您的儀表板窗口小部件。查詢。您可以將這些媒體查詢添加到主題的樣式.css文件中，或使用自定義CSS插件。您可以通過(guò)使用其ID作為CSS選擇器來(lái)定位特定的小部件。

以上是WordPress儀表板小部件API的簡(jiǎn)介的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！