{"id":751,"date":"2025-03-24T14:27:35","date_gmt":"2025-03-24T14:27:35","guid":{"rendered":"https:\/\/wpgeodirectory.com\/documentation\/article\/gd-post-badge\/"},"modified":"2025-04-03T15:23:55","modified_gmt":"2025-04-03T14:23:55","slug":"gd-post-badge","status":"publish","type":"gd_place","link":"https:\/\/wpgeodirectory.com\/documentation\/article\/core-widgets\/gd-post-badge\/","title":{"rendered":"GD > Post Badge"},"content":{"rendered":"\n
<\/span>All Widgets come as Widgets, Shortcodes or Blocks. Learn more about our Super Duper Widgets<\/a>.<\/span><\/div>\n\n\n\n

The Post Badge <\/b>widget\u00a0is used to\u00a0output a custom badge dependent on a specific custom field value<\/strong>.<\/p>\n\n\n\n

<\/span>If you need to output more than just a badge dependent on the value of a custom field then you can use the GD > Dynamic Content<\/strong> widget.<\/span><\/div>\n\n\n\n

Widget Options<\/h2>\n\n\n\n
<\/span>Some settings for this widget are advanced settings, reveal them by clicking the button next to save.<\/span><\/div>\n\n\n\n
    \n
  • Post ID<\/strong> – Leaving this blank will use the current post ID from the page or the loop, or you can specify and exact post ID if needed.<\/li>\n\n\n\n
  • Field Key<\/strong> – Selecting the custom field key to use as the conditional field.  Standard field values are also available here such as post_date.<\/li>\n\n\n\n
  • Field condition<\/strong> – This is the condition to use for the field value. You can match it to an exact value or simply use “is no empty” to show if a value is set. Many comparison types are available.<\/li>\n\n\n\n
  • Value to match<\/strong> – If a comparison condition is used that requires a matching value then this is where you can enter a matching value.  For post date enter value like +7 or -7.<\/li>\n\n\n\n
  • Icon class<\/strong> – You can show a font-awesome icon in the badge by entering the icon class. E.g “fas fa-award<\/em>“<\/li>\n\n\n\n
  • Badge<\/strong> – Badge text. Ex: FOR SALE. Leave blank to show field title as a badge, or use %%input%% to use the input value of the field or %%post_url%% for the post URL, or the field key for any other info %%email%%.<\/li>\n\n\n\n
  • Link URL<\/strong> – Badge link URL. You can use this to make the button link to something, %%input%% can be used here if a link or %%post_url%% for the post URL.<\/li>\n\n\n\n
  • Open link in new window<\/strong> – This will make the link open in a new tab\/window.<\/li>\n\n\n\n
  • Badge background color <\/strong>– Color for the badge background.<\/li>\n\n\n\n
  • Badge text color<\/strong> – Color for the badge text.<\/li>\n\n\n\n
  • Badge size <\/strong>– Set the size of the badge.<\/li>\n\n\n\n
  • Alignment<\/strong> – How the item should be positioned on the page.<\/li>\n<\/ul>\n\n\n\n

    Example Output<\/h2>\n\n\n\n

    For some examples, we can look at the default dummy data<\/p>\n\n\n\n

    \"\"\/<\/figure>\n\n\n\n

    <\/p>\n\n\n\n

    The shortcodes used in the Archive Item template are:<\/p>\n\n\n\n

    [gd_post_badge key='post_date' condition='is_less_than' search='+30' icon_class='fas fa-certificate' badge='New' bg_color='#ff0000' txt_color='#ffffff' alignment='left']\n[gd_post_badge key='facebook' condition='is_not_empty' icon_class='fab fa-facebook-f fa-fw' link='%%input%%' new_window='1' bg_color='#2b4be8' txt_color='#ffffff' alignment='left']\n[gd_post_badge key='twitter' condition='is_not_empty' icon_class='fab fa-twitter fa-fw' link='%%input%%' new_window='1' bg_color='#2bb8e8' txt_color='#ffffff' alignment='left']\n[gd_post_badge key='website' condition='is_not_empty' icon_class='fas fa-link fa-fw' link='%%input%%' new_window='1' bg_color='#85a9b5' txt_color='#ffffff' alignment='left']<\/code><\/pre>\n\n\n\n
    Badge Placement with the ‘extra class’ option<\/h2>\n\n\n\n
    These custom classes can be added to your badge to change the way it is displayed within the containing div. The most common usage is within the GD Archive item section, usually the left section, but you can also use them in the footer section as shown below.<\/p>\n\n\n\n
    [gd_archive_item_section type='open' position='left']<\/code><\/pre>\n\n\n\n
    [gd_post_badge key='featured' condition='is_not_empty' badge='FEATURED' bg_color='#fd4700' txt_color='#ffffff' css_class='gd-ab-top-left-angle gd-badge-shadow']<\/code><\/pre>\n\n\n\n
    [gd_post_images type='image' ajax_load='true' link_to='post' types='logo,post_images']<\/code><\/pre>\n\n\n\n
    [gd_archive_item_section type='close' position='left']<\/code><\/pre>\n\n\n\n
    \"\"\/<\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    To use these over the top of an archive item GD Post Images, be sure to include the badge before the GD Archive Item Close element.<\/p>\n\n\n\n
    shadow \t\t\t\t\t\/\/ gd-badge-shadow \/\/ adds a shadow to the badge \ntop left \t\t\t\t\/\/ gd-ab-top-left \/\/ positions absolute top\nabsolute left \t\t\t\t\/\/ gd-ab-top-left-angle \/\/ positions absolute top\nabsolute left, at an angle \t\t\/\/ gd-ab-top-right \/\/ positions absolute top\nabsolute right \t\t\t\t\/\/ gd-ab-top-right-angle \/\/ positions absolute top\nabsolute right, at an angle \t\t\/\/ gd-ab-bottom-left \/\/ positions absolute bottom\nabsolute left \t\t\t\t\/\/ gd-ab-bottom-left-angle \/\/ positions absolute bottom\nabsolute left, at an angle \t\t\/\/ gd-ab-bottom-right \/\/ positions absolute bottom\nabsolute bottom right, at an angle \t\/\/ gd-ab-bottom-right-angle \/\/ positions absolute bottom\ninteractive video and files \t\t\/\/ gd-lity  \/\/ adds interactivity \u2013 launching a video link in a lightbox, for example<\/code><\/pre>\n\n\n\n
    Examples of positioning<\/h4>\n\n\n\n
    Featured in the upper left<\/em><\/p>\n\n\n\n
    [gd_post_badge key="featured" condition="is_not_empty" badge="Featured" bg_color="#0073aa" txt_color="#ffffff" css_class="gd-ab-top-left"]<\/code><\/pre>\n\n\n\n
    Default category in the lower left<\/em><\/p>\n\n\n\n
    [gd_post_badge key="default_category" condition="is_not_empty" badge="%%default_category%%" bg_color="#0073aa" txt_color="#ffffff" css_class="gd-ab-bottom-left"]<\/code><\/pre>\n\n\n\n
    Examples<\/h2>\n\n\n\n
    Taxonomy Badges<\/h3>\n\n\n\n
    Examples for showing a badge based on categories<\/p>\n\n\n\n
    Default Category<\/p>\n\n\n\n
    [gd_post_badge key="default_category" condition="is_not_empty" badge="%%default_category%%" bg_color="#0073aa" txt_color="#ffffff" css_class="gd-ab-bottom-left"]<\/code><\/pre>\n\n\n\n
    Specific Category<\/p>\n\n\n\n
    [gd_post_badge key="post_category" condition="is_contains" search="32" badge="Attractions" bg_color="#0073aa" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    [gd_post_badge key="post_category" condition="is_contains" search="32,33" badge="Attractions \/ Hotels" bg_color="#0073aa" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    Examples for showing a badge based on tags.<\/p>\n\n\n\n
    [gd_post_badge key="post_tags" condition="is_contains" search="Museum" badge="Museum" bg_color="#0073aa" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    [gd_post_badge key="post_tags" condition="is_contains" search="Museum,Garden" badge="Museum \/ Garden" bg_color="#0073aa" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    Example \u2013 HTML Image Badge<\/h3>\n\n\n\n
    HTML can be used in the badge param. Make sure to enclose the HTML with \u201d (quotes\u201d and then use \u2018 (apostrophe) for inner HTML.<\/p>\n\n\n\n
    [gd_post_badge key="my_custom_field" condition="is_not_empty" badge="<img src='https:\/\/mysite.com\/wp-content\/uploads\/2020\/02\/pbjt.jpg'\/>" bg_color="#ffffff" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    Date in a badge<\/h3>\n\n\n\n
    Using \u2018post_modified\u2019 to show the date of last update or \u201cRecently Updated\u201d post_modified is the date that a listing was most recently updated.<\/p>\n\n\n\n
    If you create a badge and use %%input%% for the badge, post_modified will show as a date.<\/p>\n\n\n\n
    To show \u201cRecently Updated!\u201d if a post was updated in the last 30 days use:<\/p>\n\n\n\n
    [gd_post_badge key='post_modified' condition='is_less_than' search='+30\u2032 icon_class='fas fa-certificate' badge='Recently Updated!' bg_color='#ff0000\u2032 txt_color='#ffffff' alignment='left']<\/code><\/pre>\n\n\n\n
    Here is a \u2018New\u2019 Badge that shows for the 30 days after a post has been created. If 30 is less than the count of days since the post date, then the badge shows.<\/p>\n\n\n\n
    [gd_post_badge key="post_date" condition="is_less_than" search="+30" badge="NEW" bg_color="#0073aa" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    Read More Button<\/h3>\n\n\n\n
    Use an alternative to the GD Post Content Read More option.<\/p>\n\n\n\n
    [gd_post_badge key="post_title" condition="is_not_empty" badge="Read More" link="%%post_url%%" bg_color="#ffffff" txt_color="#433aed" alignment="center"]<\/code><\/pre>\n\n\n\n
    Write a Review Button<\/h3>\n\n\n\n
    Link to a tab in the GD Single Tabs easily.<\/p>\n\n\n\n
    [gd_post_badge key="post_title" condition="is_not_empty" badge="Write a Review" bg_color="#0073aa" txt_color="#ffffff" link="%%post_url%%#reviews"]<\/code><\/pre>\n\n\n\n
    Custom Website Link Badge<\/h3>\n\n\n\n
    [gd_post_badge key="website" condition="is_not_empty" badge="Awesome Super Link" link="%%input%%" bg_color="#9c03aa" txt_color="#ffffff" size="extra-large" list_hide="3" list_hide_secondary="2"]<\/code><\/pre>\n\n\n\n
    Verified Listing Badge<\/h3>\n\n\n\n
    Show a badge “Verified” when the listing is claimed.<\/p>\n\n\n\n
    \"\"\/<\/figure>\n\n\n\n
    [gd_post_badge key="claimed" condition="is_not_empty" badge='<i class="fas fa-check-circle"><\/i>Verified' bg_color="#ff8040" txt_color="#ffffff" size="small" alignment="right" css_class="verified"]<\/code><\/pre>\n\n\n\n
    Featured<\/h2>\n\n\n\n
    Show a badge “Recommended” when the listing is featured.<\/p>\n\n\n\n
    [gd_post_badge key="featured" condition="is_not_empty" badge="Recommended" icon_class="fas fa-ribbon" bg_color="#ef5f2e" txt_color="#ffffff"]<\/code><\/pre>\n\n\n\n
    \"\"\/<\/figure>\n\n\n\n
    <\/p>\n\n\n\n
    Custom Link for Integration with Listing Data<\/h3>\n\n\n\n
    [gd_post_badge key="phone" condition="is_not_empty" badge="<a href='https:\/\/wa.me\/%%input%%'>Chat Now<\/a>" bg_color="#9c03aa" txt_color="#ffffff" size="extra-large" list_hide="3" list_hide_secondary="2"]<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
    The Post Badge widget\u00a0is used to\u00a0output a custom badge dependent on a specific custom field value. Widget Options Example Output For some examples, we can look at the default dummy data The shortcodes used in the Archive Item template are: Badge Placement with the ‘extra class’ option These custom classes can be added to your […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"article\/tags":[597],"article\/categories":[213,422],"class_list":["post-751","gd_place","type-gd_place","status-publish","hentry","gd_place_tags-badge","gd_placecategory-extensions-features","gd_placecategory-core-widgets"],"_links":{"self":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/751","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/types\/gd_place"}],"author":[{"embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/comments?post=751"}],"version-history":[{"count":0,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/751\/revisions"}],"wp:attachment":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/media?parent=751"}],"wp:term":[{"taxonomy":"gd_place_tags","embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/tags?post=751"},{"taxonomy":"gd_placecategory","embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/categories?post=751"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}