在WordPress中，默認(rèn)情況下，短代碼只能在文章和頁(yè)面中使用，不能在小部件中使用。但是，可以使用widget_text過(guò)濾器和do_shortcode()函數(shù)來(lái)啟用此功能，從而允許“文本”小部件解析任何現(xiàn)有的短代碼。

在“文本”小部件中允許使用短代碼

WordPress默認(rèn)提供多個(gè)小部件。 “文本”小部件允許您向小部件添加任何文本，也可以添加任何HTML代碼。這意味著您也可以在此小部件中使用JavaScript代碼，因此它非常強(qiáng)大。但是，如果您需要更多功能，例如訪問(wèn)服務(wù)器中存儲(chǔ)的一些數(shù)據(jù)的PHP腳本，則默認(rèn)情況下此小部件無(wú)法幫助您。

它類似於文章。這就是為什麼，像在文章中一樣，我們希望能夠使用短代碼來(lái)做任何我們想做的事情。為此，我們可以使用widget_text過(guò)濾器。此過(guò)濾器用於允許修改“文本”小部件的內(nèi)容。我們將在這裡使用它來(lái)要求WordPress在此小部件中解析短代碼。

WordPress中短代碼的解析是通過(guò)do_shortcode()函數(shù)實(shí)現(xiàn)的。它接受一個(gè)必需的參數(shù)，即要解析的文本，並返回已解析的文本。這意味著我們可以直接將此函數(shù)用作widget_text過(guò)濾器的回調(diào)函數(shù)。

以下代碼可用於插件文件或主題的functions.php文件中：

<?php add_filter('widget_text', 'do_shortcode'); ?>

現(xiàn)在，您在“文本”小部件中鍵入的任何現(xiàn)有短代碼都將被解析。

創(chuàng)建新的短代碼小部件

或者，我們也可以創(chuàng)建我們自己的小部件。由於默認(rèn)的“文本”小部件運(yùn)行良好，我們可以簡(jiǎn)單地從以下代碼（位於/wp-includes/default-widgets.php文件中）調(diào)整其代碼。值得注意的是，我們應(yīng)該創(chuàng)建我們自己的插件，絕不修改核心WordPress文件。

<?php class WP_Widget_Text extends WP_Widget {

    public function __construct() {
        $widget_ops = array('classname' => 'widget_text', 'description' => __('Arbitrary text or HTML.'));
        $control_ops = array('width' => 400, 'height' => 350);
        parent::__construct('text', __('Text'), $widget_ops, $control_ops);
    }

    // ... (其余代碼與原文相同) ...
}
?>

我們需要更改的內(nèi)容不多。首先要更改的是類的名稱。我選擇將其命名為WP_Widget_Shortcodes，但您可以隨意選擇任何名稱。由於此類的構(gòu)造函數(shù)設(shè)置了有關(guān)小部件本身的一些信息，因此我們還需要修改它。

<?php public function __construct() {
    $widget_ops = array('classname' => 'widget_shortcodes', 'description' => __('Arbitrary text or HTML with shortcodes.'));
    $control_ops = array('width' => 400, 'height' => 350);
    parent::__construct('shortcodes', __('Shortcodes'), $widget_ops, $control_ops);
}
?>

另一個(gè)需要更改的地方是在widget()方法中，它描述了WordPress如何顯示小部件。我們更改包含要顯示的文本的$text變量的內(nèi)容。我們刪除對(duì)widget_text過(guò)濾器的調(diào)用，並將do_shortcode()函數(shù)應(yīng)用於此內(nèi)容。

<?php add_filter('widget_text', 'do_shortcode'); ?>

然後，我們需要註冊(cè)我們的widget，以便能夠像任何其他widget一樣添加它。這可以通過(guò)widgets_init操作來(lái)實(shí)現(xiàn)，該操作一旦WordPress註冊(cè)了默認(rèn)widget就會(huì)觸發(fā)。

<?php class WP_Widget_Text extends WP_Widget {

    public function __construct() {
        $widget_ops = array('classname' => 'widget_text', 'description' => __('Arbitrary text or HTML.'));
        $control_ops = array('width' => 400, 'height' => 350);
        parent::__construct('text', __('Text'), $widget_ops, $control_ops);
    }

    // ... (其余代碼與原文相同) ...
}
?>

現(xiàn)在，您可以在可用小部件列表中找到我們的widget。您可以將其添加到任何兼容區(qū)域，它將解釋您使用的任何短代碼。

結(jié)束語(yǔ)

如上所述，啟用在小部件中使用短代碼並不復(fù)雜，但您需要注意。事實(shí)上，並非每個(gè)短代碼都適合顯示小部件的位置。如果短代碼具有固定寬度，那可能是個(gè)問(wèn)題。

請(qǐng)注意，我們?cè)谀J(rèn)“文本”小部件中使用的更改是最小的。如果您想自定義小部件，可以更改任何其他內(nèi)容。

(以下為原文FAQ部分的偽原創(chuàng)，保持內(nèi)容一致性的同時(shí)調(diào)整了表達(dá)方式)

關(guān)於在WordPress小部件中使用短代碼的常見(jiàn)問(wèn)題

• 在WordPress小部件中使用短代碼的目的是什麼？

在WordPress小部件中使用短代碼，可以添加特定功能而無(wú)需編寫(xiě)代碼，它們是複雜函數(shù)的快捷方式。例如，您可以使用短代碼嵌入文件、創(chuàng)建對(duì)像或?qū)⑻囟▋?nèi)容插入到文章或頁(yè)面中。通過(guò)在小部件中使用短代碼，您可以將這些功能擴(kuò)展到網(wǎng)站的側(cè)邊欄或其他小部件區(qū)域，從而增強(qiáng)用戶體驗(yàn)。

• 如何將短代碼添加到WordPress小部件？

要將短代碼添加到WordPress小部件，請(qǐng)?jiān)赪ordPress儀表板中導(dǎo)航到“外觀”下的“小部件”部分。將“文本”小部件拖放到所需的小部件區(qū)域。在小部件的文本字段中，輸入用方括號(hào)[]括起來(lái)的短代碼。單擊“保存”以應(yīng)用更改。

• 為什麼我的短代碼在小部件中不起作用？

如果您的短代碼在小部件中不起作用，可能是由於以下幾個(gè)原因：短代碼可能不正確，或者提供短代碼的插件可能已停用。確保短代碼正確且必要的插件處?kù)痘顒?dòng)狀態(tài)。如果問(wèn)題仍然存在，則可能與其他插件或主題存在衝突。嘗試停用其他插件或切換到默認(rèn)主題以排除故障。

• 我可以在單個(gè)小部件中使用多個(gè)短代碼嗎？

是的，您可以在單個(gè)小部件中使用多個(gè)短代碼。只需確保每個(gè)短代碼都用方括號(hào)括起來(lái)，並且不同短代碼之間留有空格。

• 如何為小部件創(chuàng)建我自己的短代碼？

要為小部件創(chuàng)建您自己的短代碼，您需要在主題的functions.php文件中添加一個(gè)自定義函數(shù)。此函數(shù)應(yīng)定義短代碼的功能。定義函數(shù)後，您可以使用add_shortcode()函數(shù)創(chuàng)建新的短代碼。

• 我可以在所有類型的小部件中使用短代碼嗎？

可以在接受文本輸入的任何小部件中使用短代碼。這包括“文本”小部件、“自定義HTML”小部件和其他小部件。但是，並非所有小部件都支持短代碼。

• WordPress中的do_shortcode函數(shù)是什麼？

WordPress中的do_shortcode函數(shù)用於搜索內(nèi)容中的短代碼，並通過(guò)其鉤子過(guò)濾短代碼。它實(shí)際上允許您在文章編輯器之外使用短代碼，例如在小部件或主題文件中。

• 我可以在WordPress頁(yè)面構(gòu)建器中使用短代碼嗎？

是的，大多數(shù)WordPress頁(yè)面構(gòu)建器都支持使用短代碼。您可以像添加到常規(guī)小部件一樣，將短代碼添加到頁(yè)面構(gòu)建器模塊或小部件中。

• 如何查找我的WordPress網(wǎng)站的可用短代碼？

WordPress網(wǎng)站的可用短代碼取決於您安裝的插件和主題。某些插件和主題在其文檔中提供了可用短代碼的列表。您還可以通過(guò)搜索插件或主題文件中的add_shortcode函數(shù)來(lái)查找短代碼。

• 我可以在WordPress文章和頁(yè)面中使用短代碼嗎？

是的，短代碼可以在WordPress文章和頁(yè)面中使用。就像在小部件中一樣，您可以通過(guò)在文章編輯器中將其用方括號(hào)括起來(lái)，將短代碼添加到文章或頁(yè)面中。

以上是快速提示：如何在WordPress中的小部件中使用短代碼的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！