説明
Basketball Scorebook は、WordPress サイト内でショートコードを使って動作する軽量なシングルページアプリケーションです。プロのテーブルオフィシャルのような精度でバスケットボールの試合をデジタル記録できます。
従来の紙のスコアブックとは異なり、この「RecordedScorebook」は多くのイベント(得点、ファウル、タイムアウト)の タイムスタンプ を記録し、試合の完全なタイムラインを提供します。
主な機能:
- リアルタイム得点記録: 2P、3P、FTを入力。選手統計は自動計算
- タイムスタンプ記録: すべてのファウルとタイムアウトを正確な試合時間で記録
- ランニングスコア: 1〜160点のビジュアルランニングスコア表示 (時間と選手番号付き)
- 印刷対応: A4 横向き用紙に最適化。ブラウザから PDF 保存可能
- データ永続化とバックアップ: ブラウザの LocalStorage に自動保存されるため、不意のページ更新でもデータは失われません。ただし、ブラウザのキャッシュ削除や端末故障に備え、重要な試合では「JSON エクスポート」機能による外部保存を強く推奨します。
- JSON入出力: 試合データを JSON ファイルとして保存、共有、テンプレート化可能
- データベース不使用: すべてクライアント側 (Alpine.js) で処理。WordPress データベースに負荷なし
使い方:
ページや投稿に [basketball_scorebook] ショートコードを追加するだけです。
最適な体験のため、「全幅」ページテンプレートの使用を推奨します。
デモと使い方ガイド
プラグインをインストールせずに全機能を試せる公式デモサイト:
デモ URL: https://doc778.com/scorebook/
使い方ガイド: https://doc778.com/help-scorebook
ページや投稿に [basketball_scorebook] ショートコードを追加するだけです。
最適な体験のため、「全幅」ページテンプレートの使用を推奨します。
サードパーティリソース
このプラグインには以下のサードパーティライブラリが含まれています:
Alpine.js
- バージョン: 3.13.3 (minified)
- ソースコード: https://github.com/alpinejs/alpine
- ライセンス: MIT License
- ライセンス URL: https://github.com/alpinejs/alpine/blob/main/LICENSE.md
- 使用場所: assets/app/cdn.min.js
- 公式 CDN: https://cdn.jsdelivr.net/npm/alpinejs@3.13.3/dist/cdn.min.js
配布されている minified 版 (cdn.min.js) はAlpine.jsプロジェクトにより提供されています。
非 minified 版のソースコードは上記 GitHub リポジトリから取得できます。
インストール
basketball-scorebookフォルダを/wp-content/plugins/ディレクトリにアップロード- WordPress 管理画面の「プラグイン」メニューからプラグインを有効化。
- ページや投稿に
[basketball_scorebook]ショートコードを追加するだけです。
FAQ
-
インターネット接続なしで動作しますか ?
-
はい。ページが読み込まれた後はオフラインでも動作します。すべての計算は JavaScript (Alpine.js) を使用してブラウザー内で行われます。
-
データが消えることはありますか ?
-
通常の操作で消えることはありません。ただし、ブラウザーの「閲覧履歴の削除 (キャッシュクリア) 」を行うと、LocalStorage のデータも消去されます。最も有効な安全策として、ハーフタイムや試合終了後に JSON ファイルとして書き出しておくことをお勧めします。
-
スコアブックを PDF として保存できますか ?
-
「印刷/PDF」を選択してください。レイアウトは A4 横向きに最適化されています。
-
データは自動保存されますか ?
-
はい。スコアブックは変更のたびにブラウザの LocalStorage に自動保存されます。
-
外部へデータ送信されますか ?
-
デフォルトでは送信されません。設定ページから明示的にオプトイン (同意) しない限り、プラグインはいかなる分析データやテレメトリーも送信しません。
オプトインした場合、プラグインは匿名のイベント件数のみ (プラグインのバージョン、WordPress/PHPのバージョン、ロケール、イベント名) を送信します。サイトのURL、メールアドレス、スコアブックの内容は送信しません。
評価
このプラグインにはレビューがありません。
貢献者と開発者
変更履歴
1.0.5.3
- 修正: pubsubhubbub 等のプラグインと併用時に記事保存で「更新に失敗しました」が発生するエラーを修正
1.0.5.2
- 修正: 匿名利用統計 (オプトイン) 設定を OFF に戻した場合でも確実に保存されるよう、設定画面のチェックボックス送信ロジックを改善
- 改善: Matomo への匿名イベント送信時にブラウザ相当の User-Agent を付与し、Bot 除外フィルタで計測が除外されにくいよう調整 (オプトイン時のみ送信)
1.0.5.1
- 修正: 設定画面 (プライバシー / データ保存、匿名利用統計、変更を保存) およびレビュー依頼文言 (Basketball Scorebook をご利用いただき…、レビューを書く、ヘルプを見る、後で)の日本語・en_US 翻訳を追加
1.0.5
- 追加: 匿名利用統計 (オプトイン、イベントのみ、デフォルト OFF)
- 追加: 有効化から 7 日後に設定画面でレビュー依頼を表示 (ユーザー単位で 1 回)
- 更新: 設定画面とドキュメントにプライバシー注記 (データはブラウザーに保存) を追加
1.0.4
- 修正: 英語版の「Help」ボタンが英語の使い方ページ (
?lang=en) を開くように修正 - 改善: ブラウザの自動翻訳による画面崩れを防ぐため、スコアブック UI (iframe 内) で自動翻訳を無効化
1.0.3
- 更新: 保存データスキーマを拡張して v1.1.0 への移行を準備します (LocalStorage キーを保持したまま保存/エクスポート/インポートするために
metaとfoulEventsを追加します) - 更新: 下位互換性のためにスキーマのバージョン管理 (
meta.schemaVersion = 103) とデフォルト入力ロジックを追加。
1.0.2
- 追加: 完全な国際化 (i18n) 対応
- 追加: 日本語翻訳ファイル (ja.po / ja.mo)
- 追加: 日本語 readme (readme-ja.txt)
- 修正: 日本語 IME 入力時のフォーカス問題を解決
- 改善: プラグインの機能説明とドキュメントを充実
1.0.1
- 修正:
wp_enqueue_style()とwp_enqueue_script()を使用した適切なファイル読み込み - 修正: WordPress.org 要件に準拠した関数プレフィックスの更新 (
BSB_からBASKSC_) - 追加: サードパーティライブラリ (Alpine.js) のドキュメント
- 改善: WordPress コーディング規約に準拠したコード構造
1.0.0
- 初回リリース




