如何創建 WordPress 簡碼並使用它們

已發表: 2018-03-28

WordPress 短代碼是用作執行帖子和頁面中特定功能的快捷方式的小標籤。 您可以通過圍繞簡單單詞或短語的方括號識別短代碼。 它們是在 2.5 版中引入的,其使命是幫助人們以簡單的方式執行功能。

您可能已經知道,WordPress 使用 PHP 編程語言來啟動自身。 因此,當您想直接向帖子和頁面添加特定功能時,您必須在文本編輯器中編寫代碼。 相反,短代碼允許用戶用一個簡單的術語替換整個代碼塊,並通過發布帖子來運行它。 很神奇,不是嗎?

閱讀更多:
Udemy 的 WordPress 課程

如何使用 WordPress 短代碼

文本和可視化編輯器中的短代碼

要使用短代碼,人們不必知道如何編碼或了解它們在後端是如何工作的。 WordPress 本身以及大多數 WordPress 主題和插件使用不同的短代碼來允許使用許多高級功能。

例如,要顯示整個圖片庫,您只需使用 WordPress 隨附的[gallery]短代碼。 大多數短代碼都可以像前面的示例一樣以其基本形式使用。

一旦您發布或預覽帖子或頁面,簡碼就會被實際內容替換。

簡碼參數

通常情況下,短代碼可以有額外的參數。 通過向它們添加額外信息,您可以自定義和更改輸出。 例如,雖然微不足道的 [gallery] 短代碼顯示附加到帖子的所有圖像,但可以對其進行更改。 圖庫簡碼可讓您通過 ID 指定圖片,以便您可以只顯示特定圖片,甚至包含不屬於該特定帖子的圖片。

此外,可以通過提供附加參數來定義圖庫的大小以及許多其他內容。 下面是一個例子:

此示例中的圖庫將僅顯示具有指定 ID 號的圖像。 在這種情況下,大小將自動更改為中。 你可以通過一個簡單的短代碼獲得這一切。 現在想像一下,如果您要手動添加包含數十行甚至數百行的 PHP 代碼,整個過程會是什麼樣子。 謝謝,短代碼!

開始和結束標籤

一些更複雜的短代碼可能有開始和結束標籤。 因此,您最終會得到兩個包含特定內容的短代碼,而不是一個短代碼。

例如,谷歌地圖插件可能允許您通過短代碼在地圖上顯示位置。 大多數這樣的插件都有開始和結束標籤,而地址應該寫在兩者之間。 下面是一個例子:

[[地圖]]美國紐約[[/地圖]]

從示例中可以看出,結束標記始終以斜杠“/”開頭。 通過同時擁有這兩個標籤,WordPress 可以更輕鬆地識別短代碼的各個部分。

在文本編輯器中工作

WordPress 簡碼

儘管它們只是功能的快捷方式,但短代碼實際上是特定於 WordPress 的密碼本身。 因此,如果您嘗試在可視化編輯器中編寫短代碼,WordPress 將立即向您顯示該短代碼的輸出(或僅佔位符)。 如果您按照圖庫示例並在可視化編輯器中編寫短代碼,您會看到 WordPress 立即顯示其內容(請參閱本文中的第一張圖片以了解其工作原理)。

如果要編輯短代碼並使用其參數,請切換到文本編輯器,該編輯器可讓您查看任何給定短代碼的結構。

默認的 WordPress 簡碼

短代碼通常由主題和插件管理。 每個開發人員都可以自己註冊短代碼,所以每個都是不同的。 短代碼的作用是什麼,它的參數和功能是什麼,完全取決於您使用的特定插件和主題。

例如,幫助您在 Google 地圖上顯示位置的插件可能具有 [[maps]] 短代碼,顯示訂閱表單的插件將使用 [[form]] 等。

每個產品都不同,因此請務必查看主題和插件的描述和文檔,以了解有關其具體用法的更多信息。

但是,WordPress 附帶了一組默認短代碼,您無需安裝其他擴展即可使用。 默認情況下,這些是您可以使用的短代碼:

  • [audio] – 嵌入音頻文件
  • [caption] – 在內容周圍加上標題
  • [畫廊] – 顯示圖像畫廊
  • [播放列表] – 顯示音頻和視頻文件的集合
  • [video] – 嵌入視頻文件

轉義短代碼(顯示短代碼的文本而不執行它)

有時,您可能希望顯示代表短代碼的文本而不是執行它。 如果您嘗試向文本編輯器和可視化編輯器添加短代碼,您就會意識到它在兩種情況下都被執行。

要顯示短代碼的文本,請使用雙括號: [[shortcode]]

如果要顯示帶有開始和結束標記的短代碼,請僅使用第一個和最後一個雙括號: [[maps]New York, USA[/maps]]

在文本編輯器中工作時,您還可以用方括號的代碼替換方括號。 因此,您可以使用“[”代替“[”,而使用“]”代替“]”。 例如: [簡碼&#93 ; 也將顯示短代碼而不執行它。

如何創建一個簡單的短代碼

當您每天在 WordPress 中寫文章時,有時您會重複自己,並且必須一遍又一遍地輸入內容。 無論是網站 URL、長句還是您不斷從頭開始編寫的一段 HTML 代碼,您都應該考慮為它編寫一個短代碼。

有了這個簡單的功能,您不必成為程序員,或者您甚至不會聘請程序員來為您簡化工作。 按照接下來的幾個步驟,讓自己成為一個自定義的短代碼:

  1. 在 Appearance -> Editor 菜單中打開 function.php 文件
  2. 將以下代碼放在文件末尾:
 函數 fsg_shortURL() {
返回“http://www.firstsiteguide.com”;
}
add_shortcode('fsg', 'fsg_shortURL');
  1. 轉到文本編輯器並輸入[fsg]以獲取 URL 而不是短代碼

沒那麼難,對吧?

更高級的示例:添加圖像短代碼

通過在functions.php中放置以下代碼,您可以創建用於放置具有自定義寬度和高度屬性的圖像的短代碼:

  1. 轉到functions.php文件
  2. 粘貼以下代碼:
 函數 img_shortcode( $atts , $content = null ) {

	提取(shortcode_atts(
		大批(
			'寬度' => '',
			'高度' => '',
		), $atts )
	);
返回 '​​';
}
add_shortcode( 'img', 'img_shortcode' );
  1. 打開文本編輯器:

在這裡,您可以使用[img width='x' height='y'] http://... [/img]短代碼,其中“x”和“y”是表示寬度和高度(以像素為單位)的數字。

如果需要,您可以輕鬆添加其他圖像屬性; 查看 W3 Schools 上所有圖像屬性的列表。

如何在文本小部件中使用短代碼

使用 2017 年 11 月 15 日發布的 WordPress 4.9 版,短代碼會自動在文本小部件中工作。 但如果您仍在使用舊版本的 WordPress,本教程的這一部分將幫助您獲得結果。

簡碼可以包含您可以添加到 WordPress 網站的不同功能。 無論您是為自己創建的還是帶有主題或剛剛安裝的插件,您都可能一直在使用短代碼。 由於您確實可以節省時間並從中受益,因此沒有理由不使用短代碼。

如果您剛剛開始構建您的 WordPress 網站,您可能只在帖子編輯器中使用過短代碼。 但是,事實是您幾乎可以在任何地方使用短代碼

例如,如果您使用的是 5 秒 Google Maps PRO 插件,它允許您輕鬆創建帶有無數圖釘的地圖,您可能希望通過短代碼直接在文本小部件中插入地圖,並在側邊欄上顯示您的位置,而不是單個郵政。 但是如果您的主題不支持小部件中的短代碼,您將需要自己啟用該功能,這就是我們將在本文中展示的內容。

如果您需要在 PHP 文件中使用短代碼(例如,如果您想在 header.php 文件中運行代碼並在標頭所在的任何地方運行短代碼),您可以通過將代碼包裝在它周圍輕鬆實現. 但是,如果您嘗試在我們上面提到的示例中使用文本小部件中的短代碼,您最終會感到失望,因為這根本不起作用,小部件顯示的是短代碼,而不是它的內容。 除非您的主題已經註冊了該功能,否則您需要自己啟用它。

因此,如果您希望能夠將短代碼放入 Text Widget 並使其運行,請不要擔心; 你可以在幾秒鐘內實現它:

  1. 打開functions.php
  2. 複製並粘貼以下兩行:
 add_filter('widget_text', 'shortcode_unautop');
add_filter('widget_text', 'do_shortcode');
  1. 保存更改

雖然實際上只使用使短代碼工作的第二行就足夠了,但您將需要第一行以避免 WordPress 自動插入段落和中斷標籤,您會通過在小部件中格式化文本而無意識地創建換行符. 以防萬一您將短代碼放在單獨的行上, unautop將刪除這些段落標籤,並且短代碼將像魅力一樣工作。

現在您可以導航到Appearance -> Widgets並將 Text Widget 拖到您想要的位置。 畢竟,當您將短代碼直接寫入您的文本小部件(當然,它已在您的網站上註冊)時,它會像在帖子編輯器中輸入一樣執行。

同樣,您可以從 Text Widget 運行 PHP 代碼。 這很容易,不是嗎? 享受您的短代碼。

短代碼無處不在

如果您剛剛開始創建 WordPress 博客,短代碼可能看起來多餘且難以理解。 大多數情況下,可以通過使用插件提供的用戶友好界面來避免短代碼。 但是,當您更多地參與博客並開始使用更多插件時,您將了解短代碼的真正力量。

使用它們將成為一種例行公事,您很快就會習慣於在您創建的每篇新文章中都寫上方括號。 因此,請花幾分鐘時間,使用本文來學習基礎知識。