plugins:trimimage

差分

この文書の現在のバージョンと選択したバージョンの差分を表示します。

この比較画面にリンクする

plugins:trimimage [2011/03/23 21:28] (現在)
ライン 1: ライン 1:
 +====== NP_TrimImage ======
 +記事に埋め込まれた画像を任意のサイズにトリミングしてページ内に一覧出力するプラグイン。
 +
 +^General Plugin info ^^
 +^作者: | [[plugins:​authors:​nakahara21|nakahara21]] + [[plugins:​authors:​hsur|hsur]] |
 +^最新のバージョン:​ | 2.4.2 (2008/​12/​23) |
 +^Nucleus対応バージョン:​ | 2.0 or later (GDが使える必要があります)|
 +^入手場所:​ | [[http://​blog.cles.jp/​np_cles/​category/​31/​subcatid/​15|作者サイト]] [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​p=15650|フォーラム内の記事]] |  ​
 +^ソース: |[[http://​svn.sourceforge.jp/​view/​plugin/​trunk/​NP_TrimImage/?​root=nucleus-jp|Nucleus Japan SVN]] |
 +^動作サンプル:​ | [[http://​blog.cles.jp/​|作者サイト]] | 
 +^フォーラム参照先:​ | [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​p=15650|フォーラム内の記事]] |
 +
 +===== インストール方法 =====
 +  - Zipファイルを展開して、中身をサーバーのプラグインディレクトリにアップロードする
 +  - 管理画面からプラグインをインストールする
 +  - キャッシュを有効にする場合
 +    - ''​(mediaディレクトリ)/​phpthumb/''​ディレクトリを作成し、phpから読み書き可能に変更する\\ (例: ディレクトリ777)
 +
 +===== スキンへの記述 =====
 +<code file><​%TrimImage(件数/​1アイテムあたりの最大抽出件数,​幅,​高さ,​トリミング起点,​ランダム指定,​抽出条件,​タイトルモード,​imgタグを含めるか)%></​code>​
 +
 +
 +==== 記述例 ====
 +<​code><​%TrimImage(50,​80,​80,​lefttop,​0,​all)%></​code>​左上から80px×80pxを切り出したサムネイルをすべてのblogに属する最新順の記事から50個表示する
 +
 +<​code><​%TrimImage(10/​1,​80,​80)%></​code>​現在表示中のブログ記事を最新順に検索しサムネイルを10個表示する。但し、サムネイルは中心からから80px×80pxで切り出したものとし、1アイテムからは1個だけしかサムネイルを生成しない。
 +
 +==== パラメータの詳細 ====
 +
 +^件数 ​ |デフォルトは10\\ /​に続いて1アイテムあたりの最大抽出件数を指定することが可能。指定しない場合には、アイテムに存在するすべての画像がサムネイル対象となる。 ​ |
 +^幅  |pxで指定。デフォルトは80。0を指定するとExtractImageモード<​sup>​*1</​sup>​ |
 +^高さ ​ |pxで指定。デフォルトは80。0を指定するとExtractImageモード<​sup>​*1</​sup> ​ |
 +^トリミング起点 ​ |lefttop:​左上起点。それ以外は中心点起点(デフォルト)。 ​ |
 +^ランダム指定 ​ |1:​ランダムに抽出。\\ 0:​記事の最新順(デフォルト)。 ​ |
 +^抽出条件<​sup>​*2</​sup> ​ |all:​すべてのblog記事から。\\ itemcat:​選択しているアイテムのカテゴリと同一の記事から \\ //​(何も書かない)//:​表示しているblogの記事のみから<​sup>​*3</​sup>​。 ​ |
 +^タイトルモード ​ |item: エントリのタイトルを使用。\\ image: 画像のaltをそのまま使用(デフォルト) ​ |
 +^imgタグを含めるか<​sup>​*4</​sup> ​ |true: imgタグも対象に抽出する。(デフォルト)\\ false: imgタグを対象としない。 ​ |
 +
 +  * <​sup>​*1</​sup>​幅、高さのいずれかに0を指定した場合、画像の切り取りを行わずに、指定した幅(高さ)になるように画像を縮小表示します。(動作はExtractImageと互換です)
 +  * <​sup>​*2</​sup>​抽出条件には特定のblogid、カテゴリidを指定することもできます。\\ ブログidで指定する場合は「b2」もしくは「b2/​b6」等、カテゴリidで指定する場合は「c5」もしくは「c5/​c6」等、複数指定の場合はホワイトスペースなしの半角スラッシュで区切ってください。\\ 「b2/​c12」などブログ指定とカテゴリ指定の混在もできます。
 +  * <​sup>​*3</​sup>​カテゴリが選択されている場合には同一のカテゴリからになります。
 +  * <​sup>​*4</​sup>​画像がmediaディレクトリ以下に配置されているものに限ります。
 +
 +===== テンプレートへの記述 =====
 +<code file><​%TrimImage(幅,​高さ,​トリミング起点,​最大表示件数,​タイトルモード,​imgタグを含めるか)%></​code>​
 +例) 100×100の中央起点のトリミングサムネイルを1つだけ表示する場合は<​code><​%TrimImage(100,​100,​0,​1)%></​code>​と書きます。
 +
 +===== cssへの記述 =====
 +  * 特にプラグイン内部でスタイルの指定はしていません。
 +
 +  * 横幅60pxのサムネイルを30個表示する指定+ページ上で10個ずつ3行横並びにするTips
 +    * プラグインを改造して(コメントアウトをはずす)、出力する画像をfloat:​leftなdivで括るようにする。
 +    * さらにプラグイン出力箇所自体をwidth:​630位なdivで括る。
 +
 +===== Tips =====
 +  * <​del>​NP_Paintを使用した画像をトリミングサムネイル出力する方法は[[http://​prismpark.info/​RMnote/​item/​151|こちらをご覧下さい]]。</​del>​
 +    * 現在のバージョンではデフォルトで対応しています。
 +  * キャッシュを有効にする(v2.0以上)
 +    *  **サーバの負荷軽減のため、一度生成したサムネイルをサーバ上に保存しておき、次回以降のアクセスについては生成されたファイルの内容を返す機能(キャッシュ)がついています。**
 +    * (mediaディレクトリ)/​phpthumb/​ディレクトリを作成し、パーミッションをphpから読み書き可能(例:​ 777)に変更することでキャッシュが有効になります。
 +    * なお、キャッシュを有効にしなくても、プラグインを動作させることはできます。
 +  * パススルーモードとリダイレクトモード(v2.1以上)
 +    * NP_TrimImageにはパススルーモードとリダイレクトモードという2つのモードがあり、画像ファイルの転送をPHPで行う(パススルーモード)か、ウェブサーバに任せる(リダイレクトモード)かを選ぶことができます。
 +    * デフォルトではパススルーモードで動作するように設定していますが、NP_TrimImage.phpを書き換えることにより動作モードを変更することができます。**キャッシュを有効にしている場合にはリダイレクトモードのほうが高速に動作**するはずです。
 +    *  キャッシュが有効になっていない場合には、リダイレクトモードに設定している場合でもパススルーモードでの動作となります。
 +    * リダイレクトモードへの切り替えかた(下記参照)
 +NP_TrimImage.php
 +<code file>​define('​NP_TRIMIMAGE_FORCE_PASSTHRU',​ true); //​passthru(standard)
 +//​define('​NP_TRIMIMAGE_FORCE_PASSTHRU',​ false); //​redirect(advanced)</​code>​の部分を
 +<code file>//​define('​NP_TRIMIMAGE_FORCE_PASSTHRU',​ true); //​passthru(standard)
 +define('​NP_TRIMIMAGE_FORCE_PASSTHRU',​ false); //​redirect(advanced)</​code>​に書き換える
 +
 +===== 既知の問題点 =====
 +  * <​del>​リンクurlに実体参照文字を使用していない。(ブラウジング上の実害はありません。)</​del>​
 +    * 現在のバージョンでは修正されています。
 +
 +
 +===== 開発履歴 =====
 +  * version 2.4 [2008-12-10] [[http://​blog.cles.jp/​item/​2836|Read here]] by [[plugins:​authors:​hsur|hsur]]
 +    * [Fixed] 画像のファイル名が2バイト文字の場合に対応
 +    * [Added] 1アイテムあたりの最大抽出件数を指定可能にした
 +
 +  * version 2.3 [2008-05-02] [[http://​blog.cles.jp/​item/​2543|Read here]] by [[plugins:​authors:​hsur|hsur]]
 +    * [Fixed] lefttopが効かない問題に対応した
 +    * [Added] 抽出条件にitemcatモードを追加
 +
 +  * version 2.2 [2007-03-18] [[http://​blog.cles.jp/​item/​1903|Read here]] by [[plugins:​authors:​hsur|hsur]]
 +    * [Added] imgタグのサポート
 +    * [Added] 画像のalt/​title属性について、内容を元のaltを使うか、エントリのタイトルを使うのか選択可能にした
 +    * [Added] ExtractImageモードのサポート
 +    * [Fixed] テンプレート記述時のバグfix
 +    * [Fixed] 不適切な文字列処理を修正
 +
 +  * version 2.1 [2006-12-04] [[http://​blog.cles.jp/​item/​1748|Read here]] by [[plugins:​authors:​hsur|hsur]]
 +    * [Fixed] トリミング起点がおかしくなるバグを修正
 +    * [Added] imgタグにalt/​title属性を追加
 +    * [Changed] 内部構造の微調整
 +
 +  * version 2.0 [2006-12-03] [[http://​blog.cles.jp/​item/​1743|Read here]] by [[plugins:​authors:​hsur|hsur]]
 +    * [Changed] セキュリティFix ​
 +    * [Added] NP_Paint対応 ​
 +    * [Changed] phpThumb()を採用
 +    * [Added] サーバ負荷軽減対策を実装  ​
 +  * version 1.0 [2006-05-23]
 +    * GIF出力のバグ修正
 +  * version 0.9 [2006-05-19]
 +    * テンプレート内使用時の最大表示件数の指定に対応
 +    * NP_Thumbnailを使用している場合でも使用できるように改良
 +  * version 0.8 [2004-12-30] [[http://​nakahara21.com/?​itemid=560|Read here]]
 +    * GIF特許失効に伴い、GIF出力に対応。
 +  * version 0.7 [2004-08-03] [[http://​nakahara21.com/?​itemid=534|Read here]]
 +    * テンプレートでの使用に対応。
 +    * <​%popup()%>​ での埋込にも対応。
 +  * version 0.6 [2004-08-01] [[http://​nakahara21.com/?​itemid=533|Read here]]
 +    * 画像を含む記事が属するcategory/​blogの任意指定機能を追加。
 +  * version 0.5 [2004-07-12] [[http://​nakahara21.com/?​itemid=517|Read here]]
 +    * Nucleus 2.0への下位互換。
 +    * allモード時のリンクurl修正。
 +  * version 0.3 [2004-07-09] [[http://​nakahara21.com/?​itemid=514|Read here]]
 +    * 細かなバグ修正
 +  * version 0.2 [2004-07-03] [[http://​nakahara21.com/?​itemid=512|Read here]]
 +    * 初回リリース
 +
  
 
plugins/trimimage.txt · 最終更新: 2011/03/23 21:28 (外部編集)