內容簡介
設計師和開發人員知道，在 WordPress 中確定當前頁面使用的模板有時可能會讓人困惑和沮喪。有時會存在頁面或分類特定模板，或者文章作者已經設定了使用特定模板，或者當前主題沒有使用特定模板，導致 WordPress 回退到其他模板。
本外掛程序通過顯示用於呈現當前 WordPress 頁面的模板，緩解了設計師和開發人員的這種煩惱。以下是顯示方法：
管理列
默認情況下，在管理列中顯示了用於呈現該頁面的主題相關路徑。外掛程式的設置頁面位於“設計”-> “顯示模板”，允許您控制和配置特定方法。注意：即使通過設置啟用，管理列條目也只有在管理列顯示並且用戶有能力看到顯示的模板時才出現。
網站頁腳
默認情況下，在網站的頁腳中顯示了用於呈現該頁面的主題相關路徑。外掛程式的設置頁面位於“設計”-> “顯示模板”，允許您控制和配置特定方法。注意：即使通過設置啟用，頁腳輸出只有在主題遵循調用 wp_footer() 模板標簽的推薦做法以及用戶有能力看到顯示的模板時才出現。
小工具
提供了一個名為“顯示模板”的小工具，可以在任何小工具區域用於顯示用於呈現該頁面的主題相關路徑。
短程式碼
提供一個名為“revealtemplate”的短程式碼，可以在文章/頁面內容中使用，以顯示用於呈現該頁面的主題相關路徑。目前它支持兩個可能的屬性：
‘admin’：可以是1或0，表示模板名稱是否只向管理員顯示。 1表示僅顯示給管理員，0表示顯示給所有訪問者。默認值為1。
‘type’：模板路徑類型。必須是“absolute”、“filename”、“relative”或“theme-relative”中的一種。閱讀說明文件以獲取有關每個內容的更多信息。
例如：[revealtemplate type="absolute"]，[revealtemplate type="filename" admin="0"]
模板標籤
也提供了一個模板標籤，可用於顯示用於呈現該頁面的主題相關路徑。
默認情況下，c2c_reveal_template() 將顯示模板名稱。要僅獲取模板文件名，而不是顯示它：
<?php $template = c2c_reveal_template( false ); ?>
模板標籤還接受第二個參數，可以是以下之一：absolute、relative、theme-relative、filename。這決定了您想要報告的路徑風格。如果未指定，它將使用外掛程式設置頁面中定義的默認值。
路徑類型的示例：
“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
此外掛程式主要是打算根据需要啟用。
外掛標籤
開發者團隊
原文外掛簡介
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 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:
Admin bar
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.
Site footer
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 wp_footer() template tag at some point and the user has the ability to see the revealed template.
Widget
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.
Shortcode
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:
‘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.
‘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.
Examples: [revealtemplate type="absolute"], [revealtemplate type="filename" admin="0"]
Template Tag
A template tag is also provided which can be used to display the theme template file used to render the page.
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, 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.
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 | Plugin Directory Page | GitHub | Author Homepage
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
