
內容簡介
在管理後台的新增/編輯文章以及新增/編輯頁面中,新增一個名稱為「HTML Special Characters」的小工具。當在小工具中點擊任何特殊字符時,該字符的編碼會被插入到文章正文文本框的當前光標位置(如果光標未在正文文本框中,則插入到文章末尾)。當在小工具中將滑鼠懸停在任何特殊字符上時,懸停文本會顯示該字符的 HTML 實體編碼以及該字符的名稱。
需要注意的是,在所謂的「可視化編輯器模式」中,該特殊字符本身會被添加到文章正文中。而且,對於依賴該模式的使用者來說,在該編輯器的進階工具欄中可以獲得自己的特殊字符彈出助手,這可能使該外掛對他們來說是不必要的。實際上,該外掛更適合用在「非可視化的 HTML 模式」中,因為這是插件作者本人的使用習慣。
連結:外掛官網 | WordPress 外掛目錄頁面 | 作者網站
過濾器
外掛提供了兩個過濾器,可供使用者鉤住。一般來說,使用過濾器的程式碼應該理想地放在一個 mu-plugin 或適用於特定網站的 plugin 中(這超出了此自述文件所能解釋的範圍)。
c2c_html_special_characters(過濾器)
「c2c_html_special_characters」這個觸發點可以讓您刪除現有的字符或整個字符組,以及/或添加新的字符或字符組。
引數:
$codes(array):一個關聯數組,其中鍵是分組名稱,而值是關聯數組本身,其中代碼作為鍵,人性化描述作為值。
例子:
/**
* 添加一個新字符組(帶有重音的“A”).
*
* @param array $characters 默認HTML特殊字符。
* @return array
*/
function more_html_special_characters( $characters ) {
$characters['accented_a'] = array(
'name' => 'Accented A',
'À' => 'A grave accent',
'Á' => 'A accute accent',
'Â' => 'A circumflex',
'Ã' => 'A tilde',
'Ä' => 'A umlaut',
'Å' => 'A ring',
'Æ' => 'AE ligature',
);
return $characters; // 重要!
}
add_filter( 'c2c_html_special_characters', 'more_html_special_characters' );
c2c_html_special_characters_post_type(過濾器)
「c2c_html_special_characters_post_type」這個觸發點可以讓您指定哪些文章類型需要在 HTML Special Characters 設置中顯示鉤子。
引數:
$post_types(array):一個包含文章類型的數組。默認情況下,此值為array( 'page', 'post' )
例子:
/**
* 在其他文章類型中顯示 HTML Special Characters 幫助程式.
*
* @param array $post_types 文章類型數組。
* @return array
*/
function more_html_special_characters_post_types( $post_types ) {
$post_types[] = 'products'; // 產品頁面中顯示
unset( $post_types['page'] ); // 不顯示在頁面中
return $post_types;
}
add_filter( 'c2c_html_special_characters_post_types', 'more_html_special_characters_post_types' );
外掛標籤
開發者團隊
② 後台搜尋「HTML Special Characters Helper」→ 直接安裝(推薦)
原文外掛簡介
Add an admin widget labeled “HTML Special Characters” that is present in the admin Add/Edit Post and Add/Edit Page pages. Clicking on any special character in the widget causes its character encoding to be inserted into the post body text field at the current cursor location (or at the end of the post if the cursor isn’t located in the post body field). Hovering over any of the special characters in the admin widget causes hover text to appear that shows the HTML entity encoding for the character as well as the name of the character.
Note that when used in the visual editor mode the special character itself is added to the post body. Also note that the visual editor has its own special characters popup helper accessible via the advanced toolbar, which depending on your usage, may make this plugin unnecessary for you. In truth, the plugin is intended more for the non-visual (aka HTML) mode as that is the mode I (the plugin author) use.
Links: Plugin Homepage | Plugin Directory Page | Author Homepage
Filters
The plugin exposes two filters for hooking. Typically, code making use of filters should ideally be put into a mu-plugin or site-specific plugin (which is beyond the scope of this readme to explain).
c2c_html_special_characters (filter)
The ‘c2c_html_special_characters’ hook allows you to remove existing characters or entire groups of characters, and/or add new characters or groups of characters.
Arguments:
$codes (array) : An association array in which the keys are a grouping name and the values are associative arrays themselves with the code as the key and the human-friendly descriptions as the values.
Example:
/**
* Add a new grouping of characters (accented 'A's).
*
* @param array $characters Default HTML special characters.
* @return array
*/
function more_html_special_characters( $characters ) {
$characters['accented_a'] = array(
'name' => 'Accented A',
'À' => 'A grave accent',
'Á' => 'A accute accent',
'Â' => 'A circumflex',
'Ã' => 'A tilde',
'Ä' => 'A umlaut',
'Å' => 'A ring',
'Æ' => 'AE ligature',
);
return $characters; // Important!
}
add_filter( 'c2c_html_special_characters', 'more_html_special_characters' );
c2c_html_special_characters_post_type (filter)
The ‘c2c_html_special_characters_post_type’ hook allows you to specify which post_types for which the HTML Special Characters metabox should be shown.
Arguments:
$post_types (array) : An array of post types. By default, this value is array( 'page', 'post' )
Example:
/**
* Show HTML Special Characters Helper for additional post_types.
*
* @param array $post_types Arry of post types.
* @return array
*/
function more_html_special_characters_post_types( $post_types ) {
$post_types[] = 'products'; // Show for products
unset( $post_types['page'] ); // Don't show for pages
return $post_types;
}
add_filter( 'c2c_html_special_characters_post_types', 'more_html_special_characters_post_types' );
