=== Vidal Promise Box ===
Contributors: jmvidal2013
Tags: bible, bible promises, daily verse, devotionals, christian
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 8.2
Stable tag: 1.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An animated treasure chest revealing one of 365 daily Bible promises on a parchment card. 100% free, private and local: no accounts, no telemetry.

== Description ==

Vidal Promise Box brings the traditional Christian promise box experience to WordPress with a premium, hand-crafted design — and it is completely free.

Tap the treasure chest and its lid swings open in 3D: light pours out, a parchment scroll rises, and today's Bible promise appears on an elegant card. One promise per day, drawn from a library of **365 promises — one for every day of the year**.

A premium gift from Vidal Digital: every visitor gets the full experience at no cost. The plugin works entirely on your WordPress installation. It does not require an account, does not use artificial intelligence, does not send telemetry, and does not contact external services.

**Note:** the promise library included with this plugin is in Spanish (365 promesas bíblicas en español).

Features include:

* Elegant animated treasure chest with 3D opening lid, golden light rays, and rising parchment scroll.
* 365 Bible promises — a different promise for each day of the year, one per visitor per day.
* Interactive promise card styled as fine parchment.
* Daily and random promises.
* Local Bible promise library with categories, audiences, and needs.
* Reflections, prayers, and practical applications.
* Favorites and recent-history storage in the visitor's browser.
* Browser-based text-to-speech when supported by the device.
* Sharing through the browser's native sharing tools.
* Devotional plans.
* Bible library and Sunday School resources.
* Administrative promise editor.
* Optional complete data removal during uninstall.

Shortcodes:

* `[vidal_promise_box]`
* `[vidal_bible_library]`
* `[vidal_sunday_school]`

Official website and support: https://vidaldigitalmiami.com/plugins/vidal-promise-box/

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the ZIP from Plugins > Add New.
2. Activate Vidal Promise Box.
3. Add `[vidal_promise_box]` to a page or post.
4. Configure the plugin under Vidal Promise Box in the WordPress dashboard.

== Frequently Asked Questions ==

= Does the plugin send information to an external server? =

No. This edition does not include telemetry, artificial intelligence, licensing calls, cloud synchronization, or external API requests.

= Where are favorites and history stored? =

For visitors who are not signed in, favorites and recent history are stored in the browser. The plugin does not create a personal profile from this information.

= Does it create audio files? =

No. The audio feature uses the browser's speech synthesis when available and does not upload or store audio files.

= Can I add my own promises? =

Yes. Administrators can create and edit promises from the WordPress dashboard.

= Which Bible translation is included? =

The bundled content is marked as public-domain source material. Site administrators are responsible for ensuring that any additional translation they enter or import is properly licensed.

== Privacy ==

Vidal Promise Box does not send personal data to Vidal Digital or any external service. Anonymous visitors may receive a one-way local visitor hash used only to avoid immediate repetition and aggregate local interactions. Favorites and recent history are stored in the visitor's browser. Administrators may remove all plugin data through the uninstall setting.

== Changelog ==

= 1.2.4 =
* Simplified experience like the VidalPress edition: just the elegant treasure chest, the promise of the day on a parchment card, and "come back tomorrow". Removed the related-promise cards, action buttons (reflection, prayer, application, listen, save, share), filter selects, and the random "another promise" button.
* The chest design now matches the elegant VidalPress edition.

= 1.2.3 =
* The promise library now ships all 365 daily promises (one for every day of the year), matching the VidalPress edition.
* New "promise of the day" logic: each visitor receives the day's promise, with the day index computed in the visitor's browser from the real date (never frozen by page cache).
* Existing installations automatically receive the new promises on update; duplicates are skipped.
* Fully free: the complete 365-promise library and the elegant chest design are included for everyone.

= 1.2.2 =
* Internal preparation for the 365-promise daily library (VidalPress edition now ships exactly 365 unique promises).
* No functional changes in this WordPress edition.

= 1.2.1 =
* Completed a full WordPress.org compliance pass.
* Removed inactive AI and cloud remnants from the free edition.
* Improved escaping, translation readiness, admin notices and direct-access protection.
* Removed unnecessary rewrite flushing and manual translation loading.


= 1.2.0 =
* Renamed the plugin to Vidal Promise Box and aligned the WordPress.org slug, text domain, author links, and contributor metadata.
* Added direct-access protection to executable PHP files.
* Hardened template output buffering so every buffer is closed in the same execution flow.
* Updated the official plugin and author URLs to vidaldigitalmiami.com.

= 1.1.1 =
* Completely replaced the previous CSS chest with a new locally bundled SVG illustration.
* Added curved lid, engraved wood, gold hardware, illuminated interior and animated parchment.
* Added mobile and reduced-motion variants for the new premium chest.
* Bumped asset versions to prevent stale cached frontend files.

= 1.1.0 =
* New modern chest experience with lightweight CSS animations.
* Redesigned promise card, filters, actions, dark theme support and mobile layout.
* Improved accessibility and reduced-motion support.
* Fixed “Another promise” so it bypasses daily mode.
* Improved spoken Bible references for browser audio.

= 1.0.1 =
* Fixed a fatal activation error caused by an incorrect autoloader namespace.
* Verified class resolution for the Lite plugin namespace.


= 1.0.0 =
* Initial WordPress.org edition.
* Added local promise box, library, devotional plans, favorites, history, sharing, and browser audio.
* Removed AI, private updates, licensing, telemetry, and cloud synchronization.
* Added Vidal Digital author and support website metadata.
