Scott Reilly

This plugin provides a powerful widget, shortcode (with shortcode builder tool), and template tags for easily retrieving and displaying custom field values for posts or pages.
The power of custom fields gives this plugin the potential to be dozens of plugins all rolled into one.
This plugin allows you to harness the power of custom fields/meta data. Use the “Get Custom Field” widget, the <code>[custom_field]</code> shortcode (which has a post editor sidebar widget to help you build the shortcode), or one of six template tags to retrieve and display custom fields. Find a custom field for the current post, a specified post, a recent post, or randomly. And for the custom field values found by the plugin, you may optionally specify text or HTML to appear before and after the results. If nothing is found, then nothing is display (unless you define text to appear when no results are found). If multiple results are found, only the first will be displayed unless you specify a string to be used to join the results together (such as “,”), in which case all will be returned. Visit the Examples section to see how this plugin can be cast in dozens of different ways.
There are six template tags provided by this plugin. Here they are, with an explanation of when they are appropriate for use:
<ul>
<li><code>c2c_get_custom()</code> : Use this inside “the loop” to retrieve a custom field value for a post</li>
<li><code>c2c_get_current_custom()</code> : This is only available on the permalink post template (single.php) and page template (page.php). Can be used inside or outside “the loop”. Useful for using custom field to define text you want to include on a post or page’s header, footer, or sidebar.</li>
<li><code>c2c_get_post_custom()</code> : Useful when you know the ID of the post whose custom field value you want.</li>
<li><code>c2c_get_random_custom()</code> : Retrieve the value of a random instance of the specified custom field key, as long as the field is associated with a published posted, non-passworded post (you can modify a setting in the plugin file to search passworded posts as well).</li>
<li><code>c2c_get_random_post_custom()</code> : Retrieves the value of random custom field(s) from a post when you know the ID of the post you’re interested in.</li>
<li><code>c2c_get_recent_custom()</code> : Retrieves the most recent (according to the associated post’s publish date) value of the specified custom field.</li>
</ul>
You can filter the custom field values that the plugin would display. Add filters for ‘<code>the_meta</code>‘ to filter custom field data (see the end of the code file for commented out samples you may wish to include). You can also add per-meta filters by hooking ‘<code>the_meta_$sanitized_field</code>‘. <code>$sanitized_field</code> is a clean version of the value of <code>$field</code> where everything but alphanumeric and underscore characters have been removed. So to filter the value of the “Related Posts” custom field, you would need to add a filter for ‘<code>the_meta_RelatedPosts</code>‘.
Links: <a href="https://coffee2code.com/wp-plugins/get-custom-field-values/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/get-custom-field-values/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/get-custom-field-values/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a>
<h3>Developer Documentation</h3>
Developer documentation can be found in <a href="https://github.com/coffee2code/get-custom-field-values/blob/master/DEVELOPER-DOCS.md" rel="nofollow ugc">DEVELOPER-DOCS.md</a>. That documentation covers the numerous template tags, hooks, and shortcode provided by the plugin.
As an overview, these are the template tags provided the plugin:
<ul>
<li><code>c2c_get_custom()</code> : Template tag for use inside “the loop” and applies to the currently listed post.</li>
<li><code>c2c_get_current_custom()</code> : Template tag for use on permalink (aka single) page templates for posts and pages.</li>
<li><code>c2c_get_post_custom()</code> : Template tag for use when you know the ID of the post you’re interested in.</li>
<li><code>c2c_get_random_custom()</code> : Template tag for use to retrieve a random custom field value.</li>
<li><code>c2c_get_random_post_custom()</code> : Template tag for use to retrieve random custom field value(s) from a post when you know the ID of the post you’re interested in.</li>
<li><code>c2c_get_recent_custom()</code> : Template tag for use outside “the loop” and applies for custom fields regardless of post.</li>
</ul>
These are the hooks provided by the plugin:
<ul>
<li><code>c2c_get_custom_field_values_shortcode</code> : Filter to customize the name of the plugin’s shortcode.</li>
<li><code>c2c_get_custom_field_values_post_types</code> : Filter to customize the post types that should support the shortcode builder metabox.</li>
<li><code>get_custom_field_values/can_author_use_shortcodes</code> : Filter to customize if post author can make use of the ‘custom_field’ shortcode.</li>
<li><code>get_custom_field_values/show_metabox</code> : Filter to customize if the shortcode builder metabox is shown.</li>
</ul>
The shortcode provided is <code>[custom-field]</code>, which has a number of attributes to customize its behavior and output.

Get Custom Field Values

Use widgets, shortcodes, and/or template tags to easily retrieve and display custom field values for posts or pages.

Hiroaki Miyashita

The Custom Field Template plugin adds the default custom fields on the Write Post/Page. The template format is almost same as the one of the rc:custom_field_gui plugin. The difference is following.
<ul>
<li><a href="https://www.wpcft.com/" rel="nofollow ugc">English Custom Field Template Manual</a></li>
</ul>
We have finally published a manual site for the custom field template plugin. You can also use the custom field refinement search for posts in the admin panel. Please check here.
<ul>
<li>You can set any number of the custom field templates and switch the templates when you write/edit the post/page.</li>
<li>This plugin does not use the ini file for the template but set it in the option page of the plugin.</li>
<li>Support for TinyMCE in the textarea.</li>
<li>Support for media buttons in the textarea. – requires at least 2.5.</li>
<li>Support for multiple fields with the same key.</li>
<li>Support for hideKey and label options.</li>
<li>You can see the full option list in the setting page of the plugin.</li>
<li>You can customize the design of custom field template with css.</li>
<li>You can replace custom keys by labels.</li>
<li>You can use wpautop function.</li>
<li>You can use PHP codes in order to set values. (experimental, <code>code = 0</code>)</li>
<li>You can set an access user level in each field. (<code>level = 1</code>)</li>
<li>Supprt for inserting custom field values into tags automatically. (<code>insertTag = true</code>)</li>
<li>Adds [cft] Shortcode to display the custom field template. (only shows the attributes which have <code>output = true</code>)</li>
<li>Adds template instruction sections.</li>
<li>Adds the value label option for the case that values are diffrent from viewed values. (<code>valueLabel = apples # oranges # bananas</code>)</li>
<li>Adds the blank option. (<code>blank = true</code>)</li>
<li>Adds the break type. Set CSS of ‘#cft div’. (<code>type = break</code>)</li>
<li>Adds [cft] Shortcode Format.</li>
<li>Adds the sort option. (<code>sort = asc</code>, <code>sort = desc</code>, <code>sort = order</code>)</li>
<li>Support for Quick Edit of custom fields. (tinyMCE and mediaButton are not supported yet)</li>
<li>Support for the custom field search. (only shows the attributes which have <code>search = true</code>.)</li>
<li>Adds [cftsearch] Shortcode Format. (under development)</li>
<li>Adds PHP codes for the output value. (<code>outputCode = 0</code>)</li>
<li>Adds PHP codes before saving the values. (<code>editCode = 0</code>)</li>
<li>Adds the save functionality.</li>
<li>Adds the class option. (<code>class = text</code>)</li>
<li>Adds the auto hook of <code>the_content()</code>. (experimental)</li>
<li>You can use the HTML Editor in the textarea. (<code>htmlEditor = true</code>)</li>
<li>Adds the box title replacement option.</li>
<li>Adds the select option of the post type.</li>
<li>Adds the value count option.</li>
<li>Adds the option to use the shortcode in the widhet.</li>
<li>Adds the attributes of JavaScript Event Handlers. (<code>onclick = alert('ok');</code>)</li>
<li>Adds the Initialize button.</li>
<li>Adds the attributes of before and after text. (<code>before = blah</code>, <code>after = blah</code>)</li>
<li>Adds the export and import functionality.</li>
<li>Adds the style attribute. (<code>style = color:#FF0000;</code>)</li>
<li>Adds the maxlength attribute. (<code>maxlength = 10</code>)</li>
<li>Adds the attributes of multiple fields. (<code>multiple = true</code>, <code>startNum = 5</code>, <code>endNum = 10</code>, <code>multipleButton = true</code>)</li>
<li>Adds the attributes of the date picker in <code>text</code> type. (<code>date = true</code>, <code>dateFirstDayOfWeek = 0</code>, <code>dateFormat = yyyy/mm/dd</code>)</li>
<li>Adds the filter of page template file names (Thanks, Joel Pittet).</li>
<li>Adds the attribute of <code>shortCode</code> in order to output the shortcode filtered values. (<code>shortCode = true</code>)</li>
<li>Adds the attribute of <code>outputNone</code> in case there is no data to output. (<code>outputNone = No Data</code>)</li>
<li>Adds the attribute of <code>singleList</code> attribute in order to output with <code><ul><li></code> if the value is single. ex) <code>singleList = true</code></li>
<li>Adds the file upload type. (<code>type = file</code>)</li>
<li>Adds the fieldset type. (<code>type = fieldset_open</code>, <code>type = fieldset_close</code>)</li>
<li>Adds the option to deploy the box in each template.</li>
</ul>
Localization
<ul>
<li>Belorussian (by_BY) – <a href="http://www.fatcow.com/" rel="nofollow ugc">Marcis Gasuns</a></li>
<li>Catalan (ca) – <a href="http://andreullos.com/" rel="nofollow ugc">Andreu Llos</a></li>
<li>Czech (cs_CZ) – <a href="http://www.webees.cz/" rel="nofollow ugc">Jakub</a></li>
<li>German (de_DE) – F J Kaiser</li>
<li>Spanish (es_ES) – <a href="http://www.darioferrer.com/" rel="nofollow ugc">Dario Ferrer</a></li>
<li>Farsi (fa_IR) – <a href="http://sabood.ir/" rel="nofollow ugc">Mehdi Zare</a></li>
<li>French (fr_FR) – Nicolas Lemoine</li>
<li>Hungarian (hu_HU) – <a href="http://www.netpok.hu" rel="nofollow ugc">Balazs Kovacs</a></li>
<li>Indonesian (id_ID) – <a href="http://www.openscriptsolution.com/" rel="nofollow ugc">Masino Sinaga</a></li>
<li>Italian (it_IT) – <a href="http://gidibao.net/" rel="nofollow ugc">Gianni Diurno</a></li>
<li>Japanese (ja) – <a href="https://wpgogo.com/" rel="nofollow ugc">Hiroaki Miyashita</a></li>
<li>Dutch (nl_NL) – <a href="http://wordpresswebshop.com/" rel="nofollow ugc">Rene</a></li>
<li>Polish (pl_PL) – <a href="http://www.difreo.pl/" rel="nofollow ugc">Difreo</a></li>
<li>Brazilian Portuguese (pt_BR) – <a href="http://www.gn10.com.br/" rel="nofollow ugc">Caciano Gabriel</a></li>
<li>Russian (ru_RU) – <a href="http://www.sonika.ru/blog/" rel="nofollow ugc">Sonika</a></li>
<li>Swedish (sv_SE) – <a href="http://www.fristil.se/" rel="nofollow ugc">Pontus Carlsson</a></li>
<li>Turkish (tr_TR) – <a href="http://ramerta.com/" rel="nofollow ugc">Omer Faruk</a></li>
<li>Ukranian (uk_UA) – <a href="http://www.portablecomponentsforall.com" rel="nofollow ugc">Andrew Kovalev</a></li>
<li>Uzbek (uz_UZ) – <a href="http://www.comfi.com/" rel="nofollow ugc">Alexandra Bolshova</a></li>
<li>Chinese (zh_CN) – hurri zhu</li>
</ul>
If you have translated into your language, please let me know.
<ul>
<li><a href="http://ja.wpcft.com/" rel="nofollow ugc">Japanese Custom Field Template Manual</a></li>
</ul>
Are you interested in other plugins? See the following site <a href="https://www.cmswp.jp/" rel="nofollow ugc">CMS x WP</a>.
<h3>Known Issues / Bugs</h3>
<h3>Uninstall</h3>
<ol>
<li>Deactivate the plugin</li>
<li>That’s it! 🙂</li>
</ol>

Custom Field Template

The Custom Field Template plugin extends the functionality of custom fields.

Get Custom Field Values vs Custom Field Template