=== Chili Lokal – Opening hours, vacation notice, call button and shop screen ===
Contributors: chilicooperation
Tags: opening hours, business hours, click to call, digital signage, local business
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

For local businesses: opening hours with "open now", vacation notice with substitute, call button and shop screen, all from one set of data.

== Description ==

**Chili Lokal** combines four building blocks that a local business almost always needs. They all use the same master data: name, phone, address and opening hours. You maintain each detail only once. The admin interface is currently in German.

**1. Opening hours**

* Hours per weekday with any number of time slots (for example morning and afternoon, also past midnight)
* Public holidays and special days, one-off or every year
* Display such as "Open now · closes at 18:00" or "Closed now · opens again tomorrow at 9:00"
* The status is calculated in the visitor's browser from the published hours, using the time zone of your site, so pages can be cached
* Shortcodes `[chili_lokal_zeiten]` (table) and `[chili_lokal_status]` (one line)
* Structured data (schema.org LocalBusiness with opening hours), can be switched off

**2. Vacation and absence**

* Date ranges with a type (vacation, company holidays, training) and your own text
* Optional substitute with address, phone and website
* Automatic notice bar at the top of the site, optionally a few days in advance. It disappears by itself after the last day.
* Shortcode `[chili_lokal_abwesenheit]`
* Affects the "open now" display

**3. Floating call button**

* Phone, optionally email, route and WhatsApp (as a wa.me link)
* On mobile only or on all devices, as a round button or as a bar at the bottom edge
* Position and colour can be set, text colour is chosen for good contrast
* Optionally only during opening hours
* Keyboard accessible, with labelled links

**4. Shop screen**

* Its own full-screen address for a TV in the shop or waiting room, reachable through a secret link
* Slides: text, image, opening hours, vacation notice, clock
* Changes slides by itself and picks up edits automatically
* Loads only files from your own website

All features are free with no limits: any number of time slots, special days, absences and slides.

**Limits**

* The plugin does not know public holidays. You enter them yourself as special days.
* The "open now" line, the notice bar and the shop screen need JavaScript. Without it, visitors still see the table of opening hours and the absences.

**Privacy**

* The plugin sets no cookies, stores nothing in visitors' browsers and sends no data to external servers.
* It loads no external fonts, scripts or maps.
* The "route" and "WhatsApp" links lead to third-party services (see "External services"). Whether you offer these contact options is your decision and your responsibility.

**Optional Pro add-on (separate, for businesses only)**

A separate add-on offers multiple locations, multiple screens with a schedule per slide, scheduled notices, several contacts in the button, click counting without personal data, substitution rules and holiday templates per federal state. It is obtained separately from chili-cooperation.com and is sold to businesses only. All features of this plugin stay free and nothing in it is locked. More information: https://chili-cooperation.com/wp-apps/#lokal

**Important notes**

This plugin is a technical tool and not legal, tax or data protection advice. The site operator is responsible for the correctness of opening hours, holidays, absences, substitute and contact details, as well as for the content and image rights of the slides. Use is at your own risk, and the plugin is provided without warranty.

== External services ==

The plugin itself makes no requests to external services. It only creates links that a visitor can click. Data reaches a third party only after a visitor clicks such a link, and only the data contained in the link (the business address or phone number you entered). Which of these links appear depends on your settings.

* **Route link** to Google Maps (`https://www.google.com/maps/`), Apple Maps (`https://maps.apple.com/`) or OpenStreetMap (`https://www.openstreetmap.org/`), as selected in the master data. The link contains your business address. No map is embedded. Terms of use and privacy policies of the providers:
    * Google Maps: [terms of service](https://policies.google.com/terms), [additional terms for Google Maps](https://www.google.com/help/terms_maps/), [privacy policy](https://policies.google.com/privacy)
    * Apple Maps: [terms of use](https://www.apple.com/legal/internet-services/maps/terms-en.html), [privacy policy](https://www.apple.com/legal/privacy/)
    * OpenStreetMap: [terms of use](https://osmfoundation.org/wiki/Terms_of_Use), [privacy policy](https://osmfoundation.org/wiki/Privacy_Policy)
* **WhatsApp link** (`https://wa.me/`), only if you enter a WhatsApp number. The link contains that number. WhatsApp: [terms of service](https://www.whatsapp.com/legal/terms-of-service), [privacy policy](https://www.whatsapp.com/legal/privacy-policy).

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or search for the plugin under "Plugins > Add New".
2. Activate the plugin.
3. In the "Chili Lokal" menu, enter the master data and the opening hours.
4. Place the shortcode `[chili_lokal_zeiten]` on a page.

== Frequently Asked Questions ==

= Does "open now" work with a caching plugin? =
Yes. The page only contains the hours. Whether the business is open right now is calculated by the visitor's browser in your site's time zone.

= What do visitors see without JavaScript? =
The table of opening hours and the absences. The "open now" line, the notice bar and the shop screen need JavaScript.

= How do I enter hours that go past midnight? =
As one time slot, for example 18:00 to 01:00. The slot belongs to the day on which it starts.

= How does the shop screen work? =
Under "Ladenbildschirm" you find a secret link. Open it in the browser of a TV, tablet or mini PC and switch to full screen. The screen regularly checks whether anything has changed.

= Does the plugin know public holidays? =
No. You enter holidays yourself as special days, one-off or every year. Holidays differ by region and sometimes by municipality.

= Does the plugin set cookies or connect to external servers? =
No. It only outputs links (route, WhatsApp) that open a third-party service after a visitor clicks them. See "External services".

== Screenshots ==

1. Notice bar for an absence, opening hours with open/closed status and the floating contact button on a page of the website
2. Master data (business name, phone, email, address)
3. Opening hours with time slots per weekday
4. Vacation and absence list with substitute and effect
5. Settings of the floating call button (contact options, shape, position, colour)
6. Shop screen settings: secret link and slide list

== Changelog ==

= 0.1.0 =
* Initial release.
