Basketball Scorebook

説明

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 リポジトリから取得できます。

スクリーンショット

  • リアルタイム得点記録機能付きメインスコアボード画面
  • タイムスタンプ付き選手統計とファウル追跡
  • ランニングスコア表示 (1〜160点)
  • A4横向き印刷プレビュー

インストール

  1. basketball-scorebook フォルダを /wp-content/plugins/ ディレクトリにアップロード
  2. WordPress 管理画面の「プラグイン」メニューからプラグインを有効化。
  3. ページや投稿に [basketball_scorebook] ショートコードを追加するだけです。

FAQ

インターネット接続なしで動作しますか ?

はい。ページが読み込まれた後はオフラインでも動作します。すべての計算は JavaScript (Alpine.js) を使用してブラウザー内で行われます。

データが消えることはありますか ?

通常の操作で消えることはありません。ただし、ブラウザーの「閲覧履歴の削除 (キャッシュクリア) 」を行うと、LocalStorage のデータも消去されます。最も有効な安全策として、ハーフタイムや試合終了後に JSON ファイルとして書き出しておくことをお勧めします。

スコアブックを PDF として保存できますか ?

「印刷/PDF」を選択してください。レイアウトは A4 横向きに最適化されています。

データは自動保存されますか ?

はい。スコアブックは変更のたびにブラウザの LocalStorage に自動保存されます。

外部へデータ送信されますか ?

デフォルトでは送信されません。設定ページから明示的にオプトイン (同意) しない限り、プラグインはいかなる分析データやテレメトリーも送信しません。
オプトインした場合、プラグインは匿名のイベント件数のみ (プラグインのバージョン、WordPress/PHPのバージョン、ロケール、イベント名) を送信します。サイトのURL、メールアドレス、スコアブックの内容は送信しません。

評価

このプラグインにはレビューがありません。

貢献者と開発者

Basketball Scorebook はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“Basketball Scorebook” は1ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“Basketball Scorebook” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

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 キーを保持したまま保存/エクスポート/インポートするために metafoulEvents を追加します)
  • 更新: 下位互換性のためにスキーマのバージョン管理 (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

  • 初回リリース