Noby

<p>The “Meta Functions Shortcode” Plugin installs the Shortcode ‘meta’. With it you can access the custom fields of your articles by a simple shortcode.</p>
<p>Shortcode Syntax: <code>[meta func="" name="" alt=""]</code></p>
<p>The shortcode has three functions yet:</p>
<ol>
<li>func=”url”<br />
  Displays a link using your custom field in “name” as the link target and “alt” as the caption. If “alt” is empty the link target is used as the caption.</li>
<li>func=”plain”<br />
  Simply displays the custom field in “name” as plain text. If the field is empty it displays the text in “alt”.</li>
<li>func=”img”<br />
  Inserts the image at the url in your custom field “name” into the article. The “alt” argument is used as the images alternative text attribute.</li>
<li>More functions in later versions of the plugin… Or extend the plugin on your own. See Extending the Plugin (under Other Notes) for details.</li>
</ol>
<h4>Example</h4>
<pre><code>[meta func="url" name="download_url" alt="Download here"]
</code></pre>
<p>This little code in your article displays a link using your custom field “download_url” as the link target and “Download here” as the caption. If you leave the “alt” argument empty then it uses the link target as the caption.</p>
<p>The resulting html code is:</p>
<pre><code><a href='{download_url}'>{alt}</a>
</code></pre>
<h3>Extending the Shortcode</h3>
<h4>Method 1: Hardcoded</h4>
<p>You can extend the plugin by adding the PHP function</p>
<pre><code>function meta_functions_shortcode_{func}($meta, $alt="") {
       return "your desired text or generated html content";
}
</code></pre>
<p>by writing your own plugin file with the function in it. Be sure to replace {func} with your desired function name (will result in the parameter “func” in the shortcode). $meta will be the value of the custom field and $alt the “alt” parameter.</p>
<p>The function should return the text by which the shortcode will be replaced. For example the “_plain” function simply returns $meta or $alt if $meta is empty.</p>
<h4>Method 2: In the admin panel</h4>
<p>This method is more convenient. You can add new functions in the admin panel. For this go to the options page called “Meta Functions Shortcode”.<br />
Here you can enter a new function name, specify parameter names and set the output html code with the parameters.</p>
<p>Example:</p>
<ul>
<li>Function Name: link</li>
<li>Function Parameter Names: link_url, link_caption</li>
<li>Function Result Code: <code><a href='{link_url}'>{link_caption}</a></code> </li>
</ul>
<p>If you now enter the shortcode [meta func=”link” link_url=”download_url” link_caption=”download_caption”] then in the article/page<br />
it will be replaced by <code><a href='contents of custom field download_url'><i>contents of custom field download_caption</i></a></code>.</p>


Meta Functions Shortcode

The “Meta Functions Shortcode” Plugin installs the Shortcode ‘meta’. With it you can access the custom fields of your articles by a shortcode.

Scott Reilly

<p>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.</p>
<p>The power of custom fields gives this plugin the potential to be dozens of plugins all rolled into one.</p>
<p>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.</p>
<p>There are six template tags provided by this plugin. Here they are, with an explanation of when they are appropriate for use:</p>
<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>
<p>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>‘.</p>
<p>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></p>
<h3>Developer Documentation</h3>
<p>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.</p>
<p>As an overview, these are the template tags provided the plugin:</p>
<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>
<p>These are the hooks provided by the plugin:</p>
<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>
<p>The shortcode provided is <code>[custom-field]</code>, which has a number of attributes to customize its behavior and output.</p>


Get Custom Field Values

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

Meta Functions Shortcode vs Get Custom Field Values