コンテンツ作成のヒント
入力書式:- Filtered HTML:
- ウェブページアドレスとメールアドレスは、自動的にハイパーリンクに変換されます。
使用できるHTMLタグ: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>
このサイトではHTMLで書かれたコンテンツの投稿を許可しています。 HTMLのすべてを習得するのは気が引けるかもしれませんが、ごく少数の基本的なHTML「タグ」の使い方を習得するのはとても簡単です。 以下の表では、このサイトで利用できるタグを、一例を挙げて説明しています。
より詳細な情報は、W3CのHTML Specifications(英文)や、W3C 仕様書等の日本語訳集を参照するか、好みの検索エンジンからHTMLについて解説しているサイトを探し、それらを参考にしてください。
タグの説明 記述例 表示例 アンカーは他ページへのリンク作成に使用します。 <a href="http://diefstlun.com">Diefstlun</a>Diefstlun 強調 <em>強調</em>強調 強調 <strong>強調</strong>強調 引用 <cite>引用</cite>引用 テキストをプログラムのソースコードとして明示するために使われます。 <code>コード</code>コード順序無しリスト - 各リスト項目を <li></li> で囲み、全体を <ul></ul> で囲みます。 <ul> <li>1番目の項目</li> <li>2番目の項目</li> </ul>- 1番目の項目
- 2番目の項目
順序付きリスト - 各リスト項目を <li></li> で囲み、全体を <ol></ol> で囲みます。 <ol> <li>1番目の項目</li> <li>2番目の項目</li> </ol>- 1番目の項目
- 2番目の項目
定義リストは他の HTML リストと似ています。 定義用語を <dt></dt> 、その用語の説明を<dd></dd> で囲み、全体を <dl></dl> で囲みます。 <dl> <dt>1番目の用語</dt> <dd>1番目の定義</dd> <dt>2番目の用語</dt> <dd>2番目の定義</dd> </dl>- 1番目の用語
- 1番目の定義
- 2番目の用語
- 2番目の定義
ほとんどの特殊記号は、特に問題なく直接入力することができます。
問題が生じた場合は、HTMLのエンティティ表記を使用してみてください。 例えば、& と入力した場合はアンド記号の「&」のように表示されます。 エンティティの全リストは、HTMLのエンティティページを参照してください。
エンティティ表記の一例:
文字の説明 記述例 表示例 アンパサンド(&) && 大なり記号(>) >> 小なり記号(<) << 引用符(") "" - 行と段落は自動的に認識され、<br />(改行タグ)や <p> </p>(段落の開始・終了タグ)が自動的に挿入されます。 もし段落が認識されない場合は、空行を2つ加えてください。
- aaa:
カスタムPHPコードの使い方
カスタムPHPコードは、投稿やブロックを含む任意のタイプのサイトコンテンツに埋め込むことができます。 PHPの経験を持った信頼できるユーザが適切に使用する場合は、 投稿やブロックにPHPコードを埋め込めるのは強力かつ柔軟な機能ですが、不適切に使用された場合は深刻な安全を脅かす事態をもたらします。 また、投稿されるPHPコードに少しでもミスがあれば、誤ってサイトを危うくする可能性があります。
PHP、SQL、Drupalに精通していない場合は、投稿にカスタムPHPコードを使うことを避けてください。 PHPの安易な使用はデータベースを破損させ、サイトを操作不能にし、著しく安全性を損なう可能性がありますので絶対に避けてください。
注意:
- 保存する前に各行の文法・論理エラーを忘れずに再確認してください。
- 命令文はセミコロンで正しく終える必要があります。
- PHPコード内で使用されたグローバル変数は、スクリプトの実行後もその値を保持します。
register_globalsはoffです。 フォームを使用したい場合は、Drupal Form APIの関数を理解し、それを使用してください。- コンテンツを出力するには、コード中で
printかreturn命令を使用してください。 - 稼働中サイトで使用する前に、個別のテストスクリプトとサンプルデータベースを使用し、PHPコードの開発とテストを十分に行ってください。
- 投稿やブロックに直接埋め込むのではなく、サイト特有のモジュールや
template.phpにカスタムPHPコードを含めることを検討してください。 - PHPコードをコンテンツ内に埋め込める能力は、PHPフィルタモジュールによって提供されていることを認識してください。 このモジュールが無効化・削除された場合、投稿やブロックに埋め込まれたPHPコードは実行されず、そのまま表示されてしまいます。
基本例: 単純なメッセージで訪問者を迎える「ようこそ」ブロックの作成
「ようこそ」というカスタムブロックをサイトに加え、入力書式を「PHP code」(またはPHPをサポートする別の入力書式)にし、ブロックの本文に以下を加えてください(サンプル中の t() は文字列を翻訳可能にするDrupalの関数です):
print t('Welcome visitor! Thank you for visiting.');登録ユーザの名前を表示するには、代わりに以下を使用します:
global $user; if ($user->uid) { print t('Welcome @name! Thank you for visiting.', array('@name' => $user->name)); } else { print t('Welcome visitor! Thank you for visiting.'); }
Drupal.orgでいくつかのPHPスニペットの実例を提供しています。 また、多少のPHP経験とDrupalシステムの知識があれば、独自のPHPスニペットを作成することができます。