vicchi

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 <a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">WordPress ShortCode API</a> does not support nested shortcodes to allow this plugin’s shortcode to wrap the shortcode being documented.
<blockquote>
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
</blockquote>
The plugin supports both the self closing <code>[shortcode]</code> and enclosing <code>[shortcode]content[/shortcode]</code> forms and supports a short form name of the shortcode, <code>[wp_scs]</code> as well as the more verbose <code>[wp_shortcode_shield]</code> form. For the sake of brevity, the remainder of this documentation will use the <code>[wp_scs]</code> 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>code</code> attribute but without using the enclosing <code>[</code> and <code>]</code> 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
<pre><code>[wp_scs code="[another-shortcode-name]"]
</code></pre>
… WordPress will use the ‘]’ character inside the <code>code</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
<pre><code>[wp_scs code="another-shortcode-name"]
</code></pre>
… 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
<pre><code>[wp_scs][another-shortcode-name][/wp_scs]
</code></pre>
… and
<pre><code>[wp_scs]another-shortcode-name[/wp_scs]
</code></pre>
… 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 <a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">ShortCode API</a> …
<blockquote>
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:
<code>[myshortcode example='non-enclosing' /] non-enclosed content [myshortcode] enclosed content 
 [/myshortcode]</code>
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”.
</blockquote>

WP Shortcode Shield

Allows posts and pages to easily document WordPress shortcodes without the shortcode being expanded.

itthinx

<a href="https://www.itthinx.com/plugins/documentation/" rel="nofollow ugc">Documentation</a> provides sound structures and tools to maintain a Documentation Management System based on WordPress.
Leveraging WordPress’ framework and internal structures, the system provides a completely new section to manage documents independently from normal posts or pages.
Documents are complemented by their dedicated document categories and document tags, which allows to keep the documentation structures separate from the more blog-oriented posts or CMS-like pages.
It can be used to build a dedicated documentation site, a subsite for documentation in a multisite network or other creative deployments.
See our <a href="https://docs.itthinx.com" rel="nofollow ugc">documentation portal</a> for an example where we use the system to maintain a considerable amount of documentation for our tools.
Simple to use, yet powerful to maintain even thousands of documentation pages.
Documents can be attached to products in WooCommerce using <a href="https://www.itthinx.com/shop/woocommerce-documentation/" rel="nofollow ugc">WooCommerce Documentation</a>.
<h3>Widgets</h3>
The plugin provides several widgets that are used to display document links:
<ul>
<li>Document Hierarchy : facilitates navigating and viewing the document hierarchy</li>
<li>Document Children : displays links to children of documents</li>
<li>Documents : to display sets of document links</li>
<li>Document Categories : to display links to document categories</li>
</ul>
<h3>Shortcodes</h3>
The following shortcodes are available:
<ul>
<li>[documentation_documents] Lists documents, also useful to list documents in a category.</li>
<li>[documentation_categories] Renders a list of links to the document categories.</li>
<li>[documentation_hierarchy] Provides a means to navigate the documentation structure, equivalent to the Document Hierarchy widget.</li>
<li>[documentation_list_children] Lists the children of a document like the Document Children widget.</li>
<li>[documentation_search_form] Renders a dynamic search form. Use <a href="https://wordpress.org/plugins/search-live/" rel="ugc">Search Live</a> for a more flexible search form.</li>
</ul>
<h3>Recommended Useful Additions</h3>
You should have a look at these tools. They will help you get the most out of this Documentation Management System.
<ul>
<li><a href="https://www.itthinx.com/shop/woocommerce-documentation/" rel="nofollow ugc">WooCommerce Documentation</a> This extension for WooCommerce and the Documentation plugin for WordPress allows to link documentation pages to products and display them automatically on the product pages.</li>
<li><a href="https://wordpress.org/plugins/groups/" rel="ugc">Groups</a> Groups is designed as an efficient, powerful and flexible solution for group-oriented memberships and content access control. Use it to control who can view documents and more.</li>
<li><a href="https://www.itthinx.com/shop/groups-restrict-categories/" rel="nofollow ugc">Groups Restrict Categories</a> An extension based on Groups, provides access restrictions for categories and tags, custom post types and taxonomies. Very useful to restrict whole sets of documents based on their document categories or tags.</li>
<li><a href="https://wordpress.org/plugins/search-live/" rel="ugc">Search Live</a> Search Live supplies effective integrated live search facilities and advanced search features. Makes it really easy to find the desired documents.</li>
<li><a href="https://wordpress.org/plugins/widgets-control/" rel="ugc">Widgets Control</a> Widgets Control is a toolbox that features visibility management for all widgets, sidebars, sections of content and content blocks. This is very useful to show content and widgets in context.</li>
<li><a href="https://www.itthinx.com/shop/widgets-control-pro/" rel="nofollow ugc">Widgets Control Pro</a> Widgets Control Pro is the advanced version of the Widgets Control toolbox that features visibility management for all widgets, sidebars, sections of content and content blocks. With its additional features, it is even more useful to show document-specific content and widgets, including the options to show widgets on documents and related pages only.</li>
<li><a href="https://wordpress.org/plugins/decent-comments/" rel="ugc">Decent Comments</a> Decent Comments shows what people say. If you want to show comments along with their author’s avatars and an excerpt of their comment, then this is the right plugin for you. Use it to show comments posted on documents only or including them.</li>
<li><a href="https://wordpress.org/plugins/open-graph-protocol-framework/" rel="ugc">Open Graph Protocol Framework</a> The Open Graph protocol enables any web page to become a rich object in a social graph. For instance, this is used on Facebook to allow any web page to have the same functionality as any other object on Facebook. This will automate the process of adding basic and optional metadata to documents.</li>
</ul>
<h3>Documentation</h3>
Please refer to the <a href="https://docs.itthinx.com/document/documentation/" rel="nofollow ugc">documentation</a> pages for details. 
The site uses the <a href="https://wordpress.org/plugins/documentation/" rel="ugc">Documentation</a> plugin and is a good example of deployment, with an extensive set of documentation sections and pages.
<h3>Feedback</h3>
Feedback is welcome!
If you need help, have problems, want to leave feedback or want to provide constructive criticism, please do so here at the <a href="https://www.itthinx.com/plugins/documentation/" rel="nofollow ugc">Documentation plugin page</a>.
Please try to solve problems there before you rate this plugin or say it doesn’t work. There goes a lot of work into providing you with free quality plugins! Please appreciate that and help with your feedback. Thanks!
<h4>Twitter</h4>
Follow <a href="https://twitter.com/itthinx" rel="nofollow ugc">@itthinx</a> on Twitter for updates on this and other plugins.

Documentation

This has worked really well on my site - thank you for developing it!
Dan



WP Shortcode Shield vs Documentation