WordPress Settings API 是什么，為什么重要

你可能主要到了，成為一個(gè)優(yōu)秀的開(kāi)發(fā)者從來(lái)不是一件容易的事情。無(wú)論是客戶工作還是產(chǎn)品開(kāi)發(fā)（無(wú)論是主題還是插件），在WordPress生態(tài)系統(tǒng)中起步，最大的問(wèn)題是“在哪里”而不是“如何實(shí)現(xiàn)”。 不管你經(jīng)驗(yàn)水平如何，WordPress對(duì)于開(kāi)發(fā)人員都有很好的API文檔。但是一個(gè)活躍的開(kāi)發(fā)社區(qū)和一個(gè)記錄良好的API并不能使平臺(tái)不受不良開(kāi)發(fā)實(shí)踐的影響。

與Web開(kāi)發(fā)的大多數(shù)方面一樣，某些工作并不像它以為的流程那樣容易理解。但作為開(kāi)發(fā)人員和工匠，我們的任務(wù)是確保我們發(fā)布的產(chǎn)品正常完成。讓各種各樣的主題或者插件以盡可能最好的方式完成工作，同時(shí)繞過(guò)煩人的源代碼。在主題選項(xiàng)、菜單頁(yè)、驗(yàn)證等方面尤其如此。

我們想改善這個(gè)過(guò)程。 在本系列中，我們將深入研究WordPress設(shè)置API。我們要看看它是什么，為什么它重要，以及如何利用它在我們的工作。 我們的最終目標(biāo)是不管您的經(jīng)驗(yàn)水平如何，本系列將成為設(shè)置API的可靠參考。到最后，你應(yīng)該對(duì)API和如何正確做事的堅(jiān)實(shí)的例子有一個(gè)清晰的理解。 為了完成，我們需要從零開(kāi)始。因此，在編寫(xiě)任何代碼或通過(guò)示例工作之前，我們需要介紹設(shè)置API、它是什么以及它為什么重要。

設(shè)置API定義

在最基本的層面上，設(shè)置API是WordPress提供的一組函數(shù)，它簡(jiǎn)化了引入菜單、選項(xiàng)頁(yè)以及保存、驗(yàn)證和檢索用戶輸入的過(guò)程。

很容易，對(duì)吧？

在整個(gè)系列中，我們將深入到每一個(gè)方面，但這應(yīng)該提供一個(gè)簡(jiǎn)單的定義，我們可以在整個(gè)文章的其余部分工作。

我們?yōu)槭裁匆褂迷O(shè)置API？

現(xiàn)在我們了解了設(shè)置API實(shí)際上是什么，我們需要看看為什么我們要使用它，而不是自己處理用戶輸入、序列化和驗(yàn)證。

與WordPress核心通信

設(shè)置API是由WordPress平臺(tái)的開(kāi)發(fā)人員提供的，以便便于擴(kuò)展應(yīng)用程序。因此，使用平臺(tái)本身的作者提供的功能難道不合理嗎？

當(dāng)然，完全可以繞過(guò)這些功能和“蠻力”我們自己的功能，沒(méi)有人能真正阻止它，但這需要我們不必要的工作，忽略WordPress核心團(tuán)隊(duì)的建議，最終可能破壞儀表板的內(nèi)聚經(jīng)驗(yàn)。 選擇利用開(kāi)發(fā)人員為開(kāi)發(fā)人員提供的功能確保我們將以適當(dāng)?shù)姆绞脚c核心應(yīng)用程序進(jìn)行通信。

從盒子里拿出免費(fèi)的東西

使用設(shè)置API并不是為了確保我們通過(guò)推薦的通道接近開(kāi)發(fā)。它也確保我們的用戶界面遵循平臺(tái)的最佳做法，我們的數(shù)據(jù)是使用WordPress的其余部分使用相同的機(jī)制。它不會(huì)影響到核心，并且可以節(jié)省我們很多時(shí)間。 當(dāng)您開(kāi)始以這樣的方式構(gòu)建接口，利用現(xiàn)有的WordPress樣式并使用設(shè)置API時(shí)，您的工作將更加緊密地與系統(tǒng)的其他部分集成。 這意味著當(dāng)用戶開(kāi)始使用你的工作時(shí)，他們不會(huì)覺(jué)得他們?cè)谑褂盟麄兊牟┛蜁r(shí)使用第三方工具。相反，他們正在對(duì)核心平臺(tái)進(jìn)行增強(qiáng)（而不是說(shuō)，添加）。 誠(chéng)然，使用本地WordPress樣式不是設(shè)置API的真正部分，上面的內(nèi)容有點(diǎn)主觀的觀點(diǎn)，但是設(shè)置API的一些方面——比如引入菜單頁(yè)面——利用本地WordPress樣式。那么，你的其他工作是否應(yīng)該遵循呢？

更安全，更有彈性

通過(guò)利用WordPress固有的功能，而不是利用自己的功能，可以確保保存、檢索和驗(yàn)證設(shè)置是正確管理的。畢竟，設(shè)置API提供了核心應(yīng)用程序所依賴的大部分功能。 最重要的是，設(shè)置API遵循與其他API相同的規(guī)則。例如，當(dāng)應(yīng)用程序的更新和/或變化了，功能需要經(jīng)過(guò)通常的折舊方法。這使您有足夠的時(shí)間在兼容中斷之前對(duì)項(xiàng)目進(jìn)行升級(jí)。如果你要滾動(dòng)你自己的功能，情況就不一樣了。

即將到來(lái)的路線圖

在這一點(diǎn)上，您應(yīng)該清楚地了解設(shè)置API是什么，以及為什么您應(yīng)該在主題和插件工作中使用它。

• 菜單、區(qū)段和選項(xiàng)卡導(dǎo)航
• 注冊(cè)部分的設(shè)置
• 原始的元素（輸入，文本區(qū)域，選擇單選按鈕和復(fù)選框
• 一個(gè)簡(jiǎn)單的工作示例

在本系列的最后，您應(yīng)該擁有創(chuàng)建一個(gè)堅(jiān)實(shí)的基于WordPress的產(chǎn)品所需的一切。

• 原文出自：http://code.tutsplus.com/tutorials/the-complete-guide-to-the-wordpress-settings-api-part-1-what-it-is-why-it-matters–wp-24060
• 感謝@jiuciyu 提供翻譯：https://gitee.com/jiuciyu/unify-admin/wikis/