Title: BeerXML Shortcode Author: Derek Springer Published: August 14, 2012 Last modified: April 29, 2025 --- Search plugins ![](https://ps.w.org/beerxml-shortcode/assets/banner-772x250.png?rev=895425) ![](https://ps.w.org/beerxml-shortcode/assets/icon-256x256.png?rev=980880) # BeerXML Shortcode By [Derek Springer](https://profiles.wordpress.org/derekspringer/) [Download](https://downloads.wordpress.org/plugin/beerxml-shortcode.0.8.zip) * [Details](https://pcd.wordpress.org/plugins/beerxml-shortcode/#description) * [Reviews](https://pcd.wordpress.org/plugins/beerxml-shortcode/#reviews) * [Installation](https://pcd.wordpress.org/plugins/beerxml-shortcode/#installation) * [Development](https://pcd.wordpress.org/plugins/beerxml-shortcode/#developers) [Support](https://wordpress.org/support/plugin/beerxml-shortcode/) ## Description A shortcode for displaying beer recipes. Now with [Shortcake (Shortcode UI)](https://wordpress.org/plugins/shortcode-ui/) integration! * Link to a BeerXML document to display recipe details, style details, fermentables, hops, miscs, yeast, mash steps, fermentation schedule, and notes. * Allows you to easily switch between U.S. & Metric measurements. * Control if & how long recipe is cached. * Allow readers to download the recipe directly. It follows the basic format of: [beerxml recipe={URL} metric=true|false download=true|false style=true|false mash =true|false fermentation=true|false mhop=true|false misc=true|false actuals=true |false cache=-1|{seconds to cache}] Please note all options (minus recipe) are optional and have the following defaults: * metric = false * cache = 12 hours (60 x 60 x 12 seconds), -1 kills the cache and sets value to 0 * download = true * style = true * mash = true * misc = true * actuals = true * fermentation = false * mhop = false ## Screenshots * [[ * BeerXML recipe displayed in the twenty eleven theme. * [[ * Inserting the shortcode into a post. * [[ * Insert Post Element option. * [[ * Insert Post Element details. ## Installation 1. Upload the files to the `/wp-content/plugins/beerxml-plugin/` directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Go to Admin Dashboard -> Settings -> BeerXML Shortcode and configure defaults. ## Reviews ![](https://secure.gravatar.com/avatar/7efded6d911fd8ce7a1e79dfc528365be357083ab54471e62192bd6311967d65? s=60&d=retro&r=g) ### 󠀁[Sweet and Simple!](https://wordpress.org/support/topic/sweet-and-simple-16/)󠁿 [falstaff5225](https://profiles.wordpress.org/falstaff5225/) March 13, 2018 Straight-forward plugin that makes sharing homebrew recipes in your blog simple to do they look great! The plugin author responds quickly to support posts too! Thanks for the great plugin! ![](https://secure.gravatar.com/avatar/c6ddb8dc4278f595d2e7a633bb9dcf4693482049a33127ebbabcb587b5ffd58f? s=60&d=retro&r=g) ### 󠀁[Great for brewers!](https://wordpress.org/support/topic/great-for-brewers/)󠁿 [brulosopher](https://profiles.wordpress.org/brulosopher/) October 5, 2016 Such a great plugin for displaying recipes in a clean, easy to read way! ![](https://secure.gravatar.com/avatar/86d33c16efb02482f5a867e3ac1df58a5a452b117ed739a1e40cdfacbea106e2? s=60&d=retro&r=g) ### 󠀁[Better than ever!](https://wordpress.org/support/topic/better-than-ever/)󠁿 [Derek Springer](https://profiles.wordpress.org/derekspringer/) September 3, 2016 I wrote this plugin and I think it’s pretty great–it’s the best it’s ever been! [ Read all 9 reviews ](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/) ## Contributors & Developers “BeerXML Shortcode” is open source software. The following people have contributed to this plugin. Contributors * [ Derek Springer ](https://profiles.wordpress.org/derekspringer/) * [ Keith S. ](https://profiles.wordpress.org/zarathos/) “BeerXML Shortcode” has been translated into 3 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/beerxml-shortcode/contributors) for their contributions. [Translate “BeerXML Shortcode” into your language.](https://translate.wordpress.org/projects/wp-plugins/beerxml-shortcode) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/beerxml-shortcode/), check out the [SVN repository](https://plugins.svn.wordpress.org/beerxml-shortcode/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/beerxml-shortcode/) by [RSS](https://plugins.trac.wordpress.org/log/beerxml-shortcode/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.8 * Some potential SSRF fixes. * Better error handling for yeasts that don’t parse cleanly. #### 0.7.1 * Updated XML mime type to avoid blocked XML uploads #### 0.7 [Brülosopher’s](http://brulosophy.com/) Baby * Added ‘mhop’ flag to display hops in metric after a request by Brülosopher 🙂 * Made Miscs section optional using misc=true|false option (defaults to on). * Added Actuals row to Details table using actuals=true|false (defaults to on). * Extended length of Document URL field in Shortcake UI. #### 0.6.1 * Fix for weights improperly swapping at exactly 1 lb/kg. #### 0.6 * Weight will display oz if < 1 lb or g if < 1 kg. * Set mash schedule to default on. * Updated ‘Tested up to’ to 4.4. #### 0.5 * [Shortcake (Shortcode UI)](https://wordpress.org/plugins/shortcode-ui/) integration. When Shortcake is installed you will now be able to insert recipes via the Add Media->Insert Post Element option. Additionally, the BeerXML shortcode will now render in the visual editor. * Moved wp_set_object_terms for post to outside build_style function. Beer Style should now be set for the post even if you choose not to display beer style details. #### 0.4 Tom Sawyer edition: thanks to [ksolomon](https://github.com/ksolomon) and [jksnetwork](https://github.com/jksnetwork) for their pull requests. * Custom taxonomy for the beer style. Creates an archive of all beers added for each style with link to the list of beers for each style. @[ksolomon](https://github.com/dbspringer/beerxml-plugin/pull/5) * Added mash and fermentation details, defaulted to off. To include add mash=true or fermentation=true to shortcode or update the settings in the admin menu. @ [jksnetwork](https://github.com/dbspringer/beerxml-plugin/pull/6) #### 0.3.2 * Added default for miscs that don’t have display_value. #### 0.3.1 * Updated uninstall.php to remove options (including multisite) upon uninstall. * Updated XML retrieval to use wp_remote_get instead of file_get_contents, which caused some folks issues. * Added settings link to plugins page. #### 0.3 * Added Beer Style details section. * Added % to fermentables. * Added XML parsing security update I picked up at WCSF. #### 0.2 * Escaped XML parsing. * Added admin menu to set default values for shortcode. * Tweaked markup and added Miscs, Notes, and Download section. * Added new ‘download’ parameter to shortcode to allow readers to directly download BeerXML file. #### 0.1.1 * Added text/xml as acceptable mime type for BeerXML document self-hosting. #### 0.1 * First cut, allows basic display of details, fermentables, hops, and yeast information in U.S. or metric units. ## Meta * Version **0.8** * Last updated **11 months ago** * Active installations **100+** * WordPress version ** 3.4 or higher ** * Tested up to **6.8.5** * Languages * [Dutch](https://nl.wordpress.org/plugins/beerxml-shortcode/), [English (US)](https://wordpress.org/plugins/beerxml-shortcode/), [German](https://de.wordpress.org/plugins/beerxml-shortcode/), and [Swedish](https://sv.wordpress.org/plugins/beerxml-shortcode/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/beerxml-shortcode) * Tags * [beer](https://pcd.wordpress.org/plugins/tags/beer/)[homebrew](https://pcd.wordpress.org/plugins/tags/homebrew/) [Recipe](https://pcd.wordpress.org/plugins/tags/recipe/)[shortcode](https://pcd.wordpress.org/plugins/tags/shortcode/) * [Advanced View](https://pcd.wordpress.org/plugins/beerxml-shortcode/advanced/) ## Ratings 4.9 out of 5 stars. * [ 8 5-star reviews ](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/?filter=1) [Add my review](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/beerxml-shortcode/reviews/) ## Contributors * [ Derek Springer ](https://profiles.wordpress.org/derekspringer/) * [ Keith S. ](https://profiles.wordpress.org/zarathos/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/beerxml-shortcode/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://wordpressfoundation.org/donate/)