Title: WP Shortcode Shield Author: vicchi Published: 2012 年 4 月 25 日 Last modified: 2012 年 11 月 12 日 --- 搜尋外掛 ![](https://ps.w.org/wp-shortcode-shield/assets/banner-772x250.jpg?rev=536020) 這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個 外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。 ![](https://s.w.org/plugins/geopattern-icon/wp-shortcode-shield_f5f5f5.svg) # WP Shortcode Shield 由 [vicchi](https://profiles.wordpress.org/vicchi/) 開發 [下載](https://downloads.wordpress.org/plugin/wp-shortcode-shield.1.1.0.zip) * [詳細資料](https://tw.wordpress.org/plugins/wp-shortcode-shield/#description) * [使用者評論](https://tw.wordpress.org/plugins/wp-shortcode-shield/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/wp-shortcode-shield/#installation) * [開發資訊](https://tw.wordpress.org/plugins/wp-shortcode-shield/#developers) [技術支援](https://wordpress.org/support/plugin/wp-shortcode-shield/) ## 外掛說明 This plugin allows you to refer to a WordPress shortcode within the content of posts and pages without that shortcode being automagically expanded by WordPress. The plugin takes advantage of the fact that the [WordPress ShortCode API](https://codex.wordpress.org/Shortcode_API) does not support nested shortcodes to allow this plugin’s shortcode to wrap the shortcode being documented. > The shortcode parser uses a single pass on the post content. This means that if > > the $content parameter of a shortcode handler contains another shortcode, it won’t > be parsed The plugin supports both the self closing `[shortcode]` and enclosing `[shortcode] content[/shortcode]` forms and supports a short form name of the shortcode, `[wp_scs]` as well as the more verbose `[wp_shortcode_shield]` form. For the sake of brevity, the remainder of this documentation will use the `[wp_scs]` short form name. If using the self-closing form of the shortcode, you need to supply the name of the shortcode you are documenting using the `code` attribute but without using the enclosing `[` and `]` characters. This is because when parsing shortcodes, WordPress looks for the first occurrence of the ‘]’ character to terminate the shortcode. As a result of this, usage such as ``` [wp_scs code="[another-shortcode-name]"] ``` … WordPress will use the ‘]’ character inside the `code` attribute to try and terminate the shortcode name, which is not what is desired. Instead, the plugin automagically adds the terminating ‘[‘ and ‘]’ characters to the plugin’s output, so that usage such as ``` [wp_scs code="another-shortcode-name"] ``` … will display _[another-shortcode-name]_ in your post’s of page’s content. If you are using the enclosing form of the shortcode, you can either supply the shortcode to be documented with or without enclosing ‘[‘ and ‘]’ characters; if they are omitted, the plugin will add them for you, so that usage such as ``` [wp_scs][another-shortcode-name][/wp_scs] ``` … and ``` [wp_scs]another-shortcode-name[/wp_scs] ``` … will display the same results, namely _[another-shortcode-name]_. Finally a note of caution, you cannot mix the enclosing and self closing form of the plugin’s shortcode within the same post or page; this is not a limitation of the plugin, but the way in which WordPress implements the [ShortCode API](https://codex.wordpress.org/Shortcode_API)… > The parser does not handle mixing of enclosing and non-enclosing forms of the > same > shortcode as you would want it to. For example, if you have: > `[myshortcode example='non-enclosing' /] non-enclosed content [myshortcode] enclosed > content > [/myshortcode] > Instead of being treated as two shortcodes separated by the text ” non-enclosed > content “, > the parser treats this as a single shortcode enclosing ” non-enclosed > content [myshortcode] enclosed content”. ## 螢幕擷圖 * [[ * Raw Source Code Sample * [[ * Resultant Content Display ## 安裝方式 1. You can install WP Shortcode Shield automatically from the WordPress admin panel. From the Dashboard, navigate to the _Plugins / Add New_ page and search for _“WP Shortcode Shield”_ and click on the _“Install Now”_ link. 2. Or you can install WP Shortcode Shield manually. Download the plugin Zip archive and uncompress it. Copy or upload the `wp-shortcode-shield` folder to the `wp-content/ plugins` folder on your web server. 3. Activate the plugin. From the Dashboard, navigate to Plugins and click on the _“ Activate”_ link under the entry for WP Shortcode Shield. 4. That’s it. There’s no admin settings to configure. Go and start documenting. ## 常見問題集 How do I get help or support for this plugin? In short, very easily. But before you read any further, take a look at [Asking For WordPress Plugin Help And Support Without Tears](http://www.vicchi.org/2012/03/31/asking-for-wordpress-plugin-help-and-support-without-tears/) before firing off a question. In order of preference, you can ask a question on the [WordPress support forum](https://wordpress.org/support/plugin/wp-shortcode-shield); this is by far the best way so that other users can follow the conversation. You can ask me a question on Twitter; I’m [@vicchi](http://twitter.com/vicchi). Or you can drop me an email instead. I can’t promise to answer your question but I do promise to answer and do my best to help. Is there a web site for this plugin? Absolutely. Go to the [WP Shortcode Shield home page](http://www.vicchi.org/codeage/wp-shortcode-shield/) for the latest information. There’s also the official [WordPress plugin repository page](https://wordpress.org/extend/plugins/wp-shortcode-shield/) and the [source for the plugin is on GitHub](http://vicchi.github.com/wp-shortcode-shield/) as well. I want to amend/hack/augment this plugin; can I do this? Totally; this plugin is licensed under the GNU General Public License v2 (GPLV2). See http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt for the full license terms. ## 使用者評論 這個外掛目前沒有任何使用者評論。 ## 參與者及開發者 以下人員參與了開源軟體〈WP Shortcode Shield〉的開發相關工作。 參與者 * [ vicchi ](https://profiles.wordpress.org/vicchi/) [將〈WP Shortcode Shield〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/wp-shortcode-shield) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/wp-shortcode-shield/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/wp-shortcode-shield/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/wp-shortcode-shield/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/wp-shortcode-shield/)。 ## 變更記錄 The current version is 1.1.0 (2012.11.12) #### 1.1.0 * Released 2012.11.12 * Other: Upgraded plugin to new version of WP_PluginBase to prevent class name clashes during future upgrades. * Other: Ensure WP_ShortCodeShield is not already defined and instantiate as a singleton. * Other: Rename misleading plugin constants (they’re square brackets not angle brackets) #### 1.0.1 * Released 2012.08.29 * Fixed: Ensure WP_PluginBase is properly included and defined. #### 1.0 * Released 2012.07.17 * This is the first version of WP Shortcode Shield. ## 中繼資料 * 版本 **1.1.0** * 最後更新 **14 年前** * 啟用安裝數 **10+** * WordPress 版本需求 ** 3.4 或更新版本 ** * 已測試相容的 WordPress 版本 **3.4.2** * 語言 * [English (US)](https://wordpress.org/plugins/wp-shortcode-shield/) * 標籤: * [documentation](https://tw.wordpress.org/plugins/tags/documentation/)[page](https://tw.wordpress.org/plugins/tags/page/) [post](https://tw.wordpress.org/plugins/tags/post/)[shortcode](https://tw.wordpress.org/plugins/tags/shortcode/) * [進階檢視](https://tw.wordpress.org/plugins/wp-shortcode-shield/advanced/) ## 評分 5 星，滿分為 5 星 * [ 1 個 5 星使用者評論 ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/) ## 參與者 * [ vicchi ](https://profiles.wordpress.org/vicchi/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/wp-shortcode-shield/) ## 贊助 想要支援這個外掛的發展嗎？ [ 贊助這個外掛 ](http://www.vicchi.org/codeage/donate/)