詳解WordPress中簡碼格式標籤編寫的基本方法

2022-10-06 09:51:10 字數 2804 閱讀 6761

wordpress 簡碼是一種類似於論壇標籤的東西,格式類似於把尖括號換成中括號的 html 標籤。簡碼很多人叫做短**,但官方的翻譯應該是簡碼,在這裡糾正一下。

簡碼的開發的邏輯比較簡單,主要就是新增、刪除和判斷,會在本文全部介紹。

簡碼格式

簡碼的格式非常靈活,可以是有屬性、無屬性、閉合、非閉合等等:

[example]

[example]內容[/example]

[example attr="屬性" attr-hide="1"]內容[/example]

[example "屬性"]

新增簡碼

新增簡碼需要使用 add_shortcode() 函式,兩個屬性,第乙個為簡碼名,第二個是簡碼的**函式。

add_shortcode( $tag, $func );

例如新增名為 test 的簡碼,** bing_shortcode_test() 函式:

function bing_shortcode_test( $attr, $content )

add_shortcode( 'test', 'bing_shortcode_test' );

在文章中新增 [test] 就會輸出 「hello world!」。

從上邊的例子可以看到,簡碼的**函式需要接收兩個引數。第乙個是簡碼所有的屬性,通過陣列儲存;第二個是簡碼的內容(閉合簡碼中的內容)。

移除簡碼

remove_shortcode() 函式可以移除乙個簡碼,只需要指定簡碼的名稱即可移除。

remove_shortcode( 'test' );

remove_all_shortcodes() 函式用來移除當前新增的所有簡碼。

remove_all_shortcodes();

判斷簡碼

關於判斷簡碼,有兩個函式,shortcode_exists() 函式判斷簡碼是否存在。

remove_all_shortcodes();

if( shortcode_exists( 'test' ) ) echo '簡碼 test 存在';//false

add_shortcode( 'test', 'bing_shortcode_test' );

if( shortcode_exists( 程式設計客棧'test' ) ) echo '簡碼 test 存在';//true

還有乙個 has_shortcode() 函式,判斷字串中是否出現某某簡碼。

$content = '測試測試測試測試測試測試測試測試';

if( has_shortcode( $content, 'test' ) ) echo '字串中有 test 簡碼';//false

$content = '測試測試測試測[test]測試[/test]試測試測試測試測試';

if( has_shortcode( $content, 'test' ) ) echo '字串中有 test 簡碼';//true

執行簡碼

do_shortcode() 函式用來在字串中查詢簡碼,並在簡碼處呼叫之前新增的**函式,把簡碼執行成需要的內容。

wordpress 新增的鉤子:

add_filter( 'the_content', 'do_shortcode', 11 );

例子:function bing_shortcode_test( $attr, $content )

add_shortcode( 'test', 'bing_shortcode_test' );

$content = '測試測試測試測[test]試測試測試測試測試';

echo do_shortcode( $content );//測試測試測試測hello world!試測試測試測試測試

簡碼屬性

簡碼支援各種格式的屬性,接受給簡碼**函式的www.cppcns.com第乙個引數。如果你要給引數設定預設值,可以使用 shortcode_atts() 函式:

function bing_shortcode_test( $attr, $content )

add_shortcode( 'test', 'bing_shortcode_test' );

只有頁面中使用了簡碼的時候才載入指令碼

而在開發的過程中,有時會遇到這種問題:簡碼模組需要載入 js 或者 css 指令碼,而當頁面沒有使用簡碼的時候就會造成資源浪費。

比如下邊的這個 google 地圖外掛程式:

//新增簡碼

function bing_add_google_map( $atts, $content )

add_shortcode( 'google_map', 'bing_add_google_map');

//掛載指令碼

function bing_add_j**ascript()

add_action( 'wp_enqueue_scripts', 'bing_add_j**ascript' );

只有在頁面中使用了 [google_map] 簡碼的時候才需要載入指令碼,這怎麼做到呢?

其實很簡單,只需要在簡碼函式觸發的時候在頁尾掛載指令碼即可。

www.cppcns.com//新增簡碼

function bing_add_google_map( $atts, $content )

add_shortcode( 'google_map', 'bing_add_google_map');

//掛載指令碼

function bing_add_j**ascript()

add_action( 'wp_footer', 'bing_add_j**ascript' );

總結簡碼是個非常強大的功能,對文章內容是一種很好的擴充套件,利用好可以讓新增某些東西變的方便快捷。

wordpress 配置坑詳解

重新整理倉庫 yum clean all 重建快取 yum makecache 安裝mysql yum install mysql 一定要先安裝mysql再安裝php 否則到時候模組找不到支援,先安裝了mysql之後,模組方便自動識別版本.否則到時候版本錯誤,有得回退半天,然後清理配置,出現莫名其妙...

詳解WordPress增加檔案上傳大小 實用

方法很簡單,只需要3步就可以增加wordpress檔案上傳大小的設定 post max size 20m upload max filesize 20m 然後我們把這個檔案更名為php5.ini。請注意,上面我控制上傳檔案大小和文章大小為20m,你可以根據你自己的需要設定上限。下一步我們開啟檔案wp...

Wordpress過濾器詳解與分析

tag value tag 必需 你想建立的過濾器的名稱 value 必需,掛在這個過濾器可以修改的值 引數 這兩個引數是必須的,後面還可以帶引數可道官網檢視 同理動作鉤子有個函式是add action,過濾器鉤子也有個函式add filters。這兩個函式的用法就一樣了 add filter ta...