不知道WordPress的function.php檔案是什麼，或者你能用它做什麼？
簡而言之，WordPress的function.php檔案為你提供了一個向你的網站新增程式碼段的方法。你可以以各種有用的方式使用這些程式碼段，所以瞭解function.php檔案的工作方式可以幫助你建立一個更好的WordPress網站。
在本教學中，我們將深入研究WordPress函式檔案。我們將討論它的工作原理以及您可以在哪裡找到它。最後，我們將向您展示一些可以對functions.php檔案進行的有趣的調整。
要參與WordPress開發，您首先需要了解平臺最重要的檔案是如何工作的。WordPress可以很容易地開始修改您的網站。然而，可能很難知道從哪裡開始——或預測您的更改實際上會做什麼。
一個完美的學習場所是functions.php檔案，它也被稱為functions檔案。這是進行更改和向WordPress新增程式碼的常見位置。通過編輯此檔案，您可以完成一些有用的事情，例如將Google Analytics統計程式碼新增到您的站點、建立自定義選單或顯示文章的估計閱讀時間。
- 什麼是functions.php檔案？
- 如何安全地使用functions.php檔案？
- 更好的function.php檔案替代方案
- 如何訪問編輯function.php檔案
- 使用WordPress函式檔案的一些小Case
- 組織你的functions.php檔案的最佳做法
什麼是functions.php檔案？
WordPress functions.php檔案是一個主題檔案，你可以用它來向你的網站新增自定義程式碼段。你可以使用這些程式碼片段來修改你的網站的不同區域的功能，或新增新的內容/程式碼到你的網站。
儘管被包含在你的主題中，WordPress的function.php檔案並不侷限於對你的主題進行定製。
在WordPress Codex這樣描述的功能檔案：
您可以使用它來呼叫函式，包括PHP和內建WordPress，並定義您自己的函式。您可以通過向WordPress外掛或通過WordPress主題功能檔案新增程式碼來產生相同的結果。
簡單來說，函式檔案使您能夠向站點新增自定義程式碼。它允許您以自定義方式建立新函式或引用現有函式。正如Codex指出的那樣，這使得函式檔案非常類似於外掛，但兩者之間存在一些差異。
你可以對你網站的任何部分進行調整，類似於外掛的工作方式。
最重要的區別是函式檔案屬於特定主題。如果您要更改主題或更新到更新版本，您所做的更改將會消失。出於這個原因，您應該考慮建立一個子主題並將新程式碼新增到子主題的函式檔案中。這樣，您可以在不丟失更改的情況下更新父主題。
下面是一些你可以使用WordPress functions.php檔案進行調整的常見型別：
- 改變WordPress的核心行為，例如在搜尋結果頁上顯示多少個帖子，或者在你的網站的RSS提要中包括什麼內容。
- 建立你自己的自定義短程式碼。
- 在您的網站上新增新的內容或指令碼，例如在某些頁面上注入您的即時聊天服務的指令碼或編輯您網站的頁尾。
- 這僅僅是表面上的東西…
因為function.php檔案允許您在您的網站上新增自定義的PHP程式碼段，而不是靜態HTML，當涉及到您可以做的修改型別時，天空是無限的。
WordPress的functions.php檔案位於哪裡？
WordPress的functions.php檔案位於你的活動主題的資料夾中，和其他主題檔案一起。要找到這個檔案，你可以用FTP或檔案管理器工具連線到你的伺服器，然後瀏覽到…/wp-content/themes/[active-theme-name]/functions.php。
例如，如果你使用流行的OceanWP主題，function.php檔案將位於…/wp-content/themes/oceanwp/functions.php。
是選擇使用函式檔案還是建立外掛完全取決於您，具體取決於您的需要。現在讓我們看看編輯函式檔案的不同方式。
如何安全地使用function.php檔案
因為使用WordPress的functions.php檔案涉及到向你的網站新增程式碼，所以在你開始做任何編輯之前，遵循一些最佳做法是很重要的。
即使是像缺少逗號或撇號這樣簡單的事情，也會在你的網站上引發錯誤，例如WordPress白屏死亡。
在最近的WordPress版本中，WordPress在以更優雅的方式處理這些錯誤方面已經做得更好了，比如顯示 “您的網站發生了一個嚴重錯誤” 的資訊，或者在儲存您的修改之前檢查PHP錯誤。
但是–為了避免任何問題的發生，我們總是建議遵循這些最佳實踐…
在暫存網站上測試你的functions.php程式碼
在新增任何function.php程式碼片段到你的WordPress網站之前，我們總是建議先在你網站的暫存版本上測試它們。這可以讓你檢查任何潛在的錯誤，並驗證程式碼片段是否按預期工作。
在進行function.php修改前備份你的網站
除了在暫存站點上進行測試之外，你還需要在將程式碼片段新增到你的真實站點的 functions.php 檔案之前備份你的真實站點。
這是編輯任何WordPress檔案時要遵循的一個很好的最佳做法。
如果程式碼片段出了什麼問題，你可以恢復到這個備份點，讓你的網站立即恢復工作。
現在大部分雲伺服器都提供自動備份你的網站的服務，你也可以在任何時候手動建立一個備份。如果你伺服器不提供自動備份服務，你可以閱讀我們關於如何備份WordPress網站的指南。
建議使用子主題編輯function.php檔案
因為WordPress的function.php檔案位於你的WordPress主題的程式碼中，當你更新你的主題時，你的主題將覆蓋function.php檔案。
為了避免你對主題的 functions.php 檔案所做的修改被覆蓋，你應該始終使用一個 WordPress 子主題，並將你的程式碼片段新增到子主題的 functions.php 檔案中。
通過使用子主題，你仍然能夠在需要的時候更新父主題，但你所有的function.php定製將不會被覆蓋。
要了解更多，請檢視我們關於如何建立一個WordPress子主題的完整指南。
function.php檔案的替代方案
雖然WordPress的function.php檔案提供了一個簡單的方法來新增程式碼片段到你的網站，但在大多數情況下，有一些function.php的替代品提供了一個更好的解決方案：
- 使用程式碼管理器外掛
- 在自定義外掛中儲存程式碼片段
這些替代方案比起使用function.php檔案，可以有一些優勢：
- 不與你的主題捆綁 – 這意味著如果你更換了主題，你的function.php定製仍然存在。
- 更好的組織 – 這些替代方案使你更容易組織你的程式碼片段，如果你計劃在你的網站上新增大量的程式碼片段，這可能是有幫助的。
- 更多的控制–在程式碼管理器外掛的情況下，您可以獲得有用的選項，如使用切換按鈕啟用/禁用一個程式碼片段，只在前端或後端執行程式碼片段，等等。
使用程式碼管理器外掛
程式碼管理器外掛是一個為你提供使用者友好介面的外掛，用於新增和編輯程式碼片段，否則這些程式碼片段將被放在 functions.php 檔案中。
最受歡迎的選擇之一是免費的Code Snippets外掛，但你可以找到其他提供類似功能的外掛。
有了Code Snippets，你可以從WordPress儀表板上新增你的function.php程式碼片段，並有完整的選項。
- 新增一個標題和描述。
- 使用標籤來組織您的片段。
- 只在您網站的某個部分執行該片段。
在Code Snippets外掛中新增一個程式碼片段
然後，您可以在一個列表中看到您的所有片段，並根據需要輕鬆啟用/禁用它們。
如何在Code Snippets中管理片段
因為Code Snippets是一個外掛，即使你更換了WordPress主題，你所有的程式碼片段仍然會在那裡。
建立一個自定義功能外掛
另一個替代WordPress的functions.php檔案的方法是建立你自己的自定義外掛來容納這些程式碼片段。
雖然這聽起來很複雜，但實際上比它看起來要簡單得多。
下面是它的工作原理：
- 在你的本地計算機上為你的外掛建立一個資料夾。
- 在該資料夾中建立一個單獨的.php檔案，用你最喜歡的文字編輯器編輯它。
- 將下面的程式碼模板新增到該檔案中。
- 將你的 functions.php 程式碼片段新增到該檔案中
<?php /** * Plugin Name: My Custom Code Snippets * Description: This is a custom plugin to house code snippets. * Author: Wbolt * Version: 1.0 */ /* Add the first code snippet below this comment - use the comment to explain what it does. */ [CODE] /* Add the second code snippet below this comment. */' [CODE] /* Continue as needed. */ [CODE] ?>
然後，你只需要在WordPress上安裝和啟用該外掛。這裡有2種方法可以做到這一點：
- 通過FTP/SFTP連線到你的伺服器，並將自定義外掛資料夾上傳到wp-content/plugins資料夾。然後，進入外掛列表，啟用該外掛。
- 用你的電腦建立一個資料夾的.zip檔案。然後，進入外掛→安裝外掛，上傳.zip檔案，就像其他外掛一樣安裝。
如何訪問編輯function.php檔案
編輯函式檔案就像使用標準文字編輯器（如 TextEdit 或記事本）一樣簡單。在開始之前，建立站點的備份並儲存原始的、未經編輯的functions.php檔案非常重要。這將使您能夠在編輯過程中出現問題時恢復您的站點。
1. 使用WordPress編輯器
如果您有權訪問 WordPress 管理介面，則可以直接從主題編輯器編輯功能檔案。轉到外觀 > 主題編輯器。
在螢幕的右側，您可以看到主題中包含的所有檔案的列表。這些因您使用的主題而異，但最重要的選項之一應該是Theme Functions (functions.php)。只需單擊該檔案即可在編輯器中開啟它。
現在，您可以直接編輯檔案。完成後，不要忘記單擊底部的更新檔案以儲存更改。
2. 通過FTP訪問檔案
如果您無法使用管理儀表板或更喜歡直接配置檔案，您還可以使用FileZilla等FTP工具訪問功能檔案。
開啟您的FTP工具並輸入伺服器賬號資訊以連線到您的站點。要找到正確的檔案，請導航到wp-content/themes/[the name of your theme]。當您開啟此資料夾時，您將看到functions.php檔案。
您現在要做的就是使用您喜歡的文字編輯軟體對其進行編輯。完成更改後，使用完全相同的名稱和副檔名儲存並覆蓋函式檔案。
使用WordPress函式檔案的一些小Case
您現在應該可以開始編輯您的函式檔案了。為了讓您開始，以下是您可以進行的各種調整的一些示例。您需要做的就是複製提供的程式碼片段並將它們貼上到函式檔案最底部的新行上（不要忘記儲存它！）。
1. 將Google Analytics新增到您的網站
有多種方法可以將Google Analytics與您的WordPress網站整合。其中之一是將您的憑據直接新增到函式檔案中。這會將分析跟蹤插入您網站的標題中，確保正確捕獲每次訪問。
首先將以下程式碼貼上到函式檔案的底部：
<?php
add_action('wp_head', 'wpb_add_googleanalytics');
function wpb_add_googleanalytics() { ?>
// Replace this line with your Google Analytics Tracking ID
<?php } ?>
您現在要做的就是找到您的跟蹤ID並將其貼上到包含佔位符文字的行中。當您儲存函式檔案時，您的站點將連線到您的Google Analytics帳戶。
2. 更改預設登入錯誤資訊
預設情況下，當有人嘗試登入WordPress網站失敗時，他們會看到如下錯誤訊息：
這並不理想，因為該站點正在向潛在入侵者提供有關嘗試失敗的原因的資訊。更安全的解決方案是將其更改為通用訊息。
您可以通過將以下程式碼新增到您的函式檔案中輕鬆完成此操作：
function no_wordpress_errors(){
return 'Something went wrong!';
}
add_filter( 'login_errors', 'no_wordpress_errors' );
看到“Something went wrong!” 第二行的訊息？這是下次發生錯誤登入嘗試時將出現的訊息：
只要保留單引號字元，您就可以將其更改為您想要的任何內容。嘗試使用不同的訊息，看看它是如何工作的。
3. 新增文章的預計閱讀時間
這個巧妙的技巧使您能夠計算和顯示閱讀帖子所需的估計時間。然後，您的訪問者可以立即大致瞭解內容的時長。
要實現此程式碼，您需要進行兩次單獨的編輯。第一個像往常一樣對函式檔案完成，您需要在其中貼上以下程式碼段：
function reading_time() {
$content = get_post_field( 'post_content', $post->ID );
$word_count = str_word_count( strip_tags( $content ) );
$readingtime = ceil($word_count / 200);
if ($readingtime == 1) {
$timer = " minute";
} else {
$timer = " minutes";
}
$totalreadingtime = $readingtime . $timer;
return $totalreadingtime;
}
但是，這僅執行計算。您現在需要在想要顯示結果的任何位置新增以下程式碼：
echo reading_time();
例如，您可以將其新增到每個文章旁邊顯示的後設資料中。每個主題的構造都不同，但在二〇一七主題中，它位於template-parts > post > content.php 中。
預計閱讀時間現在將出現在每個文章的標題中，並與日期一起顯示。
4. 刪除WordPress版本號
舊版本的WordPress可能包含惡意黑客和機器人可以利用的安全漏洞。避免這種風險的一種方法是隱藏您的網站使用的 WordPress 版本。這被稱為通過默默無聞的安全。
在我們繼續之前，重要的是要注意，默默無聞不應該是您唯一的安全措施。這更像是為您已經安全的WordPress堡壘新增一個額外的堡壘。
隱藏您的版本號只需要您將以下非常簡單的程式碼片段新增到函式檔案中：
remove_action('wp_head', 'wp_generator');
現在將從您網站的所有區域中刪除版本號，包括其程式碼和您的RSS提要。
5. 自動更新您的版權宣告
更新版權宣告中的年份是很容易忘記的小任務之一。你可以跟上的一種方法是使用這個技巧，它會根據你第一篇文章的發表年份自動生成版權日期。
將以下程式碼貼上到您的函式檔案中：
function wpb_copyright() {
global $wpdb;
$copyright_dates = $wpdb->get_results("
SELECT
YEAR(min(post_date_gmt)) AS firstdate,
YEAR(max(post_date_gmt)) AS lastdate
FROM
$wpdb->posts
WHERE
post_status = 'publish'
");
$output = '';
if($copyright_dates) {
$copyright = "© " . $copyright_dates[0]->firstdate;
if($copyright_dates[0]->firstdate != $copyright_dates[0]->lastdate) {
$copyright .= '-' . $copyright_dates[0]->lastdate;
}
$output = $copyright;
}
return $output;
}
然後在要顯示版權資訊的任何位置新增以下程式碼：
<?php echo wpb_copyright(); ?>
您現在將在您的網站上看到動態更新的版權日期。
在本例中，我們將日期新增到footer.php檔案中，以便將其顯示在頁面底部。
6. 新增自定義選單
大多數主題都有預定義的導航選單，但如果您想建立自己的選單並將其放置在網站上的任何位置，該怎麼辦？您需要做的就是將此程式碼貼上到您的函式檔案中：
function wpb_custom_new_menu() {
register_nav_menu('my-custom-menu',__( 'My Customized Menu' ));
}
add_action( 'init', 'wpb_custom_new_menu' );
您可以將“我的自定義選單”替換為您要為選單命名的名稱。如果您轉到管理區域中的外觀 > 選單，您應該會看到列出的新選項。
您現在可以在站點的任何位置新增新選單。
<?php wp_nav_menu( array( 'theme_location' => 'my-custom-menu', 'container_class' => 'custom-menu-class' ) ); ?>
最常見的是，您需要將此程式碼放在header.php檔案中。
7. 自定義您的摘要
摘要是您文章的簡短示例描述，可以顯示在您的主頁或搜尋結果中，而不是完整的文章內容。預設情況下，所有摘錄都具有相同的長度和連結文字，但您可以更改它。
首先，讓我們更改將您從摘要帶到完整文章的連結的文字。這通常是“閱讀更多”或“繼續閱讀”，但您可以通過將以下程式碼段貼上到您的函式檔案中來製作任何您想要的內容：
function new_excerpt_more($more) {
global $post;
return '<a class="moretag" href="'. get_permalink($post->ID) . '"> Read the full article...</a>';
}
add_filter('excerpt_more', 'new_excerpt_more');
這裡的連結文字已設定為Read the full article…：
然後，讓我們更改摘要的長度。將此程式碼貼上到您的函式檔案中：
function new_excerpt_length($length) {
return 20;
}
add_filter('excerpt_length', 'new_excerpt_length');
預設情況下，標準長度為55個字。在本例中，它被設定為20。您可以將數字更改為您想要的任何值。
8. 為您的網站新增隨機背景
最後，讓我們以一個有趣的設計技巧結束。此調整使您可以在每次有人訪問網站時為您的網站隨機生成新的背景顏色。首先將以下程式碼新增到函式檔案中：
function wpb_bg() {
$rand = array('0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f');
$color ='#'.$rand[rand(0,15)].$rand[rand(0,15)].$rand[rand(0,15)].
$rand[rand(0,15)].$rand[rand(0,15)].$rand[rand(0,15)];
echo $color;
}
此程式碼為顏色生成HTML標記，因此您現在需要做的就是確保將其應用於頁面。為此，您需要找到 <body> 標籤，它應該如下所示：
<body <?php body_class(); ?>>
這通常位於header.php檔案中，但也可以在其他地方，具體取決於您的主題。找到正確的行後，只需將其替換為以下程式碼：
<body <?php body_class(); ?> style="background-color:<?php wpb_bg();?>">>
立即儲存您的檔案並開啟您的網站。您應該會看到它具有新的背景顏色。
重新載入頁面，您每次都會看到一種新顏色。
這顯然不是每個網站的正確設計選擇，但對某些網站來說這是一個巧妙的技巧。
9. 在部落格文章上顯示最後修改日期
預設情況下，大多數主題會顯示你釋出部落格文章的日期。然而，如果你定期更新和重新整理舊內容，你可能想同時顯示最後修改日期（或用最後修改日期取代釋出日期）。
這不僅讓你的人類訪客知道你還在更新內容，而且還向谷歌顯示你的內容是新鮮的。
function show_last_updated( $content ) {
$u_time = get_the_time('U');
$u_modified_time = get_the_modified_time('U');
if ($u_modified_time >= $u_time + 86400) {
$updated_date = get_the_modified_time('F jS, Y');
$updated_time = get_the_modified_time('h:i a');
$custom_content .= '<p class="last-updated-date">Recently updated on '. $updated_date . ' at '. $updated_time .'</p>';
}
$custom_content .= $content;
return $custom_content;
}
add_filter( 'the_content', 'show_last_updated' );
更多細節，請檢視我們顯示WordPress上最後修改日期的完整帖子。
10. 禁用某些使用者的WordPress工具欄
預設情況下，WordPress為所有使用內建WordPress使用者角色的登入使用者顯示WordPress工具欄。對於自定義的角色，例如WooCommerce商店的Customer使用者角色，就不一定是這種情況。
如果你想改變這一點，你可以使用function.php程式碼段來隱藏某些使用者角色的WordPress工具欄。
這個例子將為具有作者使用者角色的使用者僱用管理工具欄。
add_filter( 'show_admin_bar', function( $show ) {
if ( current_user_can( 'author' ) ) {
return false;
}
return $show;
} );
11. 延遲文章出現在RSS feed中
預設情況下，內容一經發布就會出現在你的RSS feed中。這可能會給內容抓取者一個機會，在谷歌索引你的原始文章之前，採集你的內容並將其索引到谷歌。
為了避免別人得到你的內容，你可以推遲帖子出現在你的RSS提要中。
雖然這不會完全阻止內容搜刮者，但它確實意味著你可以給谷歌一些時間來先索引你的內容。
以下是程式碼片段–你可以把數字–本例中的 “30”–改為你希望延遲的分鐘數：
function wbolt_delay_feed_content($where) {
global $wpdb;
if ( is_feed() ) {
// timestamp in WP-format
$now = gmdate('Y-m-d H:i:s');
// value for wait; + device
$wait = '30'; // integer
// http://dev.mysql.com/doc/refman/5.0/en/date-and-time-functions.html#function_timestampdiff
$device = 'MINUTE'; //MINUTE, HOUR, DAY, WEEK, MONTH, YEAR
// add SQL-sytax to default $where
$where .= " AND TIMESTAMPDIFF($device, $wpdb->posts.post_date_gmt, '$now') > $wait ";
}
return $where;
}
add_filter('posts_where', 'wbolt_delay_feed_content');
12. 從RSS feed中排除某些類別
除了延遲內容出現在RSS feed中，你也可能有這樣的情況：你想排除整個類別的部落格文章出現在你網站的RSS feed中。
為了達到這個目的，你可以使用下面的 functions.php 程式碼片段：
function wbolt_exclude_category_rss($query) {
if ($query->is_feed) {
$query->set('cat','-38');
}
return $query;
}
add_filter('pre_get_posts','wbolt_exclude_category_rss');
請確保用你想排除的實際類別ID替換示例類別ID–“38″（不要刪除減號）。
下面是找到ID號的方法：
- 進入 “文章“→”分類“，看到你網站上所有類別的列表。
- 點選你想排除的類別下的編輯。
- 在你的瀏覽器位址列裡看一下編輯頁面的URL。類別ID是?taxonomy=category&tag_ID=X後面的數字。
例如，如果URL是https://yoursite.com/wp-admin/term.php?taxonomy=category&tag_ID=38&post_type=post，那麼類別ID是38。
13. 按文章型別限制WordPress的修訂歷史
為了避免使你的網站的資料庫膨脹，你可能想限制儲存多少個帖子修訂。
雖然限制WordPress帖子修訂的一個方法是編輯你的網站的wp-config.php檔案，但你可能想為不同的帖子型別儲存不同的修訂數量–例如，部落格帖子和WooCommerce產品。
這個function.php程式碼片段讓你做到這一點。要使它成為你自己的，把帖子型別–本例中的 “post”–改為你想控制的實際帖子型別，把數字–本例中的 “5”–改為你想儲存的修訂次數。
function wbolt_post_revisions_by_type( $revisions, $post ) {
if( 'post' == $post->post_type ) {
$revisions = 5;
}
return $revisions;
}
add_filter( 'wp_revisions_to_keep', 'wbolt_post_revisions_by_type', 10, 2 );
* 注意 – 你要編輯緊接在 “if “語句之後的 “post”。例如，針對產品，這一行將看起來像這樣：
if( 'product' == $post->post_type ) {
14. 禁用WordPress的搜尋功能
如果你的網站不需要搜尋功能，你可能想禁用WordPress的搜尋功能以防止潛在的濫用。
例如，即使你不在你的網站上顯示一個搜尋框，機器人仍然可以通過在你的URL上新增?s=[搜尋詞]來使用搜尋功能。
要做到這一點，你可以新增以下程式碼段：
function wbolt_disable_wp_search( $query, $error = true ) {
if ( is_search() ) {
$query->is_search = false;
$query->query_vars[s] = false;
$query->query[s] = false;
// to error
if ( $error == true )
$query->is_404 = true;
}
}
add_action( 'parse_query', 'wbolt_disable_wp_search' );
add_filter( 'get_search_form', create_function( '$a', "return null;" ) );
如果有人試圖直接使用搜尋功能，你的網站將返回一個404頁面。
15. 建立你自己的自定義短程式碼
WordPress的短程式碼是非常方便的快捷方式，讓你在你的網站上嵌入動態內容。
雖然許多WordPress外掛依靠快捷鍵來幫助實現其功能，但您也可以使用WordPress functions.php檔案和add_shortcode()函式建立您自己的自定義快捷鍵。
例如，一個常見的用例是建立一個顯示當前年份的短碼。這可以讓您在所有內容中自動顯示當前年份，而不需要在每年1月1日手動更新所有內容。
要建立這樣一個短碼，你可以使用以下程式碼：
function year_shortcode() {
$year = date('Y');
return $year;
}
add_shortcode('currentyear', 'year_shortcode');
然後，當您將[currentyear]短碼新增到您的內容中時，它將自動被替換為實際年份–例如2023年。
16. 允許在文章標題中使用短程式碼
預設情況下，WordPress不會執行你放在文章標題欄裡的任何短程式碼。如果你想在WordPress的文章標題中使用簡碼，你可以通過在WordPress的function.php檔案中新增一個簡單的程式碼片斷來啟用這個功能。
例如，當與前面的程式碼片段相結合時，這將讓你通過新增[currentyear]短程式碼自動在文章標題中包括當前年份。
add_filter( 'the_title', 'do_shortcode' );
17. 設定WordPress分頁
如果你對你的主題中的分頁工作方式不滿意，你可以使用function.php程式碼段來調整分頁行為，甚至建立你自己的分頁系統。
如果你對這種型別的修改感興趣，我們有一個完整的WordPress分頁指南，其中包括一些函式.php程式碼片段的例子。
18. 改變在搜尋列表頁上包含的結果數量
WordPress給了你一個儀表盤內的選項來控制在檔案頁上列出多少個帖子（設定→閱讀）。
然而，這將改變所有存檔頁的數量。如果你只是想在搜尋結果頁面使用一個不同的數字呢？
為此，你可以在你的 functions.php 檔案中新增這個片段 – 確保將數字（本例中為 “12”）改為你想在分頁之前顯示的實際結果數。
function wbolt_search_results_list() {
if ( is_search() )
set_query_var('posts_per_archive_page', 12);
}
add_filter('pre_get_posts', 'wbolt_search_results_list');
19. 在WordPress RSS feed中包括特色圖片
如果你想在你的RSS feed內容中包括你的帖子的特色圖片，你可以在你的functions.php檔案中新增以下片段。
function wbolt_featured_image_rss($content) {
global $post;
if ( has_post_thumbnail( $post->ID ) ){
$content = '<div>' . get_the_post_thumbnail( $post->ID, 'full', array( 'style' => 'margin-bottom: 15px;' ) ) . '</div>' . $content;
}
return $content;
}
add_filter('the_excerpt_rss', 'wbolt_featured_image_rss');
add_filter('the_content_feed', 'wbolt_featured_image_rss');
按照寫法，上述程式碼片段將以全尺寸插入圖片。要使用不同的縮圖尺寸，你可以將 “全尺寸”改為不同的縮圖尺寸–例如 “大” 或 “中”。
20. 增加對檔案型別的上傳支援（如SVG）
預設情況下，WordPress阻止你上傳某些檔案型別，例如SVG檔案。
要啟用對這些被阻止的檔案型別的支援，你可以在WordPress functions.php檔案中新增以下程式碼片段：
function wbolt_myme_types($mime_types){
$mime_types['svg'] = 'image/svg+xml';
return $mime_types;
}
add_filter('upload_mimes', 'wbolt_myme_types', 1, 1);
這個程式碼段只實現了SVG的上傳，但如果需要，你可以修改它以增加對其他檔案型別的支援。
21. 隱藏非管理員的WordPress更新提示
預設情況下，當有新的更新可用時，WordPress會向所有有儀表盤許可權的使用者顯示儀表盤資訊。
即使一個使用者的角色不允許他們應用更新，儀表盤資訊也會告訴該使用者聯絡管理員。
為了調整這一點，你可以使用這個程式碼段來隱藏所有非管理員使用者的更新通知：
function wbolt_hide_update_nag() {
if ( ! current_user_can( 'update_core' ) ) {
remove_action( 'admin_notices', 'update_nag', 3 );
}
}
add_action('admin_menu','wbolt_hide_update_nag');
對於其他一些變化，請檢視我們關於如何禁用WordPress更新通知的指南。
22. 改變自動JPEG優化質量
儘管不是每個人都知道這個功能，WordPress在你上傳圖片後為你的網站建立縮圖時自動壓縮JPEG圖片。
從WordPress 4.5開始，WordPress已經把預設的質量級別設定為82（100為零壓縮）。
如果你想使這個質量級別更高或更低，你可以在你的functions.php檔案中新增以下程式碼片段–確保將數字（在這個例子中是 “90”）改為你想使用的實際質量級別：
add_filter( 'jpeg_quality', create_function( '', 'return 90;' ) );
組織你的functions.php檔案的最佳做法
如果你只是使用WordPress的functions.php檔案來新增幾個程式碼片段，你可能不需要擔心組織問題。
但是，如果你在你的網站上新增了大量的程式碼片段，如果你不遵循一些function.php檔案組織的最佳實踐，它很快就會變得笨重和複雜。
這裡有一些最佳實踐，以保持你的程式碼片段的組織性…
新增程式碼註釋來解釋一切
當你第一次在 functions.php 檔案中新增一個程式碼段時，你很清楚這個程式碼段的作用以及你為什麼要新增它。但當你一年後回頭看function.php檔案時，事情可能就不那麼清楚了。
為了避免這種情況，你要為每個程式碼段新增程式碼註釋，解釋該程式碼段的作用以及你為什麼要新增它。
程式碼註釋是不被WordPress執行的文字，但人類使用者可以通過閱讀來理解程式碼片段在做什麼。
要新增一個單行程式碼註釋，您可以使用這種格式：
// This is a single-line code comment
要新增多行程式碼註釋，你可以使用這種格式：
/** * This is a code comment that spans multiple lines * This text is also in the same comment * This is the last line in the code comment */
下面是一個如何使用程式碼註釋的例子–你可以看到，每個程式碼段前的註釋都解釋了該程式碼段的作用。
一個使用程式碼註釋來記錄functions.php檔案中的片段的例子
使用Include檔案將片段分隔到不同的檔案中
如果你真的有很多程式碼片段，你可以將它們儲存在不同的檔案中，而不是隻使用functions.php檔案。
然後，你可以使用include或require將這些程式碼片段包含在function.php檔案中。Mike Schinkel在StackExchange上有一個很好的例子，說明你可以這樣做。
考慮上面的function.php替代方案之一
如果你發現你的 functions.php 檔案有點雜亂無章，你可能更喜歡我們前面詳述的 functions.php 替代品之一。
例如，免費的Code Snippets外掛可以非常容易地組織一切，因為你可以單獨新增每個程式碼片段，並有自己的標題和描述。你還可以使用標籤來組織你的程式碼片段。
小結
WordPress functions.php檔案是一個特定主題的檔案，讓你在網站上新增PHP程式碼片段。
如果你想在 functions.php 檔案中新增程式碼片段，你應該始終使用一個子主題，這樣當你更新你的主題時，你的改動不會被覆蓋掉。我們還建議在新增程式碼片段之前備份您的網站，並儘可能在一個暫存網站上測試它們。
作為使用function.php檔案的替代方案，你也可以考慮使用程式碼管理器外掛或建立你自己的自定義外掛來放置你的程式碼片段。
現在你知道了WordPress functions.php檔案是如何工作的，你可以開始以各種有用的方式定製你的網站。
上面的函式.php示例片段給了你一些開始的好地方，但當涉及到你能做什麼時，天空是無限的。
評論留言