追加PluginManual A-D :: XOOPS マニア

addline ^{[6] [7]}

概要

• ボタンやリンクを押すと、設定ページで指定した文字列を追加。
• 行単位の追加。インライン型は同じ行内での文字列単位で追加も可能。
• ボタンやリンクの表記も変更可。

説明

• 画面のボタンを押すと、「：config/plugin^[8]/addline/設定」で、あらかじめ指定された文字列を追加します。
• テーブルのフィールドを追加したりするのに便利です。自作プラグイン/attachref.inc.phpと一緒に使うと、画像ギャラリーっぽい雰囲気のページが作れます。

使用法

ブロック型プラグイン／インライン型プラグイン

• 引数の仕様
  

  #addline(設定名,[above|below|up|down|btn:<ボタン名>|ltext:<左テキスト>|rtext:<右テキスト>])
  &addline(設定名,[before|after|above|below|up|down]){<リンク名>};

• 引数の意味
  

  設定名: 「：config/plugin[8]/addline/設定名」の指定
  above|below|up|down: #commentと同じで、追加するのがボタンの上か下かの指定
  btn: submitボタンに付ける名前
  ltext,rtext: submitボタンの左右につけるテキスト
  before,after: インライン型の場合に、追加するのがリンクの前（左）か後（右）の指定

使用例

ブロック型

例えば、以下のように#addlineを用意すると、「add」ボタンを押す毎に、テーブルの下に設定に記載した内容が追加されていきます。任意の位置に添付＆参照できる自作プラグイン​/attachref.inc.php^[9]と組み合わせると、ほら何か楽しそうでしょ？
ページ内での記載例とボタンを２回押した結果

|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|
|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|
#addline(テーブル１,above)

「：config/plugin^[8]/addline/テーブル１」の内容

|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|

インライン型

棒グラフ型簡易投票とか。

CENTER:「納豆は好きですか？」~
&addline(グラフ,before){【は　い】};▲&addline(グラフ,after){【いいえ】};~

「：config/plugin^[8]/addline/グラフ」の内容

&heart;

【表示例】

「納豆は好きですか？」
【は　い】▲【いいえ】

インライン型２

addline.inc.php.8からインライン型にもabove|below|up|downが指定できるようになりました。テーブル内に記述できるようになっただけでなく、クリックするリンクによって追加する行の内容を変えられます。下記は、[ハート追加]を１回、[リンク追加]を１回クリックした例。

|>|>|CENTER:~&addline(テーブル１,down){[リンク追加]};&addline(テーブル２,down){[ハート追加]};|
|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|&attachref(,zoom,90x90);|
|&heart;|&heart;|&heart;|

【表示例】

[リンク追加][ハート追加]
[添付]	[添付]	[添付]

「：config/plugin^[8]/addline/テーブル２」の内容

|&heart;|&heart;|&heart;|

• ここ迄は自作プラグイン/addline.inc.php^[10]より転載

• nao-pon^[11]氏の追記より転載 pukiwiki^[12]:自作プラグイン/addline.inc.php を xpWiki^[3]用に調整したものです。原作者は sha さんです。

• • オリジナルの addline の機能に「auth」オプションを追加してあります。 「auth」オプションを指定すると、編集権限がないときは、「追加」ボタンが表示されず、実際の追加処理もキャンセルされます。 「auth」オプションの指定方法は2種類あります。

• • • 「auth」オプションのみ指定 例: #addline([テンプレート],auth)
    • 「btn」オプションに併記して指定 例: #addline([テンプレート],btn:追加:auth)

AjaxChat ^{[13] [14]}

関連記事^[15] ajaxchat.inc.php

• PukiWikiMod用の説明より転載(あっているかは、不明)2008/10/16
• このチャットは<iframe>呼び出しで、id を指定することにより、いくつでも部屋を作ることができます。 XOOPS^[16]のカスタムブロックに使ってもいいし、PukiWikiMod から呼び出して、ページごとに簡単に設置したりできます。 インストール^[17]方法については AjaxChat/readme をご覧ください。
  • 以下、AjaxChat/readme より転載

制作者名

nao-pon^[11] https://hpwb.net/3UtXdL^[18] (hypweb.net) https://hpwb.net/2qlvHL^[19] (hypweb.net) 原案: 最速インターフェース研究会 https://hpwb.net/41U2os^[20] (la.ma.la)

動作環境

サーバー環境: PHPが動作するサーバー 確認済みクライアント環境: InternetExplorer 6, FireFox 1.07(Windows), Opera 8.5(Windows)

種 別

フリーウェア

概 要

Ajax技術を利用した JavaScript + PHP による軽快チャットプログラムです。

インストール^[17]

解凍したファイル一式をサーバーにアップロードし、log, stay, bak ディレクトリのパーミッションを 777 など、httpd(Apache) がファイルを作成できる権限を与えてください。

使用方法

Webページから、下記の JavaScript と <iframe>で呼び出します。

<!--========== AjaxChat Start ==========-->
<script type="text/javascript">
<!--

	var ajaxchat_url     = './';
	var ajaxchat_id      = 1;
	var ajaxchat_staypos = 'r';
	var ajaxchat_height  = 350;
	var ajaxchat_cookie_domainlevel_up = "off";

	document.write('<script type="text/javascript" src="'+ajaxchat_url+'load.js"></script>');
//-->
</script>
<noscript>
	<iframe src="./ajaxchat.htm" width="100%" height="50" style="border:none;" frameborder="0" border="0"   allowtransparency="true" scrolling="no"></iframe>
</noscript>
<!--========== AjaxChat End ==========-->

パラメータの説明

ajaxchat_url = 'ajaxchat.htm の URL(外部サーバーでも可)'; ajaxchat_id = [整数値]; 整数値を変えることで、部屋をいくつでも作成できます。 ajaxchat_staypos = '[t|r]'; 閲覧者情報の初期位置 t=上部(省略時), r=左サイド ajaxchat_height = [整数値]; チャット部分の高さ(px)

ajaxtree ^{[21] [22]}

種別

ブロック型プラグイン

概要

• ページの階層構造をツリーメニューとして表示します
• 現在参照しているページの付近だけを展開して表示します
• JavaScript が使える場合は、クリックすることでメニューの折り畳み・展開ができます
• MenuBar^[23] ページに #ajaxtree と書くだけで、手軽に設置できます

書式

#ajaxtree([タイトル])

プラグイン内設定

• PLUGIN_AJAXTREE_CHECK_MTIME wiki ディレクトリの更新日時を利用して効率良くキャッシュを更新する (true, false のいずれか)
• PLUGIN_AJAXTREE_COUNT_DESCENDANTS 階層下に含まれるページの数を表示
• PLUGIN_AJAXTREE_TOP_DEFAULTPAGE FrontPage^[24] へのリンクはツリーの先頭に表示する (true, false のいずれか)
• PLUGIN_AJAXTREE_HIDE_TOPLEVEL_LEAVES Help^[25] や MenuBar^[23] のような階層化されていないページは非表示にする (true, false のいずれか)
• PLUGIN_AJAXTREE_NON_LIST 非表示にしたいページのリスト (正規表現)
• PLUGIN_AJAXTREE_INCLUDE_LIST 非表示ページのうち例外的に表示したいページのリスト (正規表現)
• PLUGIN_AJAXTREE_EXPAND_LIST 展開したいページのリスト (正規表現)

出所

• Revulo さんの AjaxTree プラグイン PukiWiki/自作プラグイン/AjaxTree - Revulo's Laboratory^[26] 。ベースは、ajaxtree-1.2beta1 ですが、移植に際して若干修正を行っています。

備考

• 利用する場合は最初にTree データの初期化作業が必要です。管理ツールからプラグインキャッシュ初期化を行って下さい。
• 階層ノード内の並び順は、1.ページに設定したページ並び順, 2.ページ名 で昇順となります。

areaedit ^{[27] [28]}

種別

• ブロック型プラグイン
• インライン型プラグイン

機能概要

ページ内の指定領域のみを編集対象とするプラグイン

• #areaeditと#areaedit(end)で囲まれたエリアだけが、編集の対象となります。 その場合、[編集]リンクが右端に表示されます。
  • • 例えば、#commentを#areaeditと#areaedit(end)で囲っておくと、コメントのみが編集対象になるので修正が容易になる。

書式

• 引数の仕様

  #areaedit([start|end|btn:<ボタンの名前>|nofreeze|noauth|collect[:<page>]])
  &areaedit([nofreeze|noauth|preview[:<num>]]){<編集文字列>};

• 引数の意味

  <編集文字列>: 編集対象。
  start: 範囲の開始。省略できる。
  end: 範囲の終了。これを引数とする記述ごと省略すると、子要素のみが対象に。
  btn:<name>: <name>をボタン名に変更。
  nofreeze: ページが凍結されていても、その範囲は凍結されてないようにできる。
  noauth: ページに編集権限がなくても、その範囲は権限があるようにできる。
  collect: 同じページ内のインライン型の編集対象を収集する。
  collect:<page>: <page>で指定したページ内で編集対象を収集する。
  preview: インライン型に限り、編集時に編集対象の直前の空行や見出しから編集対象までを表示（99行分探索）。
  preview:<num>: previewに続けて「:」と数字を書くと、空行や見出しを探す最大行数を指定できる。

  • つまり、ページが凍結されてなくて、かつ編集権限がなければ編集できないが、noauth, nofreezeを指定すると、その範囲において、それぞれの制限を受けなくすることができます。

使用例

1. インライン型
   1. テーブルなどに記載できる。例えば下記のように記載する。すると、編集文字列の後ろに[e]リンクが出現する。これをクリックすると編集できる。

      |&ref(http://pukiwiki[12].sourceforge.jp/image/pukiwiki[12].png);|&areaedit(){画像にコメント記入};|

      【表示例】（区別のため赤字で示した）

      [29]	画像にコメント記入[e]

      
      

   2. 前の文字列とぴったりくっつくので、範囲の最初を区別したいときは、それが分かるように記載すること。後ろの方は[e]があるので範囲の終わりは分かる。ブラウザでJavascriptが有効な場合、マウスカーソルを合わせると対象範囲が色づく。

      -好きな食べ物は&areaedit(){冷やし中華でない冷麺};です。
      -好きな食べ物は「&areaedit(){冷やし中華でない冷麺};」です。

      【表示例】

      • 好きな食べ物は冷やし中華でない冷麺[e]です。
      • 好きな食べ物は「冷やし中華でない冷麺[e]」です。

• もちろん、中括弧内{body}が空だったり、中括弧ごとが無かったりしても大丈夫。
• 編集権限が無いときは[x]が表示されクリックできない。凍結されているときは[uf]で凍結解除のリンクになる。
• 改行は&br;に変換される。
• preview[:<num>]引数を付けておくと、編集時に編集対象行より前の部分（見出しや空行からの）が表示される。見ながら編集できる。

1. インライン型の編集対象を収集するブロック型プラグイン
   1. 次のように記述すると、同じページ内(page1)に記述されたインライン型の編集対象を集めて展開する。以下は記載方法。

      #areaedit(collect)
      #areaedit(end)

   2. あるページ(page1)にて、別のページ(page2)に記述されたインライン型の編集対象から収集する場合

      #areaedit(collect:page2)
      #areaedit(end)

      【表示例】（ただし実行後）
      

      [収集] page2
      

      1. 画像にコメント記入
      2. 冷やし中華でない冷麺
      3. 冷やし中華でない冷麺

• [収集]ボタンが現れる。押すとインライン型の編集対象が展開される。既に記述がある場合には上書きされる。
• 【注意】#areaedit(end)が無い場合、次の空行までを対象範囲とするので、意識して空行を用意して置かないと、関係ない記述まで食い込んで上書きされてしまうことがある。#areaedit(end)の使用を推奨。
• ここでも実験しています→「[[sha:areaedit.inc.php/test]]」

1. ブロック型 ページ内の好みの位置に次のように記述してください。
   1. 対象範囲を明示する場合
   • #areaeditと#areaedit(end)に挟まれた範囲が編集対象に。

     ここは編集対象外
     #areaedit
       ここが編集対象
     #areaedit(end)
     ここは編集対象外

   1. 終わりを明示しない場合（#areaedit(end)を省略）
   • #areaeditから最初の空行までの範囲が編集対象に。

     ここは編集対象外
     #areaedit
       ここは編集対象

ここは編集対象外。上に空行があるから。

1. 1. ページ内に複数埋め込んだ場合
   • #areaeditの後、#areaedit(end)が見つかる前に#areaeditが見つかった場合は、上記2.と同じ扱いとなる。

     ここは編集対象外
     #areaedit
        ここは１番目の編集対象
     #areaedit(end)
     ここは編集対象外。上にendがあるから。
     #areaedit
        ここは２番目の編集対象

ここは編集対象外。上に空行があるから。
#areaedit
    ここは３番目異の編集対象
#areaedit(end)
ここは編集対象外。上にendがあるから。

1. 1. コメント領域を編集対象にすると便利。
   • コメント部分を囲うと、コメントの修正が容易になる。

     #areaedit
     -テストです。こんな風にコメントを記入 -- [[sha]] SIZE(10){2003-08-12 (火) 04:26:11}
     -#areaeditをコメントで入力しても無駄よん。 -- [[sha]] SIZE(10){2003-08-12 (火) 04:26:57}

#comment
#areaedit(end)

1. 1. 「自作プラグイン​/addline.inc.php^[30]」と組み合わせると便利便利。
      ボタンを押す度に編集領域を追加することができます。大項目を追加するときにボタン押せば、大項目のテンプレートを含んだ編集領域が用意されるので他の領域の影響を気にせず編集できるのがありがたいです。
   • あるページに以下のようにaddlineプラグインを記載しておきます。追加ボタン[編集領域追加]が現れます。

     #addline(領域編集,below,btn:[編集領域追加])

   • このとき、設定ファイル（:config​/plugin^[31]/addline/領域編集）に以下のようなテンプレートを用意します。

     #areaedit
     *　月　日の　食の献立
     -
     #areaedit(end)

   • 例えば、ボタンを２回押してそれぞれ編集した様子を示したのが以下です（区別のために赤字で示しています）。お試しあれ。ちなみに、ここでも実験しています。覗いて見てください。→「[[sha:areaeditの実験２]]」

【表示例】

[編集領域追加]

[編集]

８月１３日朝食の献立

• 右上の[編集]リンクをクリックすると、以下の「８月１２日夕食の献立」とは別に編集エリアに表示されるので、その影響受けずに心理的にも気楽に編集出来ます。
  [編集]

８月１２日夕食の献立

• こんな風に編集できます。いろいろ…。

• #areaedit(end)が無い場合は、子要素のみが編集対象。
• インライン型もあるよ。&areaedit(){body};のbody部分が編集できる。
• ページ内のインライン型で記述された編集対象を収集。
• ページを凍結すれば、その部分のみ編集可能な場として提供できる。

補足説明

• 例えば、#commentを#areaeditと#areaedit(end)で囲っておくと、コメントのみが編集対象になるので修正が容易になる。
• デフォルトでは、ページが凍結されていたり、ページに編集権限がないと、このプラグインもそれに従うが、引数で影響を受けないように指定出来る。
• 編集エリアに#areaeditを記載することはできない。自動的にコメントアウト「//」される。
• #areaedit(end)が無い場合には、更に編集エリアに空行を記載することはできない。自動的にコメントアウト「//」が挿入される。
• 今回からインライン型のパーザーとして、make_link.phpのclass InlineConverterを利用してみた。PukiWiki^[12]がパージングするのと全く同じになるので検出ミスや対象間違いが防げるはず。

出所

自作プラグイン/areaedit.inc.php^[32]を参照 by nonn50^[33]

aws ^{[34] [35]}

機能概要

書式

#aws([Template name],[Search Index],[Keyword[36]],[Node Number],[Sort Mode],[No Header])

オプション

表示例

#aws(w5_2,Books,xoops[16])

出所

PukiWikiMod に含まれていた Amazon の ECS 4.0 を使った #aws プラグインを移植

block ^{[39] [40]}

機能概要

区分け、領域分けプラグイン(divタグで画面分割)
複数行引数に対応しています。

書式

#block([width][,left|center|right][,around][,font-size][,round]){{
表示する内容
}}

引数

width: 表示域の幅を % 又は px で指定します。

left center right: 左寄せ、センタリング、右寄せを指定します。width 指定をしないと無効になります。

around: 回り込み指定をします。

font-size: 表示フォントのサイズを % 又は px で指定します。

round: 表示域を角丸の枠で装飾します。

表示例

1 2 3 4 5 6 7

- | ! - | !

#block(left,width:50%,around){{ 右の領域 }} #block(left,width:50%,around){{ 左の領域 }} #clear

右の領域

左の領域

calendar9 ^{[43] [44]}

機能概要

Ajax対応calendar2 互換スケジュール管理プラグイン

出所

狩野太郎^[45]氏の自作PukiWiki^[12]プラグイン

• PukiWiki-officiaでの説明頁^[46]
• 狩野太郎氏サイトでの説明頁^[47]

表示例

#calendar9(calendar9サンプル)

^[83]休日の編集?^[83]

備考

xpWiki^[3]での設定 ini設定に「Ajax編集の有効・無効スイッチ」を設けました。 default.ini.php(デフォルトON) と keitai.ini.php(デフォルトOFF) です。

/////////////////////////////////////////////////
// Ajax edit
$root->use_ajax_edit = 1;

capture ^{[84] [85]}

種別

マルチライン型ブロックプラグイン

重要度

★★★★★

書式

#capture(key){{
内容
}}

概要

key をキーとして、あらかじめキャプチャしておき、あとで利用できるプラグインです。表の中に複数行に渡るブロックを表示したいときなどに、利用できます。

表示例

#capture(1){{
** vote のテスト
#vote(これはいい！,そうでもない)
まあ、こんな感じです。
}}
|表中|h
|#capture(1)|

code ^{[87] [88]}

機能概要

プログラムのソースコードの中に含まれるキーワードとコメントを色分けして表示

使い方

• 書式

  #code[([言語名] {,[menu|nomenu], [number|nonumber], \
  [outline|nooutline], [icon|noicon]}, ファイル名)|)]{{
  ソースコード
  }}

• WIKI上に直接記述する場合

  #code[(言語名,オプション)]{{
  ソースコード
  }}

• ファイル取り込み

  #code([言語名][,オプション],ファイル名)
  #code([言語名][,オプション],URL)

• こんな使い方もありました　By nonn50^[33]

  #code(xpWiki開発日記​/2008-04-05[89]/moblog.inc.php)

  表示例

  moblog.inc.php^[90]

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81

  <?php class xpwiki_[インストール[17]ディレクトリ名]_plugin_moblog extends xpwiki_plugin_moblog { function plugin_moblog_init () { parent::plugin_moblog_init(); ////// 必須設定項目 /////// // 受信用メールアドレス $this->config['mail'] = ''; // POPサーバー $this->config['host'] = 'localhost'; // POPサーバーアカウント $this->config['user'] = ''; // POPサーバーパスワード $this->config['pass'] = ''; // POPサーバーポート番号 $this->config['port'] = 110; // 送信元アドレスによって振り分けるページの指定 // ページ名空白 '' で無視(投稿登録中止) $this->config['adr2page'] = array( // 'メールアドレス' => array('ページ名', UserIDナンバー), // 'hoge@example.com' => array('日記', 1), // 設定例 'other' => array('', 0), // 登録メールアドレス以外 ); ////// 必須設定項目終了 ////// ////////////////////////////// ///// 以下はお好みで設定 ///// // refプラグインの追加オプション $this->config['ref'] = ',left,around,mw:240,mh:240'; // googlemaps の追加オプション $this->config['gmap'] = ',width=100%,height=300px,zoom=15,type=normal,overviewctrl=1,autozoom=1'; // 最大添付量（バイト・1ファイルにつき）※超えるものは保存しない $this->config['maxbyte'] = "1048576"; //1MB // 本文文字制限（半角で $this->config['body_limit'] = 1000; // 最小自動更新間隔（分） $this->config['refresh_min'] = 5; // 件名がないときの題名 $this->config['nosubject'] = ""; // 投稿非許可アドレス（ログに記録しない） $this->config['deny'] = array('163.com','bigfoot.com','boss.com','yahoo-delivers@mail.yahoo.co.jp'); // 投稿非許可メーラー(perl互換正規表現)（ログに記録しない） $this->config['deny_mailer'] = '/(Mail\s*Magic|Easy\s*DM|Friend\s*Mailer|Extra\s*Japan|The\s*Bat)/i'; // 投稿非許可タイトル(perl互換正規表現)（ログに記録しない） $this->config['deny_title'] = '/((未|末)\s?承\s?(諾|認)\s?広\s?告)|相互リンク/i'; // 投稿非許可キャラクターセット(perl互換正規表現)（ログに記録しない） $this->config['deny_lang'] = '/us-ascii|big5|euc-kr|gb2312|iso-2022-kr|ks_c_5601-1987/i'; // 対応MIMEタイプ（正規表現）Content-Type: image/jpegの後ろの部分。octet-streamは危険かも $this->config['subtype'] = "gif|jpe?g|png|bmp|octet-stream|x-pmd|x-mld|x-mid|x-smd|x-smaf|x-mpeg"; // 保存しないファイル(正規表現) $this->config['viri'] = ".+\.exe$|.+\.zip$|.+\.pif$|.+\.scr$"; // 25字以上の下線は削除（広告区切り） $this->config['del_ereg'] = "[_]{25,}"; // 本文から削除する文字列 $this->config['word'][] = "http://auction.msn.co.jp/"; $this->config['word'][] = "Do You Yahoo!?"; $this->config['word'][] = "Yahoo! BB is Broadband by Yahoo!"; $this->config['word'][] = "http://bb.yahoo.co.jp/"; // 添付メールのみ記録する？Yes=1 No=0（本文のみはログに載せない） $this->config['imgonly'] = 0; } } ?>

  指定したファイルが無い場合は、当然表示されません。

出所

PukiWiki^[12] 1.4.x 向けに sky さん、sakurai さんが開発されたプラグイン。 前記、使い方等についてはあさあさの公開メモ^[91]サイトの当該頁^[92]より転載しました。 また、同サイトにて詳細な説明があります。By nonn50^[33]

conf ^{[93] [94]}

機能概要

• 管理画面での環境設定フォーム

備考

• アクションプラグインになっていますので、管理者でログインしてから、?cmd=conf でアクセスしてください。 管理画面の「環境設定」メニューからもアクセスできます。

deldel ^{[97] [98]}

機能概要

複数ページを一括して削除するプラグイン

備考

deldel プラグイン^[99]に同 XOOPS^[16] 内の別の xpWiki^[3] にページを移動できるオプションを追加。 アクションプラグインになっていますので、管理者でログインしてから、?cmd=deldel でアクセスしてください。 管理画面の「環境設定」メニューからもアクセスできます。