{"id":32883,"date":"2014-11-16T11:30:08","date_gmt":"2014-11-16T11:30:08","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/shortcodes-in-use\/"},"modified":"2016-01-26T16:46:19","modified_gmt":"2016-01-26T16:46:19","slug":"shortcodes-in-use","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/shortcodes-in-use\/","author":8776642,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2.1","stable_tag":"1.2.1","tested":"4.4.34","requires":"3.8","requires_php":"","requires_plugins":"","header_name":"Shortcodes In Use","header_author":"Roger Barrett","header_description":"","assets_banners_color":"af5712","last_updated":"2016-01-26 16:46:19","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=KP2LVCBXNCEB4","header_plugin_uri":"http:\/\/wordpress.org\/plugins\/shortcodes-in-use\/","header_author_uri":"http:\/\/www.wizzud.com\/","rating":5,"author_block_rating":0,"active_installs":80,"downloads":5885,"num_ratings":9,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.2.1":"<p>Changed h2 header to h1 in line with WordPress guidelines.\nAdded a collapse\/expand all button, and removed on-page javascript.\nVerified 4.4 compatibility.<\/p>","1.2.0":"<p>Internationalization.<\/p>","1.1.0":"<p>Fixed a bug that neglected to check for a callable method specified as a string &quot;someClass::someMethod&quot;.\nAdded my own shortcode to provide a means of finding other shortcodes that don&#039;t get added when in admin backend.\nReformatted the results - removed table, added counts and collapsible regions.<\/p>","1.0.1":"<p>Fixed a wee bug that prevented checked by-location and posts-by-type filters from being highlighted when the results were shown.<\/p>","1.0.0":"<ul>\n<li>Initial release<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"9"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1381902","resolution":"128x128","location":"assets"},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1381902","resolution":"256x256","location":"assets"}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":"1381902","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.1.0","1.2.0","1.2.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1381902","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1381902","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1381902","resolution":"3","location":"assets"}},"screenshots":{"1":"Tools \/ Shortcodes In Use page","2":"Sample results","3":"Provider\/Tag filter options"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[83,3921,42099,80,3971],"plugin_category":[43,59],"plugin_contributors":[78854],"plugin_business_model":[],"class_list":["post-32883","plugin","type-plugin","status-publish","hentry","plugin_tags-admin","plugin_tags-find","plugin_tags-locate","plugin_tags-shortcode","plugin_tags-tool","plugin_category-customization","plugin_category-utilities-and-tools","plugin_contributors-wizzud","plugin_committers-wizzud"],"banners":{"banner":"https:\/\/ps.w.org\/shortcodes-in-use\/assets\/banner-772x250.png?rev=1381902","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/shortcodes-in-use\/assets\/icon-128x128.png?rev=1381902","icon_2x":"https:\/\/ps.w.org\/shortcodes-in-use\/assets\/icon-256x256.png?rev=1381902","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/shortcodes-in-use\/assets\/screenshot-1.png?rev=1381902","caption":"Tools \/ Shortcodes In Use page"},{"src":"https:\/\/ps.w.org\/shortcodes-in-use\/assets\/screenshot-2.png?rev=1381902","caption":"Sample results"},{"src":"https:\/\/ps.w.org\/shortcodes-in-use\/assets\/screenshot-3.png?rev=1381902","caption":"Provider\/Tag filter options"}],"raw_content":"<!--section=description-->\n<ul>\n<li>Can't recall where, or if, you've used a certain shortcode?<\/li>\n<li>Want to remove a plugin and unsure if it provides shortcodes or whether you're using them?<\/li>\n<li>Don't know what shortcodes come with WordPress?<\/li>\n<li>Found one unrecognised shortcode but unsure where there might be others?<\/li>\n<li>Need to swap out a theme and don't know if it has shortcodes that you've used?<\/li>\n<li>Want to use a shortcode for a specific bit of information but can't remember exactly what it's called?<\/li>\n<li>Need to a change a parameter for all occurences of a shortcode?<\/li>\n<\/ul>\n\n<p>This is a simple administration tool that lists occurences of shortcodes within post content and\/or custom fields, and\/or widget settings.\nYou can select, or search for, specific shortcodes, and it can filter down to a provider, location, or post type.\nIt is intended to help administrators\/editors locate where shortcodes have been used, so that they can be updated, renamed, deleted, or whatever.<\/p>\n\n<p>Features include :<\/p>\n\n<ul>\n<li>Search string(s) to match against shortcode tags - space or comma delimited for multple search strings<\/li>\n<li>Filter by the type of provider of shortcode - whether it is provided by a plugin, your theme, internal to WordPress (eg. <code>[gallery]<\/code>), or unknown (an inactive\/deleted plugin, maybe?)<\/li>\n<li>Filter by a specific provider - a named plugin, for example<\/li>\n<li>Filter by any number of specific, recognised shortcodes<\/li>\n<li>Filter by where to look for the shortcode - post content, post meta data (custom fields), or widgets<\/li>\n<li>Filter by the type of post that contains the shortcode<\/li>\n<li>Results include (where relevant and available) : either the widget name and its sidebar, or a linked post title and the type of post; the shortcode and its parameters; the shortcode provider (WordPress, plugin, theme, or unknown), and where it was found<\/li>\n<li>Has its own shortcode, for use when a plugin or theme only declares a shortcode when not in the admin backend<\/li>\n<\/ul>\n\n<p>What it does <strong>not<\/strong> do :<\/p>\n\n<ul>\n<li>It does <em>not<\/em> provide any insight as to what any shortcode does, or how to use\/configure it.<\/li>\n<li>It does <em>not<\/em> look at custom tables, theme options, transients.<\/li>\n<\/ul>\n\n<p>If you like this plugin (or if you don't?), please consider taking a moment or two to give it a\n<a href=\"http:\/\/wordpress.org\/support\/view\/plugin-reviews\/shortcodes-in-use\">Review<\/a> : it helps others, and gives me valuable feedback.<\/p>\n\n<h3>Shortcode<\/h3>\n\n<p>The shortcode for this plugin is...<\/p>\n\n<pre><code>[shortcodes_in_use\/]\n<\/code><\/pre>\n\n<p>...and output is restricted to users with <strong>edit_posts<\/strong> capability.<\/p>\n\n<p>The attributes available are in line with the options available in the Tool, and each one is a filter.\nSetting an attribute for all possible values is the same as omitting that attribute.<\/p>\n\n<p>Separate filters are ANDed, ie. specifying <code>provider=\"wordpress\" post_type=\"page\"<\/code> limits the results\nto shortcode tags that are in a page <strong>AND<\/strong> provided by WordPress core.<\/p>\n\n<p>Multiple values within a filter are ORed, ie. specifying <code>post_type=\"post page\" provider=\"wordpress\"<\/code>\nlimits the results to WordPress's own shortcode tags that are in either a post <strong>OR<\/strong> a page.<\/p>\n\n<p>When you run the Tool in admin, the equivalent shortcode for the selected options is provided at the end\nof the results. Also, the <em>sanitized<\/em> shortcode is repeated at the top of the shortcode's output.<\/p>\n\n<ul>\n<li><p><strong>search<\/strong> (string) : A space or comma is interpreted as a delimiter, so...<\/p>\n\n<pre><code>[shortcodes_in_use search=\"foo bar\"\/]\n<\/code><\/pre>\n\n<p>...looks for any shortcode tag that contains either \"foo\" or \"bar\".<\/p><\/li>\n<li><p><strong>provider<\/strong> (string) : Any one or more of <em>unknown<\/em>, <em>wordpress<\/em>, <em>plugin<\/em>, or <em>theme<\/em>,\ndelimited by either a comma or a space. For example...<\/p>\n\n<pre><code>[shortcodes_in_use provider=\"plugin unknown\"\/]\n<\/code><\/pre>\n\n<p>...reports any shortcode tag whose provider cannot be determined, or whose provider has be\ndetermined as being a plugin.<\/p><\/li>\n<li><p><strong>location<\/strong> (string) : Any one or more of <em>title<\/em>, <em>content<\/em>, <em>excerpt<\/em>, <em>meta<\/em> or <em>widget<\/em>,\ndelimited by either a comma or a space. For example...<\/p>\n\n<pre><code>[shortcodes_in_use location=\"content excerpt\"\/]\n<\/code><\/pre>\n\n<p>...reports any shortcode tag found in any main content or excerpt area.<\/p><\/li>\n<li><p><strong>post_type<\/strong> (string) : Any one or more of WordPress's standard post types - <em>post<\/em>, <em>page<\/em>,\n<em>attachment<\/em>, etc - and\/or any custom post types. Multiple post types are comma- or space-delimited.\nFor example...<\/p>\n\n<pre><code>[shortcodes_in_use post_type=\"post,page\"\/]\n<\/code><\/pre>\n\n<p>...reports any shortcode tag found in a post of type 'post' or 'page'.<\/p><\/li>\n<li><p><strong>tag<\/strong> (string) : Any one or more shortcode tags, delimited by either a comma or a space. For\nexample...<\/p>\n\n<pre><code>[shortcodes_in_use tag=\"shortcodes_in_use, custom_menu_wizard\"\/]\n<\/code><\/pre>\n\n<p>...reports any occurence of either of those two shortcode tags.<\/p><\/li>\n<li><p><strong>name<\/strong> (string) : This allows you to specify a specific plugin and\/or theme by name. Multiple\nnames are comma- or space-delimited, and each name <strong><em>must<\/em><\/strong> begin with either \"plugin\/\" or \"theme\/\".\nFor example...<\/p>\n\n<pre><code>[shortcodes_in_use name=\"plugin\/Shortcodes In Use, theme\/Twenty Fifteen\"\/]\n<\/code><\/pre>\n\n<p>...reports any occurence of a shortcode tag belonging to either the Shortcodes In Use plugin or\nthe Twenty Fifteen theme. Instead of the <em>name<\/em> of the plugin\/theme, you can supply their\ncontaining folder, so this would be an alternative for the example above...<\/p>\n\n<pre><code>[shortcodes_in_use name=\"plugin\/shortcodes-in-use, theme\/twentyfifteen\"\/]\n<\/code><\/pre><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>EITHER Upload the zip package via 'Plugins &gt; Add New &gt; Upload' in your WP Admin, OR Extract the zip package and upload <code>shortcodes-in-use<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in your WP Admin. The widget will now be available under Admin's <strong>Tools<\/strong> menu.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<p>If you have a question or problem that is not covered here, please use the <a href=\"https:\/\/wordpress.org\/support\/plugin\/shortcodes-in-use\">integrated Support forum<\/a>.<\/p>\n<dl>\n<dt>Does it list all available shortcodes?<\/dt>\n<dd><p>Yes, all shortcodes known to WordPress (Admin) are listed, grouped by provider, and possibly sub-grouped by plugin or theme name. You\ncan select to filter by any number of them, or by either the provider or the specific plugin\/theme. Note that you do <em>not<\/em> get any\ninformation about their use or function.<\/p><\/dd>\n<dt>Can it find shortcodes that are not known to WordPress?<\/dt>\n<dd><p>Yes, assuming it is in the standard format. By default, anything that looks like a shortcode is reported, the only exception being\nshortcodes that are \"escaped\" (by doubling up on the containing square brackets). You can filter the\nresults to just Unknown shortcodes, or you can search for a specific shortcode regardless or whether WordPress knows about it or not.<\/p><\/dd>\n<dt>Does it show nested shortcodes?<\/dt>\n<dd><p>Yes, the shortcodes are processed recursively, and nesting is indicated by a level of indentation in the results table.\nHowever, please be aware that indentation only indicates that the shortcode in question is nested <em>somewhere<\/em> within the shortcode at\nthe lesser level of indentation; it does not necessarily provide any indication of howy deeply it's nested, because the search\/filter\nparameters may exclude any of the containing shortcodes from being reported. For this same reason, a lack of indentation does not\nnecessarily mean that the shortcode is not nested within another shortcode. In other words, any indentation is only relative to the\nreported shortcodes.<\/p><\/dd>\n<dt>How does the Provider\/Tag filter work, and why the highlighting?<\/dt>\n<dd><p>It's hierarchical, with (up to) 3 levels : general provider, named provider, and tags. Select nothing amd they're all included.\nSelect a named provider and all its tags get included. Select a general provider and all its named providers (ie. all their tags)\nget included. As soon as you select anything, whatever remains unchecked and outside the immediate scope of the checked item\n(ie. not hierarchically below) gets excluded. As an example, if you check \"WordPress\" without checking \"Plugin\" then you won't get any\nresults for shortcodes provided by plugins.<\/p>\n\n<p>You can select multiple tags, multiple providers (general or named). What you can't do is select, for example, a named provider\n<strong>and<\/strong> one of its tags. Selecting a named provider gets all its tags. If you only want one or two of its tags then select them\nindividually and don't try selecting the provider. Same applies when selecting a general provider.<\/p>\n\n<p>Checked items are highlighted. Also, because the tree is collapsible (and starts out collapsed), unchecked ancestors of checked items\nare also highlighted in order to provide visual feedback that something (possibly hidden from sight) has been selected.<\/p><\/dd>\n<dt>What gets cached, and for how long?<\/dt>\n<dd><p>Based on the Location filters, the plugin caches the ids of database records that contain likely-looking shortcodes. It does <em>not<\/em> cache\nthe results of any inspection of those records' content. If you change the Location filters (excluding Widget, which does not require\ndatabase access) such that any cached ids do not accurately reflect the new filters, then the cache is discarded and refreshed with\na new set of ids. The cache is only kept for 15 minutes, and can be manually discarded at any time.\nEnquiries run via the shortcode do not use or set the cache.<\/p><\/dd>\n<dt>Why would I need to use the shortcode instead of the admin Tool?<\/dt>\n<dd><p>You may well not. But...<\/p>\n\n<p>Some plugins - for example, the WP Photo Album Plus plugin - don't add their shortcode if you are in\nthe admin backend (and I hasten to add that there is nothing wrong with that approach). What this means\nthough, is that this plugin can't then determine the provider of that shortcode when it finds it in, say,\na page's content, because WordPress hasn't been told about it. The Tool can only report it as Unknown\nProvider.<\/p>\n\n<p>So, if you get too many unknowns turning up you may want to run a quick check to make see if they can\ncan be resolved when running the shortcode on a front end page : stick\na <code>[shortcodes_in_use provider=unknown\/]<\/code> shortcode onto a page and view it while logged in as Admin?<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>tweak : changed the plugin's h2 header to h1<\/li>\n<li>addition : a collapse\/expand all button<\/li>\n<li>tweak : remove on-page javascript<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>internationalization<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>bugfix : handle the shortcode's callable function being specified as \"someClass::someMethod\"<\/li>\n<li>addition : shortcode, for when a plugin or theme doesn't declare their shortcode when in admin backend<\/li>\n<li>tweak : reformatted results to not use table, added a count, and made parts collapsible<\/li>\n<li>tweak : small optimisation changes<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>bugfix : ensure that checked by-location and posts-by-type filters also get hilighted when displaying results<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"List all the shortcodes that you have used within your content or custom fields, and find out exactly where they have been used.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/32883","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=32883"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wizzud"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=32883"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=32883"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=32883"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=32883"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=32883"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=32883"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}