ファイル読み込み中、しばらく待ちください(ファイルサイズはおよそ170KBです)。
アイテム追加フォームの「後で追加」オプションをチェックすることで、アイテムを指定した時間きっかりに公開することができます。指定された時間が来るまで、アイテムはサイトの公開された部分で見られることはありません。
この日時は、アイテムを追加するブログの「過去の日時での投稿を許可する」オプションが有効である場合を除いて、未来のものでなくてはなりません。
この設定を有効にすると、アイテムを追加する時に、アイテムの投稿日時を過去に指定することができるようになります。また、既存のアイテムの投稿日時を編集することもできるようになります。
「タイムスタンプを更新」オプションにより、アイテムの投稿された日付や時間を変更することができます。アイテムの内容を変更した時に、「タイムスタンプを更新」することで記事をブログののトップに戻すことができます。
しかし、そのアイテム独自のIDは変更されませんので、訪問者はアイテムのIDから、そのアイテムが編集後に投稿時間が変更されたものだと気づくことができます。
The Autosave function saves an item as a draft after 10 minutes editing. It should avoid that unsaved changes get lost. It is usefull for users that work for a long time on an item and often forget to save their work.
If you want to invoke Autosave before the 10 minutes are past, you can press the 'Auto save now' button at the end of the form.
The Autosave function can be enabled and disabled in the member options.
ドラフト状態のアイテムはブログの公開されたところでは閲覧することができません。推敲に時間をかけたい時や、、実際に投稿するまでに、少し時間を空けたいときなどに役に立つでしょう。ドラフト状態のアイテムは「管理ホーム」にリストとして表示されるので、時間があるときに、いつでも作業を再開することが可能です。
ドラフト状態のアイテムを編集する際に、「今すぐ追加」のラジオボタンを選んで「保存」ボタンを押すと、ドラフト状態が解除されてブログに公開されます。
アイテムには、長文記事を分割して表示するために、オプションとして「続き」部分があります。例えば、記事がブログのメインページに置くには長すぎる場合、導入を「本文」部分に、残りを「続き」部分に書くことができます。テンプレートによって、表示の形態は変わってきますが、ブログのメインページを閲覧すると「続きを読む」というリンクが出現します。
もしアイテムの単なる概略として導入部分を書きたいのなら、smartbodyというテンプレート変数を用いることで、「本文」と「続き」の表示を分けることも可能です。
「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の管理者は次のような追加権限をもちます:
一つのブログは複数の管理者を持つことができます。各ブログには、最低でも一人の管理者がいなくてはなりません。
super-admin(最高管理者)と呼ばれ、ブログのチームへの所属とは無関係に、全ての機能と全てのブログにフルアクセスできます。
またsuper-adminは、ブログの作成、グローバル設定の変更、テンプレートの書き換え、スキンの書き換え、メンバーの操作(メンバーの作成/編集/削除)を行う権限があります。
super-adminとなるのは通常サイトの管理者ただ一人でしょう。
適用すべきスキンが見つからなかった時に代用するスキンを設定します。これはスキン・パーツが設定されていなかったり、スキンが明確に指定されていなかったりした時に起こります。
ほとんどのユーザーは、この設定を気にする必要がありません。
デフォルトでは、メンバーがログインするとブラウザにcookieが保存され、翌日に戻ってきたときに再びログインする必要がなくなります。クッキーの有効期間によって、いつ無効になるか決定されます。
これらは取り高度な設定です。通常は、cookieパスは単純にスラッシュ('/')、cookieドメインは空っぽの状態から変更する必要はありません。
通常は「いいえ」に設定してください。HTTPSのurlを用いており、cookieの送受信をhttps接続を通してのみに限定したい時だけ、この設定を「はい」にします。
訪問者が最後に訪れた時間をcookieに保存させるように設定することができます。これによって、新規アイテムの隣にマークを付けることができます。
Nucleusが生成する個々のメンバー用のコンテンツを作成するときに用いられる言語を選択することができます。Nucleusによって生成されるコンテンツには、管理領域、エラーメッセージ、スキンにおけるフォームなどが含まれます。
言語の選択を行う場所は二ヶ所あります。一箇所目は「グローバル設定」で、デフォルトで用いられる「既定の言語」を設定します。もう一箇所は、各「メンバーの編集」ページの設定でメンバー毎ログイン時の使用言語を設定することができます。
これら両方の設定が無効の場合、英語がデフォルトの言語として用いられます
注意: 追加の言語ファイルはNucleusのウェブサイトからダウンロードできます。(新規ウィンドウが開きます)
訪問者に自身のメンバーアカウント作成を許可することができます。新規メンバーは管理者がチームに加えるまでは、ブログにアイテムを追加することはできませんが、自分のコメントを削除したり変更したりすることが可能です。新規メンバーのログイン許可を許可している場合、管理領域にログインして自分の設定を変更することもできます。
この設定は、訪問者によるアカウントの作成を許可している場合に、その方法で作られたアカウントを使用して管理領域にログインできるかどうかを設定します。
メンバーのプライバシーのために、メールアドレスを隠したままで、スクリプトを通してメンバー同士でメールメッセージの送信ができます。送信されたメッセージには両ユーザーのメールアドレスが含まれますので、その後は通常のメールを用いた連絡を続けることができます。このサービスは無効にすることが可能です。
デフォルトでは非メンバーは、入力されたメールアドレスが有効なものかチェックする方法が無いために、メッセージサービスを使用できません。「メンバー以外からのメッセージ送付を許可」することによってこの制限を緩和できます。非メンバーはメッセージの投函時にメールアドレスを尋ねられ、そのアドレスがメールのヘッダーFrom:
に表示されることになります。
Nucleusのサイト全体を閉鎖することが可能です。なんらかの設定調整を行うときに、あるいは何か恐ろしい間違いが起きた時にこれを実行したいと思うかもしれません:-)
チェックボックスを「はい」に設定した場合に、訪問者はここで設定したURLにリダイレクトされます。
例外:管理領域は閉鎖していない時と同様に利用可能であり、最高管理者は通常通りサイト全体を閲覧することができます。(あとでサイトを再開することを忘れないでください;-))
このオプションを用いることにより、URLスタイルを切り替え可能です:
http://example.jp/index.php?itemid=1234
http://example.jp/item/1234
注意:「Fancy URL」モードで動作するようにするためには、この設定のほかにもいくつかの作業が必要になります。詳しい解説はTips & Suggestionsに記述されています。(新規ウィンドウが開きます)
アイテム表示時に、それぞれのアイテムで次のセットが繰り返されます:
アイテムのヘッダー アイテムの本体 アイテムのフッター
「ヘッダー」、「本体」「フッター」の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 コメントの本体 2 コメントの本体 3 コメントのフッター
これらのテンプレート内では、コメント関連テンプレート変数が利用できます。
コメントのヘッダー:
<ul>
コメントの本体:
<li><%user%>: <%body%></li>
コメントのフッター
</ul>
結果は次のようになります
これはアイテムのテンプレート(アイテムのヘッダー、アイテムの本体、アイテムのフッターの3つ)で利用できるテンプレート変数、"morelink"がどのように表示されるかを決めるものです。利用可能な変数はアイテムのテンプレートと同じです。
もしアイテムに「続き」の部分が存在しない場合、テンプレート変数<%morelink%>
は無視されます。
<a href="<%itemlink%>">[続きを読む!]</a>
過去ログのリストは、以下のようなリスト体裁をとります:
アーカイブリストヘッダー アーカイブリスト本体(アーカイブごとに繰り返し) アーカイブリストフッター
利用できる変数:(ヘッダーとフッターではblogid
のみが使用できます)
名前 | 説明 |
---|---|
blogid | weblogのID |
archivelink | アーカイブへのリンク。<a href="<%archivelink%>"> のように使用します。 |
month | 月の数値(01-12の2文字表記) |
year | 年(西暦の4文字表記) |
day | 月の中での日付(二文字表記。日ごと表示の時のみ) |
strftime変数を使用することで、日付の表記を自由にカスタマイズすることができます。この変数が複雑すぎると感じるなら、次のように記述すると良いでしょう。
<a href="<%archivelink%>">%B, %Y</a><br />
出力される時刻と言語をあなたの住んでいる地域にあわせるために、localeを適切に設定してください。
カテゴリーリストは下の表のようにフォーマットされます:
カテゴリーリストヘッダー カテゴリーリストアイテム(繰り返し) カテゴリーリストフッター
利用可能な変数:(ヘッダーとフッターではblogid
、 blogurl
、self
のみが許可されています)
名前 | 説明 |
---|---|
blogid | weblogのID |
blogurl | blogのURL(blogごとの「設定」で定義される) |
self | パラメーター無しの現在のページ(例えばindex.php ) |
catlink | 該当カテゴリーの新しいアイテムへのリンク。これにより<a href="..">タグを埋め込むことができる。 |
catid | カテゴリーのID |
catname | カテゴリー名 |
catdesc | カテゴリーの説明 |
<ul>
<li><a href="<blogurl%>">まとめて表示</a>< /li>
<li><a href="<%catlink%>"><%catname%></a></li>
</ul>
ブログリストは次の様に出力されます:
ブログリストヘッダー ブログリストアイテム(存在するブログの数だけ繰り返し) ブログリストフッター
ブログリストアイテムで利用可能な変数:
名前 | 説明 |
---|---|
bloglink | ブログのURL(Nucleusコアによって与えられた引数から生成されるもの)<a href="<%bloglink%>"> のように使用します。 |
blogurl | ブログのURL(「Blog設定」の「URL」で設定されているもの)<a href="<%bloglink%>"> のように使用します。 |
blogdesc | ブログの説明 |
blogname | ブログ名(第二引数に『shortname』が指定された場合は『ブログの短縮名』) |
ヘッダーとフッターでのみ使用できる変数:
名前 | 説明 |
---|---|
siteurl | グローバル設定の「サイトのURL」 |
sitename | グローバル設定の「サイト名」 |
<ul>
<li><a href="<%siteurl%>"><%sitename%></a></li>
<li><a href="<%bloglink%>" title="<%blogdesc%>"><%blogname%></a></li>
</ul>
これは実際のところテンプレートの部品というより設定です。設定することによって、日付と時刻のローカライズを選択できます。月や曜日などは要求された言語での表示になるでしょう。
使える変数は、Nucleusが動作しているコンピュータによります。使える変数をいくつかあげますと・・・:
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>
検索が実行され結果何も見つからなかった場合に表示されます。
利用可能な変数:
名前 | 説明 |
---|---|
blogid | ブログのID |
query | 検索に用いられた文字列 |
<b><%query%></b>に該当する検索結果はありませんでした
このテンプレート・パーツは単独のコメント表示に使われます。このテンプレートでは、コメント関連テンプレート変数が利用できます。
<h2><%userlink%>さんによるコメント:</h2>
<p><%body%></p>
<div class="metadata">
(接続元:<%host%> 投稿日時:<%date%> <%time%>)
</div>
結果は次のようになります:
これらのテンプレートは、画像のポップアップウィンドウへのリンクと画像以外のメディア・オブジェクトのフォーマットに用いられます。それぞれのテンプレートで利用可能な変数は以下の通りです。
名前 | 説明 |
---|---|
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エンティティ変換される) |
これはコメントが登録メンバーからのものであることを示すのに利用できるテンプレートです。最終的にはコメントの本体で使われる<%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
という名前でスペシャルスキンパーツを作った場合)
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文書として表示されます。 また、標準的なスキン変数が使えるので、ブログとの連系を持たせた静的ページを持たせたいときなどに役立つでしょう。
ブログ、テンプレート、そしてスキンは名前や説明の他に短縮名を持たなくてはなりません。
短縮名はa~zと0~9のみで構成され、スペースを含むことはできません。
訳注:テンプレートの名前には'/'が利用できたりするので、実際にはこの限りではないようです。
メンバーの場合、「表示される名前」はログイン名として使われます。a~z、 A~Z、0~9とスペース(半角)が使用できます。ただし、名前の最初や最後にスペースを付けることはできません。
最終訪問日時Cookieの保存オプションを「はい」に設定している時、前回訪問時から後に追加されたアイテムに、「新しいアイテムに付けるマーク」テンプレートの内容が、アイテムのテンプレートに記述した変数<%new%>
の部分に表示されます。
「最終訪問日時Cookieの保存」が「いいえ」に設定されている、または前回訪問時以降にアイテムが新しく追加されていなければ、変数<%new%>
は無視されます。
次の変換記述は文字列フォーマットに基づきます(PHPドキュメントのstrftime関数から持ってきたものです)。より詳しい情報は Open Group Specificationにあります。
以下はサーバによって対応が異なりますので、参考程度にお試しください。
ブログを更新した時に、ブログ検索サイト等の公開している複数の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はメディアファイル(画像、動画、音楽など等)をウェブサイトにアップロードすることができます。
このためにいくつかの設定が必要となります:
メンバーはそれぞれ、自身のメディアファイルのプライベートなコレクションを持ちます。また、それ以外のメディア・ディレクトリ下のサブディレクトリはグローバルなコレクション(メンバー間で共有)とみなされます。
アップロードは悪用を予防するため、少なくとも一つのブログチームに入っているメンバーでなくては行えません。
訪問者によるメンバーへの成りすましを防止するために、メンバーとして登録済みの名前を使ってのゲストコメントはできないようになっています。このオプションを「いいえ」に設定することで、この規制を緩和することができます。
この設定はNucleus付属のスクリプトaction.php
の絶対URLです。通常次のようになります。
http://example.jp/actions.php
ブログにアイテムを追加する際、「本文」「タイトル」「続き」に4種類の変数を利用することができます:
<%plugin%>以外のこれらのタグはJavaScriptツールバーにある「メディアの追加」ボタンで書き入れられます。
リンク元のURLを挿入します。アクセス方法や、ブラウザ、ファイアウォール等の設定によって、空白の時があります。
なし
全て
<a href="<%referer%>">戻る</a>
アイテムのURL(permanent link)を挿入します。
名前 | 適用 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
個別アイテム
<%itemlink%>
アイテムのタイトルを挿入します。HTMLタグは除去され、エンティティはエンコードされます。
なし
個別アイテム
<%itemtitle%>
アーカイブの日付としてフォーマット済みの日付を挿入します。パラメーターなしで使うと、例えばアーカイブが2008年9月のものなら、'05 september 2008'か'september 2008'のどちらかが挿入されることになります。
名前 | 値 |
---|---|
Locale | 日付がフォーマットされるときに用いられるLocale |
Format | 日付のフォーマット(strftime変数) |
月別アーカイブ
Archive for <%archivedate%> Archive for <%archivedate(dutch)%> Archive for <%archivedate(en,%B %Y)%>
選択中のブログの、タイムスタンプの新しいアイテム群を挿入します。
名前 | 値 |
---|---|
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」を使って、ブログの一覧を「ブログ名」の降順で並べ替えて「ブログ短縮名」で表示します。
指定されたブログの、タイムスタンプの新しいアイテム群を挿入します。
名前 | 値 |
---|---|
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)%>
現在選択されているアイテムを、指定されたテンプレートを用いて挿入します(コメントは挿入されません)。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
個別アイテム
<%item(mytemplate)%>
現在選択されているアイテムについているコメントを、指定されたテンプレートを用いて挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
個別アイテム
<%comments(mytemplate)%>
選択されているブログの選択された月のアーカイブを、指定されたテンプレートを用いて表示。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリー名 |
月別アーカイブ
<%archive(mytemplate)%> <%archive(mytemplate,mycategory)%>
指定されたブログの選択された月のアーカイブを、指定されたテンプレートを用いて表示。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
月別アーカイブ
<%otherarchive(myblog,mytemplate)%> <%otherarchive(myblog,mytemplate,mycategory)%>
現在選択しているブログに存在するアーカイブの月ごとのリストを、指定されたテンプレートを使って挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
limit | 表示するリンク数の制限(例えば、過去3ヶ月分へのリンクしか表示させたくないときなど) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
<%archivelist(mytemplate)%> <%archivelist(mytemplate,mycategory)%>
スキン変数archivelistと同様にアーカイブのリストを挿入しますが、月ごとの代わりに日ごとのアーカイブのリストを挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
limit | 表示するリンク数の制限(例えば、過去3ヶ月分へのリンクしか表示させたくないときなど) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
<%archivedaylist(mytemplate)%> <%archivedaylist(mytemplate,mycategory)%>
スキン変数otherarchivelistと同様に、指定されたブログのアーカイブのリストを挿入しますが、 月ごとの代わりに日ごとのアーカイブを挿入します。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
全て
<%otherarchivedaylist(yourblog,mytemplate)%> <%otherarchivedaylist(yourblog,mytemplate,mycategory)%>
指定されたブログに存在するアーカイブ月ごとのリストを、指定されたテンプレートを用いて表示します。
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
category | 表示するカテゴリーの名前 |
全て
<%otherarchivelist(yourblog,mytemplate)%> <%otherarchivelist(yourblog,mytemplate,mycategory)%>
選択中のブログのカテゴリーリストを、指定されたテンプレートを用いて挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
blogname | 表示するブログの短縮名 |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム
<%categorylist(mytemplate)%> <%categorylist(mytemplate,myweblog)%>
現在選択されているカテゴリーに関する情報を挿入します。カテゴリーが選択されていないときは何も挿入されません。
名前 | 挿入される設定 |
---|---|
name | カテゴリー名(デフォルト) |
desc | カテゴリーの説明L |
id | カテゴリーのID |
全て
<%category%> <%category(id)%> <%category(desc)%> <%category(name)%>
現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
maxresults | 表示する結果の最大数 |
検索
<%searchresults(mytemplate)%>
指定されたブログの、現在の検索文字列に対する検索結果を、指定されたテンプレートを使用して挿入します。
名前 | 値 |
---|---|
blogname | ブログの短縮名 |
template | 使用するテンプレート名 |
名前 | 値 |
---|---|
maxresults | 表示する結果の最大数 |
検索
<%othersearchresults(myblog,mytemplate)%>
グローバル設定の既定の言語で設定した言語に基づいたキャラクターセットのコードを挿入します。日本語版では、'UTF-8'か、'EUC-JP'の何れかになります
なし
全て
<meta http-equiv="Content-Type" content="text/html; charset=<%charset%>" />
そのブログにおける一つ新しいアイテムのタイトルを挿入します。
なし
個別アイテム
<%nextitemtitle%>
そのブログにおける一つ古いアイテムのタイトルを挿入します。
なし
個別アイテム
<%previtemtitle%>
表示中のアーカイブの形式に応じて、一つ古いアーカイブの月、または日を挿入します。
表示中の形式 | 挿入される日付のフォーマット |
---|---|
日単位で表示している時 | YYYY-MM-DD |
月単位で表示している時 | YYYY-MM |
なし
月別アーカイブ
<a href="index.php?archive=<%prevarchive%>">....
表示中のアーカイブの形式に応じて、一つ新しいアーカイブの月、または日を挿入します。
表示中の形式 | 挿入される日付のフォーマット |
---|---|
日単位で表示している時 | YYYY-MM-DD |
月単位で表示している時 | YYYY-MM |
なし
月別アーカイブ
<a href="index.php?archive=<%nextarchive%>">....
選択中のブログ、あるいはカテゴリーのトップページのURLを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
全て
<%todaylink%>
選択中のブログ、あるいはカテゴリーのアーカイブへのリンクを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
全て
<%archivelink%>
アイテムページでは一つ新しいアイテムへの、アーカイブページでは一つ新しいアーカイブへのURLを挿入します。「検索ページ」と「メインの目次ページ」でも使えます。「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
amount | 「検索ページ」と「メインの目次ページ」で使用したときに、前または次のページに進んだときに表示されるアイテムの数 |
個別アイテム、月別アーカイブ、検索、メインの目次
<%nextlink%>
アイテムページでは一つ古いアイテムへの、アーカイブページでは一つ古いアーカイブへのURLを挿入します。「検索」と「メインの目次」でも使えます。「検索ページ」と「メインの目次ページ」で使用したときは、「次のページ」へのURLを挿入します。
名前 | 値 |
---|---|
linktext | 記述されていると、URLの代わりに<a href... タグによるリンクが挿入されます。 |
amount | 「検索ページ」と「メインの目次ページ」で使用したときに、前または次のページに進んだときに表示されるアイテムの数 |
個別アイテム、月別アーカイブ、検索、メインの目次
<%prevlink%>
エラーが発生したときにエラーメッセージを挿入します。
なし
エラー
<%errormessage%>
選択された画像を挿入します(画像ポップアップ用)。
名前 | 値 |
---|---|
imgtag(デフォルト) | (x)htmlのimgタグ <img ... /> |
url | 画像ファイルへのURL |
width | イメージの幅 |
height | イメージの高さ |
caption | 画像の見出し(画像と共に表示されるテキスト) |
画像ポップアップウィンドウ
<%image%>
「グローバル設定」でのサイトの設定を挿入します。
名前 | 挿入される設定 |
---|---|
url | サイトのURL |
name | サイトの名前 |
admin | 管理者のメールアドレス |
全て
<%sitevar(name)%> <%sitevar(url)%> <a href="mailto:<%sitevar(email)%>">管理人</a>
選択中のブログの設定を挿入します。
名前 | 挿入される設定 |
---|---|
id | ブログのID |
url | ブログのURL |
name | ブログの名前 |
desc | ブログの説明 |
short | ブログの短縮名 |
メインの目次、月別アーカイブ、月別アーカイブ一覧、検索、個別アイテム、メンバー詳細
<%blogsetting(name)%> <%blogsetting(id)%> <%blogsetting(desc)%> <a href="<%blogsetting(url)%>">...</a>
訪問者がログイン中のメンバーの場合、そのメンバーに関する情報を挿入します。メンバーの詳細ページにおいては、指定されたメンバーについての同じ情報を表示する追加オプションがあります。
訪問者がログイン中のメンバーではない場合は、your...のパラメーターは何も挿入しません。
名前 | 挿入される設定 |
---|---|
yourname | 訪問メンバーの表示される名前(ログインに使うもの) |
yourrealname | 訪問メンバーの本名 |
yournotes | 訪問メンバーが自身のために設定できるその他の情報(備考欄) |
yoururl | 訪問メンバーのウェブサイトURL |
youremail | 訪問メンバーのメールアドレス |
yourid | 訪問メンバーのID |
名前 | 挿入される設定 |
---|---|
name | 指定されたメンバーの表示される名前(ログインに使うもの) |
realname | 指定されたメンバーの本名 |
notes | 指定されたメンバーが自身のために設定できるその他の情報(備考欄) |
url | 指定されたメンバーのウェブサイトURL |
指定されたメンバーのメールアドレス | |
id | 指定されたメンバーのID |
全て
<%if(loggedin)%>
こんにちは<%member(yourrealname)%>さん
<%endif%>
指定されたテンプレートを用いて、ページ内にアイテムのプレビューを挿入します。(additemformと一緒に使われることが多いようです)
名前 | 値 |
---|---|
template | 使用するテンプレート名 |
メインの目次
<%preview(mytemplate)%>
現在選択しているブログへのアイテムの追加フォームを挿入します。多くの場合、previewと共に使用されます。
なし
メインの目次
<%additemform%>
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)%>
Webページ出力時に、指定されたPHPファイルを実行し、その結果を挿入します。ファイルの中身はPHPとして解釈され、実行されるので注意が必要です。また、Nucleusのスキン/テンプレート変数は展開されません。同じような変数に、取り込み時にスキン/テンプレート変数を展開するparsedincludeや、ファイルの中身をそのまま表示するincludeがあります。
名前 | 値 |
---|---|
filename | 取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもかまいません。) |
IncludeMode
とIncludePrefix
に影響を受けます。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;
'をきっちりとコードに加える必要があります。
Webページ出力時に、指定されたファイルを取り込んで挿入します。このファイルのは、取り込み時にNucleusのスキン/テンプレートによる構文解析にかけられるので、スキン/テンプレート変数が使用できます。同じような変数に、取り込んだファイルのPHPを実行するphpincludeや、ファイルの中身をそのまま表示するincludeがあります。
名前 | 値 |
---|---|
filename | 取り込むファイルの名前(index.phpからの相対位置でも絶対位置でもかまいません。URLを指定することもできます) |
IncludeMode
とIncludePrefix
に影響を受けます。<%parsedinclude (filename)%>
を呼び出すことができますが、無限ループを避けるために最大で3段階までとなります。全て
<%parsedinclude(filename.txt)%> <%parsedinclude(/home/user/myself/filename.txt)%>
プラグインを呼び出します。
名前 | 値 |
---|---|
PluginName | 呼び出されるプラグインの名前。大文字小文字が区別されるので注意が必要です。 |
この他、プラグインごとに引数が定義・追加されます。
<%PluginName (parameters)%>
と記述することで、プラグインを直接呼び出すこともできます。現在はそのようにプラグイン名で呼び出す方法が主流ですが、プラグイン呼び出しであることをあえて明示したい場合は<%plugin(parameters)%>
のほうを利用するといいでしょう。全て
<%plugin(Calendar)%> <%plugin(LastComments,myweblog)%> <%LastComments(myweblog)%>
ログインフォームまたは、ログイン中メッセージ("ログイン中:ketsunet (ログアウト)")を挿入します
なし
全て
<%loginform%>
アイテムページにコメントフォームを挿入します。
名前 | 値 |
---|---|
destinationurl | コメント追加後にリダイレクトさせるURL(デフォルトでは、投稿したアイテムの「個別アイテムページ」にリダイレクトされます) |
個別アイテム
<%commentform%> <%commentform(http://example.jp/thanks.html)%>
パーサーのプロパティを設定します。
名前 | 値 |
---|---|
property | プロパティの名前 |
value | プロパティの値 |
全て
<%set(IncludeMode,skindir)%> <%set(IncludePrefix,somedir/)%>
表示に使用中のスキンのあるディレクトリにリンクを張る時に使用します。パーサーのプロパティIncludePrefix
と共に使用することで、最良の結果を得ることができます。
名前 | 値 |
---|---|
filename | ファイルの名前(「http://~」から始まるURLに変換されます) |
全て
<%skinfile(mystyle.css)%>
決まった条件を満たしているときにのみ、コンテンツ・ブロックを挿入。
スキン変数if/ifnot/elseif/elseifnot
に対してのみ、引数が必須になります
名前 | 値 | ||
---|---|---|---|
type | 条件の種類 | ||
typeによって、以下のオプションをとることがあります | |||
name | 条件の名前 | ||
value | 条件の名前の値 |
全て
<%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%>
メンバー詳細のページで、表示されているメンバーに対して、他のログインしているメンバーがメッセージを送ることのできるフォームを挿入します。
名前 | 値 |
---|---|
rows | ボックスの横列の数値(デフォルトは10) |
cols | ボックスの縦列の数値(デフォルトは40) |
destination url | メッセージを送信した後リダイレクトされるURL |
メンバー詳細
<%membermailform%>
現在のブログに対する検索フォームを挿入します。
名前 | 値 |
---|---|
blogname | 検索を実行するブログの短縮名(ブログの短縮名を指定していても、常に検索対象に含めるの設定が「はい」のブログは検索対象になります) |
メインの目次、月別アーカイブ、月別アーカイブ一覧、個別アイテム
<%searchform%> <%searchform(otherweblog)%>
本家Nucleusウェブサイト(英語)へのリンクが付いたボタン、あるいはバナーを挿入します。
名前 | 値 |
---|---|
imgurl | 画像のURL(デフォルトのものを使わない場合) |
imgwidth | 画像の横幅(ピクセル単位) |
imgheight | 画像の高さ(ピクセル単位) |
IncludeMode
とIncludePrefix
に影響を受けます。全て
<%nucleusbutton%> <%nucleusbutton(nucleus/nucleus.gif,46,43)%>
現在表示しているページのファイル名を挿入します(index.php等で記述した「$CONF['Self']」の値です)。
なし
全て
<%self%>
表示中のブログにアイテムを追加するためのブックマークレットのURLを出力します
なし
全て
<dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>
アイテムを追加するブックマークレットをポップアップさせるためのJavascriptコードを出力します
なし
全て
<dd><a href="<%addlink%>" onclick="<%addpopupcode%>" title="ブログにアイテムを追加する">アイテムを投稿する</a></dd>
テンプレート変数はスキン変数と同じ方法で広く働きますが、テンプレート内部で利用できる点でスキン変数と区別されます。変数は <%変数名%>
という形で呼び出され、変数の機能によってはテキストを挿入します。また、その他のオプションパラメーターを持つ変数もあります。
テンプレート変数は、「アイテムのヘッダー」、「アイテムの本体」、「アイテムのフッター」、「日付ヘッダー」、「日付フッター」、「続きへのリンク」、「アイテムリンクの編集」
といった、テンプレート・パーツの中で使用できます。(変数image
、 popup
、media
、 plugin
はブログアイテムの中でも使用できます。)
コメント関連のテンプレート・パーツ(「コメントのヘッダー」、「コメントの本体」、「コメントのフッター」、「コメントが1 つの時」、「コメントが2つ以上の時」、「コメントの続きを読む」、「コメントが無い時」、「長すぎるコメントの時」
)では、利用可能な変数のセットが異なります:
これらの変数はすべて、そのときパースされているアイテムに関わる値になります。
名前 | 説明 |
---|---|
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 |
名前 | 説明 |
---|---|
authorid | 現在のアイテムの投稿者のID |
blogid | アイテムが所属するブログのID |
catid | アイテムが所属するカテゴリーのID |
query | 存在していれば、検索文字列 |
syndicate_title | RSSなどの配信用に、指定文字数以上を省略したアイテムのタイトル |
syndicate_description | RSSなどの配信用に、指定文字数以上を省略した「本文」テキスト |
karmaposlink | 投票用のURL |
karmaneglink | 投票用のURL |
new | 前回訪問時意向に追加されたアイテムを示すテキストなど |
include | 指定されたファイルの内容をそのまま挿入 |
parsedinclude | 指定されたファイル内のスキン/テンプレート変数を展開して、その結果を挿入 |
phpinclude | 指定されたファイルをPHPとして実行した結果を挿入 |
plugin | プラグインを実行 |
edit | テンプレート「アイテムを編集するためのリンク」の内容を挿入 |
editlink | アイテム編集画面(bookmarklet)のURL |
editpopupcode | editlink用のウィンドウをポップアップするjavascriptコード |
skinfile | 使用中のスキンのあるディレクトリに存在するファイルへのを使う時に使用 |
set | パーサーのプロパティを設定 |
image | メディア書庫へのインライン画像 |
popup | メディア・ディレクトリの画像をポップアップ |
media | メディア・ディレクトリからの他のメディア・オブジェクト |
relevance | 検索結果を表示するテンプレートに'search hit relevance'をインクルードする(2.5より) |
名前 | 説明 |
---|---|
body | コメントの本体 |
user | コメント者の名前 |
userid | コメント者のWebサイトのURL、もしくはコメント者のメールアドレス(入力されたままのものが挿入されます) |
コメント者のメールアドレス(スパム対策として、"@"は"(at)"に、".(ピリオド)"は"(dot)"に変換されます) | |
userlink | コメント者がログイン中の登録メンバーの時はメンバー詳細ページに、それ以外の時は入力されたWebサイトのURL、もしくはメールアドレスに対する<a href="...">タグ付きのリンク(有効なURLかメールアドレスが入力されていない場合は、コメント者の名前のみが表示されます) |
userlinkraw | userlinkと同じ。ただし、aタグの付いたリンクではなくURL、もしくはmailto:メールアドレスのみの表記。(入力されたURLやメールアドレスがいずれも文法的に有効でない場合は空になります) |
useremail | ユーザーのメールアドレス。もしコメント者によって入力されていない場合は空 |
userwebsite | ユーザーのwebsiteの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 | コメントが追加された時のタイムスタンプ |
include | 指定されたファイルの内容をそのまま挿入 |
parsedinclude | 指定されたファイル内のスキン/テンプレート変数を展開して、その結果を挿入 |
phpinclude | 指定されたファイルをPHPとして実行した結果を挿入 |
plugin | プラグインを実行 |
skinfile | 使用中のスキンのあるディレクトリに存在するファイルへのを使う時に使用 |
set | パーサーのプロパティを設定 |
カルマ投票のデータを挿入します。カルマ投票は、アイテムの'カルマ'を投票する方法で、正にでも負にでも投票できます。これら投票の総計によって、該当記事が訪問者にどのように思われているのか知ることができます。
名前 | 挿入される情報の種類 |
---|---|
totalscore | カルマ投票の総合得点(正の投票数から負の投票数を引いたもの/デフォルト) |
pos | 正の投票の総計 |
neg | 負の投票の総計 |
votes | 投票数の総計 |
posp | 正に投じられたパーセンテージ |
negp | 負に投じられたパーセンテージ |
<%karma(posp)%>がよい記事だと評価しました(総計<%votes%>票)
コメント関連テンプレート変数で、元記事のタイトルを挿入します。
名前 | 値 |
---|---|
maxlength | maxlengthで指定された数値で、アイテムのタイトル省略。 |
投稿者のデータを挿入します。
名前 | 挿入される情報の種類 |
---|---|
name | 投稿者の「表示される名前」(ログインに使うもの) |
realname | 投稿者の「本名」 |
id | 投稿者のメンバーID |
url | 投稿者のウェブサイトのURL |
投稿者の登録メールアドレス(使うのは避けるべき) |
<%author%>
<%author(realname)%>
<a href="<%author(url)%>"><%author%></a>
現在のアイテムを調べてから、「本文」と「続き」のどちらを表示するか決定します。
「続き」に何かが入力されていれば「続き」が、何も入力されていなければ「本文」が挿入されます。
部分名 | 何か入力されている? | |
---|---|---|
本文 | 入力あり | 入力あり |
続き | 入力なし | 入力あり |
smartbodyで挿入される部分 | 「本文」部分 | 「続き」部分 |
「本文」に詳しい内容を入力し、「続き」には"紹介"、"抜粋"といった内容のものを入力し、「メインの目次ページ」で使用するテンプレートには<%smartbody%>
を使い、抜粋が存在するときにはそれを、無い時は「本文」を使用するような使い方をします
この時、「個別アイテムページ」で使うテンプレートには、 <%body%>
+ <%more%>
のかわりに<%body% >
だけを記述するようにすると、より効果的に使えるでしょう
テンプレート続きへのリンクで定義されているリンクを挿入します。「続き」に何も入力されていない時は無視されます。
テンプレート部品'続きへのリンク'の中身もまたパースされるので、同様にテンプレート変数を含むことができることに注意してください(例:続きへのリンクに<%morelink%>を記述することは可能ですが、無限ループを起こします)。
なし
日付フォーマットで設定した書式で日付を挿入します。オプションの引数に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)%>
時刻フォーマットで設定した書式で時刻を挿入します。オプションの引数にstrftime変数を使用して、フォーマットを変更することもできます。
名前 | 値 |
---|---|
format | 時刻のフォーマットに用いる形式 |
<%time%> <%time(%X)%>
コメントブロックを挿入します。このブロックの詳しい説明。
名前 | 値 |
---|---|
MaxToShow | 表示するコメントの数(設定されていれば、Blog設定にあるコメントの最大量を上書きします) |
<%comments%> <%comments(5)%>
HTMLタグを取り除き、指定された長さにまで縮めたアイテムのタイトルを挿入します(指定が無い時は100)。省略された場合、末尾に"..."が追加されます。
この変数はRSS等のために使うことが意図されていましたが、他にも便利な使い方があるでしょう。
名前 | 値 |
---|---|
MaxChars | 省略せずに残す最大の幅(デフォルトは100) |
<%syndicate_title%> <%syndicate_title(25)%>
HTMLタグを取り除き、指定された幅にまで縮めたアイテムのタイトルを挿入します(指定が無い時は250)。テキストが縮められた場合は、末尾に"..."が追加される。
この変数はRSSのために使うことが意図されていましたが、他にも便利な使い方があるでしょう。
名前 | 値 |
---|---|
MaxChars | 省略せずに残す最大の幅(デフォルトは250) |
<%syndicate_description%> <%syndicate_description(25)%>
アイテム本体やテンプレートにインライン画像を挿入します。
通常テンプレート変数<%image%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。
名前 | 値 |
---|---|
filename | 画像ファイルの名前 |
width | 画像の横幅(ピクセルかパーセンテージ) |
height | 画像の高さ(ピクセルかパーセンテージ) |
text | 画像の代用テキスト |
<%image(myphoto.jpg|100|200|これが私です)%> <%image(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>
アイテム本体やテンプレートにポップアップ画像を挿入します。
通常テンプレート変数<%popup%>はアイテムに画像を挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。
名前 | 値 |
---|---|
filename | 画像ファイルの名前 |
width | 画像の横幅(ピクセルかパーセンテージ) |
height | 画像の高さ(ピクセルかパーセンテージ) |
text | 画像の代用テキスト |
<%popup(myphoto.jpg|100|200|これが私です)%> <%popup(myphoto.jpg|50%|50%|縮小していますが、これが私です)%>
アイテム本体やテンプレートにメディアオブジェクトを挿入します。
通常テンプレート変数<%media%>はアイテムにメディアファイルを挿入するときに自動的に生成されますが、テンプレート内部で直接呼び出すこともできます。その場合は、メディア・ディレクトリにある、現在のアイテムの投稿者のプライベート・コレクションから画像が持って来られるので注意が必要です。
名前 | 値 |
---|---|
filename | オブジェクトファイルの名前 |
text | オブジェクトの説明テキスト |
<%media(mysong.mp3|新曲を聞いてみてください)%>
テンプレート:アイテムを編集するためのリンクの内容を挿入します。
注意:ログイン状態のメンバーが、閲覧中のアイテムの編集を許可されている時のみ、この変数が働きます。それ以外の場合は、テンプレート変数<%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> -
Nucleusでは機能を追加するために、プラグインをインストールすることができます。プラグインは次のリストの様に働き、Nucleus本体だけでは実現できな様々な機能を提供してくれるでしょう。
action.php
を通して呼び出されたときにアクタのように振舞うプラグインに対する責任は、完全にプラグインの作者にあることをお忘れなく。プラグイン作者は、プラグインが問題なく動くように作らなければなりません。
利用可能なパーサーオプションを以下に記述します。
オプション名 | 値 | |
---|---|---|
Includeモード | normal | 通常の動作。ページを作成する「.php」ファイルのディレクトリ/URLから相対位置のファイルを取り出しインクルードします。 |
skindir | スキンディレクトリ/スキンURLから相対位置のファイルを取り出しインクルードします。 | |
影響を与えるスキン変数 | ||
Includeプリフィックス | このプロパティはインクルードするファイルそれぞれの頭に追加されるプリフィックスです。例えば、プリフィックスが このプロパティはIncludeModeのプロパティと共に使われることが意図されています。この方法で、 |
|
影響を与えるスキン変数 |
Includeプリフィックス
とIncludeモード
のプロパティは、「スキンの一般的設定」において該当スキンでの包括的な設定が可能です。なお、プロパティが設定されてしまうと、例えばテンプレートも含めたすべてのパースデータにそれが適用されることを心にとめておいてください。