Parts & Tips

てがろぐレポート ​

にししふぁくとりーさまで配布中のてがろぐで投稿したデータを取得し、指定した年の振り返りレポートを作成します。作成するレポートの内容は以下です。

  • 指定年の投稿数
  • 指定年の月々投稿数（棒グラフで表示）
  • 指定年のいちばん投稿していた話題（円グラフで表示）
    • ハッシュタグ
    • カテゴリ

表示サンプルはこちらをご覧ください。ハッシュタグまたはカテゴリを使用していない場合は、この項目は表示されません。

本スクリプトはPHP製です。バージョンは8.2以上で作成・動作確認しています。

設置方法 ​

以下よりスクリプトをダウンロードしてください。

config.phpを編集する ​

/src/_modules/config.phpの各項目を編集します。

作成レポートの年指定 ​

作成するレポートの年を指定します。西暦、半角数字で指定してください。

php
//作成するレポートの年を指定（西暦 / 半角数字）
$dateY = '2025';

戻り先リンク指定 ​

レポートページからの戻り先リンクを指定します。$siteNameの値が空の場合（''）は、戻るリンクは表示されません。

php
//サイト名（レポートページからの戻り先ページタイトル）
//サイト名が空（''）の場合は、戻るリンクは表示されません
$siteName = 'サイト名';

//サイトURL（レポートページからの戻り先ページURL）
$siteURL = 'https://example.com/';

てがろぐのログファイルのパス指定 ​

データを取得するてがろぐのログファイルと設定ファイルのパスを指定します。

php
//てがろぐのログファイル（tegalog.xml）と設定ファイル（tegalog.ini）のパス
//config.phpが入っているフォルダ（__DIR__）からのパスを指定してください
//てがろぐ設置フォルダ内にこのプログラムを設置している場合は、パスはこのままでOKです
$log_file = __DIR__. '/../../tegalog.xml';
$ini_file = __DIR__. '/../../tegalog.ini';

デフォルトの指定ではてがろぐ設置フォルダの中に本スクリプトを設置する想定です。以下の構成の場合は、パスを書き換える必要はありません。

zsh
/tegalog（てがろぐ設置フォルダ）
├ tegalog.cgi
├ tegalog.xml
├ tegalog.ini
└ [本スクリプトフォルダ]　←tegalog.cgiと同階層に設置する場合

てがろぐのログファイル名を変更している場合は、ファイル名を修正してください。

表示グラフの色指定 ​

月々の投稿数を表示するグラフのバーの色を指定します。指定できる色は1色です。

php
//月々の投稿数（棒グラフ）バーの色
//色を1つ指定してください
$dateposts_barColor = '#face68';

いちばん投稿した話題の数を表示するグラフのバーの色を指定します。デフォルトでは5色指定していますが、5色以下でも以上でも構いません。複数色指定する際は、,（カンマ）で区切ってください。
ハッシュタグ・カテゴリ共通で使用されます。

php
//投稿した話題（円グラフ）表示色
//色を複数指定してください（カンマ区切り）
$misc_barColor = [
  '#5a9cb5',
  '#face68',
  '#fa6868',
  '#83c892',
  '#faac68',
];

編集後は、config.phpを保存してください。

サーバーにアップロードする ​

config.phpの編集を終えたら、FTPでサーバーにアップロードします。

/srcフォルダをそのままごそっとアップロードしてください。/srcフォルダの名称は適宜変更して構いませんが、中に入っているのファイルやフォルダの名称は変更しないでください。

サーバーにアップロード後はブラウザでアクセスし、表示ができていればOKです。

補足

レイアウトはCSSで制御しています。必要に応じて/src/css/style.cssを適宜修正してください。

免責事項など ​

本スクリプトは、にししふぁくとりーさまの「てがろぐ」の以下ログファイルを使用します。取得するログファイルは以下の2つです。本スクリプトは、てがろぐスクリプト本体およびログファイルには影響を与えるものではありません。

  • tegalog.xml（てがろぐの投稿保存ファイル）
  • tegalog.ini（同設定ファイル / カテゴリ名の取得時に使用）

本スクリプトはどなたでもご利用いただけますが、本スクリプトを利用して生じたいかなる問題（トラブル、損害、データ損失等）について、当方は一切の責任を負いません。
なお、本スクリプトの著作権は放棄していません。

※#からはじまるHEX値のカラーコードを投稿している場合は、ハッシュタグとして計上されてしまいますが、現時点では厳密なフィルタリングが難しいため、ご了承いただけますと幸いです。

使用ライブラリ ​

本スクリプトでは、以下のライブラリを使用しています。

  • グラフ表示：Chart.js（CDN経由 / MITライセンス）
  • テンプレート部分：Twig（3条項 BSDライセンス）

不具合報告・お問い合わせについて ​

本スクリプトについて、不具合やお問い合わせの際は以下までお願いします

更新履歴 ​

  • 2025/12/31　配布開始（ver1.00）