ファイル読み込み中、しばらくお待ちください(ファイルサイズはおよそ180KBです)。
ブログにアイテムを追加する際、「本文」「タイトル」「続き」に4種類の変数を利用することができます:
<%plugin%>以外のこれらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。
訪問者に自身のメンバーアカウント作成を許可することができます。新規メンバーは管理者がチームに加えるまでは、ブログにアイテムを追加することはできませんが、自分のコメントを削除したり変更したりすることが可能です。新規メンバーのログイン許可を「はい」にしている場合、管理領域にログインして自分の設定を変更することもできます。
この設定は、訪問者によるアカウントの作成を許可している場合に、その方法で作られたアカウントを使用して管理領域にログインできるかどうかを設定します。
最後に変更を加えてから10分後に、自動的にドラフトとして保存する機能です。投稿、または編集途中に他の用事が出来て、記事を保存するのを忘れてしまった時などに、不用意に編集内容を失わずにすみます。
もし、10分待たずに下書きを保存したくなったら、フォームの下の方にある「ドラフト保存」ボタンをクリックします。
この機能は、メンバーごとの設定でオン、オフを切り替える事が出来ます。
適用すべきスキンが見つからなかった時に代用するスキンを設定します。これはスキン・パーツが設定されていなかったり、スキンが明確に指定されていなかったりした時に起こります。
ほとんどのユーザーは、この設定を気にする必要がありません。
ブログが表示される時には、ブログごとの「設定」で選択された「標準のスキン」が使用されます。選択できるのは一つだけです。(URLの引数として指定することで、別のスキンで表示させることは可能です)
<ul>
<li><a href="<%siteurl%>"><%sitename%></a></li>
<li><a href="<%bloglink%>" title="<%blogdesc%>"><%blogname%></a></li>
</ul>
メインの目次ページに表示するコメントの最大数です。これはコメント可能な最大数を制限するものではありません。
個別アイテムページでは、設定した最大数を超えていても全てのコメントが表示されます。
注意: テンプレート内部では、テンプレート変数commentsの引数によってここでの値が上書きされます。
このオプションには、新しくコメントが追加された時などに通知するメールアドレスを、一つあるいは複数設定することができます。もし通知が不要なら空っぽにしておいてください。メールアドレスは、当然ですが、有効なものでなくてはなりません。
複数のメールアドレスを設定する場合には、各メールアドレスをセミコロン(;)で区切ってください。
「常に検索対象にする」オプションが選択されていると、同じNucleusでのすべての検索において、常に検索対象に含まれます。
「ブログ1」と「ブログ2」があって、「ブログ2」の「常に検索対象にする」が「はい」、「ブログ1」は「いいえ」にになっていると、「ブログ1」での検索は「ブログ2」も対象に含まれますが、「ブログ2」での検索は「ブログ1」は対象にふくまれません。
もしサーバの時刻とあなたの住んでいる地域の時刻とが一致していなければ、ここにサーバとの時差を入力することで、Nucleus内部の時刻をあなたの住んでいる地域の時刻に合わせることができます(マイナス時差の地域に住んでいる場合は、マイナス記号付きで入力します)。参考のために現在のサーバの時刻が表示されています。
あなたの住んでいる地域の時刻が20:35で、表示されているサーバの時刻が14:35のとき、ブログの時刻を20:35にするためには「サーバ時刻との時差」を6.0に設定します。
注意:30分刻みでの時差のある地域のために、0.5刻みで設定することができます。例えば「サーバ時刻との時差」を1.5に設定すると、1時間30分の補正となります。
ブログに新しいアイテムが追加された時に、自動更新するファイルのパスを入力します。このファイルは、新しいアイテムが追加されるたびに最終変更時のタイムスタンプが上書きされ、外部からはこのファイルを参照することで、ブログに更新があったかどうかをチェックすることができます。
訪問者によるコメントが追加された時や、スキン/テンプレートに変更を加えた時には更新されず、アイテムが追加されてブログの記事に変更があったときに更新されるので、「ブログの更新状況」等を作成するサービスに使うことができます。
自動更新するファイルがないときは、フィールドを空っぽにしておいてください。
ファイルの場所は管理領域からの相対パスでも指定できますが、 /path /to /your /website /update.txt
のようにより確実な絶対パスを使った方が良いでしょう。
あらかじめファイルを作成し、書き込みができるように、ファイルとディレクトリのパーミッションを0666にしてください。
<ul>
<li><a href="<blogurl%>">まとめて表示</a>< /li>
<li><a href="<%catlink%>"><%catname%></a></li>
</ul>
Nucleusはアイテム内の改行を、デフォルトで<br/>
タグに変換します。この設定によって、アイテム内の改行箇所を出力後の(X)HTMLに反映させることができます。
なれたユーザーや、Semantic Web(br
タグは情報を付加せず、ただ記述のためにのみ使われる)を意識しているユーザーは、この機能が迷惑かもしれません。「アイテムの改行を変換する」オプションを「いいえ」に設定してください。
デフォルトでは、メンバーがログインするとブラウザにcookieが保存され、翌日に戻ってきたときに再びログインする必要がなくなります。クッキーの有効期間によって、再ログインが不要な期間が決まります。
これらは高度な設定です。通常は、cookieパスは単純にスラッシュ("/")、cookieドメインは空っぽの状態から変更する必要はありません。
※ 設定を間違うとログインできなくなります。ログインできなくなった場合に設定を元に戻すにはnucleus_configテーブルCookieDomain、CookiePathを手動で設定して下さい
通常は「いいえ」に設定してください。HTTPSのurlを用いており、cookieの送受信をhttps接続を通してのみに限定したい時だけ、この設定を「はい」にします。
※ httpで「はい」の設定を行うとログインできなくなります。ログインできなくなり「いいえ」に設定を戻すには、MysqlAdminなどを利用してnucleus_configテーブルのCookieSecureを0にしてください。
訪問者が最後に訪れた時間をcookieに保存させるように設定することができます。これによって、新規アイテムの隣にマークを付けることができます。
Nucleusのサイト全体を閉鎖することが可能です。なんらかの設定調整を行うときに、あるいは何か恐ろしい間違いが起きた時にこれを実行したいと思うかもしれません:-)
チェックボックスを「はい」に設定した場合に、訪問者はここで設定したURLにリダイレクトされます。
例外:管理領域は閉鎖していない時と同様に利用可能であり、最高管理者は通常通りサイト全体を閲覧することができます。(あとでサイトを再開することを忘れないでください;-))
ドラフト状態のアイテムは公開されたブログであっても閲覧できません。推敲に時間をかけたい時や、少し時間を空けたいときなどに役に立つでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間があるときに作業を再開することが可能です。
ドラフト状態のアイテムを編集する際に、「今すぐ追加」のラジオボタンを選んで「保存」ボタンを押すと、ドラフト状態が解除されてブログに公開されます。
アイテムには、長文記事を分割して表示するために、オプションとして「続き」部分があります。例えば、記事がブログのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。テンプレートによって、表示の形態は変わってきますが、ブログのメインページを閲覧すると「続きを読む」というリンクが出現します。
「続き」を優先して表示させる、テンプレート変数 smartbody を使えば「続き」に、アイテムの概略を記入して導入部分に使えます。
アイテム追加フォームの「後で追加」オプションをチェックすることで、アイテムを指定した時間きっかりに公開することができます。 指定された時間が来るまで、アイテムはサイトの公開された部分で見られることはありません。
この日時は、アイテムを追加するブログの「過去の日時での投稿を許可する」オプションが有効である場合を除いて、未来のものでなくてはなりません。
この設定を有効にすると、アイテムを追加する時に、アイテムの投稿日時を過去に指定することができるようになります。 また、既存のアイテムの投稿日時を編集することもできるようになります。
Nucleusが個々のメンバー用のコンテンツを作成するときに用いられる言語を選択することができます。 生成されるコンテンツには、管理領域、エラーメッセージ、スキンにおけるフォームなどが含まれます。
言語の選択を行う場所は2ヶ所あり、まず「グローバル設定/使用する言語」でデフォルトの言語を設定します。 次に「メンバーの管理/(メンバー)編集/使用する言語」でメンバー毎にログイン時の使用言語を設定することができます。
これら両方の設定が無効の場合、英語がデフォルトの言語として用いられます
注意: 追加の言語ファイルはNucleusのウェブサイトからダウンロードできます。(新規ウィンドウが開きます)
Nucleusはメディアファイル(画像、動画、音楽など)をウェブサイトにアップロードすることができます。
このためにいくつかの設定が必要です:
メンバーはそれぞれ、自身のメディアファイルのプライベートなコレクションを持ちます。また、それ以外のメディア・ディレクトリ下のサブディレクトリはグローバルなコレクション(メンバー間で共有)とみなされます。
アップロードは悪用を予防するため、少なくとも一つのブログチームに入っているメンバーでなくては行えません。
メンバーのプライバシーのために、メールアドレスを隠したままで、スクリプトを通してメンバー同士でメールメッセージの送信ができます。送信されたメッセージには両ユーザーのメールアドレスが含まれますので、その後は通常のメールを用いた連絡を続けることができます。このサービスは無効にすることが可能です。
デフォルトでは非メンバーは、入力されたメールアドレスが有効なものかチェックする方法が無いために、メッセージサービスを使用できません。「メンバー以外からのメッセージ送付を許可」することによってこの制限を緩和できます。非メンバーはメッセージの投函時にメールアドレスを尋ねられ、そのアドレスがメールのヘッダーFrom:
に表示されることになります。
利用可能なパーサーオプションを以下に記述します。
オプション名 | 値 |
---|---|
IIncludeモード |
ノーマル:通常は、ページを生成する「.php」ファイルのディレクトリ/URLから相対位置にあるファイルをインクルードします。 skindirを使う:スキンディレクトリ/スキンURLから相対位置にあるファイルををインクルードします。 影響を与えるスキン変数 |
Includeプリフィックス |
これはインクルードするファイル名それぞれの先頭に付けるプリフィックス文字列です。 このプロパティは「Includeモード」のプロパティと一緒に使われ、スキンを 影響を与えるスキン変数 |
「Includeモード」と「Includeプリフィックス」は、スキン毎の「一般設定」でそのスキンの包括的な設定を行います。
なお、これらのプロパティが設定されると、テンプレートも含めてすべてのパースデータに適用されます。
Nucleusには、機能を拡張するためのプラグインをインストールできます。プラグインは次のように振る舞って、Nucleus本体だけでは実現できない様々な機能を提供してくれるでしょう。
action.php
を通して呼び出されたときにアクションを実行する。 プラグインに対する責任は、完全にプラグインの作者にあることをお忘れなく。プラグイン作者は、プラグインが問題なく動くように作らなければなりません。
NucleusCMSのプラグインの主だったものは、以下の二つのページから見つけ出すことが出来ます。
どちらのページも全てのプラグインを網羅しているわけではありませんが、これらのページのどちらかであなたが必要としているプラグインを見つけることが出来るでしょう。 インターネット上には無料の翻訳サービスがあるので、「読めない」と恐れることはありません。
あなたがプラグインを開発したり、機能を検索するその他のリソースとして、本家フォーラムやNucleus日本語フォーラムがあります。 これらのフォーラムの中でも、プラグインリストに掲載されていない小さなプラグインを見つけることが出来るでしょう。訪問者によるメンバーへの成りすましを防止するために、メンバーとして登録済みの名前を使ってのゲストコメントはできないようになっています。このオプションを「いいえ」に設定することで、この規制を緩和することができます。
ブログを更新した時に、ブログ検索サイト等が公開しているいくつかのpingサーバーへ更新pingを送信することができます。 これらのサイトは、リクエストに応じて最近更新されたブログのリストを提示し、このデータを利用した新着記事のリスト等のサービスを、多くのウェブサイトが提供していますので、このオプションを「はい」に設定することで、訪問者を増やす事ができるかもしれません。
注意:この機能を正しく動かすために、blogごとの「設定」にあるweblogの「URL」と「Blogの名前」を埋める必要があります。
「Blogの短縮名」は主に管理領域で、どのアイテムがどのブログと結びついているのか示すために使われます。
また、新規ブログを有効にするための代替indexファイルでも用いられます(以下は「Blogの短縮名」が「myshortblogname」の時の呼び出しファイルの例):
<?php include("./config.php"), selectBlog("myshortblogname"), selector(), ?>
ブログ、テンプレート、そしてスキンは名前や説明の他に短縮名を持たなくてはなりません。
短縮名はa~zと0~9のみで構成され、スペースを含むことはできません。
訳注:テンプレートの名前には"/"が利用できたりするので、実際にはこの限りではないようです。
メンバーの場合、「表示される名前」はログイン名として使われます。a~z、 A~Z、0~9とスペース(半角)が使用できます。ただし、名前の最初や最後にスペースを付けることはできません。
「メインの目次ページ」と似た振る舞いをする、「1ヶ月分のアーカイブ」で、該当する1ヶ月分のアイテムを全て表示します。
「月別アーカイブページ」の基本的な形:
<html> <head> <title>私のウェブログ :: アーカイブ</title> </head> <body> <h1>アーカイブ</h1> <%archive(default)%> </body> </html>
このスキンでは、"default"テンプレートを使用して、選択中のブログの要求されたアーカイブが表示されます。
このスキンパーツはアーカイブが存在する全ての月の概略と、それらアーカイブへのリンクを表示します。
「月別アーカイブ一覧ページ」の基本的な形:
<html> <head> <title>私のウェブログ :: アーカイブ集</title> </head> <body> <h1>アーカイブ集</h1> <%archivelist(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><%imagetext%></title> <style type="text/css"> img { border: none; } </style> </head> <body> <a href="javascript:window.close(),"><%image%></a> </body> </html>
このスキンパーツはブログ内の最新のエントリーを表示するのに用いられます。通常はサイト、またはブログのトップページにあたる場所になります。
「メインの目次ページ」の基本的な形:
<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><%member(name)%> の情報</h1> ウェブサイト: <a href="<%member(url)%>"><%member(url)%></a> <h1>メッセージを送る</h1> <%membermailform%> </body> </html>
このスキンでは、メンバー名とメンバーのウェブサイトのアドレス、そしてメール送信フォームが表示されます。
このスキンパーツは検索結果の表示に使われます。
「検索ページ」の基本的な形:
<html> <head> <title>私のウェブログ :: 検索</title> </head> <body> <h1>検索</h1> <%searchform%> <h1>検索結果</h1> <%searchresults(default)%> </body> </html>
このスキンでは、"default"テンプレートを使用して検索の結果が表示されます。
「タイムスタンプを更新」オプションにより、アイテムが投稿された日時を変更することができます。アイテムの内容を変更した時に「タイムスタンプを更新」することで記事をブログののトップに戻せます。
しかし、アイテムIDは変更されませんので、訪問者はアイテムIDから、投稿日時が変更されたものだと見分けることができます。
このスキンパーツは、特別な見せ方をしたいコンテンツやブログの内容以外のコンテンツ、例えばフォームや静的なコンテンツ、もしくはNucleusとは切り離された動的なコンテンツ等を表示する為に使用します。
スペシャルスキンパーツは次のようにして表示します。
(fred
という名前でスペシャルスキンパーツを作った場合)
http://www.yoursite.tld/index.php?special=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文書として表示されます。 また、標準的なスキン変数が使えるので、ブログとの連系を持たせた静的ページを持たせたいときなどに役立つでしょう。
現在選択しているブログへのアイテムの追加フォームを挿入します。多くの場合、previewと共に使用されます。
なし
メインの目次
<%additemform%>
表示中のブログにアイテムを追加するためのブックマークレットのURLを出力します
なし
全て
<dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>
アイテムを追加するブックマークレットをポップアップさせるためのJavascriptコードを出力します
なし
全て
<dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>
選択されているブログの選択された月のアーカイブを、指定されたテンプレートを用いて表示。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリー名 |
月別アーカイブ
<%archive(mytemplate)%> <%archive(mytemplate,mycategory)%>
アーカイブの日付としてフォーマット済みの日付を挿入します。パラメーターなしで使うと、例えばアーカイブが2008年9月のものなら、"05 september 2008"か"september 2008"のどちらかが挿入されることになります。
名前 | 値 |
---|---|
Locale | 日付がフォーマットされるときに用いられるLocale |
Format | 日付のフォーマット(strftime変数) |
月別アーカイブ
Archive for <%archivedate%> Archive for <%archivedate(dutch)%> Archive for <%archivedate(en,%B %Y)%>
スキン変数archivelistと同様にアーカイブのリストを挿入しますが、月ごとの代わりに日ごとのアーカイブのリストを挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
limit | 表示するリンク数の制限(例えば、過去3日分へのリンクしか表示させたくないときなど) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
<%archivedaylist(mytemplate)%> <%archivedaylist(mytemplate,mycategory)%>
選択中のブログ、あるいはカテゴリーのアーカイブへのリンクを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
全て
<%archivelink%>
現在選択しているブログに存在するアーカイブの月ごとのリストを、指定されたテンプレートを使って挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
limit | 表示するリンク数の制限(例えば、過去3ヶ月分へのリンクしか表示させたくないときなど) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
<%archivelist(mytemplate)%> <%archivelist(mytemplate,mycategory)%>
スキン変数archivelistと同様にアーカイブのリストを挿入しますが、月ごとの代わりに年ごとのアーカイブのリストを挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
limit | 表示するリンク数の制限(例えば、過去3年分へのリンクしか表示させたくないときなど) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
<%archiveyearlist(mytemplate)%> <%archiveyearlist(mytemplate,mycategory)%>
選択中のブログの、タイムスタンプの新しいアイテム群を挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
amount | 表示するアイテムの数(デフォルトは10)。何番目のアイテムから始めるかというオフセットを含めることもできます。例えば10(5) と記述すると5番目から始めて10個のアイテムを表示します。 |
category | 表示するカテゴリーの名前 |
メインの目次、個別アイテム、月別アーカイブ、月別アーカイブ一覧、検索
<%blog(default,15)%> <%blog(default,5(15))%> <%blog(mytemplate)%> <%blog(mytemplate,5,mycategory)%>
Nucleusで管理しているブログのリストを、指定されたテンプレートを用いて挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 | 初期値 |
---|---|---|
bnametype | 「shortname」を指定することで、ブログ名の変わりにブログの短縮名を挿入します | bname |
orderby | 並べ替えのキーを指定します。指定可能なキーは「number(ブログID)」「name(ブログ名)」「shortnameブログの短縮名)」「description(ブログの説明)」です。 | number |
direction | orderbyで指定したキーを使って「asc」で昇順、「desc」で降順に並べ替えます。 | asc |
全て
<%bloglist(mytemplate)%>標準。「mytemplate」を使って、ブログの一覧を「ブログ名」で表示します。
<%bloglist(mytemplate,shortname)%>「mytemplate」を使って、ブログの一覧を「ブログの短縮名」で表示します。
<%bloglist(default/index,name,description)%>「default/index」を使って、ブログの一覧を「ブログの説明」で並べ替えて「ブログ名」で表示します。
<%bloglist(default/index,shortname,,desc)%>「default/index」を使って、ブログの一覧を「ブログ名」の降順で並べ替えて「ブログ短縮名」で表示します。
選択中のブログの設定を挿入します。
名前 | 挿入される設定 |
---|---|
id | ブログのID |
url | ブログのURL |
name | ブログの名前 |
desc | ブログの説明 |
short | ブログの短縮名 |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム、メンバー詳細
<%blogsetting(name)%> <%blogsetting(id)%> <%blogsetting(desc)%> <a href="<%blogsetting(url)%>">...</a>
現在選択されているカテゴリーに関する情報を挿入します。カテゴリーが選択されていないときは何も挿入されません。
名前 | 挿入される設定 |
---|---|
name | カテゴリー名(デフォルト) |
desc | カテゴリーの説明L |
id | カテゴリーのID |
全て
<%category%> <%category(id)%> <%category(desc)%> <%category(name)%>
選択中のブログのカテゴリーリストを、指定されたテンプレートを用いて挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
(※blogname が指定されている場合、エラーページ・メンバー詳細ページ・スペシャルスキンパーツでも利用できます。)
<%categorylist(mytemplate)%> <%categorylist(mytemplate,myweblog)%>
グローバル設定の既定の言語で設定した言語に基づいたキャラクターセットのコードを挿入します。日本語版では、"UTF-8"か、"EUC-JP"の何れかになります
なし
全て
<meta http-equiv="Content-Type" content="text/html; charset=<%charset%>" />
アイテムページにコメントフォームを挿入します。
名前 | 値 |
---|---|
destinationurl | コメント追加後にリダイレクトさせるURL(デフォルトでは、投稿したアイテムの「個別アイテムページ」にリダイレクトされます) |
個別アイテム
<%commentform%> <%commentform(http://example.jp/thanks.html)%>
現在選択されているアイテムについているコメントを、指定されたテンプレートを用いて挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
個別アイテム
<%comments(mytemplate)%>
バージョン2.0以降のNucleusでは使用できません。<%if(category)%>を代わりに使ってください。
全て
<%ifcat(Current Category: )%><%category%>
選択された画像を挿入します(画像ポップアップ用)。
名前 | 値 |
---|---|
imgtag(デフォルト) | (x)htmlのimgタグ <img ... /> |
url | 画像ファイルへのURL |
width | イメージの幅 |
height | イメージの高さ |
caption | 画像の見出し(画像と共に表示されるテキスト) |
画像ポップアップウィンドウ
<%image%>
このスキン変数はNucleusバージョン2.0以降使いません。代わりに<%image(caption)%>
を使ってください。
ポップアップ画像に見出しテキストをつける
なし
画像ポップアップウィンドウ
<%imagetext%>
Webページ出力時に、指定されたテキストファイルを取り込んで挿入します。ファイルの中身がそのまま出力されるので、スキン/テンプレート変数やPHPコードを使っても反映されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、PHPコードを実行するphpincludeがあります。
名前 | 値 |
---|---|
filename | 取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます) |
全て
<%include(filename.txt)%> <%include(/home/user/myself/filename.txt)%> <%include(http://example.jp/filename.html)%>
現在選択されているアイテムを、指定されたテンプレートを用いて挿入します(コメントは挿入されません)。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
個別アイテム
<%item(mytemplate)%>
アイテムのURL(permanent link)を挿入します。
名前 | 適用 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
個別アイテム
<%itemlink%>
ログインフォームまたは、ログイン中メッセージ("ログイン中:ketsunet (ログアウト)")を挿入します
なし
全て
<%loginform%>
訪問者がログイン中のメンバーの場合、そのメンバーに関する情報を挿入します。メンバーの詳細ページにおいては、指定されたメンバーについての同じ情報を表示する追加オプションがあります。
訪問者がログイン中のメンバーではない場合は、your...のパラメーターは何も挿入しません。
名前 | 挿入される設定 |
---|---|
yourname | 訪問メンバーの表示される名前(ログインID) |
yourrealname | 訪問メンバーのハンドルネーム(本名) |
yournotes | 訪問メンバーが自身のために設定できるその他の情報(備考欄) |
yoururl | 訪問メンバーのウェブサイトURL |
youremail | 訪問メンバーのメールアドレス |
yourid | 訪問メンバーのID |
yourprofileurl | 訪問メンバーの「メンバーの詳細ページ」アドレス |
名前 | 挿入される設定 |
---|---|
name | 指定されたメンバーの表示される名前(ログインID) |
realname | 指定されたメンバーのハンドルネーム(本名) |
notes | 指定されたメンバーが自身のために設定できるその他の情報(備考欄) |
url | 指定されたメンバーのウェブサイトURL |
指定されたメンバーのメールアドレス | |
id | 指定されたメンバーのID |
全て
<%if(loggedin)%>
こんにちは<%member(yourrealname)%>さん
<%endif%>
メンバー詳細のページで、表示されているメンバーに対して、他のログインしているメンバーがメッセージを送ることのできるフォームを挿入します。
名前 | 値 |
---|---|
rows | ボックスの横列の数値(デフォルトは10) |
cols | ボックスの縦列の数値(デフォルトは40) |
destination url | メッセージを送信した後リダイレクトされるURL |
メンバー詳細
<%membermailform%>
表示中のアーカイブの形式に応じて、一つ新しいアーカイブの月、または日を挿入します。
表示中の形式 | 挿入される日付のフォーマット |
---|---|
日単位で表示している時 | YYYY-MM-DD |
月単位で表示している時 | YYYY-MM |
なし
月別アーカイブ
<a href="index.php?archive=<%nextarchive%>">....
本家Nucleusウェブサイト(英語)へのリンクが付いたボタン、あるいはバナーを挿入します。
名前 | 値 |
---|---|
imgurl | 画像のURL(デフォルトのものを使わない場合) |
imgwidth | 画像の横幅(ピクセル単位) |
imgheight | 画像の高さ(ピクセル単位) |
全て
<%nucleusbutton%> <%nucleusbutton(nucleus/nucleus.gif,46,43)%>
指定されたブログの選択された月のアーカイブを、指定されたテンプレートを用いて表示。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
月別アーカイブ
<%otherarchive(myblog,mytemplate)%> <%otherarchive(myblog,mytemplate,mycategory)%>
スキン変数otherarchivelistと同様に、指定されたブログのアーカイブのリストを挿入しますが、 月ごとの代わりに日ごとのアーカイブを挿入します。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
全て
<%otherarchivedaylist(yourblog,mytemplate)%> <%otherarchivedaylist(yourblog,mytemplate,mycategory)%>
指定されたブログに存在するアーカイブ月ごとのリストを、指定されたテンプレートを用いて表示します。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
全て
<%otherarchivelist(yourblog,mytemplate)%> <%otherarchivelist(yourblog,mytemplate,mycategory)%>
スキン変数otherarchivelistと同様に、指定されたブログのアーカイブのリストを挿入しますが、 月ごとの代わりに年ごとのアーカイブを挿入します。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
全て
<%otherarchiveyearlist(yourblog,mytemplate)%> <%otherarchiveyearlist(yourblog,mytemplate,mycategory)%>
指定されたブログの、タイムスタンプの新しいアイテム群を挿入します。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
amount | 表示するアイテムの数(デフォルトは10)。何番目のアイテムから始めるかというオフセットを含めることもできます。例えば10(5) と記述すると5番目から始めて10個のアイテムを表示します。 |
category | 表示するカテゴリーの名前 |
全て
<%otherblog(myblog,default,15)%> <%otherblog(yourblog,mytemplate)%> <%otherblog(yourblog,mytemplate,15,mycategory)%> <%otherblog(yourblog,mytemplate,5(15),mycategory)%>
指定されたブログの、現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。
名前 | 値 |
---|---|
blogname | ブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
maxresults | 表示する結果の最大数 |
検索
<%othersearchresults(myblog,mytemplate)%>
Webページ出力時に、指定されたスペシャルスキンもしくはファイルを取り込んで挿入します。それぞれ同名が存在する場合はスペシャルスキンが優先されます。このファイルは、取り込み時にNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数が使用できます。同じような変数に、取り込んだファイルのPHPを実行するphpincludeや、ファイルの中身をそのまま表示するincludeがあります。
名前 | 値 |
---|---|
filename | 取り込むスペシャルスキンもしくはファイルの名前(index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます) |
<%parsedinclude (filename)%>
を呼び出すことができますが、無限ループを避けるために最大で3段階までとなります。全て
<%parsedinclude(specialskinname)%> <%parsedinclude(filename.txt)%> <%parsedinclude(/home/user/myself/filename.txt)%>
Webページ出力時に、指定されたPHPファイルを実行し、その結果を挿入します。ファイルの中身はPHPとして解釈され、実行されるので注意が必要です。また、Nucleusのスキン/テンプレート変数は展開されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、ファイルの中身をそのまま表示するincludeがあります。
名前 | 値 |
---|---|
filename | 取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもかまいません。) |
include()
を使ってインクルードされます。このコマンドは内部のクラス・メソッドから呼び出されるので、Nucleus内部やプラグインで使用されているグローバル変数にアクセスしたい時は、自身でグローバル変数を宣言する必要があります。多くの標準的な変数はNucleusによって自動的にグローバルが宣言されます。全て
<%phpinclude(filename.php)%>
<%phpinclude(/home/user/myself/filename.php)%>
次のグローバル変数は、スキン/テンプレート変数の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;
"をきっちりとコードに加える必要があります。
プラグインを呼び出します。
名前 | 値 |
---|---|
PluginName | 呼び出されるプラグインの名前。大文字小文字が区別されるので注意が必要です。 |
この他、プラグインごとに引数が定義・追加されます。
<%PluginName (parameters)%>
と記述することで、プラグインを直接呼び出すこともできます。現在はそのようにプラグイン名で呼び出す方法が主流ですが、プラグイン呼び出しであることをあえて明示したい場合は<%plugin(parameters)%>
のほうを利用するといいでしょう。全て
<%plugin(Calendar)%> <%plugin(LastComments,myweblog)%> <%LastComments(myweblog)%>
表示中のアーカイブの形式に応じて、一つ古いアーカイブの月、または日を挿入します。
表示中の形式 | 挿入される日付のフォーマット |
---|---|
日単位で表示している時 | YYYY-MM-DD |
月単位で表示している時 | YYYY-MM |
なし
月別アーカイブ
<a href="index.php?archive=<%prevarchive%>">....
決まった条件を満たしている時にのみ、コンテンツ・ブロックを挿入します。3.6以降では、テンプレートの「アイテムの本体」と「コメントの本体」でも同じ様に使う事ができます。
スキン変数 if/ifnot/elseif/elseifnot
に対してのみ、引数が必須になります
名前 | 値 | ||
---|---|---|---|
type | 条件の種類 | ||
typeによって、以下のオプションをとることがあります | |||
name | 条件の名前 | ||
value | 条件の名前の値 |
全て
<%if(loggedin)%>おかえりなさい!<%else%>ようこそ!<%endif%>
<%if(category,catname,Off Topic)%>"Off Topic" カテゴリへようこそ。<%endif%>
<%if(category,catid,1)%>"ID1"のカテゴリです。<%endif%>
<%ifnot(loggedin)%>アクセス禁止!<%elseif(admin)%>管理者さんようこそ!<%elseif(onteam)%>チームメンバーさんようこそ!<%else%>サイトメンバーさんようこそ!<%endif%>
条件が満たされない時にだけ何らかの表示を行いたい場合は、次のようにすることができます
<%ifnot(skintype,error)%><%blogsetting(name)%><%endif%>
指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入します。(additemformと一緒に使われることが多いようです)
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
メインの目次
<%preview(mytemplate)%>
アイテムページでは一つ古いアイテムへの、アーカイブページでは一つ古いアーカイブへのURLを挿入します。「検索」と「メインの目次」でも使えます。「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
amount | 「検索ページ」と「メインの目次ページ」で使用したときに、前または次のページに進んだときに表示されるアイテムの数 |
個別アイテム、月別アーカイブ、検索、メインの目次
<%prevlink%>
リンク元のURLを挿入します。アクセス方法や、ブラウザ、ファイアウォール等の設定によって、空白の時があります。
なし
全て
<a href="<%referer%>">戻る</a>
現在のブログに対する検索フォームを挿入します。
名前 | 値 |
---|---|
blogname | 検索を実行するブログの短縮名(ブログの短縮名を指定していても、常に検索対象に含めるの設定が「はい」のブログは検索対象になります) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、個別アイテム
<%searchform%> <%searchform(otherweblog)%>
現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
maxresults | 表示する結果の最大数 |
検索
<%searchresults(mytemplate)%>
パーサーのプロパティを設定します。
名前 | 値 |
---|---|
property | プロパティの名前 |
value | プロパティの値 |
全て
<%set(IncludeMode,skindir)%> <%set(IncludePrefix,somedir/)%>
「グローバル設定」でのサイトの設定を挿入します。
名前 | 挿入される設定 |
---|---|
url | サイトのURL |
name | サイトの名前 |
admin | 管理者のメールアドレス |
全て
<%sitevar(name)%> <%sitevar(url)%> <a href="mailto:<%sitevar(email)%>">管理人</a>
表示に使用中のスキンのあるディレクトリにリンクを張る時に使用します。パーサーのプロパティIncludePrefix
と共に使用することで、最良の結果を得ることができます。
名前 | 値 |
---|---|
filename | ファイルの名前(「http://~」から始まるURLに変換されます) |
全て
<%skinfile(mystyle.css)%>
スキンにアイテムを表示します
名前 | 値 |
---|---|
itemid | 表示するアイテムのID |
template | アイテムを表示するためのテンプレート |
全て
<%sticky(11,default/index)%>
「個別アイテムページ」では1つ新しいアイテムへ、「アーカイブページ」では1つ新しいアーカイブへのURLを挿入します。
「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
amount | 「検索ページ」と「メインの目次ページ」で、1ページに表示されるアイテムの数を指定します。 次のページへ進むたびに amount で指定した数だけアイテムがスキップされます。 |
recount | 「検索ページ」と「メインの目次ページ」で、2ページ目以降、アイテムの数が正確にスキップされない場合、 recount に「yes」を設定してください。 ページを進む毎に再計算されますので、正確なアイテムの数だけスキップして表示されます。 |
個別アイテム、月別アーカイブ、検索、メインの目次
<%nextlink%> <%nextlink(次のページ,10)%> <%nextlink(,10)%> <%nextlink(,10,yes)%>
選択中のブログ、あるいはカテゴリーのトップページのURLを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
全て
<%todaylink%>
このスキン変数はNucleusバージョン2.0以降使いません。スキン変数:itemidを使ってこのHTMLをあなた自身で挿入することはたいした手間ではないでしょう。
itemid入りの隠しフォームのインプット欄を挿入。
<input type="hidden" name="itemid" value="1234" />
なし
個別アイテム
次の変換記述は文字列フォーマットに基づきます(PHPドキュメントのstrftime関数から持ってきたものです)。より詳しい情報は Open Group Specificationにあります。
以下はサーバによって対応が異なりますので、参考程度にお試しください。
super-admin(最高管理者)と呼ばれ、ブログのチームへの所属とは無関係に、全ての機能と全てのブログにフルアクセスできます。
またsuper-adminは、ブログの作成、グローバル設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作(メンバーの作成/編集/削除)を行う権限があります。
super-adminとなるのは通常サイトの管理者ただ一人でしょう。
Blogの管理者は次のような追加権限をもちます:
一つのブログは複数の管理者を持つことができます。各ブログには、最低でも一人の管理者がいなくてはなりません。
過去ログのリストは、以下のようなリスト体裁をとります:
アーカイブリストヘッダー アーカイブリスト本体(アーカイブごとに繰り返し) アーカイブリストフッター
利用できる変数:(ヘッダーとフッターではblogid
のみが使用できます)
名前 | 説明 |
---|---|
blogid | weblogのID |
archivelink | アーカイブへのリンク。<a href="<%archivelink%>"> のように使用します。 |
month | 月の数値(01-12の2文字表記) |
year | 年(西暦の4文字表記) |
day | 月の中での日付(二文字表記。日ごと表示の時のみ) |
strftime変数を使用することで、日付の表記を自由にカスタマイズすることができます。この変数が複雑すぎると感じるなら、次のように記述すると良いでしょう。
<a href="<%archivelink%>">%B,%Y</a><br />
出力される時刻と言語をあなたの住んでいる地域にあわせるために、localeを適切に設定してください。
ブログリストは次の様に出力されます:
ブログリストヘッダー ブログリストアイテム(存在するブログの数だけ繰り返し) ブログリストフッター
ブログリストアイテムで利用可能な変数:
名前 | 説明 |
---|---|
bloglink | ブログのURL(Nucleusコアによって与えられた引数から生成されるもの)<a href="<%bloglink%>"> のように使用します。 |
blogurl | ブログのURL(「Blog設定」の「URL」で設定されているもの)<a href="<%blogurl%>"> のように使用します。 |
blogdesc | ブログの説明 |
blogname | ブログ名(第二引数に『shortname』が指定された場合は『ブログの短縮名』) |
ヘッダーとフッターでのみ使用できる変数:
名前 | 説明 |
---|---|
siteurl | グローバル設定の「サイトのURL」 |
sitename | グローバル設定の「サイト名」 |
カテゴリーリストは下の表のようにフォーマットされます:
カテゴリーリストヘッダー カテゴリーリストアイテム(繰り返し) カテゴリーリストフッター
利用可能な変数:(ヘッダーとフッターではblogid
, blogurl
, self
, catiscurrent
, currentcat
のみが許可されています)
名前 | 説明 |
---|---|
blogid | weblogのID |
blogurl | blogのURL(blogごとの「設定」で定義される) |
self | パラメーター無しの現在のページ(例えばindex.php ) |
catlink | 該当カテゴリーの新しいアイテムへのリンク。これにより<a href="..">タグを埋め込むことができる。 |
catid | カテゴリーのID |
catname | カテゴリー名 |
catdesc | カテゴリーの説明 |
catiscurrent | カテゴリが選択中、もしくは表示中のアイテムが所属するカテゴリの場合「yes」が、そうでなければ「no」が出力される |
currentcat | <%catiscurrent%>のシノニム |
このテンプレート・パーツは単独のコメント表示に使われます。このテンプレートでは、コメント関連テンプレート変数が利用できます。
<h2><%userlink%>さんによるコメント:</h2>
<p><%body%></p>
<div class="metadata">
(接続元:<%host%> 投稿日時:<%date%> <%time%>)
</div>
結果は次のようになります:
このテンプレートの内容は、コメントの本体で使われる変数<%short%>
に追加されます。
このテンプレート内部では、<%short%>
以外のコメント関連テンプレート変数が利用できます。
例:
<a href="<%itemlink%>">[続き]</a>
「コメントの本体」はコメント一つごとに繰り返されますが、ヘッダーとフッターは一度しか表示されません。出力は次のようになります:
コメントのヘッダー コメントの本体 1 コメントの本体 2 コメントの本体 3 コメントのフッター
これらのテンプレート内では、コメント関連テンプレート変数が利用できます。
コメントのヘッダー:
<ul>
コメントの本体:
<li><%user%>: <%body%></li>
コメントのフッター
</ul>
結果は次のようになります
コメントブロックは3つの要素で構成されています。
コメントのヘッダー コメントの本体(コメントの数だけ繰り返し) コメントのフッター
コメントが無い時
コメントが多すぎる時
コメントのテンプレート内部では、コメント関連テンプレート変数が利用できます。
日本語で使う場合は、単複同型なので両方"件のコメント"にしておいて問題ないでしょう。英語で表記したい時は、次のようなことが気になるかもしれません。
コメントの件数の表示の仕方を、"1 comment(s)"とするよりも"1 comment"、"3 comments"と表示したい人が多いのではないでしょうか?「コメントが1つの時」と「コメントが2つ以上の時」のテンプレート部分はその目的のために存在します。これらは他の所で使える<%commentword%>
変数の中身として利用されます。
1つしかコメントが無い時は、<%commentword%>
は「コメントが一つの時」で設定した内容になり、2つ以上のコメントがついているなら「コメントが二つ以上の時」で設定した内容になります。
典型的な値は"comment"と"comments"です。ここでは変数は利用できません。
日付のヘッダーと日付のフッターは、日付と時刻の変数を入力することができます。利用できる変数の詳細情報はこちらにあります。もし手っ取り早く始めたいのなら、日付フォーマットとして"%x"を使ってください。日付フォーマットで使われる言語は、テンプレートのLocaleで設定できます。
日付のヘッダーにテンプレート変数<%%daylink%%>を含めることによって、その日のアーカイブへのリンクを挿入できます。"%"が二つ続けてあることに注意!変数として展開される%dを無効にするために必要な措置です。 同様に、このテンプレート内で"%"という文字を使いたい場合は、二つ重ねて"%%"と記述しないとサイトには表示されません。
日付のヘッダーのサンプル:
<div class="day"> <h1>%d %B</h1>
日付のフッターのサンプル:
</div>
daylinkを用いた日付ヘッダーの例:
<div class="day"> <h1>%d %B</h1> <a href="<%%daylink%%>">(アーカイブ)</a>
これらは<%date%>
と <%time%>
という変数(詳細はテンプレート変数を参照)の日付と時刻の表示方法を設定します。フォーマットはLocaleにも左右されます。
利用できる変数の詳細な情報はこちら。もし手っ取り早く始めたいのなら、日付フォーマットに"%x"を、時刻フォーマットに"%X"をお使いください。
このテンプレートはテンプレート変数"edit"がどのように表示されるかを決めるものです。このテンプレートではすべてのテンプレート変数が使用できます。
<a href="<%editlink%>"
onclick="<%editpopupcode%>">編集</a>
検索結果をハイライト表示するために、検索文字列を挟み込む(X)HTMLタグを入力します。" "と記述した場所が、検索文字列に置き換えられます。また、ここで入力された文字列は、プログラム中で正規表現のパターン構文数(新しいウィンドウが開きます)としてそのまま使用されますので、いくつかの記号はバックスラッシュを直前に置くことでエスケープしなければなりません。
<span style="background-color:yellow"></span>
アイテム表示時に、それぞれのアイテムで次のセットが繰り返されます:
アイテムのヘッダー アイテムの本体 アイテムのフッター
「ヘッダー」、「本体」「フッター」の3つのブロックは、それぞれテンプレートの一部として、どのような見た目になるのかを定義します。
これらのテンプレート内では、アイテムのデータを挿入するのにテンプレート変数とよばれる系列が利用できます。
「アイテムの本体」テンプレートの一例です:
<h1><%title%></h1> <p><%body%></p> <div class="metadata"> <a href="<%itemlink%>">link</a> - <%date%> <%time%> - <a href="<%authorlink%>"><%author%></a> - <%comments%> </div>
結果は次のようになります:
コメント関連テンプレート変数で、元記事のタイトルを挿入します。
名前 | 値 |
---|---|
maxlength | maxlengthで指定された数値で、アイテムのタイトル省略。 |
<%itemtitle%>
これは実際のところテンプレートの部品というより設定です。設定することによって、日付と時刻のローカライズを選択できます。月や曜日などは要求された言語での表示になるでしょう。
使える変数は、Nucleusが動作しているコンピュータによります。使える変数をいくつかあげますと・・・:
strftimeに関するより詳しい情報は、Open Group Specificationにあります。(新規ウィンドウが開きます)
locale は日付と時刻のフォーマット、日付ヘッダー、アーカイブリストで利用されます。
これはコメントが登録メンバーからのものであることを示すのに利用できるテンプレートです。最終的にはコメントの本体で使われる<%authtext%>
変数の中身として表示されます。
このテンプレート内部では、コメント関連テンプレート変数が利用できます。
これはアイテムのテンプレート(アイテムのヘッダー、アイテムの本体、アイテムのフッターの3つ)で利用できるテンプレート変数、"morelink"がどのように表示されるかを決めるものです。利用可能な変数はアイテムのテンプレートと同じです。
もしアイテムに「続き」の部分が存在しない場合、テンプレート変数<%morelink%>
は無視されます。
<a href="<%itemlink%>">[続きを読む!]</a>
最終訪問日時Cookieの保存オプションを「はい」に設定している時、前回訪問時から後に追加されたアイテムに、「新しいアイテムに付けるマーク」テンプレートの内容が、アイテムのテンプレートに記述した変数<%new%>
の部分に表示されます。
「最終訪問日時Cookieの保存」が「いいえ」に設定されている、または前回訪問時以降にアイテムが新しく追加されていなければ、変数<%new%>
は無視されます。
検索が実行され結果何も見つからなかった場合に表示されます。
利用可能な変数:
名前 | 説明 |
---|---|
blogid | ブログのID |
query | 検索に用いられた文字列 |
<b><%query%></b>に該当する検索結果はありませんでした
これらのテンプレートは、画像のポップアップウィンドウへのリンクと画像以外のメディア・オブジェクトのフォーマットに用いられます。それぞれのテンプレートで利用可能な変数は以下の通りです。
名前 | 説明 |
---|---|
popuplink | 画像へのポップアップ・リンク |
rawpopuplink | popuplinkのジャンプ先URL |
popupcode | ポップアップウィンドウを開くjavascriptコード |
text | 代替テキスト(リンクテキスト) |
width | イメージの幅 |
height | イメージの高さ |
popuptext | textと同じだが、htmlエンティティ変換される |
link | 画像の直接のURL |
media | 画像への直接リンク |
名前 | 説明 |
---|---|
image | (x)htmlのimgタグ |
link | 画像の直接のURL |
text | 代替テキスト(リンクテキスト。htmlエンティティ変換される) |
width | イメージの幅 |
height | イメージの高さ |
media | 画像への直接リンク |
名前 | 説明 |
---|---|
media | ファイルへの直接リンク |
link | ファイルの直接のURL |
text | 代替テキスト(リンクテキスト。htmlエンティティ変換される) |
投稿者のデータを挿入します。
名前 | 挿入される情報の種類 |
---|---|
name | 投稿者の「表示される名前」(ログインID) |
realname | 投稿者のハンドルネーム(本名) |
id | 投稿者のメンバーID |
url | 投稿者のウェブサイトのURL |
投稿者の登録メールアドレス(使うのは避けるべき) |
<%author%>
<%author(realname)%>
<a href="<%author(url)%>"><%author%></a>
コメントブロックを挿入します。このブロックの詳しい説明。
名前 | 値 |
---|---|
MaxToShow | 表示するコメントの数(設定されていれば、Blog設定にあるコメントの最大量を上書きします) |
<%comments%> <%comments(5)%>
日付フォーマットで設定した書式で日付を挿入します。オプションの引数に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)%>
テンプレート:アイテムを編集するためのリンクの内容を挿入します。
注意:ログイン状態のメンバーが、閲覧中のアイテムの編集を許可されている時のみ、この変数が働きます。それ以外の場合は、テンプレート変数<%edit%>は何も表示しません。
「アイテムの本体」テンプレートの一例
<h1><%title%></h1>
<p><%body%> <%morelink%></p>
<div class="metadata">
<%edit%> <%comments%>
</div>
アイテムを編集するためのbookmarkletのURLを挿入します。この変数はテンプレート:アイテムを編集するためのリンク内で使用することができます。
「アイテムを編集するためのリンク」テンプレートの一例
<a href="<%editlink%>" onclick="<%editpopupcode%>">編集</a> -
"アイテムの編集"ウィンドウをポップアップで開くためのjavascriptのコードを挿入します。
「アイテムを編集するためのリンク」テンプレートの一例
<a href="<%editlink%>" onclick="<%editpopupcode%>">編集</a> -
アイテム本体やテンプレートにインライン画像を挿入します。
通常テンプレート変数<%image%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。
名前 | 値 |
---|---|
filename | 画像ファイルの名前 |
width | 画像の横幅(ピクセルかパーセンテージ) |
height | 画像の高さ(ピクセルかパーセンテージ) |
text | 画像の代用テキスト |
<%image(myphoto.jpg|100|200|これが私です)%> <%image(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>
カルマ投票のデータを挿入します。カルマ投票は、アイテムの"カルマ"を投票する方法で、正にでも負にでも投票できます。これら投票の総計によって、該当記事が訪問者にどのように思われているのか知ることができます。
名前 | 挿入される情報の種類 |
---|---|
totalscore | カルマ投票の総合得点(正の投票数から負の投票数を引いたもの/デフォルト) |
pos | 正の投票の総計 |
neg | 負の投票の総計 |
votes | 投票数の総計 |
posp | 正に投じられたパーセンテージ |
negp | 負に投じられたパーセンテージ |
<%karma(posp)%>がよい記事だと評価しました(総計<%votes%>票)
アイテム本体やテンプレートにメディアオブジェクトを挿入します。
通常テンプレート変数<%media%>はアイテムにメディアファイルを挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。
名前 | 値 |
---|---|
filename | オブジェクトファイルの名前 |
text | オブジェクトの説明テキスト |
<%media(mysong.mp3|新曲を聞いてみてください)%>
テンプレート続きへのリンクで定義されているリンクを挿入します。「続き」に何も入力されていない時は無視されます。
テンプレート部品"続きへのリンク"の中身もまたパースされるので、同様にテンプレート変数を含むことができることに注意してください(例:続きへのリンクに<%morelink%>を記述することは可能ですが、無限ループを起こします)。
なし
アイテム本体やテンプレートにポップアップ画像を挿入します。
通常テンプレート変数<%popup%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。
名前 | 値 |
---|---|
filename | 画像ファイルの名前 |
width | 画像の横幅(ピクセルかパーセンテージ) |
height | 画像の高さ(ピクセルかパーセンテージ) |
text | 画像の代用テキスト |
<%popup(myphoto.jpg|100|200|これが私です)%> <%popup(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>
現在のアイテムを調べてから、「本文」と「続き」のどちらを表示するか決定します。
「続き」に何かが入力されていれば「続き」が、何も入力されていなければ「本文」が挿入されます。
部分名 | 何か入力されている? | |
---|---|---|
本文 | 入力あり | 入力あり |
続き | 入力なし | 入力あり |
smartbodyで 挿入される部分 | 「本文」部分 | 「続き」部分 |
「本文」に詳しい内容を入力し、「続き」には"紹介"、"抜粋"といった内容のものを入力し、「メインの目次ページ」で使用するテンプレートには<%smartbody%>
を使い、抜粋が存在するときにはそれを、無い時は「本文」を使用するような使い方をします。
この時、「個別アイテムページ」で使うテンプレートには、 <%body%>
+ <%more%>
のかわりに<%body% >
だけを記述するようにすると、より効果的に使えるでしょう。
HTMLタグを取り除き、指定された幅にまで縮めたアイテムの本文を挿入します(指定が無い時は250)。テキストが縮められた場合は、末尾に"..."が追加される。
この変数はRSSのために使うことが意図されていましたが、他にも便利な使い方があるでしょう。
名前 | 値 |
---|---|
MaxChars | 省略せずに残す最大の幅(デフォルトは250) |
<%syndicate_description%> <%syndicate_description(25)%>
HTMLタグを取り除き、指定された長さにまで縮めたアイテムのタイトルを挿入します(指定が無い時は100)。省略された場合、末尾に"..."が追加されます。
この変数はRSS等のために使うことが意図されていましたが、他にも便利な使い方があるでしょう。
名前 | 値 |
---|---|
MaxChars | 省略せずに残す最大の幅(デフォルトは100) |
<%syndicate_title%> <%syndicate_title(25)%>
時刻フォーマットで設定した書式で時刻を挿入します。オプションの引数にstrftime変数を使用して、フォーマットを変更することもできます。
名前 | 値 |
---|---|
format | 時刻のフォーマットに用いる形式 |
<%time%> <%time(%X)%>
名前 | 説明 |
---|---|
authorid | 現在のアイテムの投稿者のID |
blogid | アイテムが所属するブログのID |
catid | アイテムが所属するカテゴリーのID |
query | 存在していれば、検索文字列 |
syndicate_title | RSSなどの配信用に、指定文字数以上を省略したアイテムのタイトル |
syndicate_description | RSSなどの配信用に、指定文字数以上を省略した「本文」テキスト |
karmaposlink | 投票用のURL |
karmaneglink | 投票用のURL |
new | 前回訪問時意向に追加されたアイテムを示すテキストなど |
include | 指定されたファイルの内容をそのまま挿入 |
parsedinclude | 指定されたファイル内のスキン/テンプレート変数を展開して、その結果を挿入 |
phpinclude | 指定されたファイルをPHPとして実行した結果を挿入 |
if-ifnot-else-elseif-elseifnot-endif | 3.60より、テンプレートでif(条件分岐)が使用できます。(オプションの「nextitem, previtem, archiveprevexists, archivenextexists, skintype」は利用できません。) |
plugin | プラグインを実行 |
edit | テンプレート「アイテムを編集するためのリンク」の内容を挿入 |
editlink | アイテム編集画面(bookmarklet)のURL |
editpopupcode | editlink用のウィンドウをポップアップするjavascriptコード |
skinfile | インポートされたスキンに属しているファイルへの正確なURLを挿入 |
set | パーサーのプロパティを設定 |
image | メディア・ライブラリの画像をインライン表示 |
popup | メディア・ディレクトリの画像をポップアップ |
media | メディア・ディレクトリの他のメディア・オブジェクト |
relevance | 検索結果を表示するテンプレートに「検索関連度」を挿入する(2.5より) |
これらの変数はすべて、そのときパースされているアイテムに関わる値になります。
名前 | 説明 |
---|---|
title | アイテムのタイトル |
body | 「本文」のテキスト |
more | 「続き」のテキスト |
category | アイテムが所属しているカテゴリーの名前 |
categorylink | アイテムが所属しているカテゴリーのURL |
karma | カルマ投票の得点 |
authorlink | 投稿者の「メンバーの詳細ページ」のURL |
itemlink | アイテムのURL(permanent) |
author | 投稿者の「表示される名前」 |
smartbody | 本文か続きのどちらか |
morelink | 「続き」部分のURL |
date | フォーマット済みの日付 |
time | フォーマット済みの時刻 |
daylink | アイテムが投稿された日付のアーカイブのURL |
comments | コメント・ブロック、もしくはコメント数 |
itemid | アイテムのID |
blogurl | ブログのURL |
名前 | 説明 |
---|---|
body | コメントの本体 |
user | コメントした人の名前 |
userid | コメントした人のWebサイトのURL、もしくはコメントした人のメールアドレス(入力されたままのものが挿入されます) |
コメントした人のメールアドレス(スパム対策として、"@"は"(at)"に、".(ピリオド)"は"(dot)"に変換されます) | |
userlink | コメントした人がログイン中の登録メンバーの時はメンバー詳細ページに、それ以外の時は入力されたWebサイトのURL、もしくはメールアドレスに対する<a href="...">タグ付きのリンク(有効なURLかメールアドレスが入力されていない場合は、コメントした人の名前のみが表示されます) |
userlinkraw | userlinkと同じ。ただし、aタグの付いたリンクではなくURL、もしくはmailto:メールアドレスのみの表記。(入力されたURLやメールアドレスがいずれも文法的に有効でない場合は空になります) |
useremail | ユーザーのメールアドレス。もしコメントした人によって入力されていない場合は空 |
userwebsite | ユーザーのwebsiteのURL。もしコメントした人によって入力されていない場合は空 |
userwebsitelink | コメントした人が登録メンバーの時はメンバー詳細ページに、それ以外の時は入力されたWebサイトのURLに対する<a href="...">タグ付きのリンク(有効なURLが入力されていない場合は、コメントした人の名前のみが表示されます) |
memberid | メンバーのID(コメントした人がログイン中の登録メンバーでない時は0になります) |
commentcount | 該当アイテムに付けられたコメントの総数 |
commentword | アイテムに付けられたコメントの件数の数え方の表記 |
date | コメントが追加された時の日付 |
time | コメントが追加された時の時刻 |
host | コメントが投稿されたホスト名 |
ip | コメントが投稿されたIPアドレス |
commentid | 現在のコメントのID |
itemid | 現在のアイテムのID |
itemlink | アイテムの詳細ページへのリンク |
itemtitle | 現在のアイテムのタイトル |
blogid | ブログのID |
blogurl | ブログのURL |
authtext | コメントした人がログイン中の登録メンバーの時は「登録メンバーからのコメントへの追加表示」テンプレートで設定した内容、それ以外は空 |
short | 最初の改行部分から先が省略されたコメントの本体。テンプレートによっては末尾にリンクが追加されます。 |
excerpt | コメントの本体。60文字でカットし"..."を追加 |
timestamp | コメントが追加された時のタイムスタンプ |
if-ifnot-else-elseif-elseifnot-endif | 3.60より、テンプレートでif(条件分岐)が使用できます。(オプションの「nextitem, previtem, archiveprevexists, archivenextexists, skintype」は利用できません。) |
include | 指定されたファイルの内容をそのまま挿入 |
parsedinclude | 指定されたファイル内のスキン/テンプレート変数を展開して、その結果を挿入 |
phpinclude | 指定されたファイルをPHPとして実行した結果を挿入 |
plugin | プラグインを実行 |
skinfile | インポートされたスキンに属しているファイルへの正確なURLを挿入 |
set | パーサーのプロパティを設定 |
テンプレート変数はスキン変数と同じ方法で広く働きますが、テンプレート内部で利用できる点でスキン変数と区別されます。変数は <%変数名%>
という形で呼び出され、変数の機能によってはテキストを挿入します。また、その他のオプションパラメーターを持つ変数もあります。
テンプレート変数は、「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」
といった、テンプレート・パーツの中で使用できます。(変数image
、 popup
、media
、 plugin
はブログアイテムの中でも使用できます。)
コメント関連のテンプレート・パーツ(「コメントのヘッダー」、「コメントの本体」、「コメントのフッター」、「コメントが1 つの時」、「コメントが2つ以上の時」、「コメントの続きを読む」、「コメントが無い時」、「長すぎるコメントの時」
)では、利用可能な変数のセットが異なります:
このオプションを用いることにより、URLスタイルを切り替え可能です:
http://example.jp/index.php?itemid=1234
http://example.jp/item/1234
注意:「Fancy URL」モードで動作するようにするためには、この設定のほかにもいくつかの作業が必要になります。詳しい解説はTips & Suggestionsに記述されています。(新規ウィンドウが開きます)