=== Sprint Dotations ===
Contributors: sprintplugins
Tags: equipment, inventory, loans, associations, clubs
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage equipment allocations, loans, returns, deposits, inventory, and member requests for a club or association.

== Description ==

Sprint Dotations helps clubs, associations, and other organizations track equipment allocated or loaned to their members from WordPress.

The plugin provides an equipment catalogue, movement history, inventory tools, and two front-end areas: a member area and an authorized manager area. It works independently and can also be grouped with other Sprint Plugins screens inside the free Sprint Club portal.

= Equipment management =

* Catalog with reference, category, size, condition, availability, and stock quantity.
* Individual and bulk allocations.
* Loans, returns, losses, damage, and decommissioning.
* Reusable allocation templates.
* Optional deposit tracking.
* Seasons and expected return dates.
* Inventory sessions with stock reconciliation.
* Complete movement history and audit log.

= User areas =

* Front-end equipment summary for each user.
* Front-end management area for authorized managers.
* Equipment, return, and issue requests from the member area.
* Printable equipment handover form.
* Optional integration with an existing Gravity Forms form.

= Communication and administration =

* Email notifications and reminders with a delivery log.
* CSV, XLSX, and JSON exports.
* CSV and XLSX imports, plus JSON backup restoration.
* XLSX import/export requires the PHP ZipArchive extension; CSV and JSON remain available without it.
* Diagnostic tools and Site Health integration.
* Essential, Complete, and Expert display modes.
* Compatibility with the central display mode provided by Sprint Club.

= Personal data =

Sprint Dotations stores relationships between WordPress user accounts and their loans, requests, emails, and equipment operations. The plugin integrates with the WordPress personal-data export and erasure tools.

Active loans and unresolved requests may be retained during an erasure request so the organization can recover its equipment and complete ongoing operations. Other information is anonymized whenever possible.

The plugin does not transmit data to an external service.

= Data retention on uninstall =

Data is retained by default to prevent accidental loss. To request complete removal, add the following constant to `wp-config.php` before uninstalling the plugin:

`define( 'SPRINT_DOTATIONS_REMOVE_DATA_ON_UNINSTALL', true );`

== Installation ==

1. Install and activate Sprint Dotations.
2. Open the “Sprint Dotations” menu in the WordPress administration area.
3. Configure the current season, permissions, and stock options.
4. Add equipment manually or use an import file.
5. Review the front-end pages created automatically during activation.

== Frequently Asked Questions ==

= Is Sprint Club required? =

No. Sprint Dotations works independently. Sprint Club can group its screens with other plugins from the Sprint Plugins suite.

= Is Gravity Forms required? =

No. The built-in handover form works without Gravity Forms. The optional integration only lets the site use a form that already exists.

= Can members request equipment? =

Yes, when this feature is enabled in the settings. It can be disabled globally.

= What happens to data when the plugin is uninstalled? =

Data is retained by default. Complete removal must be explicitly enabled with the constant documented in the “Data retention on uninstall” section.

= Does the plugin communicate with an external service? =

No. Data remains inside the WordPress installation, apart from email messages sent through the mail system configured for the site.

== Screenshots ==

1. Dashboard with the main equipment, return, reminder, and allocation indicators.
2. Equipment catalogue with availability, stock level, category, size, and condition.
3. Allocation tracking with return deadlines, overdue items, deposits, and quick actions.
4. Reminder campaigns and delivery monitoring.
5. Settings, notifications, Sprint Club integration, and display modes.
== Changelog ==

= 1.0.0 =
* Initial public release.
