記法
本ユーザガイドではコードの例を示すことが多くありますが、そのほとんどは部分的なものです。また、いくつかのコード例は UNIX 系 OS のシェルにログインしてコマンドラインとして入力する形になっており、そのような例ではシェルのプロンプトとしてドル記号 ($) を併せて記載しています:
cd $MT_DIR && sleep 1 && /usr/bin/perl tools/run-periodic-tasks
都合上、コードが途中で改行されている場合がありますのでご了承ください。
用語
- ウェブサイト/ブログ、ワークスペース/スペース
-
PowerCMS 5 までは「ウェブサイト/ブログ」と表記されていた呼称が、PowerCMS 6 からは「ワークスペース/スペース」に変更されました。詳細については、「呼称の変更」をご覧ください。
なお、この変更につきまして、本ドキュメントでは修正が間に合っておらず、旧呼称が使用されている箇所が存在します。「ウェブサイト/ブログ」は、「ワークスペース/スペース」と読み替えてご利用ください。
- MT_DIR, $MT_DIR, $MT_HOME
- PowerCMS をインストールしたディレクトリのパスを表します。通常はここに mt.cgi や mt-config.cgi などが含まれています。
- アプリケーションディレクトリ
- MT_DIR, $MT_DIR と同義です。
- POWERCMS_FILES_DIR, $POWERCMS_FILES_DIR
- 環境変数 PowerCMSFilesDir で定義される、PowerCMS の動作に必要なファイルを格納しているディレクトリのパスです。環境変数を定義していない場合、PowerCMS をインストールしたディレクトリのパス直下の powercms_files ディレクトリを意味します。
- mt-static
- PowerCMS の動作に必要なファイルのうち、画像やスタイルシートなど、静的なファイルを格納しているディレクトリを意味します。スタティックディレクトリと呼ばれることもあります。
- /path/to/filename.html
- filename.html までのフルパス表記を意味します。
- /path/to/blog
- ワークスペース/スペースの公開パスを意味します。
- 管理画面
- CGIアプリケーションディレクトリ内に設置された mt.cgi ファイルを指します。このファイル名は設定により変更されていることがあります。
- 環境変数○○
-
環境変数はアプリケーションディレクトリ内の mt-config.cgi に記述することで指定します。例えば、「環境変数EnableMTNews 1 を指定してください」と記載があった場合、 mt-config.cgi に
EnableMTNews 1
を記述します。 - スケジュールタスク
-
$MT_DIR/tools/run-periodic-tasks
を cron やタスクスケジューラに登録することで定期的に実行させるタスクを指します。スケジュールタスクの登録については「指定日投稿や公開キュー等のスケジュール処理の設定」のページをご参照ください。 - スタティック、ダイナミック
-
それぞれ静的、動的と表現されることもあります。
あらかじめ再構築により HTML ファイルを書き出しておき、訪問者がブラウザでこれを閲覧する方式をスタティック・パブリッシングと呼びますが、本ドキュメントではこの方式に加え、管理画面やフォームなど、CGI で動作する処理を総称して「スタティック」と表現することがあります。
これに対して、「ダイナミック」とは、おもに DynamicMTML の機能によって、全部もしくはコンテンツの一部を出力することです。ダイナミック・パブリッシングも同義です。
- システムレベル、ワークスペース/スペースレベル
-
PowerCMS の管理画面内における現在の画面の作業スコープを表現する際に使われることがあります。
「システムレベル」では、主にシステム全体に関わる設定を行ったり、PowerCMS 内に存在するワークスペース/スペースを横断してデータの一覧表示をするなどの操作が可能です。同様に、「ワークスペース/スペースレベル」では、現在のワークスペース/スペース単位での操作が可能です。
より理解を深めるため、合わせて「PowerCMS の操作方法」のページをご参照ください。
- ID を指定する
-
「対象のワークスペース/スペースの ID を指定する」、「対象のテンプレートの ID を指定する」のように表現されることがあります。「ID」は、データベース上の主キーでもあります。
「ID」は、例えばワークスペース一覧画面で、表示オプションから「ID」を選択することで、一覧に列として表示することが可能です。
また、アドレスバーに表示される URL から判断することもできます。特定のスペースのダッシュボードに遷移したときの URL が
- https://example.com/mt/mt.cgi?__mode=dashboard&blog_id=99
である場合、このスペースの ID は 99 です。記事編集画面の URL が
- https://example.com/mt/mt.cgi?__mode=view&_type=entry&id=4622&blog_id=32
である場合、この記事の ID は 4622 で、記事が所属するスペースの ID は 32 です。
- オブジェクト
-
「ワークスペース」「記事」「アイテム」といったデータ体系を表す場合と、そのデータ体系の中のひとつのデータ(レコード)を表す場合があります。
前者の場合、データ体系の名称とともに「記事オブジェクト」といった表現であることもあります。後者の場合「ID が○○のオブジェクト」といったように、データを識別する主キーとともに表現されることもあります。
- 次は
- 一覧へ