<C-B> 重宝しているリスト表示プラグイン :: XOOPS マニア

17種の引数 (本家様現行Verは20種 by 2009-08-06調べ)

• xpWiki版lsxには無い機能があるとのこと。( 参照: (xoops.hypweb.net) )
  • たぶん「contentsオプション」とかじゃないかなぁ... Plugin/lsx.inc.php - Sonots' PukiWiki プラグインで内部的に contentsx.inc.php を使ってる、って書いてあり、
    • xpWikiには導入されてないはずだから。
• 引数には、大別して2種、選択系(静的)と記述系(動的)がある。
  • 選択系(静的) はbool値指定と、単語指定がある。
  • 記述系(動的) は任意数字記述と、任意文字列記述がある。
• bool値指定(bool型、boolean型、論理型とも呼ばれる)は、真、偽の2値より選択。(参考文献 WikiPedia.ja:ブーリアン型)

  指定方法>>	1(推奨)	2	3(例外有)	備考
  有効(真)	on	true	(Opt名のみ)	hierarchy は未記載でも有効など例外あり
  無効(偽)	off	false	(Opt未記載)

  
  
  • 指定方法1で、明示的に OptNo 0-4 は (Opt名=) on or off と記載する癖を付けること推奨 ( on と off はキーボードで修正が凄い楽)
  • 指定方法2も、意味的にわかりやすいが、trueの4文字、falseの5文字で、有効無効の修正が面倒 (はじめこっちでしたが楽なon,offへ移行)
  • 指定方法3の、Opt名のみを記載しての(=on無しの)、オプションの有効化は、誤解を招く元 (使わない方が良い)
    • 無効のための省略は、オプションが多数あるため、記述省力化のため、利用するのは正しいと思う。(当方は、経験的に、OptNo 0-4は非省略運用)
• 文字列、数字指定
  • (いずれ記載、したい )
• 以下、引数(オプション)17種の表

  OptNo	引数(オプション)	タイプ	省略時	設定値	説明
  10	tree	未確認
  11	non_list	未確認
  12	contents	未確認
  13	include	未確認
  14	linkstr	未確認
  15	link	未確認
  16	order	未確認
  0	hierarchy	bool値	on	on,off	階層的リスト表示設定
  1	sort	文字列	name	name,date,reading	ソート方法設定
  2	reverse	bool値	off	on,off	逆順ソート設定
  3	date	bool値	off	on,off	更新日付表示設定
  4	new	bool値	off	on,off	New!表示設定
  5	depth	数字	-	任意	下位階層指定設定
  6	num	数字	-	任意	表示件数設定
  7	prefix	文字列	./	任意	対象ページ接頭辞設定
  8	filter	文字列	-	任意	対象文字列設定
  9	except	文字列	-	任意	除外文字列設定

  
  
  • 当方使ってない OptNo 10-16 はすみません、ご容赦願います。

引数組合せ

(よく使う組合せで、選択系(静的)部分は定型化できるので、コマンド利用時は、InterWikiを使うのも有りかな?)

• Opt組合せによる傾向(系統)の考察(整理)

  系統	主	従	傾向(系統)概要	近しいプラグイン
  0	0:hierarchy=on	1:sort=name	階層(＆名前順)の基本表示のバリエーション	ls2.inc.php
  1	1:sort=date	0:hierarchy=off	時間軸(＆非階層)での表示のバリエーション	recent.inc.php
  (2)	(付随系)	2:reverse	(sort付随系)ソート昇順/逆順切替	-
  (3)	(付随系)	3:date	(各種付随系)更新日付表示/非表示	-
  (4)	(付随系)	4:new	(各種付随系)New!表示/非表示	-
  (5)	(付随系)	5:depth	(各種付随系)階層範囲設定	-
  (6)	(付随系)	6:num	(各種付随系)表示件数設定	-
  7	7:prefix	5:depth	基準(＆階層範囲)での表示のバリエーション	-
  8	8:filter	9:except	フィルタ(＆除外)での表示のバリエーション	-
  (9)	(付随系)	9:except	(各種付随系)除外指定設定	-

  
  

• 引数組合せ表作成前に、本ページにあった「使い方テスト」。一時的に退避し、2-Xのどこかに流用予定
  • X-X 最新更新の5件表示例
• 引数組合せの使い方サンプルページ表

  Opt種別>>	選択系(on/off等)					記述系(数字)		記述系(文字列)
  OptNo>>	0	1	2	3	4	5	6	7	8	9	10-
  使い方サンプルページ＼Opt名	hierarchy	sort	reverse	date	new	depth	num	prefix	filter	except	...	メモ
  0-- 階層リスト(基本形)	(on)	(name)	(off)	(off)	(off)	-	-	(./)	-	-		オプション使用皆無
  0-0 階層リスト(非省略)	on	name	off	off	off	-	-	-	-	-
  0-3 階層リスト(更新日時付き)	on	name	off	on	off	-	-	-	-	-
  0-4 階層リスト(New!付き)	on	name	off	on	on	-	-	-	-	-
  0-8 階層リスト(filter使用)	on	name	off	on	on	-	-	-	設定	-		正規表現使えると、更に強力っぽい
  0-9 階層リスト(except使用)	on	name	off	on	on	-	-	-	設定	設定
  1-- 非階層リスト(基本形)	off	(name)	(off)	(off)	(off)	-	-	(./)	-	-		hierarchy=offのみ
  1-0 非階層リスト(非省略)	off	name	off	off	off	-	-	-	-	-
  1-1~4正 非階層リスト(更新順)	off	date	off	on	on	-	-	-	-	-
  1-1~4逆 非階層リスト(古い順)	off	date	on	on	on	-	-	-	-	-
  1-5 非階層リスト(階層範囲指定)	off	date	on/off	on	on	設定	-	-	-	-
  1-6 非階層リスト(n件表示)	off	date	on/off	on	on	-	設定	-	-	-
  1-8 非階層リスト(filter表示)	off	date	on/off	on	on/off	-	設定	-	設定	-		newの動き注意あり
  1-9 非階層リスト(except表示)	off	date	on/off	on	on	-	設定	-	設定	設定

  
  

• • ( )は、Opt未記載時を表し、括弧内の値がデフォルト値(のはず )
  • #lsxをテストするためには、下位ページがあるページを基準にする必要あるため、prefix=../../としているのが殆どです。、