EM Beer Manager

Manage and display your beers with WordPress. Integrates simply with Untappd and Untappd for Business. Great for everyone from home brewers to professional breweries!

Features

This plugin allows beer creators from home brewers to professional breweries to easily manage and display their beers. Includes a comprehensive beer manager section with a variety of options, including:

  • A custom beer “style” taxonomy for classifying your beers pre-populated with styles from Untappd
  • A customizable “group” taxonomy for categorizing and grouping your beers
  • “Menu” taxonomy for creating beer menus
  • Shortcodes and template tags for displaying all or a select number of beers
  • Custom meta boxes to store detailed information about each beer, including ABV, IBU, and ingredients
  • Beer check-in and rating integration with Untappd
  • A “Beer List” widget for simply displaying your beers in sidebars
  • A “Recent Check-Ins” widget for displaying recent beer check-ins for your brewery on Untappd
  • Custom page display for beers and styles
  • [Beta] Import your brewery’s beers directly from Untappd
  • [Beta] Import your beers and menus from Untappd for Business

Translations

I would love to be able to expand this section – let me know if you are able to contribute!

  • English
  • Icelandic (is_IS) – thanks to rodonmanes
  • Norwegian Bokmål (nb_NO) – thanks to Lars Kvisle
  • Brazilian Portuguese (pt_BR) – thanks to Lucas Alexandre

Support

Use the community support forums for this plugin for questions that are specific to EM Beer Manger. For support questions specific to other aspects of the WordPress, please visit the Codex or other online resources.

If you experience any issues while using a Labs feature, please contact labs@wp.erinmorelli.com.

Screenshots

  • The beer post type list page
  • Extra beer post metaboxes
  • Pre-populated styles taxonomy
  • Plugin settings page
  • Single beer page display
  • Beer list widget options & display
  • Untappd check-in widget options & display

Installation

  1. Unzip the em-beer-manager.zip file to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. See below to learn more about usage.

Use these shortcodes to display beers in your posts or use the template tags in your theme files.

Single Beer Display

These will display a single beer entry given it’s ID number (found in “Beers” admin).

  • Shortcode:

    [beer id="beer id"]

  • Template tag:

    <?php echo EMBM_Output_Shortcodes_Beer_display( $beer_id, $args ); ?>

    Where $beer_id is required and $args is a PHP array of comma-separated key => value pairs. For example:

    <?php echo EMBM_Output_Shortcodes_Beer_display( 123, array(
        'show_profile'   => false,
        'show_extras'    => true,
        'show_rating'    => false,
        'show_checkins'  => true,
        'checkins_count' => 10
    ) ); ??>
    

  • Options:

    For use with both the shortcode and template code.

    • show_profile => "true, false" (Default = true)
      Displays or hides the “Beer Profile” information section
       
    • show_extras => "true, false" (Default = true)
      Displays or hides the “More Beer Information” section

    • show_rating => "true, false" (Default = true)
      Displays or hides the Untappd beer rating

    • show_checkins => "true, false" (Default = true)
      Displays or hides the Untappd check-ins section

    • checkins_count => "true, false" (Default = true)
      The number of recent Untappd check-ins to display

List All Beers

These will display a formatted listing of all beers

  • Shortcode:

    [beer-list]

  • Template tag:

    <?php echo EMBM_Output_Shortcodes_List_display( $args ); ?>

    Where $args is a PHP array of comma-separated key => value pairs. For example:

    <?php echo EMBM_Output_Shortcodes_List_display( array(
        'show_extras'    => false,
        'show_rating'    => true,
        'beers_per_page' => 3,
        'orderby'        => 'name',
        'order'          => 'ASC'
    ) ); ?>

  • Options:

    For use with both the shortcode and template code.

    • show_profile => "true, false" (Default = true)
      Displays or hides the “Beer Profile” information section
       
    • show_extras => "true, false" (Default = true)
      Displays or hides the “More Beer Information” section
       
    • show_rating => "true, false" (Default = true)
      Displays or hides the Untappd beer rating
       
    • style => "style name" (String e.g. "India Pale Ale")
      Displays only beers belonging to a specific beer style
       
    • group => "group name" (String e.g. "Seasonal Beers")
      Displays only beers belonging to a specific group
       
    • exclude => "beer ids" (String separated by commas e.g. "4,23,24")
      Hides listed beers from output
       
    • beers_per_page => "number" (Default = -1, shows all beers on one page)
      Paginates output and displays the given number of beers per page
       
    • offset => "number" (Default = 0, starts at the first beer)
      Offsets the output of beers by given number
       
    • paginate => "true, false" (Default = true)
      Disables/enables pagination display
       
    • orderby => "string" (Default = date, see this list for options)
      Orders output by given paramater
       
    • order => "DSC, ASC" (Default = DSC)
      List beer by orderby value in ascending or descending order
       

Can I use content filters with EM Beer Manager?

Yes! New in v3.1.0, you can apply content filters to different parts of EM Beer Manager’s output:

  • embm_beer_filter_beer = The full beer post content
  • embm_beer_filter_untappd = The Untappd check-in button
  • embm_beer_filter_profile = The beer profile content
  • embm_beer_filter_extras = The beer extras content
  • embm_beer_filter_rating = The full beer rating content
  • embm_beer_filter_rating_stars = Just the stars of the rating content
  • embm_beer_filter_rating_styles = CSS styles for the rating stars
  • embm_beer_filter_reviews = The beer reviews content

Why is an Untappd account required in addition to an UTFB account?

Untappd for Business (UTFB) account credentials do not work with Untappd’s API. In order to link Untappd data to beers imported from UTFB, Untappd API access is also needed.

An Untappd brewery account is not required to work with UTFB. A standard user account will work.

Where do I find my Untappd for Business API key?

You can find your API key under the “API Access Tokens” section of your account.

Why am I seeing a “rate-limit” error?

From the Untappd API documentation:

“All API applications are rate-limited to protect against abuse and keep the platform healthy. The default limit for API access is 100 calls per hour per key.”

If you see this message, it means your authenticated API session has reached this limit and any actions that require an API call will be limited until your access is reset in the next hour.

In most cases you should still be able to use all of the Untappd features with cached data, but rare cases may display a rate-limit warning message when no cached data is available.

What is the ‘Labs’ section and how risky is it to use?

New in v2.1.0 is the EM Beer Manager ‘Labs’. This is a section where we plan to introduce new and experimental features for users to test. We do test all of the lab features before making them available, but cannot guarantee that there won’t be any issues or bugs when using them, since they are still being worked on. If you experience any issues while using a Labs feature, please contact labs@wp.erinmorelli.com.

How do I access EM Beer Manager beers, styles, and groups in the WordPress API?

Starting with v2.1.0 you can now access and update EM Beer Manager beers, styles, and groups from the WordPress API.

Beers can be accessed using /wp-json/wp/v2/embm_beers or individually at /wp-json/wp/v2/embm_beers/.

Styles can be accessed using /wp-json/wp/v2/embm_styles or individually at /wp-json/wp/v2/embm_styles/.

Groups can be accessed using /wp-json/wp/v2/embm_groups or individually at /wp-json/wp/v2/embm_groups/.

Additionally, beer profile, extras, and Untappd information is available via the API and is able to be updated via POST/PUT calls.

I accidentally deleted some of the pre-loaded styles, how do I get them back?

Starting with v2.0.0, users are now able to easily restore any missing styles. Go to the EM Beer Manager settings page. Under the “Settings” tab, click on the “Restore Styles” button. This will restore any missing styles from the pre-populated BeerAdvocate list. It will not affect any already existing or any custom styles.

Nothing is working or there are errors after upgrading to version 1.7.0

EM Beer Manager updated the beer database structure in v1.7.0 and should automatically make any necessary changes. However in the case that the automatic update does not work, you will need to uninstall EM Beer Manager and install the latest v1.7.x or higher release to maintain functionality. You will not lose any of your Beer or Styles data when uninstalling the older version.

How do I display an image of my beer next to its name and description?

When creating your new beer entry, set the “featured image” option in the sidebar to the beer image you wish to use, it will display alongside the entry when the beer is displayed on your site.

How do I display a single beer on a page?

Use the [beer id=#] shortcode inside the WordPress page editor to add a beer to any page. Replace the “#” with the ID of the beer you wish to display, which is listed on the “Beers” admin page.

How do I display a list of all my beers?

Use the [beer-list] shortcode inside the WordPress page editor to add a list of all your beers to any page.

You can display only beers from a single group using the group option, e.g.: [beer-list group="Seasonal Beers"]

You can display only beers from a single style using the style option, e.g.: [beer-list style="India Pale Ale"]

I don’t want to show that big grey box of information, how do I get rid of it?

For both the [beer id=#] and [beer-list] shortcodes there are 2 optional attributes of show_profile and show_extras. Set both of these to false to hide the grey box.

Example: [beer-list show_profile="false" show_extras="false"]

What’s the difference between show_profile and show_extras?

The show_profile setting refers to all the content in the “Beer Profile” information stored for each beer. This includes ABV, IBU, Hops, Malts, Additions, and Yeast.

The show_extras setting refers to the “Extra Beer Information” content stored for each beer. This includes Beer Number, Availability, and Additional Notes.

Why isn’t the Untappd check-in button hidden when I set show_extras to false?

The Untappd check-in integration is handled separately from the show_extras setting. To hide the button for a single beer, make sure the “Untappd Check-in URL” box is empty – a square Untappd check-in icon will appear on the “Beers” admin page next to the beers where the button is active. You can also completely disable the Untappd options through the “EM Beer Manager” settings page.

My beer and style pages are not displaying or are showing a 404 error

Try refreshing your permalinks by going to “Settings” -> “Permalinks” and clicking the “Save Settings” button. If you are running EM Beer Manager 1.7.1 or earlier, it may be due to your site’s theme overriding the EM Beer Manager templates. We recommend updating to version 1.8.0 or higher, but you can also edit the templates in the plugin file to suit your needs. They’re located in wp-content -> plugins -> em-beer-manager -> templates.

3.1.0

Download – Released 06/09/17

  • [NEW] Connect to and import beers/menus from your Untappd for Business account
  • [NEW] Sync your imported beers with changes from Untappd
  • [NEW] Beer images now link to their respective beer
  • [FIXED] Bug with how beer styles were displaying in titles

3.0.5

Download – Released 04/28/17

  • [FIXED] Broken brewery account authentication for Labs

3.0.4

Download – Released 02/12/17

  • [FIXED] PHP compatibility issue with Untappd authentication

3.0.3

Download – Released 02/11/17

  • [FIXED] Minor bugs related to logging in to Untappd

3.0.2

Download – Released 02/01/17

  • [FIXED] Compatibility issue with PHP versions < 5.4

Show More

Project Development

If you’d like to help develop this plugin or use parts of it for your own, email me and I can add you as a collaborator.

GitHub

Manage your beers with WordPress. Integrates simply with Untappd beer checkins. Great for everyone from home brewers to professional breweries!


latest commit 8921d79347
Thu Aug 3 1:03:21 2017

Merge pull request #6 from mensch/fix_archive_embm_beer

Fix archive for embm_beer CPT by Erin Morelli

 

Bitbucket