Tlloancy Kitchen Line

By Thomas Lloancy

0+ active installationsVersion 1.0.2

Order fulfillment (takeaway / dine-in / delivery) and a kitchen display board for WooCommerce. Soft-enhances Tlloancy Step Configurator when present.

Description

Tlloancy Kitchen Line keeps product configuration and kitchen logistics apart:

  • Customer chooses fulfillment on the configurator summary (or at checkout)
  • Pickup slots with cutoff rules, closed dates and an optional orders-per-slot limit
  • Fullscreen kitchen board: New → Prep → Ready → Done
  • Works standalone with WooCommerce (classic checkout); richer tickets when TLSC is active
  • Dedicated Kitchen staff role for the kitchen tablet

Clear how-to guides (shipped in the plugin):

  • docs/MODE-DEMPLOI.md (French)
  • docs/USER-GUIDE.md (English)

Installation

  1. Upload the plugin folder to wp-content/plugins/
  2. Activate Tlloancy Kitchen Line
  3. WooCommerce → Kitchen Line for settings
  4. WooCommerce → Kitchen Board for the display
  5. Read docs/MODE-DEMPLOI.md or docs/USER-GUIDE.md for the full walkthrough

FAQ

Does it require Tlloancy Step Configurator?

No. With TLSC, fulfillment appears on the wizard summary. Without TLSC, fields appear at checkout.

Where is the user guide?

In the plugin folder: docs/USER-GUIDE.md (EN) and docs/MODE-DEMPLOI.md (FR).

Does it work with the Checkout block?

With Tlloancy Step Configurator, yes: mode and slot are collected in the wizard and travel with the cart. Without it, the fulfillment fields are added to the classic checkout only. If your checkout page uses the Checkout block, a warning is shown on the settings page: use the [woocommerce_checkout] shortcode instead.

Who can open the kitchen board?

Admins and Shop managers, and anyone with the tllokili_use_board capability. On activation the plugin creates a Kitchen staff role that can only open the board. If the plugin was already active, deactivate and reactivate it once to create the role.

Which orders appear on the board?

Paid orders (processing, on-hold, completed). An order with a pickup slot shows on the day of its slot; an order without a slot (dine in) shows on the day it was placed. Use the tllokili_board_statuses filter to change the statuses.

What happens when the cart has several modes?

The latest Kitchen Line choice wins. Earlier lines in the cart are rewritten to that mode and slot. Takeaway and dine-in stay on local pickup. Delivery uses a WooCommerce shipping method (cost can be 0).

What if no shipping rate matches the mode?

Takeaway and dine-in keep local pickup rates, delivery drops them. If that would leave no rate at all (for example no local pickup configured), all rates are kept so checkout is never blocked.

Where are the translations?

English is the source language in the code. French ships in languages/tlloancy-kitchen-line-fr_FR.po.

Where is fulfillment stored?

Order meta _tllokili_mode, _tllokili_slot, _tllokili_slot_label, _tllokili_status.

Changelog

1.0.2

  • Kitchen board: a lost connection now shows a banner and keeps retrying; an expired session or security token reloads the page instead of freezing on stale tickets.
  • Kitchen board: orders are shown on the day of their pickup slot (or the day they were placed when there is no slot), no longer mixing today’s and tomorrow’s orders; no more 80-order cap; tickets sorted by pickup time.
  • Kitchen board: unpaid (pending) orders no longer appear or beep.
  • Kitchen board: tickets now show quantities, customer name, customer note and variations / add-ons of plain WooCommerce lines; the order total no longer shows a raw €.
  • Kitchen board: the board only redraws when something changed (taps are no longer lost), requests no longer overlap, polling pauses in a hidden tab, new Back button, sound unlocked with a first tap (Enable sound button), no false beep when changing day or filter.
  • New dedicated capability tllokili_use_board and a Kitchen staff role: kitchen tablets no longer need a Shop manager account.
  • Standalone checkout (without TLSC): mode and slot are now saved on the order. A warning is shown when the checkout page uses the Checkout block.
  • Cart and Checkout blocks: the fulfillment held in the cart is re-validated at checkout; orders are hydrated through the Store API too.
  • Declared compatibility with High-Performance Order Storage and Cart/Checkout blocks.
  • Slots: slots already past (same-day pickup) and full slots are no longer offered.
  • New settings: closed dates, orders per slot, optionally complete the WooCommerce order when a ticket reaches Done. Pickup window times are validated.
  • Order labels: a mode switched off later is still shown with its proper name; “Fulfillment” and “Pickup” order line labels are translatable.
  • Shipping: delivery / pickup filtering never removes every rate.
  • Added uninstall.php (settings, role and capability are removed; order meta is kept). Legacy pre-release settings are migrated once instead of on every read.

1.0.1

  • The latest fulfillment choice is copied onto earlier Kitchen Line lines in the cart.
  • Takeaway and dine-in keep the local pickup rate. Delivery drops pickup rates.
  • French translation is loaded from languages/tlloancy-kitchen-line-fr_FR.mo.

1.0.0

  • Initial release: fulfillment bridge, slots, kitchen board REST + UI
  • WordPress.org review: prefix tllokili, no bundled .po/.mo