Title: WP Shortcode Shield Author: vicchi Published: 2012-04-25 Last modified: 2012-11-12 --- Szukaj wtyczek ![](https://ps.w.org/wp-shortcode-shield/assets/banner-772x250.jpg?rev=536020) Wtyczka **nie została przetestowana z trzema ostatnimi głównymi wydaniami WordPressa**. Może nie być już utrzymywana lub obsługiwana, co może skutkować problemem ze zgodnością z nowszymi wersjami WordPressa. ![](https://s.w.org/plugins/geopattern-icon/wp-shortcode-shield_f5f5f5.svg) # WP Shortcode Shield Autor: [vicchi](https://profiles.wordpress.org/vicchi/) [Pobierz](https://downloads.wordpress.org/plugin/wp-shortcode-shield.1.1.0.zip) * [Szczegóły](https://pl.wordpress.org/plugins/wp-shortcode-shield/#description) * [Recenzje](https://pl.wordpress.org/plugins/wp-shortcode-shield/#reviews) * [Instalacja](https://pl.wordpress.org/plugins/wp-shortcode-shield/#installation) * [Rozwój](https://pl.wordpress.org/plugins/wp-shortcode-shield/#developers) [Wsparcie](https://wordpress.org/support/plugin/wp-shortcode-shield/) ## Opis 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”. ## Zrzuty ekranu * [[ * Raw Source Code Sample * [[ * Resultant Content Display ## Instalacja 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. ## Najczęściej zadawane pytania 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. ## Recenzje Wtyczka nie ma jeszcze żadnej recenzji. ## Kontrybutorzy i deweloperzy „WP Shortcode Shield” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki. Zaangażowani * [ vicchi ](https://profiles.wordpress.org/vicchi/) [Przetłumacz wtyczkę “WP Shortcode Shield” na swój język.](https://translate.wordpress.org/projects/wp-plugins/wp-shortcode-shield) ### Interesuje cię rozwój wtyczki? [Przeglądaj kod](https://plugins.trac.wordpress.org/browser/wp-shortcode-shield/), sprawdź [repozytorium SVN](https://plugins.svn.wordpress.org/wp-shortcode-shield/) lub czytaj [dziennik rozwoju](https://plugins.trac.wordpress.org/log/wp-shortcode-shield/) przez [RSS](https://plugins.trac.wordpress.org/log/wp-shortcode-shield/?limit=100&mode=stop_on_copy&format=rss). ## Rejestr zmian 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. ## Meta * Wersja **1.1.0** * Ostatnia aktualizacja **13 lat temu** * Włączone instalacje **10+** * Wersja WordPressa ** 3.4 lub nowszej ** * Testowano do **3.4.2** * Język * [English (US)](https://wordpress.org/plugins/wp-shortcode-shield/) * Tagi * [documentation](https://pl.wordpress.org/plugins/tags/documentation/)[page](https://pl.wordpress.org/plugins/tags/page/) [post](https://pl.wordpress.org/plugins/tags/post/)[shortcode](https://pl.wordpress.org/plugins/tags/shortcode/) * [Widok zaawansowany](https://pl.wordpress.org/plugins/wp-shortcode-shield/advanced/) ## Oceny 5 na 5 gwiazdek. * [ 1 recenzja 5-gwiazdkowa ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=5) * [ 0 recenzji 4-gwiazdkowych ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=4) * [ 0 recenzji 3-gwiazdkowych ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=3) * [ 0 recenzji 2-gwiazdkowych ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=2) * [ 0 recenzji 1-gwiazdkowych ](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/#new-post) [Zobacz wszystkierecenzje.](https://wordpress.org/support/plugin/wp-shortcode-shield/reviews/) ## Zaangażowani * [ vicchi ](https://profiles.wordpress.org/vicchi/) ## Wsparcie Masz coś do dodania? Potrzebujesz pomocy? [Zobacz forum wsparcia](https://wordpress.org/support/plugin/wp-shortcode-shield/) ## Złóż datek Czy chcesz wesprzeć rozwój wtyczki? [ Wspomóż wtyczkę ](http://www.vicchi.org/codeage/donate/)