QHM (Quick Homepage Maker) ユーザのためのTips集。小技から大技までテクニック満載

プラグイン

QHMの機能には、最初から組み込まれている機能と後からプラグインという形で追加する機能があります。
有償版QHMは最初から多数のプラグインを組み込んであります。無所版のQHMは少しだけプラグインを組み込んであります。
プラグインのソースプログラムは、公開されていますので、その気になればソースから仕様を理解して、改造やまたは新規作成することもできます。（PHPの知識が必要です）

QHMはプラグインにより機能を拡張できます。QHMの元になっているPukiWikiのプラグインはそのままQHMでも利用できます。是非、プラグインの導入をしてみませんか？

• プラグインソースのあるフォルダ
  \plugin
• プラグインの種類
  プラグインには、用途により以下の3つのタイプがあります。
  • インラインタイプ
    以下のような形式で先頭に＆を書きます。

    例）　&color(　){　};

    文字の装飾などに利用します。改行はしません。

    <span>で開始し、</span>で終了するタグを出力します。

  • ブロックタイプ
    以下のような形式で先頭に＃を書きます。

    例）　#article(　)

    ブロックタイプを使用すると、BOXができると思えば理解しやすいです。改行が入ります。このBOXを並べることでレイアウトを行い、画面デザインを変更できます。

    <div>で開始し、</div>で終了するタグを出力します。

  • コマンドタイプ
    ブラウザのURLを入れる欄から以下の形式で入力できます。

    例）　http://サイト名/index.php?cmd=xxxxxx

プラグインの改造　[☆☆]

#comment4 (評価欄を追加し、結果を表形式に)

　#comment4 は、#comment2をベースに作成しました。
　#comment2 は、短いコメントを入力し、入力結果はリスト形式で表示されます。これを以下のように改造しました。

• 評価用の☆マークを選択できるようにする
• 入力結果を表形式で表示する。
• 入力欄を一番上にして、結果はその下に新しいものを上から順番に表示する。

■改造したプラグイン名 (QHM 4.27)
　\plugin\comment2.inc.php をコピーして comment4.inc.php　を作成しました。

■改造場所と改造内容
comment2を10行くらい修正して、名前を全て comment4 に変更しています。以下からダウンロードしてください。

ダウンロードしたファイル(comment4.inc.zip)を解凍して　comment4.inc.php をpluginフォルダへアップロードしてください。そのまま使用できます。
　もっと体裁をよくしたいとか、いろいろと不満はあるでしょうが、これ以上の改造はしないつもりです。ひょっとしたら、北研さんから正式にこんなプラグインがリリースされるかもしれません。
尚、当プラグイン使用による不具合は極力対応しますが、それ以外の要望については対応できません。ひょっとしたら対応するかもしれませんが...
自己責任でお使いください。

プラグインの記述

#comment4

このプラグインを評価してください。
以下に自由に入力してcommnet4プラグインを使ってみてください。

お名前: 認証コード(5126) 評価： ☆　 ☆☆　 ☆☆☆　

#include (インクルード可能な回数を増やす)

　#include(ファイル名,notitle)で他のページを取り込むことが可能ですが、初期設定では１ページ内に4回しか#include() を呼び出せないようになっています。これ以上指定するとエラーになります。そこで、プラグイン　include.inc.php　の以下を変更すれば #includeの最大数が変更可能です。

■改造するプラグイン名 (QHM 4.27)
　\plugin\include.inc.php

■改造場所と改造内容
4を適当な値に変更してください。あまり大きくしないほうが良いと思います。

// Max pages allowed to be included at a time
define('PLUGIN_INCLUDE_MAX', 4);

#showrss (ブログのタイトルと更新日を1行で表示)

showrssプラグインを改造することで、1行にRSSのタイトルと日付を表示できます。
QHMの版数が古いと対応していません。RSS関連のプラグインの仕様が変更になっています。

■改造するプラグイン名 (QHM 4.27)
　\plugin\showrss.inc.php

■改造場所と改造内容
　196行目を1行だけ修正します。

　上の行が改造前　（行の先頭に // を付けて改造前を保存しておくとよいでしょう。）
　下の行が改造後

// return "<strong>$date</strong>\n<ul class=\"recent_list\">\n$str</ul>\n";
return "<ul class=\"recent_list\">$str ($date)</ul>\n";

■プラグインの記述例

#showrss(http://xxxx/index.rdf, recent, 5)

・タイトル (2010-01-28) の形式で表示します。

日付を前に持ってきたかったのですが、改行されてしまいどうしてもうまくいかず
タイトル、日付　の順番になりました。これでも結構いい感じだと思いますが...
誰かもっといい案ありましたら教えてください。

#article (掲示板のコメントを外す)

掲示板（#articleプラグイン）に「コメント機能」を入れたくないときは、以下のファイルを2行修正すればできます。

■改造するプラグイン名 (QHM 4.27)
　\plugin\article.inc.php

■改造場所と改造内容
　上の行が修正前、下の行が修正後です。修正したい行ををコピーして先頭に // を付けておくとあとで元に戻すのが楽です。

33行目

//define('PLUGIN_ARTICLE_COMMENT', 1); // 書き込みの下に一行コメントを入れる 1:入れる 0:入れない
define('PLUGIN_ARTICLE_COMMENT', 0); // 書き込みの下に一行コメントを入れる 1:入れる 0:入れない

74行目

// $article .= $msg . "\n" . '//--------- 以下はコメント ----------' . "\n" . "*** コメント";
$article .= $msg . "\n" . '//--------- 以下はコメント ----------' . "\n";

プラグインの新規作成　[☆☆☆]

QHM用に新規にプラグインを作成する場合は、以下のサイトを参考にしてください。

• PukiWikiのPlug-inの仕様

• Sonots' PukiWiki プラグイン

プラグインの作り方　[☆☆☆]

まずは、簡単なプラグインをお手本に、それを修正することからはじめると良いでしょう。
インラインタイプからはじめるのが簡単でしょう。

（未稿）

お奨めのプラグイン　[☆☆]

PukiWikiの自作プラグインを導入してみませんか

• 自作プラグイン
  こちらのサイトにはQHMでも利用できそうなプラグインが多数登録されています。是非ダウンロードしてみてください。

QHMで動作確認済のもの

• ログ取得（logparanoia.inc.php）
• ファイルを選択ダウンロード（webdl.inc.php）

ご意見箱

皆様のご意見をお待ちします。

• おおいに役に立ちました。すばらしいサイトですね -- 太郎 2011-02-05 (土) 23:39:26
• 太郎さん　ありがとうございます。お役に立ててなによりです。 -- tomzo 2011-04-16 (土) 01:54:18
• pc未熟者でしたが少しずつ理解出来てきました、凄いです。 -- 水先案内人 2012-04-04 (水) 18:22:26

お名前: 認証コード(5795)

当ページは役に立ちましたか？

選択肢	投票
たいへん役に立った	25
ちょっとだけ役に立った	3
普通	1
あんまり	5