Dougal Campbell

<p>By default, the only way to see how a new theme looks on your site is to<br />
activate it, making it visible to everyone who visits. With this plugin, it<br />
is possible to view how a new theme looks without activating it.</p>
<h3>TODO</h3>
<p>Possible future enhancements:</p>
<ul>
<li>Add an options screen.</li>
<li>Allow choice of theme to preview from a known list of installed themes.</li>
<li>Provide persistent previews by setting a cookie.</li>
<li>Restrict preview ability by user Roles/Capabilities.</li>
<li>Child-theme friendliness.</li>
</ul>
<h3>Notes</h3>
<p>May not work properly with child themes. This is because it will not be able<br />
to inherit from the parent theme as it normally would.</p>


Theme Preview

Allows you test how a theme looks on your site without activating it.

Scott Reilly

<p>Designers and developers know that it can sometimes be confusing and frustrating to determine the exact template being utilized to render the currently displayed page in WordPress. Sometimes page or category specific templates exist, or a page/post has been set by the post author to use a particular template, or the current theme doesn’t employ certain templates causing WordPress to fall back to others.</p>
<p>This plugin relieves that aggravation by assisting designers and developers by displaying the template being used to render the currently displayed page in WordPress. This can be shown in one or more of the following methods:</p>
<h4>Admin bar</h4>
<p>By default, the theme-relative path to the theme template file used to render the page is shown in the admin bar. The settings page for the plugin, at ‘Design’ -> ‘Reveal Template’, allows you to control and configure this particular method. Note: even if enabled by the setting, the admin bar entry also only appears if the admin bar is showing and if the user has the ability to see the revealed template.</p>
<h4>Site footer</h4>
<p>By default, the theme-relative path to the theme template file used to render the page is shown in the site’s footer. The settings page for the plugin, at ‘Design’ -> ‘Reveal Template’, allows you to control and configure this particular method. Note: even if enabled by the setting, the footer output only appears if the theme follows the recommended practice of calling the <code>wp_footer()</code> template tag at some point and the user has the ability to see the revealed template.</p>
<h4>Widget</h4>
<p>A widget named “Reveal Template” is made available which can be used to display the theme template file used to render the page in any widget location.</p>
<h4>Shortcode</h4>
<p>A shortcode called ‘revealtemplate’ is made available which can be used in post/page content to display the theme template file used to render the page. Currently it supports two possible attributes:</p>
<ul>
<li>‘admin’ : Can either be 1 or 0 to indicate if the template name should be revealed to admins only. 1 means to admins only, 0 to all visitors. The default is 1.</li>
<li>‘type’ : The template path types. Must be one of ‘absolute’, ‘filename’, ‘relative’, or ‘theme-relative’. Read the documentation for more information on what each of these mean.</li>
</ul>
<p>Examples: <code>[revealtemplate type="absolute"]</code>, <code>[revealtemplate type="filename" admin="0"]</code></p>
<h4>Template Tag</h4>
<p>A template tag is also provided which can be used to display the theme template file used to render the page.</p>
<pre><code><?php c2c_reveal_template(); ?>
</code></pre>
<p>By default, <code>c2c_reveal_template()</code> will echo the template name. To simply retrieve the template filename rather than displaying it:</p>
<pre><code><?php $template = c2c_reveal_template( false ); ?>
</code></pre>
<p>The template tag also takes a second argument which be can be one of the following: absolute, relative, theme-relative, filename. This determines the path style you’d like reported. If not specified, it uses the default defined in the plugin’s settings page.</p>
<p>Examples of path types:</p>
<ul>
<li>“absolute” : /usr/local/www/yoursite/wp-content/themes/yourtheme/single.php</li>
<li>“relative” : wp-content/themes/yourtheme/single.php</li>
<li>“theme-relative” : yourtheme/single.php</li>
<li>“filename” : single.php</li>
</ul>
<p>This plugin is primarily intended to be activated on an as-needed basis.</p>
<p>Links: <a href="https://coffee2code.com/wp-plugins/reveal-template/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/reveal-template/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/reveal-template/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Template Tags</h3>
<p>The plugin provides one template tag for use in your theme templates, functions.php, or plugins.</p>
<h4>Functions</h4>
<ul>
<li><code><?php function c2c_reveal_template( $echo = true, $template_path_type = '' ) ?></code><br />
Formats for output the template path info for the currently rendered template.</li>
</ul>
<h4>Arguments</h4>
<ul>
<li>
<p><code>$echo</code> (bool)<br />
Optional. Echo the template info? Default is true.</p>
</li>
<li>
<p><code>$template_path_type</code> (string)<br />
Optional. The style of the template’s path for return. Accepts: ‘absolute’, ‘relative’, ‘theme-relative’, ‘filename’. Default is ”, which causes the function to use the template path type configured via the plugin’s settings page.</p>
</li>
</ul>
<h4>Examples</h4>
<ul>
<li>
<p><code><?php //Output the current template<br />
c2c_reveal_template( true, 'theme-relative' );<br />
?></code></p>
</li>
<li>
<p><code><?php // Retrieve the value for use in code, so don't display/echo it.<br />
$current_template = c2c_reveal_template( false, 'filename' );<br />
if ( $current_template == 'category-12.php' ) {<br />
// Do something here<br />
}<br />
?></code></p>
</li>
</ul>


Reveal Template

Great plugin, out of the box it shows the rendered template in the footer. This has just become part of my toolbox.

Where has this been all my life!

Reveal the theme template file used to render the displayed page, via the admin bar, footer, widget, shortcode, and/or template tag.

Theme Preview vs Reveal Template