オプション（引数）一覧
| オプション | 機 能 | 携帯 |
|---|
| i | 携帯用ページの表示（携帯への切り替えは自動判別していますが明示的に携帯用の表示であることを設定します） | ○ |
| id:xxxx | 表示させるジャンル(xxxx)を指定します
バックナンバーを表示させる場合はバックナンバーのファイル名をジャンル名の後に半角の / に続けて指定（拡張子は不要、例：id:xxx/yyy）
| ○ |
| rec:1 | 詳細ページをメニューのように一覧で表示させるテンプレートを使う場合に詳細ページを単独で表示します
例：<a href="/cgi-bin/whatsnew/whats_display.cgi?id:xxx+rec:1">What's New Index</a> |
|
call:xxxx
recc:xxxx | 呼出キーで表示する詳細ページを指定します（半角英数字）
callカスタム番号:xxxxで呼出キーのカスタム番号を指定することもできます（指定無しは「初期設定」の呼出キー指定） |
|
| max:xx | 表示させるメニューの最大件数(xx)を指定 |
|
| start:xx | メニューに表示させる最初のレコードNo.(xx)を指定 | ○ |
| date:2004/02 | 表示させるメニューの年月を指定する（年だけ、年月日の指定も可能、/で区切る） | ○ |
| nolimit | 表示させるメニューの掲載終了日をチェックしない（掲載終了日を過ぎていても表示する） |
|
| pchk: | メニュー表示時に閲覧制限のID、パスワードを要求 |
|
| spl:xxx | 設定プログラムを whats_setxxx.pl で起動します |
|
| window:xxx | 詳細記事を新しいウインドウ xxx を開いて表示します（窓名を省略すると nowindow と同じ意味）
GreyBox で表示させる場合は window:greybox横幅x高さ（例：window:greybox800x600、* を指定するとフルスクリーンで表示、無指定は1000x600） |
|
| nowindow | ターゲットの指定があっても現在のウインドウに詳細を表示します。メニュー表示のリンクを GreyBox で表示させる場合などに指定すると GreyBox の二重オープンを防げます |
|
| nolink | 詳細へのリンクを行いません |
|
| target:xxx | 詳細を表示するフレーム、窓 xxx を指定する |
|
| fsize:xxx | 表示するフォントサイズを指定します |
|
| new:xx | xx日前までに公開された記事はメニューの年月日表示の後に New! と表示します |
|
| day:xx | xx日前までに公開された記事のみを表示対象にする |
|
| base:xxx | メニューページのテンプレートを指定します。ジャンル用はファイル名のみを共用のテンプレートは !ファイル名 、他ジャンルのファイルは ジャンル名/ファイル名 で指定。任意の場所のファイルはドキュメントルート（/）、またはサーバーのルートから指定します。 |
|
| sbase:xxx | 詳細ページのテンプレートを指定しますテンプレートを指定します。ジャンル用はファイル名のみを共用のテンプレートは%ファイル名で、他ジャンルのファイルはジャンル名/ファイル名で指定。任意の場所のファイルはドキュメントルート（/）、またはサーバーのルートから指定します。 |
|
| filter:xxx |
フィルター条件を指定して条件に合致するデータのみを表示させます。<LOOP>で指定するフィルターと同じ記述方法で記述します。
- フィルター条件の比較演算子一覧
| 文字比較 | 使用例 | 条件指定（例の場合カスタム項目3が） | 数字比較 | 使用例 | 条件指定（例の場合カスタム項目3が） |
|---|
| !eq!(!EQ!) | 3!eq!ABC | ABC,abc(ABC)と等しい | !Eq! | 3!Eq!123 | 123と等しい |
|---|
| !ne!(!NE!) | 3!ne!ABC | ABC,abc(ABC)と等しくない | !Ne! | 3!Ne!123 | 123としくない |
|---|
| !ct!(!CT!) | 3!ct!ABC | ABC,abc(ABC)を含む |
|
|
|
|---|
| !nct!(!NCT!) | 3!nct!ABC | ABC,abc(ABC)を含まない |
|
|
|
|---|
| !Gt! | 3!Gt!ABC | ABCより大きい | !gt! | 3!gt!123 | 123より大きい |
|---|
| !Ge! | 3!Ge!ABC | ABCより小さいか等しい | !ge! | 3!ge!123 | 123より小さいか等しい |
|---|
| !Lt! | 3!Lt!ABC | ABCより小さい | !lt! | 3!lt!123 | 123より小さい |
|---|
| !Le! | 3!Le!ABC | ABCより小さいか等しい | !le! | 3!le!123 | 123より小さいか等しい |
|---|
| !Rg! | 3!Rg!ABC_XYZ | 範囲内にある ABC>= 値 | !rg! | 3!rg!1000_2000 | 範囲内にある 1000>= 値 <2000 | |
|---|
| !etc! | 3!etc!大阪:京都 | 大阪、京都以外 |
|
|
|
|---|
| !Etc! | 3!Etc!大阪:京都 | 大阪、京都を含まない |
|
|
|
|---|
| !bl! | 3!bl!yes(no) | ブランク（yes)、ブランクでない（no) |
|
|
|
|---|
|
|
| !Bl! | 3!Bl!yes | 0（yes)、 0 でない（no) |
|---|
※文字比較と数字比較では結果が変わります。例えば 1234 と 99 を文字で比較すると 99 が大きいと判断されます。数字で比較しないと正しく判断されません。
※等しい、等しくないの条件のみ【文字比較】【数字比較】のパターンが逆になっていますので注意してください。
※条件の値がブランクの場合は条件に合致したと判定します。
※等しい、等しくない、含む、含まないの条件でアルファベットの大文字小文字を区別して判定したい場合は比較演算子を大文字で指定します。（例：!CT!）
- 評価は左から右に順番に行われます、優先順位をつけたりグループ分けする場合は半角の（ ）で括って指定してください。
以下のAのような例（カスタム項目1が1で且つカスタム4が1または2）では左から順番に評価されるため !or! の評価はうまく動作せずBのように記述しなければなりません。
A、1!eq!1!and!4!eq!1!or!4!eq!2
B、4!eq!1!or!4!eq!2!and!1!eq!1
しかし括弧で囲めば明確にわかりやすく記述できるようになります
1!eq!1!and!(4!eq!1!or!4!eq!2)
- 指定する値にカスタム番号の値を評価させる場合は custom番号 または Custom番号 を指定します。Custom はメニューページのカスタム項目です。
（例）1!eq!Custom5 カスタム項目番号1の値がメニュー項目のカスタム項目番号5の値と等しい。
- カスタム項目番号の前にand:(or:)を付けてカスタム項目番号を半角の:で区切って複数指定するとそれぞれのカスタム項目と値との比較を and または or での複合条件比較されます。（and:(or:)を省略すると or となります）
例：or:3:5:7!eq!abc カスタム３，５、７のどれかが abc と等しい条件になります。
- 指定する値の前にand:(or:)を付けて指定する値を半角の:で区切って複数指定するとそれぞれの指定する値とカスタム項目の値との比較を and または or での複合条件比較されます。（and:(or:)を省略すると or となります）
例：3!eq!or:abc:def:ghi カスタム３の値が abc、def、ghiのどれかと等しい条件になります。
- 比較演算子に etc を使う場合は、指定する値を半角の:で区切って複数指定するとそれぞれの指定する値がカスタム項目と等しくない（以外）となります。（例：3!etc!大阪:京都）
含まれないとする場合は Etc を使用します。（例：3!Etc!大阪:京都）
- 指定する値には特殊記号（/*!"#$%&'()=~|\+-?}{[]<>,等）は使えません。
- （例）1!eq!news!or!2!ne!dog!and!3!eq!cat カスタム項目番号1の値が news であるかカスタム項目番号2の値が dog でなく、かつカスタム項目番号3の値が cat であるデータのみをメニューに表示します。
- フィルター条件に全角の文字を使う場合、全角の文字をURLエンコードで変換するする必要があります。スーパーバイザーメニューにURL変換がありますのでそちらで変換してください。
filter:1!eq!大阪 をURLエンコードすると filter:1!eq!%91%e5%8d%e3（シフトJISの場合）になります。
- オーナーID（ジャンルID）、タイトル、記事、登録日を指定する場合はカスタム番号のかわりにオーナーID=991、タイトル=992、記事=993、登録年月日=994、登録更新年月日=995 を指定します。
（例）994!eq!2006/10/10!or!992!ne!dog 登録日が 2006/10/10 またはタイトルが dog と等しくない
登録年月日、登録更新年月日を指定する場合は当日からの日数で日付を指定することできます。（例）994!gt!-30 登録日が本日から30日前までのデータ。
- Tips フィルターのカスタム番号に997を指定すると「初期設定」で閲覧制限を「個別の記事にかける」を指定している場合にパスワード制限が掛かっている記事と掛かっていない記事を分けて表示することができます。
パスワード制限が掛かっている記事を表示（997!eq!1）、パスワード制限が掛かっていない記事を表示（997!eq!0）
- Tips 子ジャンルや登録者IDを指定している親ジャンルを表示する場合に子ジャンルや登録者IDのそれぞれの最新のデータのみを表示させることができます。
（例）1!owner_new! 各子ジャンルの最新の1件のデータ、2!owner_new! 各登録者IDの最新の2件のデータ
- Tips 比較する値に !cook!クッキー保存名 を指定するとクッキーに保存されている値を比較条件とすることができます。
以下の例のように保存された値を参照させる場合は 3!eq!!cook!cooktest と記述します。カスタム項目3の値がクッキー保存名 cooktest で保存された値と等しいときにという条件になります。
クッキーへの保存の手順は説明ページで
- カスタム番号を 991 で指定するとオーナーID（ジャンルID）を比較対象に、 992 を指定するとタイトルを比較対象に、 993 を指定すると記事を、994 を指定すると登録年月日、995 を指定すると登録、更新年月日を、997を指定すると閲覧制限デ-タを比較対象にします。
年月日のフォーマットは 9999/99/99 ですので比較は文字（テキスト）の比較演算子を使います。
|
|
| all | filter や search でのデータの検索は全てのデータが対象にはなりません。データ登録時にWebに掲載にチェックを入れていないデータや掲載期間を外れたデータなどは検索対象外となります。
全てのデータを検索対象とする場合は all オプションを指定します。
|
|
| sort:カスタム番号x桁数y |
- メニューページを表示する時に該当するデータをカスタム項目の値でソートしてから表示します。
x の位置には n（値を数字としてソート）または c（文字としてソート）、桁数にはカスタム項目の値が取りうる最大の桁、バイト数を、y の位置には B（大〜小ででソート）または S（小〜大でソート）を指定します。
- x、桁数、y は省略できます、x は省略すると「文字項目」、y は省略すると「小〜大」が、桁数は数字は11桁、文字は16バイトが初期値になります。
- 複数のカスタム項目でソートを行う場合は半角の : で区切って続けます。例：sort:3n:5cS 昇順、降順どちらで並べるかは最後の指定が全体に採用されます（個別に昇順、降順を変えることはできません）。
- 登録年月日でソートする場合はカスタム番号に 994 を指定します。
登録、更新年月日でソートする場合はカスタム番号に 995 を指定します。
タイトルでソートする場合はカスタム番号に 992 を指定します。
- 数字項目を指定した時は値の中の数字、小数点以外は削除してからソートします。（「価格\15,000」も処理できます）
コードなど桁数が固定の数字項目は文字項目として文字数を指定して処理するほうが効率的に処理できます。（例：sort:3c2S、カスタム番号３の値を文字として比較し小さいものから並べ替えて表示します、カスタム番号３の値の最大バイト数は2バイトです）
- 数字項目はマイナスを処理できません。（プラスの数字と判断します）
整数部11桁、小数点以下3桁を超えた数字は処理できません。
文字項目は半角16文字までをソート対象にします。（初期値）
対象文字数（最大文字数）は次のように指定して処理すると効率的に処理できます。（例：sort:3c2S、カスタム番号３の値を文字として比較し小さいものから並べ替えて表示します、カスタム番号３の値の最大バイト数は10バイトです）
文字の処理できるソート対象文字数の初期値は設定ファイル whatsnew_set.pl で変更することができます。
- （例：sort:3nS、カスタム番号３の値を数字として比較し小さいものから並べ替えて表示します）
※注意 <!--page--> タグを使用してメニューを分割して表示して表示し、ページの中に並べ替えリンクがある場合はページで表示されているデータの中での並び替えではなく全体が並び替えられます。そのため並び替え後の表示は違ったデータの一覧になることにご注意下さい。
- カスタム項目の値を 998n を指定した場合はソートキーとしてランダムな数字が割り当てられます。そのため他のキーと組み合わせるとランダム表示が可能です。
（例：sort:1n:998c カスタム項目1順でランダムに表示されます）
※注意 表示最大数を指定し <!--page--> タグを使用してメニューを分割して表示している場合は表示ページ以外のメニュー頁に移動した時、データ全体で再度ランダム化が行われますので表示済みの同じデータが重複して表示される可能性があります。
<!--page--> タグを使用しないか <!--page0--> タグを使用して総数と表示数のみを表示するようにして下さい。
|
|
| sort:R |
- メニューページを表示する時に該当するデータをランダムに表示します。
※注意 表示最大数を指定し <!--page--> タグを使用してメニューを分割して表示している場合は表示ページ以外のメニュー頁に移動した時、データ全体で再度ランダム化が行われますので表示済みの同じデータが重複して表示される可能性があります。
<!--page--> タグを使用しないか <!--page0--> タグを使用して総数と表示数のみを表示するようにして下さい。
|
|
search:キーワード
SEARCH:キーワード |
- テキスト項目にキーワードが含まれるデータのみをメニューに表示します（全文検索）。
半角アルファベットの大文字小文字を区別して比較したい場合は SEARCH を使ってください。
- キーワードをANDで複数指定したい場合はキーワードをブランクで区切ります。
キーワードをORで複数指定したい場合はキーワードを|で区切ります。
AND、ORを組み合わせることはできません。
- キーワードに全角が含まれる場合はURL変換する必要があります。スーパーバイザーメニューにURL変換がありますのでそちらで変換してください。
- Tips カスタム項目が選択項目で選択値と表示値を変えている場合（コード化など）に全文検索を行うと表示値がキーワードで指定されるとマッチしません。そのような場合は x を付けて指定すると選択値を表示値に展開して検索されますのでマッチするようになります。
例：searchx:キーワード
|
|
| rep:任意テキスト | 指定した任意テキストをテンプレートの %rep% と置き換えます。
ショッピングカートCGIと組み合わせて使用する場合などでカートIDなどをセットすることができます。
Tips %rep% を <font color=%rep,aaa=red,bbb=blue,ccc=yellow%> のように半角の,で区切って指定すると任意テキストの値によって表示を変えることもできます。この例の場合は任意テキストが aaa の場合は red を bbb の場合は blue を ccc の場合は yellow を挿入します。
使用例：<font color=%rep,aaa=red,bbb=blue,ccc=yellow%>
|
|
| D:半角数字 | テンプレートのカスタムタグと組み合わせて使用します。
<!--custom2D=3-->この例ではカスタム番号２は D:3 オプションで表示させた場合にのみ置き換えが実行されます。 |
|
| pfix:xxx |
- 詳細ページへのリンクはHTML書出処理で生成した静的詳細ページとします。xxxではHTML書出処理に使った設定ファイル名を指定します。
- この機能を使う場合は事前に詳細ページの全ページをHTML書出処理で生成しておいてください。
またその際の使用テンプレートに前後のページへのリンクに置き換えるエンドタグを使用していると、フィルターや検索を指定して表示すると結果に該当しないページへリンクしますのでご注意ください。
- この現象を避けるためエンドタグはインデックス(メニュー）ページのみへのリンクを指定してください。<!--END ,インデックス--><!--[ index ]-->
|
|
| watch | クッキーに保存させておいたワッチリストの詳細データをメニュー表示します。
watch:ユニークIDリスト でユニークIDリストを指定するとクッキーではなくユニークIDリストの詳細データをメニュー表示します。
ユニークIDリストは複数指定する場合は半角の:で区切って続けて指定します。
ユニークIDをテンプレートでセットするにはタグ <!--uniq_id--> を使います。watch:<!--uniq_id-->
|
|
| form:フォームID | フォームメールプロのクッキー保存機能（以前に送信を行った方のデータをクッキーに保存して再送信時に項目にセット）を有効にするためのオプションです。
必要時にセットしてください。form_id はフォームメールプロのフォームIDを指定します。
一括資料請求を使うときに有効です。
フォームメールプロで保存したクッキーのドメインとパスがWhatsNewのクッキー読込のドメインとパスと一致しなければ使用することはできません） |
|
| idx:リンク先URL | メニューから詳細へのリンクを同じWINDOWに表示した場合、詳細ページの「INDEX（メニュー）へ戻る」のリンクがうまく設定できません。そのような場合は、引数に idx:/index.html としメニューのリンク先を明示してやります。
+idx:URL指定
例：<iframe src="/cgi-bin/whatsnew/whats_display.cgi?id:news+base:top.html+idx:/index.html" name="xxx" width="xx" 〜 </iframe>
また、同じジャンルのメニューページへリンクさせる場合は、以下のようにURLの指定の先頭に!を付け引数から指定します。
引数の中に+がある場合は+を_plus_に変えて指定します。
例：+idx:!base:/aaa/ccc.html_plus_max:10（実際のリンク /cgi-bin/whatsnew/whats_display.cgi?id:news+base:/aaa/ccc.html+max:10）
|
|
| Custom | 詳細データを表示せずメニュー頁カスタム項目のみを表示させる場合に指定します。（余分な詳細データを読み込むことがありません） |
|
| php | PHPから表示プログラムを呼出して表示させる場合にテンプレートの<body>タグ前と</body>タグ以降を無視します
|
|
| script | <script>タグの箇所に What's New を表示させる場合に指定します
|
|
| read件数:ジャンル名 | 複数のジャンルのタイトルメニューの一覧を表示させることができます 参照 |
|
| cntup:カスタム番号 | カスタム番号の値の件数をカウントします。検索フォームのテンプレートなどで有効に機能します。
whats_display.cgi?id:test+cntup:3 この例ではカスタム項目3の値で件数をカウントします。（テンプレートでは<!--cnt:カスタム項目3の値-->を配置します）
whats_display.cgi?id:test+cntup:3C2 この例ではカスタム項目3の値にメニュー項目カスタム番号2の値（半角,で区切られたキーテキスト）が含まれている件数をカウントします。
例えばメニュー項目カスタム番号2の値が大阪,東京,名古屋であればカスタム項目3の値によって大阪,東京,名古屋が含まれたデータ件数をカウントすることになります。（複数のキーテキストが含まれる場合は最初のキーテキストのみが適用されます、テンプレートでは<!--cnt:大阪-->〜<!--cnt:名古屋-->を配置します）
whats_display.cgi?id:test+cntup:3C2L この例ではカスタム項目3の値にメニュー項目カスタム番号2の値（半角,で区切られた数値）の範囲の件数をカウントします。
例えばメニュー項目カスタム番号2の値が1000,2000,3000であればカスタム項目3の値によって1000より小さい、2000より小さい、3000より小さいのそれぞれのデータ件数をカウントすることになります。（テンプレートでは<!--cnt:1000-->〜<!--cnt:3000-->を配置します） |
|