{"id":395770,"date":"2024-03-20T08:00:00","date_gmt":"2024-03-20T08:00:00","guid":{"rendered":"https:\/\/www.weixiaoduo.com\/plugins\/untappd-ratings-for-woocommerce\/"},"modified":"2025-03-21T23:20:00","modified_gmt":"2025-03-21T23:20:00","slug":"untappd-ratings-for-woocommerce","status":"publish","type":"post","link":"https:\/\/www.weixiaoduo.com\/plugins\/untappd-ratings-for-woocommerce\/","title":{"rendered":"Untappd Ratings for WooCommerce"},"content":{"rendered":"<p><strong>Untappd<\/strong> is used by millions of users worldwide to check-in their beverages and this plugin serves as a helpful solution for bottle shops, breweries, brewpubs, beer shops, and anyone needing to connect <strong>WooCommerce<\/strong> and <strong>Untappd<\/strong>.<\/p>\n<p>It enables them to display statistics on their sites effortlessly!<\/p>\n<h4>Features<\/h4>\n<ul>\n<li>Show Untappd ratings instead of WooCommerce ones on single-product and loop pages.<\/li>\n<li>Sort products by Untappd ratings.<\/li>\n<li>Add an Untappd feed map to your site using Google Maps.<\/li>\n<li>Add Untappd ratings and reviews to Product Structured Data.<\/li>\n<li>Search beverages and breweries.<\/li>\n<\/ul>\n<h3>Prerequisites<\/h3>\n<ul>\n<li><a href=\"https:\/\/github.com\/woocommerce\/woocommerce\" rel=\"nofollow ugc\"><strong>WooCommerce<\/strong><\/a><\/li>\n<\/ul>\n<h4>Prerequisites for Using Untappd API<\/h4>\n<p>To utilize the <strong>Untappd API<\/strong> (https:\/\/api.untappd.com\/v4\/), you need to have an <a href=\"https:\/\/untappd.com\/create\" rel=\"nofollow ugc\"><strong>Untappd<\/strong> account<\/a> and obtain <a href=\"https:\/\/untappd.com\/api\/dashboard\" rel=\"nofollow ugc\"><strong>Untappd<\/strong> API access<\/a>.<\/p>\n<h4>Pricing<\/h4>\n<p><strong>Free tier<\/strong>: 100 API calls x hour.<\/p>\n<p>No billing account required.<\/p>\n<h4>Prerequisites for Adding an Untappd feedmap Using Google Maps API<\/h4>\n<p>To utilize the <strong>Google Maps API<\/strong> (https:\/\/maps.googleapis.com), you must have a <a href=\"https:\/\/developers.google.com\/maps\/documentation\/javascript\/cloud-setup\" rel=\"nofollow ugc\"><strong>Google Cloud<\/strong><\/a> project with a billing account.<\/p>\n<p>To add an interactive map, you need to enable the <a href=\"https:\/\/developers.google.com\/maps\/documentation\/javascript\/overview\" rel=\"nofollow ugc\">Maps Javascript API<\/a>.<\/p>\n<p>To add a static map, you need to enable the <a href=\"https:\/\/developers.google.com\/maps\/documentation\/maps-static\/overview\" rel=\"nofollow ugc\">Maps Static API<\/a>.<\/p>\n<p>To learn more about Google Maps, visit <a href=\"https:\/\/www.google.com\/maps\/about\/#!\/\" rel=\"nofollow ugc\"><strong>Google Maps<\/strong><\/a>.<\/p>\n<h4>Pricing<\/h4>\n<p><strong>Google Cloud APIs<\/strong> offer a free monthly tier of $200 USD. After this limit is reached, additional charges may apply. <a href=\"https:\/\/developers.google.com\/maps\/billing-and-pricing\/pricing\" rel=\"nofollow ugc\">Read more<\/a><\/p>\n<h3>Configuration<\/h3>\n<ol>\n<li><strong>Access WordPress Admin<\/strong>: Log in to your <strong>WordPress<\/strong> admin dashboard.<\/li>\n<li><strong>Navigate to WooCommerce<\/strong>: Once logged in, go to the <strong>WooCommerce<\/strong> section on the left-hand menu of the <strong>WordPress<\/strong> admin dashboard.<\/li>\n<li><strong>Go to WooCommerce > Settings<\/strong>: Once <strong>WooCommerce<\/strong> is selected, go to <strong>Settings<\/strong> section under <strong>WooCommerce<\/strong> menu admin dashboard.<\/li>\n<li><strong>WooCommerce Settings<\/strong>: Once on <strong>WooCommerce<\/strong> settings section switch to the <strong>Products<\/strong> tab and Scroll down to the <strong>Reviews<\/strong> section.<\/li>\n<li>\n<p><strong>WooCommerce Products Reviews Settings<\/strong>:<\/p>\n<ul>\n<li><strong>Enable reviews<\/strong>:\n<ul>\n<li><strong>Enable product reviews<\/strong>: Check this to enable reviews and to allow <strong>Untappd ratings for WooCommerce<\/strong> to override them.<\/li>\n<li><strong>Show \u201cverified owner\u201d label on customer reviews<\/strong>: This plugin ignores this setting, all reviews from <strong>Untappd<\/strong> are shown and data is not verified.<\/li>\n<li><strong>Reviews can only be left by \u201cverified owners\u201d<\/strong>: This plugin ignores this setting, all reviews from <strong>Untappd<\/strong> are shown and data is not verified.<\/li>\n<\/ul>\n<\/li>\n<li><strong>Product ratings<\/strong>:\n<ul>\n<li><strong>Enable star rating on reviews<\/strong>: Enables the star rating review option for reviews and allows <strong>Untappd ratings for WooCommerce<\/strong> to override them.<\/li>\n<li><strong>Star ratings should be required, not optional<\/strong>: Make star rating required for reviews.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>Go to <a href=\"https:\/\/woo.com\/document\/product-reviews\/\" rel=\"nofollow ugc\">WooCommerce Product Reviews Help<\/a> to read more.<\/p>\n<\/li>\n<li>\n<p>Press <strong>Save changes<\/strong> to apply the new settings.<\/p>\n<\/li>\n<li><strong>WooCommerce Settings<\/strong>: Stay on <strong>WooCommerce<\/strong> settings section and switch to the <strong>Untappd<\/strong> tab.<\/li>\n<li>\n<p><strong>Untappd Ratings for WooCommerce Settings<\/strong>:<\/p>\n<p>To find all settings values visit <a href=\"https:\/\/untappd.com\/api\/dashboard\" rel=\"nofollow ugc\">Untappd API Dashboard<\/a>.<\/p>\n<ul>\n<li>\n<p><strong>Untappd API section<\/strong>:<\/p>\n<ul>\n<li><strong>Untappd API Client ID<\/strong>: Your Client ID obtained from <strong>Untappd<\/strong> API Dashboard.<\/li>\n<li><strong>Untappd API Client Secret<\/strong>: Your Client Secret obtained from <strong>Untappd<\/strong> API Dashboard.<\/li>\n<li><strong>API Url<\/strong>: Endpoint for the Untappd API. Default is https:\/\/api.untappd.com\/v4\/.<\/li>\n<li><strong>APP Name<\/strong>: The name of your application as registered in the <strong>Untappd<\/strong> API access request.<\/li>\n<li><strong>Cache time<\/strong>: This plugin utilizes temporarily cached data. Enter an integer representing the number of hours the cached data will last. Default is 3 hours.<\/li>\n<li><strong>Show \u201cPowered by Untappd\u201d logo<\/strong>: Enable to display the Untappd logo in the footer of Storefront-based themes. Default is disabled.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>Untappd ratings configuration<\/strong>:<\/p>\n<ul>\n<li><strong>Use Untappd Ratings<\/strong>: Override <strong>WooCommerce<\/strong> ratings system with <strong>Untappd<\/strong> ratings. Default is disabled.<\/li>\n<li><strong>Sort using Untappd Ratings<\/strong>: Enable sorting on loop-page by <strong>Untappd<\/strong> ratings. To enable sorting by ratings, URWC will add post meta data to all products. Default is disabled.<\/li>\n<li><strong>Display Ratings Text<\/strong>: Show text-based ratings alongside stars. Default is disabled.<\/li>\n<li><strong>Display Total Ratings<\/strong>: Show total ratings next to stars. Default is disabled.<\/li>\n<li><strong>Structured Data<\/strong>: Include <strong>Untappd<\/strong> ratings and check-in data in product structured data. Default is disabled.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><strong>Untappd map<\/strong>:<\/p>\n<ul>\n<li><strong>Cache Status<\/strong>:  If cache fails, this option is disabled to prevent excessive connections to the <strong>Untappd<\/strong> API. Default is enabled.<\/li>\n<li><strong>Add Product Link<\/strong>: Show a link to the Untappd review for products that have been reviewed on Untappd. Default is enabled.<\/li>\n<li><strong>Show ratings\/reviews<\/strong>: Only show ratings and reviews to WP editors on <strong>Google Maps<\/strong> InfoWindows. Default is disabled.<\/li>\n<li><strong>Apply disallowed and moderation words checks to Untappd data<\/strong>: Checkins with WP disallowed words will not be shown and checkins with moderated words will only be shown to WP editors. Default disabled.<\/li>\n<li><strong>Show disclaimer on infoWindows marker<\/strong>: Display a disclaimer linked to the Untappd reporting page. Default is disabled.<\/li>\n<li><strong>Untappd brewery search<\/strong>: Use the selector to find a term and retrieve the brewery ID needed to add a shortcode.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Press <strong>Save changes<\/strong> to apply the new settings.<\/p>\n<\/li>\n<li><strong>Verify Installation<\/strong>: That\u2019s it! Once configured, verify that the plugin is working correctly adding a map or a beverage id to the product meta.<\/li>\n<\/ol>\n<h3>Usage<\/h3>\n<h4>Show Untappd Ratings on product page instead of WooCommerce one\u2019s<\/h4>\n<ol>\n<li><a href=\"https:\/\/woo.com\/document\/managing-products\/\" rel=\"nofollow ugc\">Edit the product<\/a> you want to show <strong>Untappd<\/strong> ratings.<\/li>\n<li>Navigate to <a href=\"https:\/\/woo.com\/document\/managing-products\/#product-data\" rel=\"nofollow ugc\"><strong>The Product Data<\/strong><\/a> meta box, then go to the <strong>Untappd<\/strong> section.<\/li>\n<li><strong>Untappd<\/strong> section:\n<ul>\n<li><strong>Untappd Beer Search<\/strong>: Enter an <strong>Untappd<\/strong> beverage ID or a search term to find a beverage. Once found, select the beverage and update\/save product. Use brewery name and beer name to find the beer faster and reduce the number of calls to the Untappd API. <\/li>\n<\/ul>\n<\/li>\n<li>Check ratings on product page.<\/li>\n<\/ol>\n<h4>Show Untappd Map<\/h4>\n<p>Edit any part of your site with your favorite editor and add a shortcode:<\/p>\n<p>[urwc_untappd_map api_key=\u201dGOOGLE_API_KEY\u201d brewery_id=\u201d73836\u2033 center_map=\u201dyes\u201d height=\u201d500\u2033 max_checkins=\u201d300\u2033 zoom=\u201d4\u2033]<\/p>\n<p>You can find all shortcode options in the attribute table on the <a href=\"https:\/\/github.com\/ChillCode\/untappd-ratings-for-woocommerce#add-a-google-map-untappd-feed-to-your-site\" rel=\"nofollow ugc\"><strong>Untappd ratings for WooCommerce<\/strong><\/a> GitHub repository.<\/p>\n<p>Use the search function added in the <strong>Untappd Settings<\/strong> to find a term and retrieve the brewery ID required to add a shortcode.<\/p>\n<p>Alternatively, to find the brewery ID for the Untappd brewery search shortcode, follow these steps:<\/p>\n<ol>\n<li>Visit the Untappd website: https:\/\/untappd.com\/.<\/li>\n<li>Use the search bar at the top to search for the brewery you\u2019re interested in.<\/li>\n<li>Once you find the brewery, click on its name to view its details.<\/li>\n<li>In the URL of the brewery\u2019s page, you\u2019ll find a numerical value after \u201c\/brewery\/\u201d \u2013 this is the brewery ID.<\/li>\n<li>Copy the brewery ID and use it when adding the shortcode.<\/li>\n<\/ol>\n<p>For example, if the URL is https:\/\/untappd.com\/w\/brasserie-cantillon\/202, then 202 would be the brewery ID to use in the shortcode.<\/p>\n<h3>Disclosure on use of 3rd Party and external services<\/h3>\n<p>This software make use of <strong>Google Maps API<\/strong> (https:\/\/maps.googleapis.com) and <strong>Untappd API<\/strong> (https:\/\/api.untappd.com\/v4\/) endpoints.<\/p>\n<p>Every service has its own set of terms and conditions, as well as potential charges. To find out more about pricing and specific terms, please consult the provided links.<\/p>\n<p><a href=\"https:\/\/untappd.com\/terms\" rel=\"nofollow ugc\"><strong>Untappd Terms of Use<\/strong><\/a><\/p>\n<p><a href=\"https:\/\/cloud.google.com\/maps-platform\/terms\" rel=\"nofollow ugc\"><strong>Google Maps Platform Terms of Service<\/strong><\/a><\/p>\n<p>Your utilization of these services establishes a legal agreement between you (the end user of <strong>Untappd ratings for WooCommerce<\/strong>) and the respective service provider. We, in this context, are not a participant in this contractual agreement. We solely furnish the software facilitating access to their API, which operates on your servers and within your browser.<\/p>\n<ul>\n<li>We do not impose charges for accessing these APIs.<\/li>\n<li>We do not mediate API calls through our servers.<\/li>\n<li>We do not retain or handle your access credentials.<\/li>\n<li>We do not verify reviews or ratings, and we hold no accountability for their content nor authenticity.<\/li>\n<li>We hold no accountability for your actions regarding data usage.<\/li>\n<\/ul>\n<h3>Copyright<\/h3>\n<p><a href=\"https:\/\/wordpress.org\/plugins\/woocommerce\/\" rel=\"ugc\"><strong>WooCommerce<\/strong><\/a>, <a href=\"https:\/\/www.google.com\/maps\/about\/#!\/\" rel=\"nofollow ugc\"><strong>Google Maps<\/strong><\/a> and <a href=\"https:\/\/untappd.com\" rel=\"nofollow ugc\"><strong>Untappd<\/strong><\/a> trademarks are the property of their respective owners.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Everything you need to show Untappd ratings on WooCommerce stores.<\/p>\n","protected":false},"author":65,"featured_media":363312,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"slim_seo":{"title":"Untappd Ratings for WooCommerce - \u8587\u6653\u6735\u63d2\u4ef6\u76ee\u5f55","description":"Everything you need to show Untappd ratings on WooCommerce stores."},"footnotes":""},"categories":[1],"tags":[53983,6896,692,18785,42],"class_list":["post-395770","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-map-feed","tag-ratings","tag-reviews","tag-untappd","tag-woocommerce"],"_links":{"self":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/395770","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/comments?post=395770"}],"version-history":[{"count":0,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/395770\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media\/363312"}],"wp:attachment":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media?parent=395770"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/categories?post=395770"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/tags?post=395770"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}