WordPress Shortcode（短代碼／簡碼）是一段用方括號 [ ] 包起來的指令，只要把它貼到文章、頁面或小工具裡，就能快速插入表單、按鈕、輪播、商品列表等功能，不必每次重寫程式。本篇 WordPress Shortcode 教學，會帶你從「什麼是短代碼」、語法結構、常見內建短代碼，一路到「如何自訂短代碼」與「短代碼失效怎麼辦」，看完就能完整掌握。
什麼是 WordPress Shortcode（短代碼／簡碼）？
WordPress Shortcode 中文常稱為「短代碼」或「簡碼」，指的是用中括號 [ ] 包住的一小段語法（例如 
因此短代碼非常適合用在「需要重複出現」或「需要動態產生」的內容，例如購物車、聯絡表單、最新文章列表、輪播圖等。
短代碼的語法結構與運作原理
WordPress 短代碼主要有三種寫法：
- 自閉合（單獨使用）：
[shortcode_name]，例如 - 帶參數：
[shortcode_name id="123" size="large"]，用參數調整顯示方式。 - 包覆內容：
[shortcode_name]這裡是內容[/shortcode_name]，會把中間的內容一起處理（例如加上特定樣式）。
運作原理是：外掛或主題在程式中用 add_shortcode() 註冊一個短代碼名稱，並綁定一個函式。當頁面載入、WordPress 解析內容遇到該短代碼時，就會呼叫對應函式、把回傳的 HTML 顯示在該位置。
WordPress 常見的內建與外掛短代碼
：為圖片加上說明文字。：嵌入 YouTube、地圖等外部內容。- WooCommerce：
[woocommerce_cart]、[woocommerce_checkout]、[products]等，用來顯示購物車、結帳、商品列表。 - 表單外掛（如 Contact Form 7、Gravity Forms）：用短代碼把表單放到任何頁面。
WordPress Shortcode 實際應用範例
範例一：WooCommerce 購物車、結帳頁
用過 WooCommerce 購物車 的電商使用者會發現，結帳頁、會員中心其實只是在頁面放上一行短代碼（如下圖），前台就會自動產生完整畫面——這都是因為工程師已經把功能寫進短代碼裡。
購物車結帳畫面的 Shortcode：
對應前台顯示的結帳畫面：
範例二：重複使用的輪播或影片
若同一組輪播、影片要重複出現在多支商品或多個頁面，也可以做成短代碼。只要在不同頁面貼上同一組短代碼，前台就會顯示相同內容，日後要更新也只需改一處。
如何自訂 WordPress 短代碼？（add_shortcode 教學）
如果現成外掛沒有你要的功能，可以自己寫一個短代碼。最基本的做法是在佈景主題的 functions.php（建議用子佈景主題）加入：
function gc_hello_shortcode( $atts ) {
$a = shortcode_atts( array( 'name' => '訪客' ), $atts );
return '您好，' . esc_html( $a['name'] ) . '！';
}
add_shortcode( 'hello', 'gc_hello_shortcode' );之後在文章中輸入 [hello name="小明"]，前台就會顯示「您好，小明！」。實務上，自訂短代碼常用來輸出促銷區塊、CTA 按鈕、特定商品列表等需要重複使用的內容。
短代碼 vs Gutenberg 區塊：差在哪？該用哪個？
| 比較項目 | 短代碼 Shortcode | Gutenberg 區塊 |
|---|---|---|
| 使用方式 | 輸入 [ ] 文字指令 | 視覺化拖拉、即時預覽 |
| 學習門檻 | 需記得短代碼名稱與參數 | 直覺、所見即所得 |
| 相容性 | 跨頁面、跨編輯器通用 | 較新，部分舊外掛尚未支援 |
| 適合情境 | 重複功能、跨系統共用 | 單頁排版、圖文編排 |
兩者並非互斥——目前許多外掛同時提供短代碼與區塊版本。需要在多處重複、或在不支援區塊的地方使用時，短代碼仍是最通用的選擇。
短代碼失效或直接顯示文字怎麼辦？
如果頁面上出現像 [xxx] 這樣的純文字、功能沒有正常顯示，通常是因為：
- 提供該短代碼的外掛或主題被停用、移除：短代碼失去定義，就會以文字顯示。
- 短代碼名稱拼錯或參數格式錯誤：檢查方括號、引號是否正確。
- 從別的網站貼過來：對方的短代碼在你的網站沒有對應功能。
解法是：重新啟用對應外掛、修正短代碼，或直接移除這段失效的短代碼文字。先前網站若使用過 Elementor 等頁面編輯器，停用後也常殘留這類短代碼，需要一併清理。
結語
短代碼是 WordPress 好用的設計之一，讓不會寫程式的使用者也能在網頁上自由插入功能、重複利用排版與輪播，對設計師與工程師而言都能大幅省時。如果你有網站設計需求或需要 WordPress 客製化外掛模組，歡迎參考我們的網頁設計與網站製作服務，或直接與我們聯絡。
常見問題（FAQ）
WordPress Shortcode（短代碼）是什麼？
短代碼是用方括號 [] 包起來的指令，能在文章或頁面快速插入功能或內容（如表單、按鈕、輪播）。
短代碼怎麼用？
把外掛或主題提供的短代碼貼到內容編輯器中即可；部分短代碼還能加參數（如 id、size）調整顯示方式。
可以自己做短代碼嗎？
可以。在子佈景主題的 functions.php 用 add_shortcode() 註冊名稱與函式即可，常用來輸出重複使用的 CTA、促銷區塊或商品列表。
停用外掛後短代碼會怎樣？
若提供該短代碼的外掛被停用，短代碼會失效並可能以文字顯示，需移除或改用其他方式呈現。
