<p align="center">
  <img src="assets/images/librebite-logo.png" alt="Libre Bite Logo" width="200">
</p>

# Libre Bite

**Die WooCommerce-Erweiterung für Restaurants, Take-Aways, Cafés und Bars.**

[![Stable Tag](https://img.shields.io/badge/stable-1.2.8-blue.svg)](https://github.com/simurech/libre-bite/releases)
[![WordPress](https://img.shields.io/badge/WordPress-6.0%2B-21759b.svg)](https://wordpress.org/)
[![WooCommerce](https://img.shields.io/badge/WooCommerce-8.0%2B-96588a.svg)](https://woocommerce.com/)
[![PHP](https://img.shields.io/badge/PHP-7.4%2B-8892be.svg)](https://php.net/)
[![Lizenz](https://img.shields.io/badge/Lizenz-GPL--2.0--or--later-green.svg)](https://www.gnu.org/licenses/gpl-2.0.html)

> Stressfreier Service, volle Teller, glückliche Gäste — Libre Bite ist das WooCommerce-Plugin für Restaurants, Take-Aways und Cafés, die ihre Bestellungen direkt und provisionsfrei abwickeln wollen. Deine Daten bleiben in deiner eigenen WordPress-Installation. Keine Plattformgebühren. Kein Vendor-Lock-in.

---

## Kostenlos starten — Abo nur für Premium-Features

**Libre Bite ist vollständig kostenlos nutzbar.** Alle Kernfunktionen — Kassensystem, Bestellboard, Standortverwaltung, Produkt-Add-ons, Zeitfenster — sind ohne Abo verfügbar.

Ein Abo (Libre Bite Pro) ist nur dann erforderlich, wenn du erweiterte Funktionen wie Mehrstandort-Verwaltung, optimierten Checkout, Trinkgeld, Tischbestellung (QR-Code) oder Abholungserinnerungen nutzen möchtest. Die Pro-Preise sind bewusst günstig gehalten — ein Bruchteil der Provisionen, die Lieferplattformen monatlich einbehalten.

**7 Tage Pro gratis testen — ohne Zahlungspflicht.**

---

## Aufgebaut auf WordPress & WooCommerce

Libre Bite ist ein **WordPress-Plugin** und baut vollständig auf **WooCommerce** auf — dem meistgenutzten Open-Source-Shop-System der Welt.

Das bedeutet für dich:
- **Keine neue Plattform lernen** — du arbeitest in deinem vertrauten WordPress-Dashboard.
- **Deine Produkte bleiben WooCommerce-Produkte** — du pflegst sie einmal, sie sind sofort im POS, Checkout und Online-Shop verfügbar.
- **Zahlungen über jeden WooCommerce-kompatiblen Payment-Gateway** — bar, Karte, Twint, PayPal, Stripe oder jeden anderen Gateway, den du bereits nutzt. Libre Bite erhebt dabei **keine Transaktionsgebühren**.
- **Offline-Zahlungen ebenfalls möglich** — «Barzahlung», «Kartenzahlung bei Abholung» oder eigene Zahlungsarten über WooCommerce-Standard.

---

## Für wen ist Libre Bite?

Libre Bite wurde für **Kleinstbetriebe** im Gastgewerbe entwickelt — Betriebe, die eine ernsthafte Software brauchen, aber keine Enterprise-Kosten stemmen können oder wollen.

| Betriebsart | Was Libre Bite bringt |
|---|---|
| Restaurant | Volle Teller ohne Provisionen — Bestellungen direkt, Küche informiert, Gäste zufrieden |
| Take-Away / Schnellgastronomie | Schneller Thekenverkauf mit POS, Twint & Karte akzeptieren, keine Drittgebühren |
| Café / Bar | Extras, Trinkgeld und Tagesgeschäft ohne Mehrfach-Tools verwalten |
| Gastrobetrieb mit mehreren Standorten | Alle Filialen aus einer WordPress-Installation — eigenes Kanban und POS pro Standort (Pro) |

---

## Modular — nur aktivieren, was du brauchst

Libre Bite ist vollständig modular aufgebaut. Du aktivierst im Admin-Bereich nur die Module, die dein Betrieb tatsächlich benötigt — alles andere bleibt ausgeblendet. Keine überflüssigen Menüpunkte, keine unerwünschten Funktionen.

---

## Funktionen

### Kostenlose Funktionen

| Funktion | Beschreibung |
|---|---|
| **Live Kanban-Bestellboard** | Echtzeit-Bestellkarten, Drag-&-Drop-Statusaktualisierung (Neu → In Bearbeitung → Bereit → Abgeschlossen) |
| **Integriertes Kassensystem (POS)** | Browserbasierte Kassenoberfläche für Lauf- und Thekenkundschaft |
| **Standortverwaltung** | Filiale mit Adresse, Öffnungszeiten und Bestellweiterleitung |
| **Schweizer 5-Rappen-Rundung** | Automatische Rundung auf 5 Rappen für CHF-Barzahlungen |
| **Zeitfenster im Checkout** | Kunden wählen ein Abholungs- oder Lieferzeitfenster beim Bestellen |
| **Produkt-Add-ons** | Konfigurierbare Extras pro Produkt (Toppings, Saucen, Grössen) mit Preisaufschlägen |
| **Modulsteuerung** | Nur die Funktionen aktivieren, die der Betrieb wirklich braucht |
| **HPOS-kompatibel** | Vollständig getestet mit WooCommerce High-Performance Order Storage |

### Pro-Funktionen (Abo erforderlich)

| Funktion | Beschreibung |
|---|---|
| **Tischbestellung (QR-Code)** | QR-Codes pro Tisch, Gäste bestellen direkt am Tisch ohne Adressfelder |
| **Mehrstandort-Verwaltung** | Beliebig viele Filialen, jede mit eigenem Kanban-Board und POS |
| **Optimierter Bestellvorgang** | Konversionsorientierter Checkout für Gastronomiebetriebe |
| **Erweitertes Trinkgeldsystem** | Prozentuale Vorschläge + freie Eingabe, pro Bestellung gespeichert |
| **Automatische Abholungserinnerungen** | E-Mail-Erinnerungen X Minuten vor geplantem Abholzeitpunkt |
| **Nährwertangaben & Allergenkennzeichnung** | EU-konforme Kennzeichnung auf Produktseiten und im Checkout |
| **Erweiterte Sound-Benachrichtigungen** | Browsersignal bei neuer Bestellung, pro Standort konfigurierbar |

---

## Zahlungen

Libre Bite integriert **keine eigene Zahlungsabwicklung**. Alle Zahlungen laufen über WooCommerce-Standard-Gateways:

- **Bar / Offline** — Kunden bezahlen bei Abholung oder am Tisch
- **Karte, Twint, PayPal, Stripe** — über die jeweiligen WooCommerce-Plugins
- **Jeder andere WooCommerce-kompatible Gateway** — du bist vollständig frei in der Wahl

**Libre Bite erhebt keine Transaktionsgebühren.** Du zahlst ausschliesslich das Abo für Pro-Features.

---

## Architektur

Libre Bite verwendet eine modulare, klassenbasierte Architektur. Jeder Funktionsbereich ist ein eigenes Modul, das basierend auf den Admin-Einstellungen bedingt geladen wird.

```
libre-bite/
├── libre-bite.php          # Plugin-Bootstrap, Freemius-Init
├── includes/
│   ├── core/               # Installer, Loader, Konstanten
│   ├── admin/              # Admin-Menüs, Einstellungsseiten
│   ├── modules/            # Funktionsmodule (Kanban, POS, Standorte, Checkout …)
│   └── frontend/           # Checkout-Hooks, öffentliche Ausgabe
├── assets/
│   ├── css/                # Admin- und Frontend-Stylesheets
│   └── js/                 # Kanban Drag & Drop, POS-Oberfläche, Checkout-Skripte
└── vendor/
    └── freemius/           # Freemius SDK (Lizenz- und Abonnementverwaltung)
```

---

## Gerät & Betrieb

### Gerätekompatibilität

Libre Bite funktioniert auf jedem Gerät — keine App-Installation nötig. Die Bestellübersicht (Kanban-Board), das Kassensystem (POS) und die Reservierungsübersicht sind für Touch-First-Bedienung optimiert und eignen sich gut für ein Tablet, das an der Theke oder im Küchenbereich montiert ist.

### Betriebsmodelle

**Option 1 — Bestehende Website erweitern**
Das Plugin lässt sich in jeden bestehenden WordPress/WooCommerce-Shop integrieren. Jedes Theme ist kompatibel — keine Änderungen am Design nötig.

**Option 2 — Eigenständige Installation (Subdomain)**
Als eigene Installation betreiben, z. B. auf einer Subdomain wie `order.meinrestaurant.ch` — komplett unabhängig vom Hauptauftritt, nur für den Gastronomie-Betrieb.

**Option 3 — Managed Hosting durch Libre Bite**
Libre Bite übernimmt die komplette Einrichtung: Installation, Konfiguration, Hosting und laufende Wartung — von A bis Z. Kostenpflichtig. Kontakt via [GitHub](https://github.com/simurech/libre-bite).

---

## Systemanforderungen

| Komponente | Minimum | Empfohlen |
|---|---|---|
| WordPress | 6.0 | Aktuellste Version |
| WooCommerce | 8.0 | Aktuellste Version |
| PHP | 7.4 | 8.1+ |
| MySQL | 5.6 | 8.0+ / MariaDB 10.4+ |

---

## Installation

**Über WordPress.org (empfohlen):**
1. Im WordPress-Dashboard zu **Plugins → Installieren** navigieren.
2. Nach „Libre Bite" suchen.
3. Auf **Jetzt installieren** klicken, dann **Aktivieren**.

**Manuelle Installation via GitHub:**
1. Die neueste Release-`.zip` von der [Releases-Seite](https://github.com/simurech/libre-bite/releases) herunterladen.
2. In WordPress zu **Plugins → Installieren → Plugin hochladen** navigieren.
3. Die `.zip`-Datei hochladen und aktivieren.

**Nach der Aktivierung:**
1. Sicherstellen, dass WooCommerce aktiv ist.
2. Im Admin-Menü zu **Libre Bite** navigieren.
3. Benötigte Module aktivieren und Standort(e) konfigurieren.

---

## Screenshots

> Screenshots befinden sich im `assets/`-Verzeichnis auf der WordPress.org-Plugin-Seite.

| Nr. | Beschreibung |
|---|---|
| 1 | Kanban-Bestellboard — Echtzeit-Küchenanzeige |
| 2 | Kassenoberfläche (POS) — Thekenbestellerfassung |
| 3 | Standorteinstellungen — Filialadresse und Öffnungszeiten |
| 4 | Zeitfenster im Checkout — Kundenauswahl des Abholzeitfensters |
| 5 | Produkt-Add-ons — konfigurierbare Extras pro Menüpunkt |
| 6 | Moduleinstellungen — Funktionen nach Bedarf ein-/ausschalten |

---

## Roadmap

| Feature | Status |
|---|---|
| Öffnungszeiten: 2 Zeitfenster pro Tag (Mittagspause) | Geplant |
| Öffnungszeiten: Feiertage (zentral, pro Standort wählbar) | Geplant |
| Öffnungszeiten: Google Maps API-Integration | Geplant (Pro) |
| Zeitslots: Blocker (erste/letzte Bestellung n Minuten nach/vor Öffnung) | Geplant (Pro) |
| Rechteverwaltung pro Standort (POS + Kanban) | Geplant (Pro) |
| Vorbestellungen: ausgegraut + gesperrt + Sichtbarkeits-Checkbox | Geplant (Pro) |
| Optimierter Checkout: Beleg-Frage entfernen, Buttons auf Bestätigungsseite | Geplant (Pro) |
| Beleg nachträglich per E-Mail senden (aus Bestellansicht) | Geplant (Pro) |
| Trinkgeld: Fixbeträge + konfigurierbare Texte/Titel | Geplant (Pro) |
| Reservierungen: Tischübersicht, Auto-Freigabe, Zeitfenster, Auto-Zuweisung | Geplant (Pro) |
| Branding-Ausbau (Farbpresets, Live-Vorschau) | Geplant (v2.0) |

---

## Freemius & Datenschutz

Libre Bite nutzt [Freemius](https://freemius.com) für die Verwaltung von Pro-Lizenzen und die Bereitstellung von Plugin-Updates für zahlende Abonnenten. Die Freemius-Integration ist **ausschliesslich Opt-in** — es werden keine Daten übermittelt, solange du bei der Plugin-Aktivierung nicht aktiv zustimmst.

Bei erteilter Zustimmung erfasst Freemius grundlegende Informationen zur Website-Umgebung (WordPress-Version, PHP-Version, Liste aktiver Plugins) für die Lizenzvalidierung und Nutzungsanalyse. Es werden keinerlei Bestell-, Kunden- oder Produktdaten übertragen.

- [Datenschutzerklärung von Freemius](https://freemius.com/privacy/)
- [Nutzungsbedingungen von Freemius](https://freemius.com/terms/)

---

## Lizenz

**Libre Bite** steht unter der [GNU General Public License v2.0 oder später](https://www.gnu.org/licenses/gpl-2.0.html).

**Autor:** Simon Urech — [@simurech](https://github.com/simurech)
