=== TallOrder Menu ===
Contributors: tallorderpos
Tags: restaurant, menu, food menu, hospitality, online ordering
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show your TallOrder menu on your site: always the same as your table QR codes, with Order online when you take orders.

== Description ==

For restaurants, cafés, bars and shops that use **TallOrder**. Put your menu on your site: the same one guests see on your table QR codes, at the same moment. Change a price or switch an item off in TallOrder and your site follows.

* **The real menu.** Headings, items, prices, photos, sizes and options, per location. Give an area (say the patio) and it shows that area's menu.
* **Honest allergens.** Allergens and diet tags as you set them in TallOrder. An item with no tags says so, and is never shown as "free from".
* **Languages.** Shows your menu in the languages you offer, and guests can switch.
* **Your colours.** The menu uses your venue's brand from TallOrder, or a colour you choose.
* **Order online.** When you take orders online, an Order online button opens your my.tallorder.app page (Shop online for shops). When you don't, there's no button.
* **A block and a shortcode.** The "TallOrder menu" block in the editor, or `[tallorder_menu]` anywhere else: classic editor, page builders, widgets.
* **Light.** The menu script loads only on pages that show the menu.
* **Measurable.** With Google Tag Manager on your site, the menu pushes `tallorder_menu_ready`, `tallorder_menu_item_viewed` and `tallorder_menu_order_clicked` to the dataLayer, never with a guest's details.

You need a TallOrder account with QR menus switched on for your location (or the online shop, for a shop). Your location ID is in the TallOrder portal under Brand & venue › Website & social.

Use TallOrder Reservations too? Both plugins share one script, and the menu uses the Reservations plugin's location ID when you haven't set one here.

= Shortcode =

`[tallorder_menu]` uses the location ID from Settings › TallOrder Menu. Options:

* `mode`: `popup` (a link that opens the menu, the default) or `inline` (the menu in the page)
* `label`: the link text, e.g. `label="See the menu"`
* `area`: an area's menu, e.g. `area="8"`
* `lang`: open in a language, e.g. `lang="af"`
* `heading`: open at a heading, e.g. `heading="cocktails"`
* `color`: accent colour, e.g. `color="#2ba7b8"`
* `source`: carried onto orders placed from the menu, e.g. `source="facebook"` (default `website`)
* `location`: another location's ID, for a group with several venues

Example: `[tallorder_menu mode="inline" area="8"]`

== External services ==

This plugin shows TallOrder's menu page on your site, and checks your location ID with TallOrder.

* **The menu widget.** On pages that show the menu, your visitors' browsers load TallOrder's widget script from `https://menu.tallorder.app/v1/embed.js`, and the menu page from `menu.tallorder.app` inside a frame. The menu page reads your menu from TallOrder's API; a visitor's browser sends only your location ID and the language shown. Nothing about your visitors is sent to or stored on your site.
* **Checking your location ID.** On the plugin's settings page and in the block editor, your site asks TallOrder's API (`https://q2iwmy5kbc.eu-west-1.awsapprunner.com/tallorder-integration-service/v1/customer/location-settings`) for your location's public details: your venue's name, and whether QR menus or the online shop are on. Only the location ID is sent. The answer is cached on your site for 12 hours.

TallOrder's terms and conditions: https://www.tallorderpos.com/terms-and-conditions/
TallOrder's privacy policy: https://www.tallorderpos.com/privacy-policy/

== Installation ==

1. Install the plugin from Plugins › Add New, or upload the zip, and activate it.
2. Go to Settings › TallOrder Menu and enter your location ID. The page confirms which venue's menu it shows.
3. Add the "TallOrder menu" block to a page, or paste `[tallorder_menu]`.

== Frequently Asked Questions ==

= Where do I find my location ID? =

In the TallOrder portal: Brand & venue › Website & social. It's two numbers joined by a dash, like `31-27`. For an area's menu, add the area: `31-27-8`.

= Can I show a different menu per area? =

Yes. Set the area on the block, or use `[tallorder_menu area="8"]`. Each area shows the menu its table QR codes show.

= Will prices on my site be out of date? =

No. It's the same menu as your table QR codes, refreshed about every minute.

= Does it slow my site down? =

Only pages that show the menu load its script, and the menu loads in a frame after your page.

= Does it store anything about my visitors? =

No. The menu runs on TallOrder's site inside a frame. Your site stores only the plugin's settings and the cached location check.

= What if a visitor has JavaScript turned off? =

The link opens your menu page on menu.tallorder.app, so it still works.

== Screenshots ==

1. The menu in a page.
2. An item opened, with its sizes, options and allergens.
3. The "TallOrder menu" block in the editor.
4. Settings › TallOrder Menu, confirming the venue.

== Changelog ==

= 1.0.0 =
* First release: the block, the `[tallorder_menu]` shortcode and the settings page.
