Skip to content

Plugin-ImageThumbnail.md

Latest commit

 

History

History
73 lines (48 loc) · 2.18 KB

Plugin-ImageThumbnail.md

File metadata and controls

73 lines (48 loc) · 2.18 KB
Raw

画像サムネイルプラグイン（ImageThumbnail Plugin）

投稿本文中の画像URLを検出し、サムネイル付きリンクに変換するプラグインです。

ファイル配置: backend/plugins/ImageThumbnail/ImageThumbnailPlugin.php

概要

項目 内容
プラグイン名 画像サムネイル
フックタイプ AFTER_POST | BEFORE_READ（複合フック）
バージョン 1.0.0
実装状態 BEFORE_READ: 実装済み / AFTER_POST: 未実装（TODO）

動作

BEFORE_READ（実装済み）

レス表示時に本文中の画像URLを検出し、クリック可能なサムネイル画像に変換します。

変換前:

https://example.com/image.jpg

変換後（HTML）:

<a href="https://example.com/image.jpg" target="_blank" rel="noopener">
  <img src="https://example.com/image.jpg"
       style="max-width:200px;max-height:200px"
       loading="lazy" alt="">
</a>

AFTER_POST（未実装）

サムネイル画像のローカルキャッシュ生成を予定です。

対応画像形式

デフォルト設定: jpg, jpeg, png, gif, webp

allowed_extensions 設定で変更可能です。（カンマ区切り）

設定項目

設定キー 型 デフォルト 説明
max_width int 200 サムネイルの最大幅（px）
max_height int 200 サムネイルの最大高さ（px）
quality int 80 JPEG 圧縮品質（1-100）※ AFTER_POST 実装時に使用予定
allowed_extensions string jpg,jpeg,png,gif,webp 対象拡張子（カンマ区切り）
enabled_domains text （空） 許可ドメイン（空欄で全許可、改行区切り）
lazy_loading bool true loading="lazy" 属性を付与する

注意事項

  • URLは htmlspecialchars() でエスケープされる（XSS対策）
  • enabled_domains に値を設定すると、指定ドメインの画像のみサムネイル化される
  • lazy_loading は画面外の画像の読み込みを遅延させ、ページ表示速度を改善する