Nucleusポップアップ・ヘルプ

ファイル読み込み中、しばらくお待ちください（ファイルサイズはおよそ170KBです）。

後で追加/過去の日時での投稿

後で追加

アイテム追加フォームの「後で追加」オプションをチェックすることで、アイテムを指定した時間きっかりに公開することができます。指定された時間が来るまで、アイテムはサイトの公開された部分で見られることはありません。

この日時は、アイテムを追加するブログの「過去の日時での投稿を許可する」オプションが有効である場合を除いて、未来のものでなくてはなりません。

過去の日時での投稿を許可する

この設定を有効にすると、アイテムを追加する時に、アイテムの投稿日時を過去に指定することができるようになります。また、既存のアイテムの投稿日時を編集することもできるようになります。

投稿日時の変更

「タイムスタンプを更新」オプションにより、アイテムの投稿された日付や時間を変更することができます。アイテムの内容を変更した時に、「タイムスタンプを更新」することで記事をブログののトップに戻すことができます。

しかし、そのアイテム独自のIDは変更されませんので、訪問者はアイテムのIDから、そのアイテムが編集後に投稿時間が変更されたものだと気づくことができます。

自動保存

最後に変更を加えてから10分後に、自動的にドラフトとして保存する機能です。投稿、または編集途中に他の用事が出来て、記事を保存するのを忘れてしまった時などに、不用意に編集内容を失わずにすみます。

もし、10分待たずに下書きを保存したくなったら、フォームの下の方にある｢ドラフト保存｣ボタンをクリックします。

この機能は、メンバーごとの設定でオン、オフを切り替える事が出来ます。

ドラフト(Drafts/草稿)

ドラフト状態のアイテムはブログの公開されたところでは閲覧することができません。推敲に時間をかけたい時や、、実際に投稿するまでに、少し時間を空けたいときなどに役に立つでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間があるときに、いつでも作業を再開することが可能です。

ドラフト状態のアイテムを編集する際に、「今すぐ追加」のラジオボタンを選んで「保存」ボタンを押すと、ドラフト状態が解除されてブログに公開されます。

「続き」部分

アイテムには、長文記事を分割して表示するために、オプションとして「続き」部分があります。例えば、記事がブログのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。テンプレートによって、表示の形態は変わってきますが、ブログのメインページを閲覧すると「続きを読む」というリンクが出現します。

もしアイテムの単なる概略として導入部分を書きたいのなら、smartbodyというテンプレート変数を用いることで、「本文」と「続き」の表示を分けることも可能です。

Blogの短縮名

「Blogの短縮名」は主に管理領域で、どのアイテムがどのブログと結びついているのか示すために使われます。

また、新規ブログを有効にするための代替indexファイルでも用いられます（以下は「Blogの短縮名」が「myshortblogname」の時の呼び出しファイルの例）：

<?php
    include('./config.php');
    selectBlog('myshortblogname');
    selector();
?>

標準のスキン

ブログが表示される時には、ブログごとの「設定」で選択された「標準のスキン」が使用されます。選択できるのは一つだけです。（URLの引数として指定することで、別のスキンで表示させることは可能です）

通知するメールアドレス

このオプションには、新しくコメントが追加された時などに通知するメールアドレスを、一つあるいは複数設定することができます。もし通知が不要なら空っぽにしておいてください。メールアドレスは、当然ですが、有効なものでなくてはなりません。

複数のメールアドレスを設定する場合には、各メールアドレスをセミコロン(;)で区切ってください。

コメントの最大量

メインの目次ページに表示するコメントの最大数です。これはコメント可能な最大数を制限するものではありません。個別アイテムページでは、設定した最大数を超えていても全てのコメントが表示されます。

注意： テンプレート内部では、テンプレート変数commentsの引数によってここでの値が上書きされます。

サーバ時刻との時差

もしサーバの時刻とあなたの住んでいる地域の時刻とが一致していなければ、ここにサーバとの時差を入力することで、Nucleus内部の時刻をあなたの住んでいる地域の時刻に合わせることができます（マイナス時差の地域に住んでいる場合は、マイナス記号付きで入力します）。参考のために現在のサーバの時刻が表示されています。

実例

あなたの住んでいる地域の時刻が20:35で、表示されているサーバの時刻が14:35のとき、ブログの時刻を20:35にするためには「サーバ時刻との時差」を6.0に設定します。

注意：30分刻みでの時差のある地域のために、0.5刻みで設定することができます。例えば「サーバ時刻との時差」を1.5に設定すると、1時間30分の補正となります。

自動更新するファイル

ブログに新しいアイテムが追加された時に、上書きするファイルのパスを入力します。このファイルは、新しいアイテムが追加されるたびに最終変更時のタイムスタンプが上書きされ、外部からはこのファイルを参照することで、ブログに更新があったかどうかをチェックすることができます。このファイルは訪問者によるコメントが追加された時や、スキン/テンプレートに変更を加えた時には更新されません。アイテムが追加されてブログの記事に変更があったときに更新されるので、「Weblogの更新状況」等を作成するサービスに使うことができます。

自動更新されるファイルが必要ないときは、フィールドを空っぽにしておいてください。

自動更新されるファイルの場所は管理領域からの相対パスでも指定することが可能ですが、 /path/to/your/website/update.txt のようにより確実な絶対パスを使った方が良いでしょう。また自動更新されるファイルを作成し、かつそのファイルに書き込みができるように、自動更新ファイルとそれを作成するディレクトリのパーミッションを0666にしてください。

Blogの管理者

Blogの管理者は次のような追加権限をもちます：

• チームの操作
• Blog設定の変更
• 投稿者に関係なく、該当Blogのどのアイテムでも編集や削除が可能
• Blogの削除

一つのブログは複数の管理者を持つことができます。各ブログには、最低でも一人の管理者がいなくてはなりません。

管理者の特権

super-admin（最高管理者）と呼ばれ、ブログのチームへの所属とは無関係に、全ての機能と全てのブログにフルアクセスできます。

またsuper-adminは、ブログの作成、グローバル設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作（メンバーの作成/編集/削除）を行う権限があります。

super-adminとなるのは通常サイトの管理者ただ一人でしょう。

管理者領域へのログイン

super-adminはそれぞれのメンバーを、管理領域へのログインを許可しないよう設定できます。

既定のBlog

サイトへの接続時にブログが指定されていない場合に表示されるブログです。

基本のスキン

適用すべきスキンが見つからなかった時に代用するスキンを設定します。これはスキン・パーツが設定されていなかったり、スキンが明確に指定されていなかったりした時に起こります。

ほとんどのユーザーは、この設定を気にする必要がありません。

Cookie設定

ログインCookieの有効期間

デフォルトでは、メンバーがログインするとブラウザにcookieが保存され、翌日に戻ってきたときに再びログインする必要がなくなります。クッキーの有効期間によって、いつ無効になるか決定されます。

• セッションごと ブラウザを終了させるとcookieは削除されます。
• 一ヶ月 一ヶ月続けてサイトか管理領域を訪れないというようなことが無い限り、cookieはコンピュータに残り続けます。このオプションを使えば、おそらく再ログインする必要はなくなるでしょう。（自分でログアウトしたときや、他のコンピュータからログインするときは別ですが）

CookieパスとCookieドメイン

これらは高度な設定です。通常は、cookieパスは単純にスラッシュ（'/'）、cookieドメインは空っぽの状態から変更する必要はありません。

セキュアCookie

通常は「いいえ」に設定してください。HTTPSのurlを用いており、cookieの送受信をhttps接続を通してのみに限定したい時だけ、この設定を「はい」にします。

最終訪問日時Cookieの保存

訪問者が最後に訪れた時間をcookieに保存させるように設定することができます。これによって、新規アイテムの隣にマークを付けることができます。

言語

Nucleusが生成する個々のメンバー用のコンテンツを作成するときに用いられる言語を選択することができます。Nucleusによって生成されるコンテンツには、管理領域、エラーメッセージ、スキンにおけるフォームなどが含まれます。

言語の選択を行う場所は二ヶ所あります。一箇所目は「グローバル設定」で、デフォルトで用いられる「既定の言語」を設定します。もう一箇所は、各「メンバーの編集」ページの設定でメンバー毎ログイン時の使用言語を設定することができます。

これら両方の設定が無効の場合、英語がデフォルトの言語として用いられます

注意： 追加の言語ファイルはNucleusのウェブサイトからダウンロードできます。（新規ウィンドウが開きます）

アカウントの作成

訪問者に自身のメンバーアカウント作成を許可することができます。新規メンバーは管理者がチームに加えるまでは、ブログにアイテムを追加することはできませんが、自分のコメントを削除したり変更したりすることが可能です。新規メンバーのログイン許可を許可している場合、管理領域にログインして自分の設定を変更することもできます。

新規メンバーのログイン許可

この設定は、訪問者によるアカウントの作成を許可している場合に、その方法で作られたアカウントを使用して管理領域にログインできるかどうかを設定します。

メッセージサービス

メンバー間メッセージサービス

メンバーのプライバシーのために、メールアドレスを隠したままで、スクリプトを通してメンバー同士でメールメッセージの送信ができます。送信されたメッセージには両ユーザーのメールアドレスが含まれますので、その後は通常のメールを用いた連絡を続けることができます。このサービスは無効にすることが可能です。

メンバー以外のメッセージサービス

デフォルトでは非メンバーは、入力されたメールアドレスが有効なものかチェックする方法が無いために、メッセージサービスを使用できません。「メンバー以外からのメッセージ送付を許可」することによってこの制限を緩和できます。非メンバーはメッセージの投函時にメールアドレスを尋ねられ、そのアドレスがメールのヘッダーFrom:に表示されることになります。

サイトの閉鎖

Nucleusのサイト全体を閉鎖することが可能です。なんらかの設定調整を行うときに、あるいは何か恐ろしい間違いが起きた時にこれを実行したいと思うかもしれません:-)

チェックボックスを「はい」に設定した場合に、訪問者はここで設定したURLにリダイレクトされます。

例外：管理領域は閉鎖していない時と同様に利用可能であり、最高管理者は通常通りサイト全体を閲覧することができます。（あとでサイトを再開することを忘れないでください;-)）

URLモード

このオプションを用いることにより、URLスタイルを切り替え可能です：

• Normal: URLは次のようになります http://example.jp/index.php?itemid=1234
• Fancy: URLは次のようになります http://example.jp/item/1234

注意：「Fancy URL」モードで動作するようにするためには、この設定のほかにもいくつかの作業が必要になります。詳しい解説はTips & Suggestionsに記述されています。（新規ウィンドウが開きます）

一覧の既定の表示数

一覧表示画面で一度に表示するブログ、アイテム、コメントの数を入力します。初期値は｢10｣です。

デバッグモード

｢はい｣に設定すると、システム情報を表示したり、対応しているプラグインをデバッグモードにしたりできます。

テンプレート：アイテム

アイテム表示時に、それぞれのアイテムで次のセットが繰り返されます：

アイテムのヘッダー
アイテムの本体
アイテムのフッター

「ヘッダー」、「本体」「フッター」の3つのブロックは、それぞれテンプレートの一部として、どのような見た目になるのかを定義します。

変数

これらのテンプレート内では、アイテムのデータを挿入するのにテンプレート変数とよばれる系列が利用できます。

例

テンプレート：アイテムの例

テンプレート：アイテムの例

「アイテムの本体」テンプレートの一例です：

<h1><%title%></h1>

<p><%body%></p>

<div class="metadata">
 <a href="<%itemlink%>">link</a> -
 <%date%> <%time%> -
 <a href="<%authorlink%>"><%author%></a> -
 <%comments%>
</div>

結果は次のようになります：

テンプレート：コメント

コメントブロックは3つの要素で構成されています。

1. コメントが表示されるとき（ブログの設定、もしくは「コメント本体」のテンプレート内の<%comments%>の引数で許可されているコメントの最大数を下回っているとき）

   コメントのヘッダー
     コメントの本体（コメントの数だけ繰り返し）
   コメントのフッター

2. コメントがまったく無いとき

   コメントが無い時
   

3. コメントがあるが、許可されている最大数を上回っているとき（個別アイテムページでのみ表示されます）

   コメントが多すぎる時
   

コメントのテンプレート内部では、コメント関連テンプレート変数が利用できます。

テンプレート：コメントのヘッダーとフッター

特徴

「コメントの本体」はコメント一つごとに繰り返されますが、ヘッダーとフッターは一度しか表示されません。出力は次のようになります：

コメントのヘッダー
  コメントの本体 1
  コメントの本体 2
  コメントの本体 3
コメントのフッター

これらのテンプレート内では、コメント関連テンプレート変数が利用できます。

例

コメントのヘッダー:

<ul>

コメントの本体:

<li><%user%>: <%body%></li>

コメントのフッター

</ul>

結果は次のようになります

• hsur: そうでしたね。なんでソコ抱き合ってんの・・・っていう感じで
• satona: ぼくは、センセーとしましたよ。ハグ。
• hsur: ぇ！

テンプレート：続きへのリンク

これはアイテムのテンプレート（アイテムのヘッダー、アイテムの本体、アイテムのフッターの3つ）で利用できるテンプレート変数、"morelink"がどのように表示されるかを決めるものです。利用可能な変数はアイテムのテンプレートと同じです。

もしアイテムに「続き」の部分が存在しない場合、テンプレート変数<%morelink%>は無視されます。

例

<a href="<%itemlink%>">[続きを読む！]</a>

テンプレート：アーカイブリスト

過去ログのリストは、以下のようなリスト体裁をとります：

アーカイブリストヘッダー
  アーカイブリスト本体（アーカイブごとに繰り返し）
アーカイブリストフッター

利用できる変数：（ヘッダーとフッターではblogidのみが使用できます）

strftime変数を使用することで、日付の表記を自由にカスタマイズすることができます。この変数が複雑すぎると感じるなら、次のように記述すると良いでしょう。

<a href="<%archivelink%>">%B, %Y</a><br />

出力される時刻と言語をあなたの住んでいる地域にあわせるために、localeを適切に設定してください。

テンプレート：カテゴリーリスト

カテゴリーリストは下の表のようにフォーマットされます：

カテゴリーリストヘッダー
  カテゴリーリストアイテム（繰り返し）
カテゴリーリストフッター

利用可能な変数：（ヘッダーとフッターではblogid、 blogurl、selfのみが許可されています）

カテゴリーリストの例を見る

テンプレート：カテゴリーリストの例

「テンプレート：カテゴリーリスト」の解説に戻る

カテゴリーリストヘッダー

<ul>
  <li><a href="<blogurl%>">まとめて表示</a>< /li>

カテゴリーリストアイテム

<li><a href="<%catlink%>"><%catname%></a></li>

カテゴリーリストフッター

</ul>

結果はこうなります：

• まとめて表示
• あなたのカテゴリー
• わたしのカテゴリー

テンプレート：ブログリスト

ブログリストは次の様に出力されます：

ブログリストヘッダー
  ブログリストアイテム（存在するブログの数だけ繰り返し）
ブログリストフッター

ブログリストアイテムで利用可能な変数：

ヘッダーとフッターでのみ使用できる変数：

ブログリストの例を見る

テンプレート：ブログリストの例

「テンプレート：ブログリスト」の解説に戻る

ブログリストヘッダー

<ul>
  <li><a href="<%siteurl%>"><%sitename%></a></li>

ブログリストアイテム

<li><a href="<%bloglink%>" title="<%blogdesc%>"><%blogname%></a></li>

ブログリストフッター

</ul>

表示は次のようになります

• あなたのサイト
• あなたのブログ
• わたしのブログ

テンプレート：Locale

これは実際のところテンプレートの部品というより設定です。設定することによって、日付と時刻のローカライズを選択できます。月や曜日などは要求された言語での表示になるでしょう。

使える変数は、Nucleusが動作しているコンピュータによります。使える変数をいくつかあげますと･･･：

• en：英語
• dutch：オランダ語
• ja_JP：日本語
• ...

strftimeに関するより詳しい情報は、Open Group Specificationにあります。（新規ウィンドウが開きます）

locale は日付と時刻のフォーマット、日付ヘッダー、アーカイブリストで利用されます。

テンプレート：日付と時刻のフォーマット

これらは<%date%>と <%time%>という変数（詳細はテンプレート変数を参照）の日付と時刻の表示方法を設定します。フォーマットはLocaleにも左右されます。

利用できる変数の詳細な情報はこちら。もし手っ取り早く始めたいのなら、日付フォーマットに"%x"を、時刻フォーマットに"%X"をお使いください。

テンプレート：日付のヘッダー/フッター

日付のヘッダーと日付のフッターは、日付と時刻の変数を入力することができます。利用できる変数の詳細情報はこちらにあります。もし手っ取り早く始めたいのなら、日付フォーマットとして"%x"を使ってください。日付フォーマットで使われる言語は、テンプレートのLocaleで設定できます。

日付のヘッダーにテンプレート変数<%%daylink%%>を含めることによって、その日のアーカイブへのリンクを挿入できます。'%'が二つ続けてあることに注意！変数として展開される%dを無効にするために必要な措置です。 同様に、このテンプレート内で'%'という文字を使いたい場合は、二つ重ねて"%%"と記述しないとサイトには表示されません。

日付のヘッダーのサンプル：

<div class="day">
<h1>%d %B</h1>

日付のフッターのサンプル：

</div>

daylinkを用いた日付ヘッダーの例：

<div class="day">
<h1>%d %B</h1>
<a href="<%%daylink%%>">（アーカイブ）</a>

テンプレート：ハイライト表示

検索結果をハイライト表示するために、検索文字列を挟み込む(X)HTMLタグを入力します。"\0"と記述した場所が、検索文字列に置き換えられます。また、ここで入力された文字列は、プログラム中で正規表現のパターン構文数（新しいウィンドウが開きます）としてそのまま使用されますので、いくつかの記号はバックスラッシュを直前に置くことでエスケープしなければなりません。

例

<span style='background-color:yellow'>\0</span>

テンプレート：検索で何も見つからなかった場合

検索が実行され結果何も見つからなかった場合に表示されます。

利用可能な変数：

例

<b><%query%></b>に該当する検索結果はありませんでした

テンプレート：コメントの本体

このテンプレート・パーツは単独のコメント表示に使われます。このテンプレートでは、コメント関連テンプレート変数が利用できます。

例

<h2><%userlink%>さんによるコメント：</h2>

<p><%body%></p>

<div class="metadata">
 （接続元：<%host%> 投稿日時：<%date%> <%time%>）
</div>

結果は次のようになります：

テンプレート：メディアとポップアップ

これらのテンプレートは、画像のポップアップウィンドウへのリンクと画像以外のメディア・オブジェクトのフォーマットに用いられます。それぞれのテンプレートで利用可能な変数は以下の通りです。

ポップアップ画像へのリンクコード

インライン画像のコード

メディアオブジェクトへのリンクコード

テンプレート：登録メンバーからのコメントへの追加表示

これはコメントが登録メンバーからのものであることを示すのに利用できるテンプレートです。最終的にはコメントの本体で使われる<%authtext%>変数の中身として表示されます。

このテンプレート内部では、コメント関連テンプレート変数が利用できます。

テンプレート：コメントの続きを読む

このテンプレートの内容は、コメントの本体で使われる変数<%short%>に追加されます。

このテンプレート内部では、<%short%>以外のコメント関連テンプレート変数が利用できます。

例：

 <a href="<%itemlink%>">[続き]</a>

テンプレート：コメントの数え方

日本語で使う場合は、単複同型なので両方"件のコメント"にしておいて問題ないでしょう。英語で表記したい時は、次のようなことが気になるかもしれません。

コメントの件数の表示の仕方を、"1 comment(s)"とするよりも"1 comment"、"3 comments"と表示したい人が多いのではないでしょうか？「コメントが1つの時」と「コメントが2つ以上の時」のテンプレート部分はその目的のために存在します。これらは他の所で使える<%commentword%>変数の中身として利用されます。

1つしかコメントが無い時は、<%commentword%>は「コメントが一つの時」で設定した内容になり、2つ以上のコメントがついているなら「コメントが二つ以上の時」で設定した内容になります。

典型的な値は"comment"と"comments"です。ここでは変数は利用できません。

テンプレート：アイテムを編集するためのリンク

このテンプレートはテンプレート変数"edit"がどのように表示されるかを決めるものです。このテンプレートではすべてのテンプレート変数が使用できます。

例：

<a href="<%editlink%>"
   onclick="<%editpopupcode%>">編集</a>

スキン：メインの目次ページ

このスキンパーツはブログ内の最新のエントリーを表示するのに用いられます。通常はサイト、またはブログのトップページにあたる場所になります。

「メインの目次ページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ</title>
  </head>
  <body>

    <h1>私のウェブログ</h1>
    <%blog(mytemplate,20)%>

  </body>
</html>

このスキンでは、選択中のブログのアイテムが、タイムスタンプの新しいものから20個、'mytemplate'というテンプレートを使用して表示されます。

個別アイテムページ

このスキンパーツは個別のアイテムを表示するために使われます。アイテムに付けられた全てのコメントと、コメント追加フォームを含めたものになります。

「個別アイテムページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ :: アイテム</title>
  </head>
  <body>

    <h1>アイテム</h1>
    <%item(detailed)%>

    <h1>コメント</h1>
    <%comments(detailed)%>

    <h1>コメントを追加</h1>
    <%commentform%>

  </body>
</html>

このスキンでは、'detailed'テンプレートを使用してアイテムとコメント、そして標準のコメントフォームが表示されます。

スキン：月別アーカイブ一覧ページ

このスキンパーツはアーカイブが存在する全ての月の概略と、それらアーカイブへのリンクを表示します。

「月別アーカイブ一覧ページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ :: アーカイブ集</title>
  </head>
  <body>

    <h1>アーカイブ集</h1>
    <%archivelist(default)%>

  </body>
</html>

このスキンでは、'default'テンプレートを使用して、選択中のブログのアーカイブが存在する全ての月のリストが表示されます。

スキン：月別アーカイブページ

このスキンパーツは「メインの目次ページ」と似た振る舞いをしますが、該当月の全てのアイテムを表示します。

「月別アーカイブページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ :: アーカイブ</title>
  </head>
  <body>

    <h1>アーカイブ</h1>
    <%archive(default)%>

  </body>
</html>

このスキンでは、'default'テンプレートを使用して、選択中のブログの要求されたアーカイブが表示されます。

スキン：検索ページ

このスキンパーツは検索結果の表示に使われます。

「検索ページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ :: 検索</title>
  </head>
  <body>

    <h1>検索</h1>
    <%searchform%>

    <h1>検索結果</h1>
    <%searchresults(default)%>

  </body>
</html>

このスキンでは、'default'テンプレートを使用して検索の結果が表示されます。

スキン：エラーページ

このスキンパーツはエラーが発生したときに用いられます。

「エラーページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ :: エラー</title>
  </head>
  <body>

    <h1>エラーが発生しました！</h1>
    <%errormessage%>

    <br /><br />

    <a href="javascript:history.back();">戻る</a>

  </body>
</html>

このスキンでは、エラーメッセージと、元のページへ戻るためのリンクが表示されます。

スキン：メンバー詳細ページ

このスキンパーツはメンバーの詳細を表示するのに使われます。

「メンバー詳細ページ」の基本的な形：

<html>
  <head>
    <title>私のウェブログ :: メンバーの詳細</title>
  </head>
  <body>

    <h1><%member(name)%> の情報</h1>
    ウェブサイト：
    <a href="<%member(url)%>"><%member(url)%></a>

    <h1>メッセージを送る</h1>
    <%membermailform%>

  </body>
</html>

このスキンでは、メンバー名とメンバーのウェブサイトのアドレス、そしてメール送信フォームが表示されます。

スキン：画像ポップアップウィンドウ

このスキンパーツは画像をポップアップウィンドウを使用して表示する場合に使われる、ポップアップウィンドウ内のレイアウトを決定します。

「画像ポップアップウィンドウ」の基本的な形：

<html>
<head>
  <title><%imagetext%></title>
  <style type="text/css">
   img { border: none; }
  </style>
</head>
<body>
  <a href="javascript:window.close();"><%image%></a>
</body>
</html>

スキン：スペシャルスキンパーツ

このスキンパーツは、特別な見せ方をしたいコンテンツやブログの内容以外のコンテンツ、例えばフォームや静的なコンテンツ、もしくはNucleusとは切り離された動的なコンテンツ等を表示する為に使用します。 スペシャルスキンパーツは次のようにして表示します。 (fredという名前でスペシャルスキンパーツを作った場合)

このスキンタイプに関するさらなる議論は、NucleusCMS本家サポートフォーラムで行われています。: Nucleus 3.31 and Static Pages

標準的なスペシャルスキンパーツ:

<html>
  <head>
    <title>私のブログ</title>
  </head>
  <body>

    <h1>このサイトについて</h1>
    <p>This page was published in order
	to provide a platform to publicize the plight
	of the peeping-polly parrot whose present
	prognosis is perturbingly pessimistic.</p>

  </body>
</html>

この例は、ごく一般的なHTML文書として表示されます。 また、標準的なスキン変数が使えるので、ブログとの連系を持たせた静的ページを持たせたいときなどに役立つでしょう。

短縮名と表示される名前

ブログ、テンプレート、そしてスキンは名前や説明の他に短縮名を持たなくてはなりません。

短縮名はa～zと0～9のみで構成され、スペースを含むことはできません。

訳注：テンプレートの名前には'/'が利用できたりするので、実際にはこの限りではないようです。

メンバーの場合、「表示される名前」はログイン名として使われます。a～z、 A～Z、0～9とスペース（半角）が使用できます。ただし、名前の最初や最後にスペースを付けることはできません。

テンプレート：新しいアイテムに付けるマーク

最終訪問日時Cookieの保存オプションを「はい」に設定している時、前回訪問時から後に追加されたアイテムに、「新しいアイテムに付けるマーク」テンプレートの内容が、アイテムのテンプレートに記述した変数<%new%>の部分に表示されます。

「最終訪問日時Cookieの保存」が「いいえ」に設定されている、または前回訪問時以降にアイテムが新しく追加されていなければ、変数<%new%>は無視されます。

時間変数の概要

次の変換記述は文字列フォーマットに基づきます（PHPドキュメントのstrftime関数から持ってきたものです）。より詳しい情報は Open Group Specificationにあります。

• %a - 現在のロケールに基づく短縮された曜日の名前
• %A - 現在のロケールに基づく完全な曜日の名前
• %b - 現在のロケールに基づく短縮された月の名前
• %B - 現在のロケールに基づく完全な月の名前
• %c - 現在のロケールに基づく適当な日付と時間の表現
• %d - 日付を10進数で(01から31)
• %H - 時間を24時間表示の10進数で(00から23まで)
• %I - 時間を12時間表示の10進数で(01から12までの範囲)
• %j - 年間での日付を10進数で表現 (001から366)
• %m - 月を10進数で表現 (01から12)
• %M - 分を10進数で表現
• %p - 指定した時間により 'am' または 'pm' 、または 現在のロケールに対応した文字列
• %S - 秒を10進数で表現
• %U - 年間で何番目の週であるかを 10 進数で表現。 年間で最初の日曜を最初の週の最初の日として数えます。
• %W - 現在の年で何番目の週であるかを10進数で表現。 年間で最初の月曜を最初の週の最初の日として数えます。
• %w - 曜日を10進数で表現。日曜は0になります。
• %x - 時間を除いた日付を現在のロケールに基づき表現します。
• %X - 日付を除いた時間を現在のロケールに基づき表現します。
• %y - 世紀の部分を除いた年を10進数として表現。(00から99までの範囲)
• %Y - 世紀を含む年を 10進数で表現
• %Z - タイムゾーンまたはその名前または短縮形
• %% - 文字リテラル'%'

以下はサーバによって対応が異なりますので、参考程度にお試しください。

• %-dまたは%#d - 日付を10進数で(1から31)
• %-Hまたは%#H - 時間を24時間表示の10進数で(0から23まで)
• %-Iまたは%#I - 時間を12時間表示の10進数で(1から12までの範囲)
• %-mまたは%#m - 月を10進数で表現 (1から12)
• %-Mまたは%#M - 分を10進数で表現(0から59まで)

Pingサーバに更新通知を送信する

ブログを更新した時に、ブログ検索サイト等の公開している複数のpingサーバに更新pingを送信することができます。これらのpingサーバを用意しているサイﾄでは、リクエストに応じて最近更新されたブログのリストを提示してくれます。このデータを利用した新着記事のリスト等のサービスを、数多くのウェブサイトが提供していますので、このオプションを「はい」に設定することで、あなたのブログは新しい訪問者を得ることになるでしょう。

注意:この機能を正しく動かすために、blogごとの「設定」にあるweblogの「URL」と「Blogの名前」を埋める必要があります。

常に検索対象に含める

「常に検索対象にする」オプションが選択されていると、同一のNucleus内で行われたすべてのブログ内検索において、常に検索対象に含まれます。

例として、'lifelog'と'linkdump'という2つのブログを持ち、'linkdump'の「常に検索対象にする」が「はい」、'lifelog'は「いいえ」にになっていると仮定しましょう。そうすると、'lifelog'で検索した場合は'linkdump'も検索するのに対して、'linkdump'での検索では、'linkdump'のエントリーしか検索しません。

改行を変換する

Nucleusはアイテム内の改行を、デフォルトで<br />タグに変換します。この設定によって、アイテム内の改行箇所を出力後の(X)HTMLに反映させることができます。

手馴れたユーザーや、Semantic Web（brタグは情報を付加せず、ただ記述のためにのみ使われる）のために努力するユーザーの中には、この機能が迷惑だと感じるかもしれません。その場合はこのオプションを「いいえ」に設定してください。

メディア

Nucleusはメディアファイル（画像、動画、音楽など）をウェブサイトにアップロードすることができます。

このためにいくつかの設定が必要となります：

• メディア(画像・音声)ディレクトリ：メディアファイルが保存されるサーバー上の場所（サーバのファイルシステム上のパス）
• メディアURL：メディアファイルのURL上の場所
• ファイルのアップロードを許可しますか?：ファイルのアップロードを不許可にすることができます
• アップロードを許可するファイルタイプ：アップロードできるファイルの拡張子（複数必要な場合は、コンマで区切る）
• アップロードファイルの最大サイズ：ここで設定したものよりファイルサイズの大きなものはアップロードすることができません。
• アップロードするファイル名の頭に日付を付加する：アップロードされたファイルのファイル名の先頭に、現在の日付を付加するかどうかを選択します。このオプションで「はい」を選んでいると、例えば 'bunny.jpg'という名前のファイルを2008年9月5日にアップロードしたなら、'20080905-bunny.jpg'というファイル名になります。何故こんな機能があるかというと、大量のファイルをアップロードしているときについ同じ名前を用いてしまう問題を避けるためです。

メンバーはそれぞれ、自身のメディアファイルのプライベートなコレクションを持ちます。また、それ以外のメディア・ディレクトリ下のサブディレクトリはグローバルなコレクション（メンバー間で共有）とみなされます。

アップロードは悪用を予防するため、少なくとも一つのブログチームに入っているメンバーでなくては行えません。

メンバー名の保護

訪問者によるメンバーへの成りすましを防止するために、メンバーとして登録済みの名前を使ってのゲストコメントはできないようになっています。このオプションを「いいえ」に設定することで、この規制を緩和することができます。

プラグインURL

この設定はプラグイン管理領域のベースURLです。通常次のようになります。

http://example.jp/nucleus/plugins/

スキンURL

この設定はNucleusスキン・ディレクトリのベースURLです。通常次のようになります。

http://example.jp/skins/

action.phpへのフルURL

この設定はNucleus付属のスクリプトaction.phpの絶対URLです。通常次のようになります。

http://example.jp/actions.php

アイテムの追加

ブログにアイテムを追加する際、「本文」「タイトル」「続き」に4種類の変数を利用することができます：

• <%popup(...)%> ポップアップ画像の挿入
• <%image(...)%> インライン画像の挿入
• <%media(...)%> メディアオブジェクトの挿入
• <%plugin(...)%> プラグインによる処理

<%plugin%>以外のこれらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。

スキン変数：referer

リンク元のURLを挿入します。アクセス方法や、ブラウザ、ファイアウォール等の設定によって、空白の時があります。

引数

なし

スキンタイプ

全て

例

<a href="<%referer%>">戻る</a>

スキン変数：itemid

現在選択しているアイテムのIDを挿入します。

引数

なし

スキンタイプ

個別アイテム

例

<%itemid%>

スキン変数：itemlink

アイテムのURL（permanent link）を挿入します。

引数

スキンタイプ

個別アイテム

例

<%itemlink%>

スキン変数：itemtitle

アイテムのタイトルを挿入します。HTMLタグは除去され、エンティティはエンコードされます。

引数

なし

スキンタイプ

個別アイテム

例

<%itemtitle%>

スキン変数：archivedate

アーカイブの日付としてフォーマット済みの日付を挿入します。パラメーターなしで使うと、例えばアーカイブが2008年9月のものなら、'05 september 2008'か'september 2008'のどちらかが挿入されることになります。

引数

• オプション：

  名前	値
  Locale	日付がフォーマットされるときに用いられるLocale
  Format	日付のフォーマット（strftime変数）

スキンタイプ

月別アーカイブ

例

Archive for <%archivedate%>
Archive for <%archivedate(dutch)%>
Archive for <%archivedate(en,%B %Y)%>

スキン変数：blog

選択中のブログの、タイムスタンプの新しいアイテム群を挿入します。

引数

スキンタイプ

メインの目次、個別アイテム、月別アーカイブ、月別アーカイブ一覧、検索

例

<%blog(default,15)%>
<%blog(default,5(15))%>
<%blog(mytemplate)%>
<%blog(mytemplate,5,mycategory)%>

スキン変数：bloglist

Nucleusで管理しているブログのリストを、指定されたテンプレートを用いて挿入します。

引数

スキンタイプ

全て

例

<%bloglist(mytemplate)%>
標準。「mytemplate」を使って、ブログの一覧を｢ブログ名｣で表示します
<%bloglist(mytemplate,shortname)%>
「mytemplate」を使って、ブログの一覧を｢ブログの短縮名｣で表示します
<%bloglist(default/index,name,description)%>
「default/index」を使って、ブログの一覧を｢ブログの説明｣で並べ替えて｢ブログ名｣で表示します。
<%bloglist(default/index,shortname,,desc)%>
「default/index」を使って、ブログの一覧を｢ブログ名｣の降順で並べ替えて｢ブログ短縮名｣で表示します。

スキン変数：otherblog

指定されたブログの、タイムスタンプの新しいアイテム群を挿入します。

引数

スキンタイプ

全て

例

<%otherblog(myblog,default,15)%>
<%otherblog(yourblog,mytemplate)%>
<%otherblog(yourblog,mytemplate,15,mycategory)%>
<%otherblog(yourblog,mytemplate,5(15),mycategory)%>

スキン変数：item

現在選択されているアイテムを、指定されたテンプレートを用いて挿入します（コメントは挿入されません）。

引数

• 必須：

  名前	値
  template	使用するテンプレート名

スキンタイプ

個別アイテム

例

<%item(mytemplate)%>

スキン変数：comments

現在選択されているアイテムについているコメントを、指定されたテンプレートを用いて挿入します。

引数

• 必須：

  名前	値
  template	使用するテンプレート名

スキンタイプ

個別アイテム

例

<%comments(mytemplate)%>

スキン変数：archive

選択されているブログの選択された月のアーカイブを、指定されたテンプレートを用いて表示。

引数

スキンタイプ

月別アーカイブ

例

<%archive(mytemplate)%>
<%archive(mytemplate,mycategory)%>

スキン変数：otherarchive

指定されたブログの選択された月のアーカイブを、指定されたテンプレートを用いて表示。

引数

スキンタイプ

月別アーカイブ

例

<%otherarchive(myblog,mytemplate)%>
<%otherarchive(myblog,mytemplate,mycategory)%>

スキン変数：archivelist

現在選択しているブログに存在するアーカイブの月ごとのリストを、指定されたテンプレートを使って挿入します。

引数

スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム

例

<%archivelist(mytemplate)%>
<%archivelist(mytemplate,mycategory)%>

スキン変数：archivedaylist

スキン変数archivelistと同様にアーカイブのリストを挿入しますが、月ごとの代わりに日ごとのアーカイブのリストを挿入します。

引数

スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム

例

<%archivedaylist(mytemplate)%>
<%archivedaylist(mytemplate,mycategory)%>

スキン変数：otherarchivedaylist

スキン変数otherarchivelistと同様に、指定されたブログのアーカイブのリストを挿入しますが、 月ごとの代わりに日ごとのアーカイブを挿入します。

引数

スキンタイプ

全て

例

<%otherarchivedaylist(yourblog,mytemplate)%>
<%otherarchivedaylist(yourblog,mytemplate,mycategory)%>

スキン変数：otherarchivelist

指定されたブログに存在するアーカイブ月ごとのリストを、指定されたテンプレートを用いて表示します。

引数

スキンタイプ

全て

例

<%otherarchivelist(yourblog,mytemplate)%>
<%otherarchivelist(yourblog,mytemplate,mycategory)%>

スキン変数：categorylist

選択中のブログのカテゴリーリストを、指定されたテンプレートを用いて挿入します。

引数

スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム

例

<%categorylist(mytemplate)%>
<%categorylist(mytemplate,myweblog)%>

スキン変数：category

現在選択されているカテゴリーに関する情報を挿入します。カテゴリーが選択されていないときは何も挿入されません。

引数

スキンタイプ

全て

例

<%category%>
<%category(id)%>
<%category(desc)%>
<%category(name)%>

スキン変数：searchresults

現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。

引数

スキンタイプ

検索

例

<%searchresults(mytemplate)%>

スキン変数：othersearchresults

指定されたブログの、現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。

引数

スキンタイプ

検索

例

<%othersearchresults(myblog,mytemplate)%>

スキン変数：query

現在の検索文字列を挿入します。

引数

なし

スキンタイプ

検索

例

<%query%>

スキン変数：version

現在使用しているNucleusのバージョンを挿入します。

引数

なし

スキンタイプ

全て

例

<%version%>

スキン変数：charset

グローバル設定の既定の言語で設定した言語に基づいたキャラクターセットのコードを挿入します。日本語版では、'UTF-8'か、'EUC-JP'の何れかになります

引数

なし

スキンタイプ

全て

例

<meta http-equiv="Content-Type" content="text/html; charset=<%charset%>" />

スキン変数：previtem

そのブログにおける一つ古いアイテムのIDを挿入します。

引数

なし

スキンタイプ

個別アイテム

例

<%previtem%>

スキン変数：nextitem

そのブログにおける一つ新しいアイテムのIDを挿入します 。

引数

なし

スキンタイプ

個別アイテム

例

<%nextitem%>

スキン変数：nextitemtitle

そのブログにおける一つ新しいアイテムのタイトルを挿入します。

引数

なし

スキンタイプ

個別アイテム

例

<%nextitemtitle%>

スキン変数：previtemtitle

そのブログにおける一つ古いアイテムのタイトルを挿入します。

引数

なし

スキンタイプ

個別アイテム

例

<%previtemtitle%>

スキン変数：prevarchive

表示中のアーカイブの形式に応じて、一つ古いアーカイブの月、または日を挿入します。

引数

なし

スキンタイプ

月別アーカイブ

例

<a href="index.php?archive=<%prevarchive%>">....

スキン変数：nextarchive

表示中のアーカイブの形式に応じて、一つ新しいアーカイブの月、または日を挿入します。

引数

なし

スキンタイプ

月別アーカイブ

例

<a href="index.php?archive=<%nextarchive%>">....

スキン変数：archivetype

日単位か月単位、どちらのアーカイブタイプが現在表示されているのか示す。

引数

なし

スキンタイプ

月別アーカイブ

スキン変数：todaylink

選択中のブログ、あるいはカテゴリーのトップページのURLを挿入します。

引数

スキンタイプ

全て

例

<%todaylink%>

スキン変数：archivelink

選択中のブログ、あるいはカテゴリーのアーカイブへのリンクを挿入します。

引数

スキンタイプ

全て

例

<%archivelink%>

スキン変数：nextlink

アイテムページでは一つ新しいアイテムへの、アーカイブページでは一つ新しいアーカイブへのURLを挿入します。「検索ページ」と「メインの目次ページ」でも使えます。「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。

引数

スキンタイプ

個別アイテム、月別アーカイブ、検索、メインの目次

例

<%nextlink%>

スキン変数：prevlink

アイテムページでは一つ古いアイテムへの、アーカイブページでは一つ古いアーカイブへのURLを挿入します。「検索」と「メインの目次」でも使えます。「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。

引数

スキンタイプ

個別アイテム、月別アーカイブ、検索、メインの目次

例

<%prevlink%>

スキン変数：errormessage

エラーが発生したときにエラーメッセージを挿入します。

引数

なし

スキンタイプ

エラー

例

<%errormessage%>

スキン変数：image

選択された画像を挿入します（画像ポップアップ用）。

引数

• オプション

  名前	値
  imgtag（デフォルト）	(x)htmlのimgタグ <img ... />
  url	画像ファイルへのURL
  width	イメージの幅
  height	イメージの高さ
  caption	画像の見出し（画像と共に表示されるテキスト）

スキンタイプ

画像ポップアップウィンドウ

例

<%image%>

スキン変数：sitevar

「グローバル設定」でのサイトの設定を挿入します。

引数

• 必須：

  名前	挿入される設定
  url	サイトのURL
  name	サイトの名前
  admin	管理者のメールアドレス

スキンタイプ

全て

例

<%sitevar(name)%>
<%sitevar(url)%>
<a href="mailto:<%sitevar(email)%>">管理人</a>

スキン変数：blogsetting

選択中のブログの設定を挿入します。

引数

• 必須：

  名前	挿入される設定
  id	ブログのID
  url	ブログのURL
  name	ブログの名前
  desc	ブログの説明
  short	ブログの短縮名

スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム、メンバー詳細

例

<%blogsetting(name)%>
<%blogsetting(id)%>
<%blogsetting(desc)%>
<a href="<%blogsetting(url)%>">...</a>

スキン変数：member

訪問者がログイン中のメンバーの場合、そのメンバーに関する情報を挿入します。メンバーの詳細ページにおいては、指定されたメンバーについての同じ情報を表示する追加オプションがあります。

訪問者がログイン中のメンバーではない場合は、your...のパラメーターは何も挿入しません。

引数

• 必須：
  • ログインしたメンバーの情報（全てのスキンタイプで使用可能）：

    名前	挿入される設定
    yourname	訪問メンバーの表示される名前（ログインID）
    yourrealname	訪問メンバーのハンドルネーム(本名)
    yournotes	訪問メンバーが自身のために設定できるその他の情報（備考欄）
    yoururl	訪問メンバーのウェブサイトURL
    youremail	訪問メンバーのメールアドレス
    yourid	訪問メンバーのID

  • 指定されたメンバーの情報（「メンバーの詳細ページ」でのみ使用可能）：

    名前	挿入される設定
    name	指定されたメンバーの表示される名前（ログインID）
    realname	指定されたメンバーのハンドルネーム(本名)
    notes	指定されたメンバーが自身のために設定できるその他の情報（備考欄）
    url	指定されたメンバーのウェブサイトURL
    email	指定されたメンバーのメールアドレス
    id	指定されたメンバーのID

スキンタイプ

全て

例

<%if(loggedin)%>
こんにちは<%member(yourrealname)%>さん
<%endif%>

スキン変数：preview

指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入します。（additemformと一緒に使われることが多いようです）

引数

• 必須：

  名前	値
  template	使用するテンプレート名

スキンタイプ

メインの目次

例

<%preview(mytemplate)%>

スキン変数：adminurl

管理領域のURLを挿入します。

引数

なし

スキンタイプ

全て

例

<a href="<%adminurl%>">管理領域</a>

スキン変数：additemform

現在選択しているブログへのアイテムの追加フォームを挿入します。多くの場合、previewと共に使用されます。

引数

なし

スキンタイプ

メインの目次

例

<%additemform%>

スキン/テンプレート変数：include

Webページ出力時に、指定されたテキストファイルを取り込んで挿入します。ファイルの中身がそのまま出力されるので、スキン/テンプレート変数やPHPコードを使っても反映されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、PHPコードを実行するphpincludeがあります。

引数

• 必須：

  名前	値
  filename	取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます）

注意

• この変数はパーサー設定のIncludeMode とIncludePrefixに影響を受けます。

スキンタイプ

全て

例

<%include(filename.txt)%>
<%include(/home/user/myself/filename.txt)%>
<%include(http://example.jp/filename.html)%>

スキン/テンプレート変数：phpinclude

Webページ出力時に、指定されたPHPファイルを実行し、その結果を挿入します。ファイルの中身はPHPとして解釈され、実行されるので注意が必要です。また、Nucleusのスキン/テンプレート変数は展開されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、ファイルの中身をそのまま表示するincludeがあります。

引数

• 必須：

  名前	値
  filename	取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもかまいません。）

注意

• この変数はパーサー設定のIncludeMode とIncludePrefixに影響を受けます。
• ファイルはphpのコマンドinclude()を使ってインクルードされます。このコマンドは内部のクラス・メソッドから呼び出されるので、Nucleus内部やプラグインで使用されているグローバル変数にアクセスしたい時は、自身でグローバル変数を宣言する必要があります。多くの標準的な変数はNucleusによって自動的にグローバルが宣言されます。

スキンタイプ

全て

例

<%phpinclude(filename.php)%>
<%phpinclude(/home/user/myself/filename.php)%>

スキン/テンプレート変数：phpinclude：vars

次のグローバル変数は、スキン/テンプレート変数のphpincludeによってインクルードされたファイルからアクセスできるものです：

$GATEWAY_INTERFACE, $SERVER_NAME, $SERVER_SOFTWARE
$SERVER_PROTOCOL, $REQUEST_METHOD, $QUERY_STRING
$DOCUMENT_ROOT, $HTTP_ACCEPT, $HTTP_ACCEPT_CHARSET
$HTTP_ACCEPT_ENCODING, $HTTP_ACCEPT_LANGUAGE
$HTTP_CONNECTION, $HTTP_HOST, $HTTP_REFERER
$HTTP_USER_AGENT, $REMOTE_ADDR, $REMOTE_PORT
$SCRIPT_FILENAME, $SERVER_ADMIN, $SERVER_PORT
$SERVER_SIGNATURE, $PATH_TRANSLATED, $SCRIPT_NAME
$REQUEST_URI, $argv, $argc, $PHP_SELF
$HTTP_COOKIE_VARS, $HTTP_GET_VARS, $HTTP_POST_VARS
$HTTP_POST_FILES, $HTTP_ENV_VARS, $HTTP_SERVER_VARS
$HTTP_SESSION_VARS, $PATH_INFO, $HTTPS
$HTTP_RAW_POST_DATA, $HTTP_X_FORWARDED_FOR

他の変数に関しては、'global $varname;'をきっちりとコードに加える必要があります。

スキン/テンプレート変数：parsedinclude

Webページ出力時に、指定されたファイルを取り込んで挿入します。このファイルのは、取り込み時にNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数が使用できます。同じような変数に、取り込んだファイルのPHPを実行するphpincludeや、ファイルの中身をそのまま表示するincludeがあります。

引数

• 必須：

  名前	値
  filename	取り込むファイルの名前（index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます）

注意

• この変数はパーサー設定のIncludeMode とIncludePrefixに影響を受けます。
• インクルードしたファイルの中からでも、再び<%parsedinclude (filename)%>を呼び出すことができますが、無限ループを避けるために最大で3段階までとなります。

スキンタイプ

全て

例

<%parsedinclude(filename.txt)%>
<%parsedinclude(/home/user/myself/filename.txt)%>

スキン/テンプレート変数：plugin

プラグインを呼び出します。

引数

• 必須：

  名前	値
  PluginName	呼び出されるプラグインの名前。大文字小文字が区別されるので注意が必要です。

• この他、プラグインごとに引数が定義・追加されます。

注意

• プラグイン名が既存の変数とぶつからない場合、<%PluginName (parameters)%>と記述することで、プラグインを直接呼び出すこともできます。現在はそのようにプラグイン名で呼び出す方法が主流ですが、プラグイン呼び出しであることをあえて明示したい場合は<%plugin(parameters)%>のほうを利用するといいでしょう。

スキンタイプ

全て

例

<%plugin(Calendar)%>
<%plugin(LastComments,myweblog)%>
<%LastComments(myweblog)%>

スキン変数：loginform

ログインフォームまたは、ログイン中メッセージ（"ログイン中:ketsunet (ログアウト)"）を挿入します

引数

なし

スキンタイプ

全て

例

<%loginform%>

スキン変数：commentform

アイテムページにコメントフォームを挿入します。

引数

スキンタイプ

個別アイテム

例

<%commentform%>
<%commentform(http://example.jp/thanks.html)%>

スキン/テンプレート変数 set

パーサーのプロパティを設定します。

引数

スキンタイプ

全て

例

<%set(IncludeMode,skindir)%>
<%set(IncludePrefix,somedir/)%>

スキン/テンプレート変数：skinfile

表示に使用中のスキンのあるディレクトリにリンクを張る時に使用します。パーサーのプロパティIncludePrefixと共に使用することで、最良の結果を得ることができます。

引数

スキンタイプ

全て

例

<%skinfile(mystyle.css)%>

スキン/テンプレート変数：skinname

現在使用しているスキンの名前を挿入します。

引数

なし

スキンタイプ

全て

例

<%skinname%>

スキン変数：if/ifnot/else/elseif/elseifnot/endif

決まった条件を満たしているときにのみ、コンテンツ・ブロックを挿入。

引数

スキン変数if/ifnot/elseif/elseifnotに対してのみ、引数が必須になります

• 必須：

  名前	値
  type	条件の種類
  typeによって、以下のオプションをとることがあります
  	name	条件の名前
  	value	条件の名前の値

条件の種類

• category：カテゴリーを選択しているとき、条件は満たされる
  • category：カテゴリが選択されているか調べる
  • category,catname,CategoryName ：現在のカテゴリが CategoryName と一致するか調べる
  • category,catid,CategoryID：現在のカテゴリのIDが CategoryId と一致するか調べる
• blogsetting：Blog設定の name項目の値がvalueと一致しているか調べる（nameはSQLテーブル nucleus_blogにあるカラム名）
• loggedin：訪問中のメンバーが現在ログインしていれば、条件は満たされる
• onteam：訪問中のメンバーがログインしており、かつ現在いるブログ（あるいはnameパラメーターで指示されたブログ）のチームに入っていれば、条件は満たされる
• admin：訪問中のメンバーがログインしており、かつ現在いるブログ（あるいはnameパラメーターで指示されたブログ）の管理権限があれば、条件は満たされる
• archiveprevexists：もし現在のブログに現在表示しているものより新しい月、または日のアーカイブがあれば真
• archivenextexists：もし現在のブログに現在表示しているものより古い月、または日のアーカイブがあれば真
• previtem：もし現在のブログにより新しいアイテムがあるのなら真となる（個別アイテムページでのみ使用可能）
• nextitem：もし現在のブログにより古いアイテムがあるのなら真となる（個別アイテムページでのみ使用可能）
• skintype：現在のスキンタイプが value（index, search, item, archive, archivelist, ...）と一致するか調べる（URLによって判別）
• hasplugin：プラグインがインストールされているか、またはプラグインのオプションが特定の値をとっているか調べる
  • hasplugin,PluginName：該当プラグインが存在すれば、条件は満たされる
  • hasplugin,PluginName, OptionName：プラグインのオプションが「いいえ」に設定されてなければ、条件は満たされる
  • hasplugin,PluginName, OptionName=value：プラグインのオプションが特定の値に設定されていれば、条件は満たされる
• if拡張対応プラグイン名：第1引数には、'NP_'を取ったプラグイン名を指定します。第1引数で指定したプラグインに、第2引数、第3引数を渡した結果が真なら真
  • プラグイン名,属性名: 使用法 プラグイン名 プラグインが 属性名 をチェックします
  • プラグイン名,属性名,属性値: 使用法 プラグイン名 プラグインが 属性名 の値が 属性値 かどうかチェックします

スキンタイプ

全て

例

<%if(loggedin)%>
おかえりなさい！
<%else%>
ようこそ！
<%endif%>

<%if(category,catname,Off Topic)%>
'Off Topic' カテゴリへようこそ。
<%endif%>

<%ifnot(loggedin)%>
アクセス禁止！
<%elseif(admin)%>
管理者さんようこそ！
<%elseif(onteam)%>
チームメンバーさんようこそ！
<%else%>
サイトメンバーさんようこそ！
<%endif%>

注意

条件が満たされない時にだけ何らかの表示を行いたい場合は、次のようにすることができます：

<%ifnot(skintype,error)%>
<%blogsetting(name)%>
<%endif%>

スキン変数：membermailform

メンバー詳細のページで、表示されているメンバーに対して、他のログインしているメンバーがメッセージを送ることのできるフォームを挿入します。

引数

スキンタイプ

メンバー詳細

例

<%membermailform%>

スキン変数：searchform

現在のブログに対する検索フォームを挿入します。

引数

スキンタイプ

メインの目次、月別アーカイブ、月別アーカイブ一覧、個別アイテム

例

<%searchform%>
<%searchform(otherweblog)%>

スキン変数：nucleusbutton

本家Nucleusウェブサイト（英語）へのリンクが付いたボタン、あるいはバナーを挿入します。

引数

注意

• このタグはパーサー設定のIncludeMode とIncludePrefixに影響を受けます。

スキンタイプ

全て

例

<%nucleusbutton%>
<%nucleusbutton(nucleus/nucleus.gif,46,43)%>

スキン変数：self

現在表示しているページのファイル名を挿入します（index.php等で記述した「$CONF['Self']」の値です）。

引数

なし

スキンタイプ

全て

例

<%self%>

スキン変数：addlink

表示中のブログにアイテムを追加するためのブックマークレットのURLを出力します

引数

なし

スキンタイプ

全て

例

<dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>

スキン変数：addpopupcode

アイテムを追加するブックマークレットをポップアップさせるためのJavascriptコードを出力します

引数

なし

スキンタイプ

全て

例

<dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>

テンプレート変数：概略

どういったものなのか？

テンプレート変数はスキン変数と同じ方法で広く働きますが、テンプレート内部で利用できる点でスキン変数と区別されます。変数は <%変数名%>という形で呼び出され、変数の機能によってはテキストを挿入します。また、その他のオプションパラメーターを持つ変数もあります。

利用可能な変数

テンプレート変数は、「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」といった、テンプレート・パーツの中で使用できます。（変数image、 popup、media、 pluginはブログアイテムの中でも使用できます。）

• 基本の変数･･･（title、bodyなど...）
• 上級の変数･･･（include、pluginなど...）

コメント関連のテンプレート・パーツ（「コメントのヘッダー」、「コメントの本体」、「コメントのフッター」、「コメントが1 つの時」、「コメントが2つ以上の時」、「コメントの続きを読む」、「コメントが無い時」、「長すぎるコメントの時」）では、利用可能な変数のセットが異なります：

• コメント関連の変数･･･

テンプレート変数：基本の変数

これらの変数はすべて、そのときパースされているアイテムに関わる値になります。

テンプレート変数の概略...

テンプレート変数：上級の変数

テンプレート変数の概略...

テンプレート変数：コメント関連（前半）

テンプレート変数の概略...

テンプレート変数：コメント関連（後半）

テンプレート変数の概略...

テンプレート変数：karma

カルマ投票のデータを挿入します。カルマ投票は、アイテムの'カルマ'を投票する方法で、正にでも負にでも投票できます。これら投票の総計によって、該当記事が訪問者にどのように思われているのか知ることができます。

引数

• オプション：

  名前	挿入される情報の種類
  totalscore	カルマ投票の総合得点（正の投票数から負の投票数を引いたもの/デフォルト）
  pos	正の投票の総計
  neg	負の投票の総計
  votes	投票数の総計
  posp	正に投じられたパーセンテージ
  negp	負に投じられたパーセンテージ

例

<%karma(posp)%>がよい記事だと評価しました（総計<%votes%>票）

テンプレート変数：templateitemtitle

コメント関連テンプレート変数で、元記事のタイトルを挿入します。

引数

• オプション：

  名前	値
  maxlength	maxlengthで指定された数値で、アイテムのタイトル省略。

テンプレート変数：author

投稿者のデータを挿入します。

引数

• オプション：

  名前	挿入される情報の種類
  name	投稿者の「表示される名前」（ログインID）
  realname	投稿者のハンドルネーム(本名)
  id	投稿者のメンバーID
  url	投稿者のウェブサイトのURL
  email	投稿者の登録メールアドレス（使うのは避けるべき）

例

<%author%>
<%author(realname)%>
<a href="<%author(url)%>"><%author%></a>

テンプレート変数：smartbody

現在のアイテムを調べてから、｢本文｣と｢続き｣のどちらを表示するか決定します。

「続き」に何かが入力されていれば「続き」が、何も入力されていなければ「本文」が挿入されます。

使用例

「本文」に詳しい内容を入力し、「続き」には"紹介"、"抜粋"といった内容のものを入力し、「メインの目次ページ」で使用するテンプレートには<%smartbody%>を使い、抜粋が存在するときにはそれを、無い時は「本文」を使用するような使い方をします

この時、「個別アイテムページ」で使うテンプレートには、 <%body%> + <%more%>のかわりに<%body% >だけを記述するようにすると、より効果的に使えるでしょう

テンプレート変数：morelink

テンプレート続きへのリンクで定義されているリンクを挿入します。「続き」に何も入力されていない時は無視されます。

テンプレート部品'続きへのリンク'の中身もまたパースされるので、同様にテンプレート変数を含むことができることに注意してください（例：続きへのリンクに<%morelink%>を記述することは可能ですが、無限ループを起こします）。

引数

なし

テンプレート変数：date

日付フォーマットで設定した書式で日付を挿入します。オプションの引数にstrftime変数を使用して、フォーマットを変更することもできます。

引数

• オプション：

  名前	値
  format	日付のフォーマットに用いる形式
  下記の4つの特別なパラメーターが利用可能です
  rfc822	LocaleにあわせたRFC822フォーマットの日付
  rfc822GMT	GMTにあわせたRFCフォーマットの日付
  iso8601	ISO-8601フォーマットの日付（W3Cの時刻と日付フォーマット（新しいウィンドウが開きます）に概略があります）。例：2008-09-05T10:00:00-05:00
  utc	iso8601と同じ。ただし、タイムゾーンの表示として"Z"を使うUTCで表現される。

例

<%date%>
<%date(%x)%>
<%date(rfc822)%>
<%date(rfc822GMT)%>

テンプレート変数：time

時刻フォーマットで設定した書式で時刻を挿入します。オプションの引数にstrftime変数を使用して、フォーマットを変更することもできます。

引数

• オプション：

  名前	値
  format	時刻のフォーマットに用いる形式

例

<%time%>
<%time(%X)%>

テンプレート変数：comments

コメントブロックを挿入します。このブロックの詳しい説明。

引数

• オプション：

  名前	値
  MaxToShow	表示するコメントの数（設定されていれば、Blog設定にあるコメントの最大量を上書きします）

例

<%comments%>
<%comments(5)%>

テンプレート変数：syndicate_title

HTMLタグを取り除き、指定された長さにまで縮めたアイテムのタイトルを挿入します（指定が無い時は100）。省略された場合、末尾に"..."が追加されます。

この変数はRSS等のために使うことが意図されていましたが、他にも便利な使い方があるでしょう。

引数

• オプション：

  名前	値
  MaxChars	省略せずに残す最大の幅（デフォルトは100）

例

<%syndicate_title%>
<%syndicate_title(25)%>

テンプレート変数：syndicate_description

HTMLタグを取り除き、指定された幅にまで縮めたアイテムのタイトルを挿入します（指定が無い時は250）。テキストが縮められた場合は、末尾に"..."が追加される。

この変数はRSSのために使うことが意図されていましたが、他にも便利な使い方があるでしょう。

引数

• オプション：

  名前	値
  MaxChars	省略せずに残す最大の幅（デフォルトは250）

例

<%syndicate_description%>
<%syndicate_description(25)%>

テンプレート変数：image

アイテム本体やテンプレートにインライン画像を挿入します。

通常テンプレート変数<%image%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。

引数

• 必須：

  名前	値
  filename	画像ファイルの名前
  width	画像の横幅（ピクセルかパーセンテージ）
  height	画像の高さ（ピクセルかパーセンテージ）
  text	画像の代用テキスト

• 注意:画像、ポップアップ、メディアタグでは、引数はコンマではなく '|'で区切られなければなりません。

例

<%image(myphoto.jpg|100|200|これが私です)%>
<%image(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>

テンプレート変数：popup

アイテム本体やテンプレートにポップアップ画像を挿入します。

通常テンプレート変数<%popup%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。

引数

• 必須：

  名前	値
  filename	画像ファイルの名前
  width	画像の横幅（ピクセルかパーセンテージ）
  height	画像の高さ（ピクセルかパーセンテージ）
  text	画像の代用テキスト

• 注意:画像、ポップアップ、メディアタグでは、引数はコンマではなく '|'で区切られなければなりません。

例

<%popup(myphoto.jpg|100|200|これが私です)%>
<%popup(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>

テンプレート変数：media

アイテム本体やテンプレートにメディアオブジェクトを挿入します。

通常テンプレート変数<%media%>はアイテムにメディアファイルを挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。

引数

• 必須：

  名前	値
  filename	オブジェクトファイルの名前
  text	オブジェクトの説明テキスト

• 注意:画像、ポップアップ、メディアタグでは、引数はコンマではなく '|'で区切られなければなりません。

例

<%media(mysong.mp3|新曲を聞いてみてください)%>

テンプレート変数：edit

テンプレート：アイテムを編集するためのリンクの内容を挿入します。

注意：ログイン状態のメンバーが、閲覧中のアイテムの編集を許可されている時のみ、この変数が働きます。それ以外の場合は、テンプレート変数<%edit%>は何も表示しません。

例

「アイテムの本体」テンプレートの一例

<h1><%title%></h1>
<p><%body%> <%morelink%></p>
<div class="metadata">
    <%edit%> <%comments%>
</div>

結果は次のようになります

テンプレート変数：editlink

アイテムを編集するためのbookmarkletのURLを挿入します。この変数はテンプレート：アイテムを編集するためのリンク内で使用することができます。

例

「アイテムを編集するためのリンク」テンプレートの一例

<a href="<%editlink%>"
    onclick="<%editpopupcode%>">編集</a> -

テンプレート変数：editpopupcode

'アイテムの編集'ウィンドウをポップアップで開くためのjavascriptのコードを挿入します。

例

「アイテムを編集するためのリンク」テンプレートの一例

<a href="<%editlink%>" onclick="<%editpopupcode%>">編集</a> -

プラグイン

Nucleusでは機能を追加するために、プラグインをインストールすることができます。プラグインは次のリストの様に働き、Nucleus本体だけでは実現できな様々な機能を提供してくれるでしょう。

1. スキン変数のように振舞う
2. テンプレート変数のように振舞う
3. Nucleusによって生成されたイベントのフック。「プラグインの管理」画面での「上へ」と「下へ」リンクは、イベント発生時にプラグインを呼び出す順番を決定するために用いられます。最初のプラグインは最初に呼び出され、最後のプラグインは最後に呼び出されます。
4. action.phpを通して呼び出されたときにアクタのように振舞う

プラグインに対する責任は、完全にプラグインの作者にあることをお忘れなく。プラグイン作者は、プラグインが問題なく動くように作らなければなりません。

パーサーのプロパティ

利用可能なパーサーオプションを以下に記述します。

IncludeプリフィックスとIncludeモード のプロパティは、「スキンの一般的設定」において該当スキンでの包括的な設定が可能です。なお、プロパティが設定されてしまうと、例えばテンプレートも含めたすべてのパースデータにそれが適用されることを心にとめておいてください。