《PHP應用:詳解WordPress中簡碼格式標簽編寫的基本方法》要點:
本文介紹了PHP應用:詳解WordPress中簡碼格式標簽編寫的基本方法,希望對您有用。如果有疑問,可以聯系我們。
PHP實戰WordPress 簡碼是一種類似于論壇標簽的東西,格式類似于把尖括號換成中括號的 Html 標簽.簡碼很多人叫做短代碼,但官方的翻譯應該是簡碼,在這里糾正一下.
PHP實戰簡碼的開發的邏輯比擬簡單,主要就是添加、刪除和判斷,會在本文全部介紹.
PHP實戰簡碼格式
PHP實戰簡碼的格式非常靈活,可以是有屬性、無屬性、閉合、非閉合等等:
PHP實戰[example]
PHP實戰[example]內容[/example]
PHP實戰[example attr="屬性" attr-hide="1"]內容[/example]
PHP實戰[example "屬性"]
PHP實戰添加簡碼
PHP實戰添加簡碼必要使用 add_shortcode() 函數,兩個屬性,第一個為簡碼名,第二個是簡碼的回調函數.
PHP實戰
add_shortcode( $tag, $func );
PHP實戰例如添加名為 test 的簡碼,回調 Bing_shortcode_test() 函數:
PHP實戰
function Bing_shortcode_test( $attr, $content ){
return 'Hello World!';
}
add_shortcode( 'test', 'Bing_shortcode_test' );
PHP實戰在文章中添加 [test] 就會輸出 “Hello World!”.
PHP實戰從上邊的例子可以看到,簡碼的回調函數必要接收兩個參數.第一個是簡碼所有的屬性,通過數組儲存;第二個是簡碼的內容(閉合簡碼中的內容).
PHP實戰移除簡碼
PHP實戰remove_shortcode() 函數可以移除一個簡碼,只必要指定簡碼的名稱即可移除.
PHP實戰
remove_shortcode( 'test' );
PHP實戰remove_all_shortcodes() 函數用來移除當前添加的所有簡碼.
PHP實戰
remove_all_shortcodes();
PHP實戰判斷簡碼
PHP實戰關于判斷簡碼,有兩個函數,shortcode_exists() 函數判斷簡碼是否存在.
PHP實戰
remove_all_shortcodes();
if( shortcode_exists( 'test' ) ) echo '簡碼 test 存在';//False
add_shortcode( 'test', 'Bing_shortcode_test' );
if( shortcode_exists( 'test' ) ) echo '簡碼 test 存在';//True
PHP實戰還有一個 has_shortcode() 函數,判斷字符串中是否出現某某簡碼.
PHP實戰
$content = '測試測試測試測試測試測試測試測試';
if( has_shortcode( $content, 'test' ) ) echo '字符串中有 test 簡碼';//False
$content = '測試測試測試測[test]測試[/test]試測試測試測試測試';
if( has_shortcode( $content, 'test' ) ) echo '字符串中有 test 簡碼';//True
PHP實戰執行簡碼
PHP實戰do_shortcode() 函數用來在字符串中查找簡碼,并在簡碼處調用之前添加的回調函數,把簡碼執行成必要的內容.
PHP實戰WordPress 添加的鉤子:
PHP實戰
add_filter( 'the_content', 'do_shortcode', 11 );
PHP實戰例子:
PHP實戰
function Bing_shortcode_test( $attr, $content ){
return 'Hello World!';
}
add_shortcode( 'test', 'Bing_shortcode_test' );
$content = '測試測試測試測[test]試測試測試測試測試';
echo do_shortcode( $content );//測試測試測試測Hello World!試測試測試測試測試
PHP實戰簡碼屬性
PHP實戰簡碼支持各種格式的屬性,接受給簡碼回調函數的第一個參數.如果你要給參數設置默認值,可以使用 shortcode_atts() 函數:
PHP實戰
function Bing_shortcode_test( $attr, $content ){
extract( shortcode_atts( array(
'url' => 'http://www.bgbk.org',
'hide' => false,
'text' => '點擊暗藏 / 顯示'
), $attr ) );
$hide = $hide ? ' style="display:none;"' : '';
return '<a href="' . $url . '"' . $hide . '>' . $text . '</a>';
}
add_shortcode( 'test', 'Bing_shortcode_test' );
PHP實戰
只有頁面中使用了簡碼的時候才加載腳本
而在開發的過程中,有時會遇到這種問題:簡碼模塊需要加載 JS 或者 CSS 腳本,而當頁面沒有使用簡碼的時候就會造成資源浪費.
PHP實戰好比下邊的這個 Google 地圖插件:
PHP實戰
//添加簡碼
function Bing_add_google_map( $atts, $content ){
//content...
}
add_shortcode( 'google_map', 'Bing_add_google_map');
//掛載腳本
function Bing_add_javascript(){
wp_enqueue_script( 'map_scripts' );
}
add_action( 'wp_enqueue_scripts', 'Bing_add_javascript' );
PHP實戰只有在頁面中使用了 [google_map] 簡碼的時候才必要加載腳本,這怎么做到呢?
PHP實戰其實很簡單,只必要在簡碼函數觸發的時候在頁腳掛載腳本即可.
PHP實戰
//添加簡碼
function Bing_add_google_map( $atts, $content ){
$GLOBALS['google_map_shortcode'] = true;
return '地圖的代碼';
}
add_shortcode( 'google_map', 'Bing_add_google_map');
//掛載腳本
function Bing_add_javascript(){
global $google_map_shortcode;
if( isset( $google_map_shortcode ) && $google_map_shortcode ) wp_enqueue_script( 'map_scripts' );
}
add_action( 'wp_footer', 'Bing_add_javascript' );
PHP實戰總結
PHP實戰簡碼是個非常強大的功能,對文章內容是一種很好的擴展,利用好可以讓添加某些東西變的便利快捷.
PHP實戰關于簡碼的函數都在:wp-includes/shortcode.php 文件里,有才能的朋友可以閱讀一下,了解原理.
《PHP應用:詳解WordPress中簡碼格式標簽編寫的基本方法》是否對您有啟發,歡迎查看更多與《PHP應用:詳解WordPress中簡碼格式標簽編寫的基本方法》相關教程,學精學透。維易PHP學院為您提供精彩教程。