=== ButterMenus for Toast ===
Contributors: briankerrdesign
Donate link: https://buttermenus.com
Tags: toast, restaurant, menus, shortcode, food
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.7.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Display live Toast POS menus on your WordPress site using a simple shortcode. No manual menu updates required.

== Description ==

**ButterMenus** is a WordPress plugin that connects your website directly to Toast POS, allowing restaurants to display up-to-date menus automatically.

Once configured, ButterMenus fetches menu data from Toast’s API and renders it cleanly on the frontend using a shortcode. Update your menu in Toast, and your website updates automatically—no copy-and-paste, no outdated menus.

The plugin is lightweight and built with caching to minimize API requests.

** Features:**
* Display a specific Toast menu by ID
* Match your existing fonts & style
* SEO optimized formatting
* Built-in caching for performance
* Shortcode-based output for flexibility
* Customizable frontend styling via CSS
* Secure API authentication

**PRO Features:**
* Use shortcodes to display multiple menus by ID
* Filter menu groups and sections by ID
* Optional item images
* Customizable price leaders, item tags, pricing, and more

**PRO (Multilocation):**
* Display menus with multiple locations

Upgrade to [ButterMenus PRO](https://buttermenus.com/pricing)

**Important:**  
ButterMenus is a third-party plugin and is not affiliated with, endorsed by, or sponsored by Toast, Inc.

== Installation ==

1. Upload the `butter-menus` folder to the `/wp-content/plugins/` directory, or install via the WordPress Plugins screen.
2. Activate the plugin through the “Plugins” menu in WordPress.
3. Go to **ButterMenus → Settings** in the WordPress admin.
4. Enter your Toast API credentials, Restaurant GUID, and display options.
5. Save settings.

== Usage ==

Use the shortcode below on any page or post:

[butter_menu]

**[ButterMenus PRO](https://buttermenus.com/pricing) Shortcode Options:**

[butter_menu 
    id="MENU_ID"
    images="true"
    groups="GROUP_ID_1,GROUP_ID_2"
    title="Optional Title"
    ....
]

Parameters:
* id (required): Toast Menu ID
* groups (optional): Comma-separated list of specific sub-menu group (section) IDs
* title (optional): Override menu title or set to "" to hide
* descriptions (optional): Show item descriptions (default: true) 
* prices (optional): Display prices (default: true) 
* leaders (optional): Display price leaders (...) (default: true) 
* calories (optional): Display item calories (default: false) 
* images (optional): Display item images (default: false)
* center (optional): Center the menus / text (default: false)
* cards (optional): Show menu items as cards (default: false)


== Frequently Asked Questions ==

= Does this update automatically when I change my menu in Toast? =
Yes. Menu data is pulled directly from Toast’s API and refreshed based on caching rules.

= Can I show only part of a menu? =
Yes. Use the groups shortcode parameter to limit which menu groups are displayed. (PRO)

= Is this plugin affiliated with Toast? =
No. ButterMenus is an independent, third-party plugin.

= Is this plugin free? =
This version is free. If you want to display multiple menus, and customize more, get [ButterMenus PRO](https://buttermenus.com/pricing)

== Screenshots ==

1. ButterMenus admin dashboard showing fetched menus
2. Plugin settings to add Toast API credentials
3. Frontend menu - Standard view
4. Frontend menu - With added images (PRO)
5. Frontend menu - Card view (PRO)
6. Frontend menu - Listed view (PRO)

== Changelog ==
= 1.7.0
* Codebase update
* Minor fixes

= 1.6.3
* Minor fixes

= 1.6.2
* Minor fixes

= 1.6.1
* Price display for under description
* Minor fixes

= 1.6.0
* Multiple location support (PRO)
* Minor fixes

= 1.5.0
* Name and slug updated
* Minor fixes

= 1.4.1 =
* Sized pricing fix

= 1.4.0 =
* Outside audit fixes

= 1.3.1 =
* Minor fixes

= 1.3 =
* Added limiting for tags (PRO)
* Minor fixes

= 1.2 =
* Added support for item tags (PRO)
* Added support for size based pricing
* Minor fixes

= 1.1 =
* Added default font styles
* Added price decimal option
* Minor fixes

= 1.0 =
* Initial release
* Toast API authentication
* Menu fetching and caching
* Shortcode rendering
* Admin dashboard
* Image support
* Group filtering
* Cache clearing tools
