=== Reveal Template === Contributors: coffee2code Donate link: http://coffee2code.com/donate Tags: template, theme, debug, presentation, template, design, coffee2code Requires at least: 3.1 Tested up to: 3.3 Stable tag: 2.2 Version: 2.2 Reveal the theme template file used to render the displayed page, via the footer and/or template tag. == Description == Reveal the theme template file used to render the displayed page, via the footer and/or template tag. 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. This plugin relieves the aggravation by assisting designers and developers by displaying the template being used to render the currently displayed page in WordPress. This typically appears in the site's footer (though only if the theme follows the recommended practice of calling the `wp_footer()` template tag) at some point. Also, obviously this can only universally apply to the site if said footer is actually used on every page. A template tag is also provided which can be used to display the template file. `` By default, `c2c_reveal_template()` will echo the template name. To simply retrieve the template filename rather than displaying it: `` The template tag also takes a second argument which be can be one of the following: absolute, relative, template-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. Examples of path types: * "absolute" : /usr/local/www/yoursite/wp-content/themes/yourtheme/single.php * "relative" : wp-content/themes/yourtheme/single.php * "theme-relative" : yourtheme/single.php * "filename" : single.php This plugin is primarily intended to be activated on an as-needed basis. Links: [Plugin Homepage](http://coffee2code.com/wp-plugins/reveal-template/) | [Plugin Directory Page](http://wordpress.org/extend/plugins/reveal-template/) | [Author Homepage](http://coffee2code.com) == Installation == 1. Whether installing or updating, whether this plugin or any other, it is always advisable to back-up your data before starting 1. Unzip `reveal-template.zip` inside the `/wp-content/plugins/` directory for your site (or install via the built-in WordPress plugin installer) 1. Activate the plugin through the 'Plugins' admin menu in WordPress 1. Optionally customize the plugin's settings by click the plugin's 'Settings' link next to its 'Deactivate' link (still on the Plugins page), or click on the'Design' -> 'Reveal Template' link, to go to the plugin's admin settings page. == Template Tags == The plugin provides one template tag for use in your theme templates, functions.php, or plugins. = Functions = * `` Formats for output the template path info for the currently rendered template. = Arguments = * `$echo` (bool) Optional. Echo the template info? Default is true. * `$template_path_type` (string) 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. = Examples = * `` * `` == Changelog == = 2.2 = * Update plugin framework to 031 * Remove support for 'c2c_reveal_template' global * Note compatibility through WP 3.3+ * Drop support for versions of WP older than 3.1 * Move .pot into lang/ * Regenerate .pot * Add 'Domain Path' directive to top of main plugin file * Update screenshot for WP 3.3 * Add link to plugin directory page to readme.txt * Update copyright date (2012) = 2.1 = * Update plugin framework to v023 * Save a static version of itself in class variable $instance * Deprecate use of global variable $c2c_reveal_template to store instance * Explicitly declare all functions as public * Add __construct(), activation(), and uninstall() * Note compatibility through WP 3.2+ * Drop compatibility with versions of WP older than 3.0 * Minor code formatting changes (spacing) * Add plugin homepage and author links in description in readme.txt = 2.0.4 = * Fix bug with theme-relative template path output showing parent theme path instead of child theme path = 2.0.3 = * Update plugin framework to version 021 * Explicitly declare all class functions public * Delete plugin options upon uninstallation * Note compatibility through WP 3.1+ * Update copyright date (2011) = 2.0.2 = * Update plugin framework to version 017 = 2.0.1 = * Update plugin framework to version 016 * Fix template tag name references in readme.txt to use renamed function name * Add Template Tags section to readme.txt = 2.0 = * Re-implementation by extending C2C_Plugin_013, which among other things adds support for: * Reset of options to default values * Better sanitization of input values * Offload of core/basic functionality to generic plugin framework * Additional hooks for various stages/places of plugin operation * Easier localization support * Full localization support * Add c2c_reveal_template() * Deprecate reveal_template() in favor of c2c_reveal_template() (but retain for backward compatibility) * Rename class from 'RevealTemplate' to 'c2c_RevealTemplate' * Remove docs from top of plugin file (all that and more are in readme.txt) * Change description * Add package info to top of plugin file * Add PHPDoc documentation * Note compatibility with WP 2.9+, 3.0+ * Drop support for versions of WP older than 2.8 * Minor tweaks to code formatting (spacing) * Add Changelog and Upgrade Notice sections to readme.txt * Update copyright date * Remove trailing whitespace in header docs * Update screenshot * Add .pot file = 1.0.1 = * Check for 'manage_options' instead of 'edit_posts' permission in order to edit settings * Use plugins_url() instead of hard-coding path * Tweak readme tags and donate link * Note compatibility with WP 2.8+ = 1.0 = * Initial release == Upgrade Notice == = 2.2 = Recommended update. Highlights: updated plugin framework; noted compatibility with WP 3.3+; dropped compatibility with versions of WP older than 3.1. = 2.1 = Recommended update. Noted WP 3.2 compatibility; dropped support for versions of WP older than 3.0; updated plugin framework; deprecate global variable. = 2.0.4 = Bugfix release: fixed bug with theme-relative template path output showing parent theme path instead of child theme path = 2.0.3 = Minor release: updated underlying plugin framework; noted compatibility with WP 3.1+ and updated copyright date. = 2.0.2 = Minor update. Updated plugin framework to latest version (017). = 2.0.1 = Minor update. Fixed and expanded readme.txt. Updated plugin framework to latest version (016). = 2.0 = Recommended update. Highlights: re-implementation; full localization support; deprecated reveal_template() (use c2c_reveal_template() instead); misc non-functionality changes; verified WP 3.0 compatibility.