如何安全地將自定義代碼添加到 WordPress 網站

已發表: 2020-12-29

用戶經常想方設法調整他們的網站、插件和主題,或者對現有功能進行一些修改。 在大多數情況下,您可以通過向 WordPress 網站添加自定義代碼來實現。

將自定義代碼添加到您的網站沒有任何問題。 但是,在對 WordPress 網站進行這些更改時,您需要注意一些事項。

本文重點介紹了需要注意的事項,以及將自定義代碼添加到 WordPress 網站的最佳實踐。

在 WordPress 中添加自定義代碼片段之前要尋找什麼

添加代碼片段作者在其教程中建議的最簡單方法是將代碼片段添加到主題的functions.php文件中。 但是,當您將代碼片段添加到主題的functions.php文件時,存在許多限制和缺點。

每次升級主題時,您添加到functions.php文件的自定義代碼片段都會被覆蓋,除非您手動升級主題,或手動將代碼片段從一個functions.php文件複製到另一個。 考慮到大多數開發人員非常頻繁地發布升級,尤其是在使用高級主題時,將代碼片段添加到主題的functions.php文件變得非常難以維護。

此外,如果您想更改主題,則還必須遷移代碼,從長遠來看,這絕對不是一件好事。

另一個缺點是主題文件在每個頁面上都執行,並且通過將代碼片段添加到主題的functions.php文件中,破壞整個網站的風險要高得多。

讓我們看看如何將自定義代碼片段添加到您的 WordPress 網站的最佳實踐,這樣您就不必再擔心丟失某些代碼片段、忘記遷移它或在升級主題時破壞功能。

向 WordPress 網站添加自定義代碼片段

可以使用以下方法之一添加自定義代碼:

  • 使用插件(請參閱我們的 WordPress 插件介紹以了解有關 WordPress 插件的更多信息)
  • 創建自定義插件
  • 創建子主題

現在,讓我們詳細討論每種方法。

1. 使用代碼片段插件

代碼片段1 插件是向 WordPress 網站添加自定義代碼的好方法,如果您不喜歡自己編寫一些代碼,這種方式比創建自己的插件更容易。

安裝插件後,您的 WordPress 菜單中會添加一個新的片段部分,您可以在其中添加新的片段。 每個片段都有代碼空間和關於代碼功能的附加信息的描述。

提示:如果您正在使用來自網站的有用代碼片段,請在說明中添加 URL,以便您記住代碼的來源。

自定義代碼示例

就像插件一樣,您可以啟用和禁用自定義代碼片段,也可以將它們導出到 PHP 文件中。 在某些情況下,自定義片段會導致與其他插件或主題發生衝突,因此停用所有自定義代碼對於定位問題很有用。

2. 創建您自己的站點特定插件

創建您自己的自定義站點特定插件是將自定義代碼添加到 WordPress 站點的最佳方式,因為您可以完全控制代碼。

什麼是特定於站點的 WordPress 插件?

特定於站點的 WordPress 插件用於將自定義代碼添加到不依賴於主題的網站。 這意味著無論您使用哪個主題,或者如果您在主題之間切換,您的插件的自定義代碼將始終運行,當然只要插件被激活。

為什麼創建特定於站點的 WordPress 插件更好?

如果您將自定義代碼添加到主題的函數文件中,則在您更新或切換主題時它將消失。

特定於站點的 WordPress 插件允許您輕鬆地將自定義代碼片段添加到您的 WordPress 站點,並確保它們與主題無關。 它是一個獨立的 WordPress 插件,這意味著它不依賴於您的主題,這意味著您可以自由更新或切換您的主題而不會丟失自定義代碼。

您無需成為 PHP 專家即可創建特定於站點的 WordPress 插件。 只需按照以下簡單步驟操作即可。

1.創建插件目錄

首先,您需要為插件創建一個目錄並為其命名。 它可以是任何名稱,例如站點的網站。 插件的目錄應該在您網站的/wp-content/plugins/目錄中創建。 對於這個例子,我們調用插件wpwhitesecurity-shortcodes 。 注意:在目錄名稱中始終使用破折號而不是空格。

2.創建插件文件

接下來,您將需要插件的主文件。 雖然對於文件名應該是什麼沒有規定,但最好的做法是文件名與插件名稱相同。 所以在我們的例子中,插件的文件名是wpwhitesecurity-shortcodes.php

該文件至少應包含標題和說明。

使用文本編輯器創建此文件,例如 NotePad ++ 或 TextEdit。 不要使用 Microsoft Word 或類似的編輯器,因為它會將格式數據添加到文本中,並且可能會弄亂您的文件。 上面列出的所有編輯器都是免費的。

這是您需要添加到文件中的所有內容:

<?php
/*
* Plugin Name: WP White Security Shortcodes
* Plugin URL: https://www.wpwhitesecurity.com
* Description: Site-specific plugin for custom code snippets in wpwhitesecurity.com
*/

這就是全部。 現在是時候添加自定義代碼了。

3.添加自定義代碼片段

現在您可以將教程等中的代碼片段複製並粘貼到此文件中。 如果您已離線創建插件文件,請將插件的文件夾壓縮為 .zip 文件,然後從 WordPress 儀表板上傳到您的網站。

從現在開始,您無需擔心丟失某些代碼片段、忘記遷移它或在升級主題或 WordPress 時破壞某些功能。 下次您遇到 WordPress 代碼片段並希望將其添加到您的網站時,請將其添加到特定於站點的插件文件中。

4.添加index.php文件(可選)

這是一個可選步驟。 為避免列出目錄,您應該在插件目錄中添加一個索引文件。 您需要做的就是:

創建一個名為 index.php 的文件
向其中添加以下內容:

<?php
/**
* Nothing to see here.

3.使用子主題functions.php

之前,我們說過不要使用主題的functions.php文件。 但是,對於某些更改,這是一個很好的選擇,例如,對於特定主題的更改。 這樣,當您的主題出現時,主題特定的自定義代碼就出來了,因為不再需要它了。

儘管如此,主題更改應始終添加到子主題,而不是父主題,因此它是升級安全的。

如果您將代碼添加到您的functions.php ,請始終確保查找關閉 PHP 標記。 這就是它們的樣子: ?> 。 如果您的主題文件以其中之一結尾,則應將自定義代碼放在其上方。

子主題functions.php目錄

結論

正如我們剛剛看到的,有幾種不同的方法可以將自定義代碼添加到您的 WordPress 網站,但從長遠來看,並非所有方法都是好的。 然而,他們中的一些人在特定的事情上比其他人更好。 例如,對於特定主題的更改(網站的外觀和感覺),將自定義代碼添加到functions.php文件。 對於任何其他更改,理想情況下,您應該創建自定義站點特定插件

只需確保以安全的方式將自定義代碼添加到 WordPress,並在出現問題時輕鬆調試。
我們希望本文能幫助您了解如何在您的 WordPress 網站中輕鬆添加自定義代碼片段。

本文中使用的參考文獻[ + ]

本文使用的參考資料
1 https://wordpress.org/plugins/code-snippets/