このプロジェクトについて

publii-goatcounter-analytics-plugin は、オープンソースの静的サイトジェネレーターかつ CMS である [Publii](https://getpublii.com/) 用のプラグインです。ユーザーのプライバシーを損なうことなく、サイト管理者が publish 済みのウェブサイトへ [GoatCounter](https://www.goatcounter.com) の分析データ埋め込みや、任意の訪問者カウンター表示を可能にします。 ## 特徴 - Publii が生成するサイトへの GoatCounter トラッキングコードのシンプルな統合。 - HTML、SVG、PNG の複数フォーマットに対応した任意の訪問者カウンター表示。 - CSS セレクターを使ったカウンター配置のカスタマイズ（デフォルトは `footer`）。 - カウンターから "by GoatCounter" というブランディングテキストを削除できるオプション。 - 公開前のテスト用にプレビューモードでの解析出力をサポート。 ## セットアップ プラグインの設定手順： 1. **GoatCounter エンドポイントを入力**: 発行された GoatCounter のエンドポイント URL を、Publii 内のプラグイン設定フィールドにコピーペーストしてください。 2. **プラグイン設定へ移動**: Publii で対象サイトの設定を開き、「Plugins」セクション内にある「GoatCounter Integration」プラグインを見つけてください。 3. **GoatCounter コードの入力**: サイトを紐付けするために、提供されるフィールドへ GoatCounter の分析コードを貼り付けてください。 4. **プレビューモード**: テスト用にプレビューモードでも解析出力を有効化できます。公開時には不正確なデータが発生しないよう無効にしてください。 ## 訪問者カウンター サイトで訪問者カウンターを表示させるには： 1. **カウンターを有効化**: プラグイン設定で「Show Visitor Counter」をチェックします。同時に、GoatCounter のサイト設定パネルにて「Allow adding visitor counts on your website」を有効にする必要があります（初期値は off）。} 2. **CSS セレクターを設定**: カウンターを追加したい親要素の CSS セレクターを指定します（デフォルトは `footer`）。 3. **カウンター種類を選択**: HTML、SVG、または PNG フォーマットから選んでください。 4. **ブランディングを非表示**: オプションで "by GoatCounter" という表示を非表示にできます。 ## カスタマイズ 選択したカウンター種類に応じて CSS によるカスタマイズが可能です： - **HTML カウンター**: 周囲の `div` および内部要素をスタイル設定できます。 - **SVG カウンター**: CSS により `#gcvc-border`、`#gcvc-for`、`#gcvc-views`、`#gcvc-by` などの要素をカスタマイズできます。 詳細なスタイリングについては、[GoatCounter ドキュメント](https://www.goatcounter.com/help/visitor-counter) を参照してください。 ## GDPR 同意 本プラグインは GDPR 同意の処理を行いません。これは GoatCounter が明示的な同意通知なしに一般的にコンプライアンスであると見なされているためです。詳しくは [GDPR consent notices](https://www.goatcounter.com/help/gdpr) をご覧ください。 ## ライセンス MIT ライセンス。プルリクエストや GitHub の issues を通じた貢献を歓迎します。