=== Hotel Guest Guide – Hotelness ===
Contributors: hotelness
Tags: hotel, guest guide, hospitality, bed and breakfast, multilingual
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create a multilingual guest guide for hotels and rentals, then share it with a downloadable QR code or printable guest sign.

== Description ==

Hotel Guest Guide – Hotelness helps hotels, B&Bs, guesthouses and holiday rentals create one clear guest information page for every stay. Add check-in details, Wi-Fi instructions, breakfast times, parking, accessibility, house rules, local tips, emergency contacts and frequently asked questions, then share the page with a downloadable QR code.

Use the guided setup to create a draft WordPress page automatically, or add the guide manually with a shortcode. Only sections containing information are displayed, so every property can keep the page concise.

= QR code and printable guest sign =

Enter the final public URL of the guide to generate a QR code directly inside the WordPress administration screen. Download it as a high-resolution PNG or scalable SVG, or print an A5 guest sign with the property name and QR code. Generation takes place entirely in the browser: the URL is not sent to an external QR service.

= Available sections =

* Check-in, check-out, reception hours and arrival directions.
* Wi-Fi access, cleaning and in-room amenities.
* Breakfast, restaurant, bar and dietary requirements.
* Accessibility information for entrances, routes, lifts and rooms.
* Services for families and pet policies.
* Parking, electric vehicle charging, shuttles and public transport.
* Pool, spa, gym and wellness bookings.
* Property rules and sustainability guidance.
* Selected places, restaurants and local experiences.
* Emergency details, useful contacts and frequently asked questions.

= Appearance and publishing =

The plugin includes four visual styles: Elegant, Essential, Natural and Inherit from theme. Administrators can choose an accent colour, reorder sections, use an expanded or accordion layout, and publish either the full guide or an individual section.

= Multilingual guides without extra plugins =

Create separate guest content in English, Italian, German, French and Spanish. Place the matching shortcode on each translated page. WPML and Polylang are not required. The administration interface is available in English and Italian.

Full guide:

`[hotelness_info]`

Guide in a specific language:

`[hotelness_info lang="en"]`

Individual section:

`[hotelness_info lang="en" section="stay"]`

Available values for the `theme` attribute are `elegant`, `essential`, `natural` and `inherit`.

= Privacy =

The plugin does not create accounts, use cookies, track visitors or send information to Hotelness or any third-party service. Information entered by an administrator is stored in the site's WordPress database and becomes public only when the shortcode is placed on a public page. QR codes are generated locally in the browser.

The optional Hotelness credit is disabled by default and can be enabled explicitly by an administrator.

For a complete setup walkthrough and practical examples, see the [Hotel Guest Guide documentation](https://hotelness.it/strumenti/plugin-guida-ospiti-hotel/).

== Installation ==

1. Upload the `hotelness-guest-information` folder to `/wp-content/plugins/`, or install the ZIP file from Plugins > Add Plugin.
2. Activate the plugin.
3. Open Hotelness from the WordPress administration menu.
4. Review the available sections, complete the relevant information and choose the appearance.
5. Create a draft guest information page from the Publish step, review it and publish it. You can also add `[hotelness_info]` manually.
6. Return to the Publish step, enter the final page URL and download the QR code or print the guest sign.

== Frequently Asked Questions ==

= Are empty sections displayed? =

No. An enabled section is displayed only when it contains at least one piece of information.

= Can I publish a single section? =

Yes. Use the `section` attribute, for example `[hotelness_info lang="en" section="stay"]`. Stable English identifiers and the supported Italian aliases are accepted.

= Are WPML or Polylang required? =

No. Add the shortcode with the appropriate language to each translated page, for example `[hotelness_info lang="de"]`. If a requested translation is completely empty, the plugin uses the configured fallback language.

= Does the public guide work without JavaScript? =

Yes. All public information remains readable. JavaScript only enhances the accordion and internal navigation behaviour.

= Does the plugin send data to Hotelness? =

No. The plugin makes no external requests and collects no telemetry.

= Is the guide URL sent to a QR code service? =

No. QR code generation runs locally in the browser using a library bundled with the plugin. The URL is not sent to Hotelness or a third-party QR service.

= Which QR code formats can I download? =

You can download a 1200 × 1200 pixel PNG for everyday printing or an SVG for scalable professional artwork. The plugin can also print an A5 guest sign directly from the browser.

= What happens to the data when I uninstall the plugin? =

The data is preserved by default. To remove it during uninstallation, define `HOTELNESS_GUEST_INFORMATION_DELETE_DATA_ON_UNINSTALL` as `true` in `wp-config.php` before deleting the plugin.

== Third-party libraries ==

QR code generation uses qrcode-generator 2.0.4 by Kazuhiko Arase, licensed under the MIT License. Source: https://github.com/kazuhikoarase/qrcode-generator

== Screenshots ==

1. The finished mobile guest guide with practical stay information.
2. Four-step guided configuration with multilingual content and live preview.
3. One-click page creation and local QR code generation in the Publish step.
4. Downloadable QR files and the printable guest sign.

== Changelog ==

= 1.1.0 =

* Added local QR code generation for any public guest guide URL.
* Added high-resolution PNG and scalable SVG downloads.
* Added an A5 printable guest sign using the property name, logo and guide language.
* Added storage and validation of the public guide URL.
* Updated the plugin description, installation guide, FAQ and screenshots for the QR workflow.
* Corrected the top-level administration CSS selectors after the unique-prefix update.

= 1.0.6 =

* Added one-click creation of a draft guest information page from the guided setup.
* Made the manual shortcode an advanced publishing option instead of the primary workflow.
* Improved the plugin name, summary, tags and description so accommodation providers can find its purpose more easily.
* Prepared the administration interface for the standard WordPress translation workflow.
* Added `nofollow` to the optional Hotelness credit link.

= 1.0.5 =

* Replaced short global prefixes with unique Hotelness Guest Information prefixes to prevent conflicts with other plugins and themes.

= 1.0.4 =

* Removed icons from the introductory section navigation for more reliable theme compatibility.
* Strengthened navigation chip alignment and spacing across themes.

= 1.0.3 =

* Prepared the readme and translation loading for WordPress.org requirements.
* Improved icon alignment and removed theme-generated hover underlines from section navigation.

= 1.0.2 =

* Added clearer section progress, sequential navigation and a final review step.
* Improved icon isolation from WordPress theme styles.

= 1.0.0 =

* First complete release for testing and review.
* Added separate guides in English, Italian, German, French and Spanish.
* Added explicit shortcode language selection, whole-guide fallback and content duplication between languages.
* Added English and Italian administration interfaces.
