{"id":33969,"date":"2019-03-04T10:33:49","date_gmt":"2019-03-04T10:33:49","guid":{"rendered":"http:\/\/getshortcodes.com\/?post_type=docs&p=33969"},"modified":"2023-11-23T09:02:33","modified_gmt":"2023-11-23T09:02:33","slug":"post-meta","status":"publish","type":"docs","link":"https:\/\/getshortcodes.com\/docs\/post-meta\/","title":{"rendered":"Post Meta"},"content":{"rendered":"\n
[su_meta key=\"mood\" post_id=\"1\"]<\/code><\/pre>\n\n\n
Table of contents<\/p>\n\n
  1. Description<\/a><\/li>
  2. Options<\/a><\/li>
  3. Unsafe Feature<\/a><\/li><\/ol><\/li><\/ol>\n\n\n
    Description<\/h2>\n\n\n\n
    This shortcode allows you to display custom field values.<\/p>\n\n\n\n
    Options<\/h2>\n\n\n\n
    Option name<\/th>Possible values<\/th>Default value<\/th><\/tr>
    key<\/strong>
    Meta key name<\/td>    		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
    default<\/strong>
    This text will be shown if data is not found<\/td>    		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
    before<\/strong>
    This content will be shown before the value<\/td>    		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
    after<\/strong>
    This content will be shown after the value<\/td>    		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
    post_id<\/strong>
    You can specify custom post ID. Leave this field empty to use an ID of the current post. Current post ID may not work in Live Preview mode<\/td>    		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr>
    filter<\/strong>
    You can apply custom filter to the retrieved value. Enter here function name. Your function must accept one argument and return modified value. Name of your function must include word filter. The following example code could be added to the end of the functions.php file of your theme: 
    function my_custom_filter( $value ) {return 'Value is: ' . $value;}<\/code><\/td>    		Any text value<\/td>\u2013 none \u2013<\/em><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Unsafe Feature<\/h2>\n\n\n\n
    Starting with plugin version 7.0.0, the  shortcode is considered an Unsafe Feature. This means that the shortcode will be automatically disabled if your site has at least one user with a role lower than administrator (e.g. Contributor). Learn more about unsafe features<\/a>.<\/p>\n\n\n\n
    However, you can still use the shortcode.<\/p>\n\n\n\n
    The first option is to enable Unsafe features<\/em> by navigating to Dashboard > Shortcodes > Settings > Advanced settings<\/em>. It is strongly discouraged if you have non-administrator users on your site (ex. Contributors), as they may use the shortcode to access sensitive information stored in post metadata.<\/p>\n\n\n\n
    The second method is to whitelist the specific meta fields. You can use the su\/shortcode\/meta\/allowed_keys<\/code> filter to do this. Put the code below to the end of the functions.php<\/em> file of the active theme and add your meta field names.<\/p>\n\n\n\n
    add_filter('su\/shortcode\/meta\/allowed_keys', function($allowed_keys) {\n\t$allowed_keys[] = 'mood';\n\t$allowed_keys[] = '_sku';\n\n\treturn $allowed_keys;\n});<\/code><\/pre>\n\n\n\n
    The code above will allow you to use the following shortcodes even while the Unsafe features option is disabled:<\/p>\n\n\n\n
    [su_meta key=\"mood\"]\n[su_meta key=\"_sku\"]<\/code><\/pre>\n","protected":false},"featured_media":36689,"template":"","docs_category":[21],"class_list":["post-33969","docs","type-docs","status-publish","has-post-thumbnail","hentry","docs_category-shortcodes"],"_links":{"self":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs\/33969","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/types\/docs"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/media\/36689"}],"wp:attachment":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/media?parent=33969"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs_category?post=33969"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}