使用短代碼的兩種情況是： - 短代碼是一個自我關閉的標簽，就像我們在“基本短消息”部分中看到的那樣。 - 短碼是封閉的內容。 ## 封閉內容 用短碼封裝內容可以對封閉的內容進行操作。 ``` [wporg]內容來操縱[/ wporg] ``` 如上所述，為了封裝一部分內容，您需要做的所有操作都添加了一個類似于HTML的開始[$tag]和結束[/$tag]。 ## 處理封閉內容 讓我們回到我們原來的[wporg]短代碼： ``` <?php function wporg_shortcode($atts = [], $content = null) { // do something to $content // always return return $content; } add_shortcode('wporg', 'wporg_shortcode'); ``` 看看回調函數，我們看到我們選擇接受兩個參數$atts和$content。 $content參數將保留我們附帶的內容。 稍后我們會談談$atts。 $content的默認值設置為null，因此我們可以通過使用PHP函數is_null()來區分自我關閉標簽和封閉標簽。 shortcode [$tag]，包括其內容和結束[/$tag]將被替換為處理函數的返回值。 >[warning] 警報：處理函數負責保護輸出。 ## 短碼截圖 短碼解析器對帖子的內容執行單次傳遞。 這意味著如果一個短碼處理程序的$content參數包含另一個短碼，則不會被解析。 ``` [wporg]another [shortcode] is included[/wporg] ``` 通過在處理函數的最終返回值上調用do_shortcode()可以在其他短碼內使用短碼。 ``` <?php function wporg_shortcode($atts = [], $content = null) { // do something to $content // run shortcode parser recursively $content = do_shortcode($content); // always return return $content; } add_shortcode('wporg', 'wporg_shortcode'); ``` ## 限制 短代碼解析器無法處理相同[$tag]的封閉和非封閉形式的混合。 ``` [wporg] non-enclosed content [wporg]enclosed content[/wporg] ``` 解析器將其視為由文本“非封閉內容”分隔的兩個短碼，而不是將其視為包圍“非封閉內容[wporg]封閉內容”的單個短代碼。