# Basketball Scorebook for WordPress

[🇯🇵 日本語のドキュメント (Japanese Docs)](./README.ja.md)

[![WordPress Plugin](https://img.shields.io/wordpress/v/basketball-scorebook.svg)](https://wordpress.org/plugins/basketball-scorebook/)
[![GPLv2 License](https://img.shields.io/badge/license-GPLv2-blue.svg)](https://www.gnu.org/licenses/gpl-2.0.html)

**A professional, lightweight digital basketball scorebook with timestamps, running scores, and PDF export.**

Perfect for coaches, table officials, and fans who want more than just a simple scoreboard.

---

## 🏀 Live Demo & Usage
Experience the full functionality without installation:
- **English Demo:** [https://doc778.com/scorebook-en](https://doc778.com/scorebook-en)
- **Japanese Demo:** [https://doc778.com/scorebook/](https://doc778.com/scorebook/)
- **Usage Guide:** [https://doc778.com/help-scorebook-en](https://doc778.com/help-scorebook-en)

---
![Basketball Scorebook Dashboard](https://doc778.com/wp-content/uploads/2025/12/image-1.png)
---

## ✨ Key Features

* **Real‑time Scoring:** Quick input for 2P, 3P, and FT. Player statistics are auto-calculated.
* **Timestamped Events:** Automatically records the exact time of every foul, timeout, and score.
* **Running Score Visualization:** Professional tracking of game flow (1–160 pts).
* **Print & PDF Ready:** Optimized for A4 landscape printing or saving as PDF via the browser.
* **Data Safety:** Auto-saves to browser `LocalStorage`. Support for JSON Import/Export for manual backups.
* **No Database Bloat:** Runs entirely client-side (Alpine.js), keeping your WordPress database clean.

## 🚀 Installation

1.  Download the repository and upload the `basketball-scorebook` folder to `/wp-content/plugins/`.
2.  Activate the plugin in your WordPress dashboard.
3.  Add the shortcode `[basketball_scorebook]` to any page.
    * *Tip: Use a "Full-Width" template for the best experience.*

## 🛠 Tech Stack
- **Alpine.js:** For fast, reactive client-side data handling.
- **Tailwind CSS:** For a modern, responsive UI.
- **WordPress API:** For seamless integration.

## 📄 License
Licensed under the [GPLv2 or later](https://www.gnu.org/licenses/gpl-2.0.html).