WordPress Shortcode 速成指南：無需編碼即可輕鬆嵌入HTML組件

WordPress 短代碼為作者提供了一種便捷的方式，無需編寫代碼即可在渲染頁面中插入HTML組件。這些短代碼可以在插件代碼中創(chuàng)建，也可以放置在主題的functions.php文件中。

短代碼的關(guān)鍵優(yōu)勢：

• 簡化HTML嵌入: 輕鬆添加複雜的HTML內(nèi)容，而無需直接編寫HTML代碼。
• 參數(shù)化定制: 通過參數(shù)自定義短代碼的輸出，實(shí)現(xiàn)靈活的個(gè)性化設(shè)置。
• 嵌套功能: 支持短代碼嵌套，構(gòu)建更複雜的頁面功能。
• 提高效率: 簡化內(nèi)容管理，提高內(nèi)容創(chuàng)作效率。

建議創(chuàng)建一份短代碼速查表，包含各種示例，尤其是在處理複雜功能時(shí)，這將使內(nèi)容管理更加便捷和用戶友好。

短代碼創(chuàng)建位置：

通常，為自定義插件創(chuàng)建的短代碼應(yīng)放置在插件代碼本身中。但是，您也可以將短代碼定義放置在主題的functions.php文件中。更實(shí)用的方法是創(chuàng)建一個(gè)單獨(dú)的shortcodes.php文件，然後使用以下語句將其包含在functions.php中：

include('shortcodes.php');

第一個(gè)“Hello World”短代碼：

短代碼定義包含：

1. 一個(gè)返回HTML代碼字符串的函數(shù)；
2. 對WordPress add_shortcode() 鉤子的調(diào)用，該鉤子將短代碼文本定義綁定到該函數(shù)。

最基本的示例：

// "Hello World" 短代碼
function shortcode_HelloWorld() {
  return '<p>Hello World!</p>';
}
add_shortcode('helloworld', 'shortcode_HelloWorld');

保存文件，然後在頁面或文章中輸入[helloworld]。訪問該頁面，您將看到它已被替換為“Hello World!”段落。

短代碼參數(shù)：

短代碼可以具有可選參數(shù)，例如：

<code>[sitemap title='網(wǎng)頁列表', depth=3]</code>

參數(shù)作為數(shù)組傳遞給短代碼函數(shù)作為第一個(gè)參數(shù)。生成頁面層次結(jié)構(gòu)站點(diǎn)地圖的完整代碼：

// sitemap 短代碼
function shortcode_GenerateSitemap($params = array()) {

  // 默認(rèn)參數(shù)
  extract(shortcode_atts(array(
    'title' => '站點(diǎn)地圖',
    'id'    => 'sitemap',
    'depth' => 2
  ), $params));

  // 創(chuàng)建站點(diǎn)地圖
  $sitemap = wp_list_pages("title_li=&depth=$depth&sort_column=menu_order&echo=0");
  if ($sitemap) {
    $sitemap =
      ($title ? "<h2>$title</h2>" : '') .
      '<ul>' . $sitemap . '</ul>';
  }

  return $sitemap;
}
add_shortcode('sitemap', 'shortcode_GenerateSitemap');

shortcode_atts() 函數(shù)在需要時(shí)為參數(shù)分配默認(rèn)值。然後，PHP extract() 函數(shù)將每個(gè)數(shù)組值轉(zhuǎn)換為實(shí)際變量 $title、$id 和 $depth。 （如果您使用的是PHP 5.4或更高版本，則可以使用較短的[...]語法替換array(...)。）在任何文章或頁面中添加[sitemap]短代碼，並根據(jù)需要更改參數(shù)，例如[sitemap depth=5]。

嵌套BBCode短代碼：

BBCode（公告板代碼）是一種輕量級標(biāo)記格式，與標(biāo)準(zhǔn)短代碼一樣，使用[方括號]來表示命令。這允許短代碼包含文本內(nèi)容或彼此嵌套。假設(shè)您的頁面需要引用和通用的號召性用語按鈕。創(chuàng)建一個(gè)單個(gè)短代碼是不切實(shí)際的，尤其是在按鈕可以單獨(dú)使用或嵌入到引用中時(shí)。我們可能需要這樣的HTML：

include('shortcodes.php');

當(dāng)編輯器非常熟悉HTML時(shí)，這可能會出錯(cuò)。幸運(yùn)的是，短代碼提供了一種更簡單的途徑，例如：

// "Hello World" 短代碼
function shortcode_HelloWorld() {
  return '<p>Hello World!</p>';
}
add_shortcode('helloworld', 'shortcode_HelloWorld');

標(biāo)籤之間的內(nèi)容作為第二個(gè)參數(shù)傳遞給短代碼函數(shù)。我們可以創(chuàng)建兩個(gè)短代碼函數(shù)：

<code>[sitemap title='網(wǎng)頁列表', depth=3]</code>

請注意do_shortcode($content)函數(shù)的使用，該函數(shù)在存在時(shí)將進(jìn)一步的短代碼應(yīng)用於內(nèi)容。短代碼易於實(shí)現(xiàn)，並且可以快速更改或增強(qiáng)。我建議創(chuàng)建一個(gè)包含示例的短代碼速查表，以便編輯器在需要復(fù)雜功能時(shí)可以參考。

(文章部分內(nèi)容由SiteGround贊助提供。感謝您支持使SitePoint成為可能的合作夥伴。)

以上是如何為編輯器創(chuàng)建自定義的WordPress短代碼的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！