目 次 4.7 ユーザー 権 限 ユーザー 権 限 について ユーザー 権 限 の 指 定 方 法 詳 細 な 指 定 方 法 ユーザー 全 体 への 権 限 設 定 権 限 の

Transcription

1 目 次 目 次 1. この 資 料 について CMS DESIGNER の 基 本 的 な 仕 組 み 概 要 主 なフォルダ 構 成 作 業 の 流 れ XML と 文 字 コードについて スキーマ 定 義 スキーマとは 何 か スキーマファイルの 作 成 スキーマファイルの 編 集 スキーマファイルの 設 置 スキーマ リファレンス schema タグの 設 定 data タグの 種 類 data タグ - text data タグ - textarea data タグ - int data タグ - menu data タグ - img data タグ - file data タグ - date, time, datetime, year, month data タグ - geolocation data タグ - separator data タグ - list ソート( 並 べ 替 え) 指 定 グループ( 絞 込 み) 指 定 エントリ 見 出 し 項 目 名 の 指 定 エントリ 定 義 エントリ 定 義 とは 何 か エントリ 定 義 手 順 エントリ 保 存 用 フォルダの 作 成 とパーミッションの 設 定 SITE.CONFIG.XML へのエントリ 定 義 の 追 加 区 切 り 表 示 用 のエントリ 定 義 について 画 像 キャッシュの 指 定 [ 最 終 更 新 日 2015/08/28 16:32:00] 1 / 127

2 目 次 4.7 ユーザー 権 限 ユーザー 権 限 について ユーザー 権 限 の 指 定 方 法 詳 細 な 指 定 方 法 ユーザー 全 体 への 権 限 設 定 権 限 の 拒 否 (deny) 許 可 しない(none) と 拒 否 (deny) の 違 い コンテンツ 一 覧 への 表 示 / 非 表 示 権 限 設 定 事 例 集 その 他 の 留 意 事 項 デザイン 定 義 デザイン 定 義 とは 何 か XSLT(XML STYLESHEET LANGUAGE TRANSFORMATIONS)について エントリ1 件 用 のデザイン 定 義 エントリ 一 覧 用 のデザイン 定 義 デザイン リファレンス 指 定 の 箇 所 へデータ 項 目 を 埋 め 込 む 画 像 項 目 (img 項 目 )を 出 力 する 画 像 項 目 (img 項 目 )を 縮 小 / 拡 大 して 表 示 する(サムネイル 等 ) ファイル 項 目 (file 項 目 )を 出 力 する 繰 り 返 し 項 目 (list 項 目 )を 出 力 する データ 値 の 内 容 によって 処 理 を 変 える メニュー 項 目 を 表 示 する エントリ 一 覧 から 個 別 のエントリへリンクを 張 る 次 のエントリへ 前 のエントリ へのリンクをつける 一 覧 表 示 で 次 のページへ 前 のページへ のリンクをつける エントリの 更 新 日 付 や 日 付 項 目 を 表 示 する エントリ ID を 表 示 する グループ 絞 込 み 条 件 を 表 示 する NEW! 表 示 をする 現 在 日 時 を 取 得 する エントリ 作 成 者 名 を 表 示 する メニュー 項 目 の 選 択 肢 リストを 表 示 する ウェブサイトへの 埋 め 込 み デザイン 定 義 と HTML 画 面 の 関 係 埋 め 込 み 先 の 画 面 の 作 成 埋 め 込 み 命 令 タグ [ 最 終 更 新 日 2015/08/28 16:32:00] 2 / 127

3 目 次 埋 め 込 み 命 令 タグ 一 覧 エントリ1 件 分 の 埋 め 込 み- cmsd:entry 命 令 タグ(1) エントリ 一 件 分 の 埋 め 込 み(ナビゲーション 付 き) - cmsd:entry 命 令 タグ(2) エントリ 一 覧 の 埋 め 込 み - cmsd:entrylist 命 令 タグ 絞 込 みの 指 定 ( 固 定 ) URL パラメータからの 動 的 な 絞 込 みの 指 定 text/textarea 項 目 のタグ 除 去 RSS の 出 力 XML 形 式 での 出 力 (Flash や Ajax との 連 携 ) 実 行 時 ソート エントリ 一 覧 のテーブル 表 示 機 能 エントリ 項 目 の 直 接 出 力 一 覧 - 詳 細 連 動 機 能 フリーワード 検 索 機 能 ( 複 数 キーワードによる AND 検 索 ) デザインパラメータ 埋 め 込 み 命 令 ( 旧 コマンド) cmsview::entry 命 令 - エントリ1 件 分 の 埋 め 込 み cmsview::navi_entry 命 令 - エントリ 一 件 分 の 埋 め 込 み(ナビゲーション 付 き) cmsview::listtop 命 令 - エントリ 一 覧 の 埋 め 込 み cmsview::listpage 命 令 - エントリ 一 覧 の 埋 め 込 み(ナビゲーション 付 き) 絞 込 みの 指 定 URL パラメータからの 絞 込 みの 指 定 cmsview::rss 命 令 - RSS の 出 力 cmsview::xml_entry 命 令 - エントリ1 件 分 の XML 出 力 cmsview::xml_navi_entry 命 令 - エントリ 一 件 分 の XML 出 力 (ナビゲーション 付 き) cmsview::xml_listtop 命 令 - エントリ 一 覧 の XML の 出 力 cmsview::listpage 命 令 - エントリ 一 覧 の XML の 出 力 (ナビゲーション 付 き) その 他 出 力 文 字 コードの 変 換 出 力 文 字 コードの 変 換 機 能 を 使 う 際 の 注 意 事 項 ( 必 ずお 読 み 下 さい) サイト 全 体 の 出 力 文 字 コードを 指 定 する ページ 個 別 の 出 力 文 字 コードを 指 定 する XSLT の 文 字 コード 変 換 を 利 用 する XSLT ライブラリが 原 因 のトラブル 対 処 方 法 ページキャッシュによるページ 表 示 のパフォーマンス 改 善 ページキャッシュ 機 能 について [ 最 終 更 新 日 2015/08/28 16:32:00] 3 / 127

4 目 次 ページキャッシュの 利 用 方 法 全 てのページのページキャッシュをまとめて 有 効 にする ページキャッシュの 日 次 更 新 注 意 事 項 HTML エディタの 利 用 (WYSIWYG エディタ) メニュー 項 目 の 選 択 肢 として 他 のエントリ 一 覧 ( 外 部 データソース)を 読 み 込 む 設 定 手 順 メニュー 項 目 に 外 部 データソースを 使 用 した 場 合 のデザイン 定 義 外 部 データソースとしてエントリ 定 義 (site.config.xml)を 利 用 する 資 料 デザイン 定 義 (XSL ファイル)へ 渡 されるエントリデータの XML [ 最 終 更 新 日 2015/08/28 16:32:00] 4 / 127

5 1. この 資 料 について 1 この 資 料 について 1.この 資 料 について この 資 料 は CMS Designer の 詳 しい 利 用 方 法 を 解 説 しています CMS Designer そのものについての 詳 細 は Web サイトをご 覧 下 さい また はじめての 方 はこの 資 料 を 読 む 前 に CMS Designer チュートリアル1 をお 読 みになることをお 勧 めします 用 語 について 当 資 料 中 では CMS Designer を 使 ってサイトを 設 計 / 構 築 する 人 を 総 称 して ウェブデザイナー 又 は 単 に デザイナー と 呼 んでいます これは 当 ツールが デザイナー 自 らがプログラマーや SE の 力 を 借 りることなしに 独 力 で 更 新 可 能 なウェブサイト を 構 築 することを 目 的 として 作 られている 為 です ですから もし 本 来 の 意 味 でのウェブデザイナーではない 例 えばプログラマーなどがこのツール を 使 う 場 合 は 文 中 に この 作 業 はデザイナーが 行 います と 書 いてあったとしても それはサイトを 構 築 するあなたの 事 を 常 に 指 しています デザイナー 以 外 に 登 場 する 役 割 としては サイト 管 理 者 があります サイト 管 理 者 は 完 成 した ウェブサイトを 実 際 に 更 新 していく 人 のことを 指 します 通 常 は ウェブサイト 納 入 先 の 企 業 の 担 当 者 などがそれに 該 当 します [ 最 終 更 新 日 2015/08/28 16:32:00] 5 / 127

6 2. CMS Designer の 基 本 的 な 仕 組 み 2 CMS Designer の 基 本 的 な 仕 組 み 2.CMS Designer の 基 本 的 な 仕 組 み 2.1 概 要 CMS Designer の 構 成 を 日 記 を 例 にして 図 で 表 します ( diray は インストールフォルダには 含 まれていません あくまで 説 明 用 の 例 です ) スキーマ: 日 記 diary title body 生 成 エントリ: 育 児 日 記 <title> 件 名 1</title> <body> <title> <title> 本 件 名 1</title> <body> 本 件 文 文 名 です </body> です </body> 1</title> <body> 本 文 です </body> 日 記 ページ(HTML) デ ザイ ン 対 象 デザイン(XSL): 日 記 用 A title 表 示 内 容 ( デー タ ) ヘッダー ナビゲーション 育 児 日 記 エ メニュー body ントリを 日 記 用 A デザイン 使 用 する デザイン で こ こ に 埋 め 込 む フッター (1) エントリ 投 稿 し 蓄 積 していく データ そのもの つまり コンテンツ です 1つの 投 稿 が1つのエントリファイルとして 保 存 されます このファイルはシステムによって 自 動 的 に 生 成 され サイト 管 理 者 やデザイナーが 直 接 編 集 することはありません (2) スキーマ エントリの 型 となる 情 報 です このエントリには " 件 名 "と" 本 文 " そして" 写 真 "と"URL"の 記 入 欄 がある というような 情 報 を 定 義 します HTML の form 定 義 みたいなものです コンテンツ 管 理 画 面 はこのスキーマの 情 報 を 読 み 込 んで 入 力 画 面 を 構 成 します このファイルはデザイナーが 作 成 します (3) デザイン エントリをどのように HTML として 表 示 するかを 指 定 します テンプレートのようなものです 一 覧 表 示 用 単 票 表 示 用 連 票 表 示 用 など 表 示 したい 方 法 やシチュエーションに 合 わせてそ れぞれデザインファイルを 作 成 します デザイナーが 作 成 します [ 最 終 更 新 日 2015/08/28 16:32:00] 6 / 127

7 2. CMS Designer の 基 本 的 な 仕 組 み デザイナーはまずスキーマを 作 成 し 次 にそのスキーマをどのように HTML に 変 換 して 表 示 する かをデザインします 最 後 に そのデザインを 好 きな 画 面 (HTML)に 埋 め 込 んで 表 示 します 作 成 作 成 スキーマ デザイン Web デザイナ 読 込 コンテンツ 管 理 エントリ HTML 表 示 入 力 生 成 表 示 サイト 管 理 者 訪 問 者 図 :CMS Designer とその 関 係 者 [ 最 終 更 新 日 2015/08/28 16:32:00] 7 / 127

8 2. CMS Designer の 基 本 的 な 仕 組 み 2.2 主 なフォルダ 構 成 CMS Designer の 主 なフォルダ 構 成 は 以 下 の 通 りです デザイナーが 意 識 する 必 要 のある 箇 所 は 太 字 の 部 分 です /cmsdesigner システムを 格 納 するフォルダです /config site.config.xml エントリ 定 義 をや 全 体 的 な 設 定 ここに 記 述 します デザイナーが 直 接 編 集 します users.config.xml ユーザー 名 やパスワード( 暗 号 化 )がここに 設 定 されます システムが 直 接 更 新 します /schema スキーマ 毎 にフォルダを 作 成 して その 中 にスキーマ 定 義 とデザイン 定 義 を 格 納 します /diary( 例 ) このように スキーマ 毎 にフォルダを 作 成 します デザイナーが 作 成 します diary.schema.xml スキーマ 定 義 ファイルです デザイナーが 作 成 します diary.default.design.xsl エントリ1 件 表 示 用 のデザインファイル( 標 準 用 )です デザイナーが 作 成 します diary.list.default.design.xsl エントリ 一 覧 表 示 用 のデザインファイル( 標 準 用 )です デザイナーが 作 成 します /data /entry エントリ 毎 にフォルダを 作 成 して その 中 にエントリデータを 格 納 します /baby_diary( 例 ) このように エントリ 毎 にフォルダを 作 成 します デザイナーが 作 成 します フォルダだけ 作 れば あとはシステムが 自 動 的 にここへエントリデータを 追 加 していきま す /include 特 にデザイナーが 意 識 することはありません システムの 本 体 部 分 です [ 最 終 更 新 日 2015/08/28 16:32:00] 8 / 127

9 2. CMS Designer の 基 本 的 な 仕 組 み 2.3 作 業 の 流 れ CMS Designer を 使 ったサイト 構 築 作 業 は 大 まかに 以 下 の 流 れで 進 みます 最 初 に 更 新 させる 内 容 を 決 めて(スキーマ 定 義 エントリ 定 義 ) その 内 容 をどのように 表 示 す るかを 決 めて(デザイン 定 義 ) それをどこに 表 示 するかを 決 める( 埋 め 込 み) という 流 れになりま す スキーマの 定 義 更 新 項 目 ( 入 力 項 目 )を 定 義 する 作 業 です XML 形 式 のスキーマファイルを 作 成 します エントリの 定 義 たいした 作 業 ではありませんが エントリ 用 のフォルダを 作 成 し site.config.xml にエントリフォルダ 名 を 追 加 する 作 業 です デザインの 定 義 小 さなテンプレートを 作 っていく 作 業 になります 1 件 用 のデザイン 一 覧 用 のデ ザインなど 1つのスキーマに 対 して 複 数 のデザイン 定 義 を 行 うこともあります ウェブサイトへの 埋 め 込 み どのエントリを どのデザインを 使 って 画 面 上 のどこに 埋 め 込 むかを 指 定 しま す あなたの HTML ページにたった 2 行 加 えるだけの 作 業 です [ 最 終 更 新 日 2015/08/28 16:32:00] 9 / 127

10 2. CMS Designer の 基 本 的 な 仕 組 み 2.4 XML と 文 字 コードについて CMS Designer で 扱 う 各 ファイルのうち 拡 張 子 が xml 又 は xsl となっているファイルは 全 て XML 形 式 のデータです XML 形 式 のファイルは 文 字 コードを UTF-8 で 保 存 する 必 要 があります XML 形 式 や UTF-8 文 字 コードについて 詳 しくない 方 は 以 下 の 注 意 事 項 をお 読 みください コラム:XML って 何? XML について 分 からない 方 はご 心 配 なく HTML と 書 き 方 はほとんど 同 じです <name> 名 前 </name> のように <タグ 名 >データ</タグ 名 >の 形 式 になっているテキストデータのことです 理 解 しておく 必 要 がある HTML との 違 いは 次 の2 点 だけです 1 閉 じタグが 無 いタグの 場 合 について HTML の IMG タグ( 例 :<img src="xxx.jpg">)のように 閉 じタグが 無 い タグは <img src="xxx.jpg" /> のように 書 かなければいけません > の 前 に / をつけます <br>も <br />になります もちろん 閉 じタグとセットにして <br></br> と 書 けば OK ですが ちょっと 冗 長 な 書 き 方 ですね <br />だけの 方 がシンプルです 2 属 性 は 必 ず""で 囲 う HTML では <form action=post >のように 書 けましたが 属 性 値 は 必 ず""で 囲 って <form action="post">と 書 かなければいけません 気 をつける 必 要 があるのはこれぐらいです まずは とりあえずやってみましょう! [!] 注 意 :UTF-8 について CMS Designer では スキーマファイルやデザインファイルなどの XML ファイルは UTF-8 の 文 字 コード( 漢 字 コード)で 保 存 する 必 要 があります UTF-8 でファイルを 保 存 するには Windows 標 準 添 付 の メモ 帳 でファイルを 保 存 する 際 に 文 字 コード から UTF-8 を 選 んで 保 存 すれば OK です UTF-8 が 扱 えるエディタとしては Windows 上 では 秀 丸 エディタ などが 有 名 です [ 最 終 更 新 日 2015/08/28 16:32:00] 10 / 127

11 3. スキーマ 定 義 3 スキーマ 定 義 3.スキーマ 定 義 3.1 スキーマとは 何 か スキーマは エントリの 型 となる 情 報 です スキーマを 定 義 する 作 業 は HTML の form タグを 作 るのに 似 ています form タグは input というタ グを 使 って 入 力 項 目 を 定 義 します フォームから 送 信 されたデータは メールやサーバなどに 送 ら れます これと 同 様 にスキーマは 入 力 項 目 を 定 義 し CMS Designer がそれを HTML フォームとして 表 示 し ます フォームから 送 信 されたデータは エントリデータとしてサーバに 保 存 されます スキーマ <?xml version="1.0" encoding="utf-8"?> <schema name="diary" caption=" 日 記 帳 " > <data name="title" type="text" caption=" 件 名 " /> <data name="body" type="textarea" caption=" 本 文 " /> </schema> 対 応 する 日 記 帳 入 力 項 目 件 名 本 文 [ 最 終 更 新 日 2015/08/28 16:32:00] 11 / 127

12 3. スキーマ 定 義 3.2 スキーマファイルの 作 成 まず スキーマ 名 を 決 定 します スキーマ 名 は 半 角 英 数 字 でつけます 日 本 語 や 全 角 文 字 は 使 用 できません 例 えば 日 記 帳 ならば"diary"のようにつけます スキーマファイルには スキーマ 名 +.schema.xml の 形 式 でファイル 名 をつけます 拡 張 子 は"xml"です 例 えばスキーマ 名 が"diary"なら "diary.schema.xml"がスキーマファイル 名 になります 3.3 スキーマファイルの 編 集 スキーマファイルは 以 下 のような 構 成 で 記 述 します <?xml version="1.0" encoding="utf-8"?> <schema name="diary" caption=" 日 記 帳 " > <data name="title" type="text" caption=" 件 名 " /> <data name="body" type="textarea" caption=" 本 文 " /> ヘッダ スキーマ 定 義 項 目 定 義 項 目 定 義 </schema> 文 字 コードは UTF-8 で 保 存 します ヘッダはそのままコピーしてください スキーマ 定 義 部 の 詳 細 はは 3.5 スキーマ リファレンス を 参 照 してください 3.4 スキーマファイルの 設 置 スキーマファイルをサーバに 設 置 する 為 に 以 下 の 作 業 を 行 います 1 /cmsdesigner/config/schema フォルダ 以 下 に 新 規 にスキーマ 名 と 同 名 のフォルダを 作 成 し てください 例 えばスキーマ 名 が"diary"なら /cmsdesigner/config/schema/diary というフォルダを 作 成 します 2 1で 作 成 したフォルダに スキーマファイルをアップロードしてください 以 上 でスキーマの 設 定 は 完 了 です [ 最 終 更 新 日 2015/08/28 16:32:00] 12 / 127

13 3. スキーマ 定 義 3.5 スキーマ リファレンス schema タグの 設 定 schema タグには 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 スキーマ 名 半 角 英 数 字 で 設 定 ( 先 頭 は 必 ず 英 字 ) caption 不 可 日 本 語 名 称 title 可 エントリ 一 覧 の 見 出 しに 使 う 項 目 名 詳 しくは エント リ 見 出 し 項 目 名 の 指 定 を 参 照 して 下 さい data タグの 種 類 data タグには 以 下 の 種 類 があります 詳 細 についてはそれぞれの 種 別 (type)の 詳 細 説 明 を 参 照 してください 種 別 (type) 説 明 text 1 行 テキスト 項 目 textarea 複 数 行 テキスト 項 目 int 整 数 値 項 目 menu ドロップダウンメニューからの 選 択 式 入 力 項 目 img 画 像 アップロード 項 目 file ファイルアップロード 項 目 date 日 付 項 目 西 暦 年 + 月 + 日 の 入 力 用 time 時 刻 項 目 時 (24H)+ 分 の 入 力 用 datetime 日 時 項 目 西 暦 年 + 月 + 日 + 時 (24H)+ 分 の 入 力 用 year 年 項 目 西 暦 年 の 入 力 用 month 年 月 項 目 西 暦 年 + 月 の 入 力 用 list リスト 項 目 separator 特 殊 入 力 項 目 ではなく 見 た 目 上 の 区 切 り [ 最 終 更 新 日 2015/08/28 16:32:00] 13 / 127

14 3. スキーマ 定 義 data タグ - text text 項 目 は 1 行 分 のテキストを 入 力 するのに 適 しています 何 かの 名 称 ちょっとしたコメントなどの 入 力 にはこれを 使 用 すると 良 いでしょう text 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてください type 不 可 "text"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイト 管 理 者 が 分 かりやすい 名 称 をつけてください size 可 テキストボックスの 大 きさを 指 定 します HTML の size 属 性 と 同 じです maxlength 可 入 力 できる 文 字 の 数 に 制 限 を 設 けたい 時 に 指 定 します 省 略 した 場 合 無 制 限 になります size 省 略 時 の 入 力 欄 のテキストボックスの 大 きさにも 影 響 します minlength 可 入 力 しなければならない 最 低 文 字 数 を 指 定 します 1 以 上 にすれば 必 須 入 力 項 目 になります 指 定 しなかった 場 合 は 0 になります output 可 入 力 されたテキストデータの HTML への 出 力 方 法 を 指 定 します -"text1" 入 力 された 内 容 をそのまま 出 力 します HTML タグなどが 入 力 された 場 合 もそ のまま 出 力 しますので 場 合 によっては HTML が 崩 れることがあります HTML タグなどが 入 力 されても 問 題 ない 項 目 に 指 定 してください -"text2" 通 常 はこれを 指 定 してください 改 行 を 自 動 的 に BR タグに 変 換 して 出 力 します( 自 動 改 行 ) サイト 管 理 者 がい ちいち BR タグを 使 って 改 行 する 必 要 はありません また "<"や">" "&"など HTML として 表 示 できない 文 字 を 自 動 的 に"&" などのコードに 変 換 して 出 力 します サイト 管 理 者 が 不 用 意 にこれらの 文 字 を 入 力 してしまっても HTML が 崩 れる ことはありません -"html1" 入 力 された 内 容 をそのまま HTML として 出 力 します HTML つまり HTML タグが 入 力 されたら そのタグが 有 効 になります HTML タグを 有 効 にしたい 場 合 に 使 用 してください サイト 管 理 者 に HTML の 知 識 がある 場 合 のみ 注 意 してこれを 利 用 してくださ い -"html2" 基 本 は html1 と 同 じ 動 作 ですが 改 行 を BR タグ(<br />)に 変 換 します( 自 動 改 行 ) HTML を 有 効 にしつつ サイト 管 理 者 が BR をいちいち 記 述 する 手 間 を 省 きます サイト 管 理 者 に HTML の 知 識 がある 場 合 のみ 注 意 してこれを 利 用 してくださ い 尚 以 下 の 場 合 には 行 末 に BR タグを 付 けません 行 末 が">"で 終 わっている 又 は <pre></pre>で 囲 ってある 範 囲 これは 例 えば TABLE タグなどを 入 力 した 場 合 には 行 末 に<br />が 付 くと 困 るし PRE タグの 範 囲 は BR をつける 必 要 が 無 い 為 です 例 ) <data name="url" type="text" caption="ホームページ" maxlength="1000" /> [ 最 終 更 新 日 2015/08/28 16:32:00] 14 / 127

15 3. スキーマ 定 義 data タグ - textarea textarea 項 目 は 複 数 行 のまとまったテキストを 入 力 するのに 適 しています 本 文 や 説 明 文 などの 入 力 にはこれを 使 用 すると 良 いでしょう textarea 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します type 属 性 以 外 text 項 目 と 同 じです 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてください type 不 可 "textarea"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイト 管 理 者 が 分 かりやすい 名 称 をつけてください cols 可 テキストボックスの 幅 を 指 定 します HTML の 属 性 と 同 じです rows 可 テキストボックスの 高 さを 指 定 します HTML の 属 性 と 同 じです maxlength 可 入 力 できる 文 字 の 数 に 制 限 を 設 けたい 時 に 指 定 します 省 略 した 場 合 無 制 限 になります cols rows 省 略 時 の 入 力 欄 のテキストボックスの 大 きさにも 影 響 し ます minlength 可 入 力 しなければならない 最 低 文 字 数 を 指 定 します 1 以 上 にすれば 必 須 入 力 項 目 になります 指 定 しなかった 場 合 は 0 になります output 可 text 項 目 と 同 じです autolink 可 "True"を 設 定 すると 入 力 された 文 章 中 の URL と 思 われる 部 分 を 自 動 的 にリンクに 変 換 します output 属 性 が"text2" 又 は"html2"の 場 合 のみ 有 効 です 例 ) <data name="description2" type="textarea" caption=" 所 在 地 " output="html1" maxlength="100" /> [ 最 終 更 新 日 2015/08/28 16:32:00] 15 / 127

16 3. スキーマ 定 義 data タグ - int int 項 目 は 整 数 値 を 入 力 するのに 適 しています 個 数 評 価 値 番 号 などの 入 力 にはこれを 使 用 すると 良 いでしょう int 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "int"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください min 可 入 力 できる 範 囲 の 下 限 を 指 定 します 0 以 上 の 値 を 指 定 できます 例 えば"5"と 指 定 すると 4 以 下 の 値 は 入 力 できなくなります max 可 入 力 できる 範 囲 の 上 限 を 指 定 します 0 以 上 の 値 を 指 定 できます 例 えば"100"と 指 定 すると 101 以 上 の 値 は 入 力 できなくなりま す 例 ) <data name="count" type="int" caption=" 個 数 " min="0" max="50" /> [ 最 終 更 新 日 2015/08/28 16:32:00] 16 / 127

17 3. スキーマ 定 義 data タグ - menu menu 項 目 は 選 択 項 目 を 入 力 するのに 適 しています 何 かの 種 別 カテゴリ 名 などの 選 択 入 力 にはこれを 使 用 すると 良 いでしょう menu 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "menu"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください また 選 択 項 目 の 値 として menuitem タグを 子 に 持 ちます 例 えば 以 下 のように 設 定 します <data name="shopkind" type="menu" caption="お 店 種 別 " > <menuitem id="1"> 中 華 </menuitem> <menuitem id="2">ラーメン</menuitem> <menuitem id="3"> 和 食 </menuitem> <menuitem id="4"> 洋 食 </menuitem> <menuitem id="5">スイーツ</menuitem> </data> menuitem タグの id 属 性 に 指 定 されている 値 が 実 際 にデータとして 保 存 されます [ 最 終 更 新 日 2015/08/28 16:32:00] 17 / 127

18 3. スキーマ 定 義 data タグ - img img 項 目 は 画 像 ファイルをアップロードさせるのに 用 います img 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "img"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください alt 可 HTML の img タグの alt 属 性 を 入 力 させるかどうかを 指 定 しま す 省 略 した 場 合 "False"になります -"False" 入 力 させない -"True" 入 力 させる maxfilesize 可 アップロードする 画 像 ファイルのサイズを 指 定 します 単 位 は byte です 1KB(KBytes)=1024bytes で 計 算 します "20KB"や"3MB"のように 書 くこともできます width 可 アップロードする 画 像 の 幅 が 指 定 した width より 大 きかった 場 合 自 動 的 に width まで 幅 を 縮 小 します( 縦 横 比 は 保 持 されま す) height 可 アップロードする 画 像 の 高 さが 指 定 した height より 大 きかった 場 合 自 動 的 に height まで 高 さを 縮 小 します( 縦 横 比 は 保 持 さ れます) 例 ) <data name="shopphoto" type="img" caption=" 写 真 " /> [ 最 終 更 新 日 2015/08/28 16:32:00] 18 / 127

19 3. スキーマ 定 義 data タグ - file file 項 目 は 画 像 以 外 の 添 付 ファイルをアップロードさせるのに 用 います PDF ファイルや 各 種 資 料 ファイルなどはこの 項 目 を 使 用 してください file 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "file"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください maxfilesize 可 アップロードするファイルのサイズを 指 定 します 単 位 は byte です 1KB(KBytes)=1024bytes で 計 算 します "20KB"や"3MB"のように 書 くこともできます 例 ) <data name="file1" type="file" caption=" 添 付 ファイル" /> [ 最 終 更 新 日 2015/08/28 16:32:00] 19 / 127

20 3. スキーマ 定 義 data タグ - date, time, datetime, year, month date, time, datetime, year, month 項 目 は 日 時 を 入 力 するのに 用 います 年 月 日 を 入 力 したい 場 合 は date 時 刻 を 入 力 したい 場 合 は time 日 時 を 入 力 したい 場 合 は datetime を 使 います また 西 暦 年 のみを 入 力 したい 場 合 は year 西 暦 年 と 月 を 入 力 したい 場 合 は month を 使 ってく ださい これらの 日 時 項 目 は 初 期 値 として 現 在 の 日 時 が 設 定 されます 日 時 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "date" 又 は"time" 又 は"datetime" 又 は"year" 又 は"month"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください 例 ) <data name="birthday" type="date" caption=" 生 年 月 日 " /> [ 最 終 更 新 日 2015/08/28 16:32:00] 20 / 127

21 3. スキーマ 定 義 data タグ - geolocation Ver.1.1.5a 以 降 で 使 用 可 能 です geolocation 項 目 は 地 図 の 緯 度 経 度 情 報 を 入 力 する 際 に 使 用 します 使 用 の 為 には Google Maps API が 必 要 です 詳 しい 使 用 方 法 は CMS Designer 公 式 サイトの ダウンロードページより Google Maps API v3 を 使 った 地 図 表 示 サンプル をダウンロードして 何 ある 説 明 テキストファイルを 参 照 してください geolocation 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "geolocation"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください 例 ) <data name="location" type="geolocation" caption=" 所 在 地 " /> [ 最 終 更 新 日 2015/08/28 16:32:00] 21 / 127

22 3. スキーマ 定 義 data タグ - separator separator は data タグの 中 で 唯 一 意 味 のないタグ です このタグはコンテンツ 管 理 画 面 上 で 各 種 項 目 の 間 に 区 切 り( 横 線 ) を 入 れて 見 やすくする 為 のもので 入 力 内 容 にはまったく 影 響 を 与 えません 例 えば 基 本 情 報 と 追 加 情 報 のようにセクションを 分 けたい 場 合 などに 区 切 りを 使 って 領 域 を 分 けることができます name 属 性 と type 属 性 だけを 指 定 した 場 合 細 い 横 線 が 入 ります caption 属 性 を 指 定 すると 大 きな 文 字 でその caption が 区 切 り 線 内 に 表 示 されます description 属 性 を 指 定 すると 小 さな 文 字 でその description が 区 切 り 線 内 に 表 示 されます caption と description を 両 方 同 時 に 指 定 することもできます 用 途 によって 使 い 分 けて 下 さい 区 切 り 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "separator"と 指 定 します caption 可 能 区 切 り 線 の 内 部 に 大 き な 文 字 で 見 出 し を 表 示 し ま す separator を 大 見 出 し 代 わりに 使 いたい 場 合 に 指 定 します description 可 能 区 切 り 線 の 内 部 に 小 さな 文 字 で 説 明 文 を 表 示 します separator を 小 見 出 し 又 は 補 足 表 示 代 わりに 使 いたい 場 合 に 指 定 します 例 ) <data name="separator1" type="separator" caption=" 基 本 情 報 " description=" 必 ず 入 力 する 必 要 がある 項 目 群 です " /> [ 最 終 更 新 日 2015/08/28 16:32:00] 22 / 127

23 3. スキーマ 定 義 data タグ - list list 項 目 は 繰 り 返 し 項 目 を 入 力 する 際 に 使 用 する 特 殊 なタグです( 使 用 するケースは 稀 ですの で 必 要 無 い 場 合 は 読 み 飛 ばしてください) list 項 目 の 中 に 繰 り 返 したい 項 目 を 定 義 します 例 えば 画 像 データを1つのエントリの 中 にたくさん 登 録 した 場 合 このような 方 法 を 考 えるかも しれません <?xml version="1.0" encoding="utf-8"?> <schema name=" 写 真 たくさん" caption=" 写 真 たくさん" > <data name="title" type="text" caption="タイトル" /> <data name="photo1" type="img" caption=" 写 真 1" /> <data name="photo2" type="img" caption=" 写 真 2" /> <data name="photo3" type="img" caption=" 写 真 3" /> <data name="photo4" type="img" caption=" 写 真 4" /> <data name="photo5" type="img" caption=" 写 真 5" /> <data name="photo6" type="img" caption=" 写 真 6" /> </schema> 入 力 画 面 には 画 像 ファイルのアップロード 項 目 が 6 つ 並 ぶことになります しかしこの 方 法 だと 最 大 6 件 まで 画 像 を 登 録 することができますが 逆 に 言 えば 7 件 以 上 は 登 録 できません list 項 目 を 使 うと 0 件 ~ 何 件 でも 同 じ 項 目 を 繰 り 返 し 登 録 させることができます <?xml version="1.0" encoding="utf-8"?> <schema name=" 写 真 たくさん" caption=" 写 真 たくさん" > <data name="title" type="text" caption="タイトル" /> <data name="shopphotolist" type="list" caption=" 写 真 一 覧 " > <listitem caption=" 写 真 の 説 明 文 " > <data name="photo" type="img" caption=" 写 真 " /> <data name="photodesc" type="textarea" caption=" 写 真 の 説 明 文 " /> </listitem> </data> </schema> list 項 目 の 場 合 には data タグに 以 下 の 属 性 を 設 定 します 属 性 値 省 略 内 容 name 不 可 データ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 同 一 スキーマ 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてくださ い type 不 可 "list"と 指 定 します caption 不 可 日 本 語 名 称 入 力 項 目 の 横 にラベルとして 表 示 されます サイ ト 管 理 者 が 分 かりやすい 名 称 をつけてください 繰 り 返 したい 入 力 項 目 (data タグ)を listitem タグで 囲 みます 尚 listitem タグの 中 には 複 数 の 項 目 を 含 めることができます この 中 にさらに list 項 目 を 含 めることも 可 能 です [ 最 終 更 新 日 2015/08/28 16:32:00] 23 / 127

24 3. スキーマ 定 義 listitem 要 素 に title 属 性 を 指 定 することで コンテンツ 管 理 画 面 のリスト 項 目 一 覧 の 見 出 しに 表 示 する 内 容 を 任 意 に 指 定 することができます <?xml version="1.0" encoding="utf-8"?> <schema name=" 写 真 たくさん" caption=" 写 真 たくさん" > <data name="title" type="text" caption="タイトル" /> <data name="shopphotolist" type="list" caption=" 写 真 一 覧 " > <listitem caption=" 写 真 の 説 明 文 " title="photodesc" > <data name="photo" type="img" caption=" 写 真 " /> <data name="photodesc" type="textarea" caption=" 写 真 の 説 明 文 " /> </listitem> </data> </schema> 上 記 の 例 では photodesc 項 目 の 内 容 が 見 出 しとして 利 用 されます title 属 性 を 省 略 した 場 合 には list 項 目 内 の 内 部 項 目 のうち 先 頭 の 項 目 が 見 出 しとして 使 用 さ れます また title 属 性 にはカンマ 区 切 りで 複 数 の 項 目 を 指 定 することができます その 場 合 には 各 項 目 の 値 が で 区 切 られて 指 定 した 順 序 で 表 示 されます [ 最 終 更 新 日 2015/08/28 16:32:00] 24 / 127

25 3. スキーマ 定 義 ソート( 並 べ 替 え) 指 定 エントリを 登 録 すると 通 常 は 更 新 された 順 に( 降 順 で)ソート( 並 べ 替 え)されます つまり 新 しいエントリほど 先 頭 に 来 ます しかし 場 合 によっては 件 名 をあいうえお 順 に という 場 合 もあったり 商 品 番 号 順 に という 場 合 もあるでしょう CMS Designer では どの 項 目 でソートするか 昇 順 か 降 順 かを 指 定 することができます 例 えば 次 のようなスキーマがあるとして <?xml version="1.0" encoding="utf-8"?> <schema name="diary" caption=" 日 記 帳 " > <data name="title" type="text" caption=" 件 名 " /> <data name="body" type="textarea" caption=" 本 文 " /> </schema> 件 名 で 昇 順 にソートしたい という 場 合 は 次 のように schema タグに sortkey 属 性 と sortorder 属 性 を 追 加 します <?xml version="1.0" encoding="utf-8"?> <schema name="diary" caption=" 日 記 帳 " sortkey="title" sortorder="asc" > <data name="title" type="text" caption=" 件 名 " /> <data name="body" type="textarea" caption=" 本 文 " /> </schema> sortkey 属 性 には ソート 項 目 にしたい 項 目 名 を 指 定 します 省 略 すると 更 新 日 されます sortorder 属 性 には 昇 順 か 降 順 かで 以 下 のように 設 定 します 省 略 すると"desc"になります sortorder 属 性 説 明 "asc" 昇 順 でソートする 例 )4,7,10,11,15... "desc" 降 順 でソートする 例 )15,11,10,7,4... 尚 sortkey として 指 定 できるデータ 項 目 は スキーマのルート 階 層 (schema タグの 直 下 の 階 層 )のデータ 項 目 だけです また 複 数 のソート 項 目 を 指 定 することはできません [!] 注 意 ソート 機 能 は エントリ 投 稿 時 にソートが 実 行 されるものです 表 示 の 際 にソート 順 を 指 定 して 昇 順 / 降 順 を 入 れ 替 えたりというような 事 はできません また ソート 項 目 を 設 定 してエントリを 投 稿 した 後 でソート 項 目 やソート 順 を 変 更 しても 既 存 のエントリの 並 び 順 は 変 更 されません その 場 合 は 既 存 のエントリを 全 て 保 存 しなおせば 正 しくソートされますが 基 本 的 には 運 用 中 のソート 項 目 の 変 更 はしないでください [ 最 終 更 新 日 2015/08/28 16:32:00] 25 / 127

26 3. スキーマ 定 義 グループ( 絞 込 み) 指 定 エントリ 一 覧 に 全 てのエントリを 表 示 するのではなく 全 エントリの 中 から この 種 類 のエントリだ け を 一 覧 したい 場 合 があります 例 えば 商 品 エントリを 商 品 種 別 が 雑 貨 のものだけ 表 示 したい という 場 合 などです CMS Designer には グループ という 簡 単 な 絞 込 み 機 能 があります 例 えば 次 のようなスキーマがあるとして <?xml version="1.0" encoding="utf-8"?> <schema name="shop" caption="お 店 情 報 " > <data name="shopname" type="text" caption=" 店 名 " maxlength="10" /> <data name="url" type="text" caption="ホームページ" /> <data name="description" type="textarea" caption=" 説 明 " output="text2" maxlength="100" /> <data name="shopkind" type="menu" caption="お 店 種 別 "> <menuitem id="1"> 中 華 </menuitem> <menuitem id="2">ラーメン</menuitem> <menuitem id="3"> 和 食 </menuitem> <menuitem id="4"> 洋 食 </menuitem> <menuitem id="5">スイーツ</menuitem> </data> </schema> このスキーマのエントリの 中 から お 店 種 別 が 中 華 や ラーメン などのエントリだけを 一 覧 表 示 するには まず お 店 種 別 項 目 をグループに 指 定 します <data name="shopkind" type="menu" caption="お 店 種 別 " group="true"> 上 記 の 太 字 の 部 分 のように データ 項 目 に group 属 性 を 追 加 し 値 を"True"と 記 入 します 実 際 に 絞 込 みをする 方 法 については6 章 を 参 照 してください ソート 項 目 と 同 じく グループ 項 目 も 運 用 中 に 変 更 することはできません group 属 性 が 指 定 できるデータ 項 目 は スキーマのルート 階 層 (schema タグの 直 下 の 階 層 )の データ 項 目 だけです group 属 性 は 複 数 の 項 目 に 指 定 して 使 用 できます 使 用 する 際 には 異 なる 二 つのグループ に 絞 込 み 条 件 を 指 定 することもできます( 例 えば お 店 種 別 が" 和 食 "で 且 つ 評 価 が"5"の エントリ など) グループを 増 やせば 増 やすほど 処 理 のパフォーマンスは 落 ちていきます 絞 込 み 機 能 を 使 わ なくても グループ 項 目 が 存 在 するだけで 多 少 負 荷 がかかります textarea 項 目 をグループ 項 目 に 指 定 するのは 極 力 避 けてください グループ 指 定 された 項 目 は index ファイルという 絞 込 み 検 索 用 の 別 ファイルにデータ 内 容 が 全 てコピーされます グループ 項 目 はあくまでも 項 目 の 値 が のもの という 絞 込 みしかできません でないもの とか 以 下 などの 複 雑 な 絞 込 みはできませんのでご 了 承 ください [ 最 終 更 新 日 2015/08/28 16:32:00] 26 / 127

27 3. スキーマ 定 義 エントリ 見 出 し 項 目 名 の 指 定 既 定 では コンテンツ 管 理 画 面 のエントリ 一 覧 の エントリ 見 出 し には スキーマの 最 初 に 指 定 さ れた 項 目 の 内 容 が 表 示 されます 例 えば 以 下 のような 場 合 には エントリ 見 出 しとして shopname の 内 容 が 表 示 されます <?xml version="1.0" encoding="utf-8"?> <schema name="shop" caption="お 店 情 報 " > <data name="shopname" type="text" caption=" 店 名 " maxlength="10" /> <data name="url" type="text" caption="ホームページ" /> <data name="description" type="textarea" caption=" 説 明 " output="text2" maxlength="100" /> <data name="shopkind" type="menu" caption="お 店 種 別 "> <menuitem id="1"> 中 華 </menuitem> <menuitem id="2">ラーメン</menuitem> <menuitem id="3"> 和 食 </menuitem> <menuitem id="4"> 洋 食 </menuitem> <menuitem id="5">スイーツ</menuitem> </data> </schema> しかし サイト 管 理 者 によっては お 店 の 名 前 ではなく 説 明 の 内 容 を 表 示 して 欲 しい というよう な 場 合 もあるかもしれません また shopname 項 目 より 前 に shopkind 項 目 を 配 置 して 欲 しい という 要 望 も 有 り 得 ます shopkind 項 目 を 先 頭 に 持 ってくると エントリ 一 覧 には 中 華 とか ラー メン などが 並 ぶ 事 になり 非 常 に 困 ります そんなときはエントリ 見 出 しとして 用 いたい 項 目 名 を 明 示 的 に 指 定 することができます schema タグの title 属 性 に エントリ 見 出 し 用 のデータ 項 目 名 を 指 定 します <?xml version="1.0" encoding="utf-8"?> <schema name="shop" caption="お 店 情 報 " title="description"> <data name="shopname" type="text" caption=" 店 名 " maxlength="10" /> <data name="url" type="text" caption="ホームページ" /> <data name="description" type="textarea" caption=" 説 明 " output="text2" maxlength="100" /> <data name="shopkind" type="menu" caption="お 店 種 別 "> <menuitem id="1"> 中 華 </menuitem> <menuitem id="2">ラーメン</menuitem> <menuitem id="3"> 和 食 </menuitem> <menuitem id="4"> 洋 食 </menuitem> <menuitem id="5">スイーツ</menuitem> </data> </schema> この title 属 性 には 複 数 のデータ 項 目 名 をカンマ 区 切 りで 指 定 することも 可 能 です 複 数 指 定 し た 場 合 には で 各 項 目 が 連 結 されたものが 見 出 しとして 使 用 されます <schema name="shop" caption="お 店 情 報 " title="shopname,shopkind,description"> 尚 見 出 しは 最 長 50 文 字 でカットされて 表 示 されます [ 最 終 更 新 日 2015/08/28 16:32:00] 27 / 127

28 4. エントリ 定 義 4 エントリ 定 義 4.エントリ 定 義 4.1 エントリ 定 義 とは 何 か スキーマは 単 なるデータの 型 である 為 実 際 にエントリを 登 録 する 為 には 指 定 したスキーマ ( 型 )を 使 って 生 成 したエントリを 保 管 してゆく 場 所 を 作 らなければなりません それが エントリ 定 義 です 4.2 エントリ 定 義 手 順 エントリ 定 義 は 二 つの 作 業 が 必 要 になります 1 エントリ 保 存 用 フォルダの 作 成 とパーミッションの 設 定 2 site.config.xml へのエントリ 定 義 の 追 加 4.3 エントリ 保 存 用 フォルダの 作 成 とパーミッションの 設 定 エントリ 保 存 用 フォルダを 以 下 の 場 所 に 作 成 し パーミッションを"707" 以 上 に 設 定 します フォルダ 名 は エントリフォルダ 名 として 各 所 で 使 いますので 覚 えておいてください /cmsdesigner/data/entry 例 えば"mydiary"というエントリフォルダ 名 ならば /cmsdesigner/data/entry/mydiary ( パーミッションを 707 に 設 定 ) というフォルダを 新 規 に 作 成 します 作 成 後 mydiary フォルダのパーミッションを"707" 以 上 に 設 定 してください パーミッションの 設 定 作 業 は 忘 れやすいのでご 注 意 ください 4.4 site.config.xml へのエントリ 定 義 の 追 加 次 に /public-html/cmsdesigner/config/site.config.xml ファイルをエディタで 編 集 します このフ ァイルも UTF-8 の 文 字 コードですので UTF-8 対 応 のエディタで 編 集 してください 以 下 は site.config.xml の 例 です site.config.xml( 例 ) <?xml version="1.0" encoding="utf-8"?> <site> <entries> <entry name="news1" schema="news" caption=" 新 着 情 報 " /> <entry name="news2" schema="news" caption="お 知 らせ" /> </entries> </site> [ 最 終 更 新 日 2015/08/28 16:32:00] 28 / 127

29 4. エントリ 定 義 entries タグの 中 に 設 定 されている entry タグが それぞれエントリ 定 義 です entry タグの 設 定 内 容 属 性 値 省 略 内 容 name 不 可 エントリフォルダ 名 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) システム 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてください schema 不 可 このエントリ 定 義 の 型 となるスキーマ 名 を 指 定 します caption 不 可 日 本 語 名 称 エントリ 選 択 の 際 の 見 出 しとして 表 示 されます サイト 管 理 者 が 分 かりやすい 名 称 をつけてください publishcontrol 可 エントリ 毎 の 公 開 / 非 公 開 を 管 理 するかどうかを 設 定 します 省 略 すると"on-off"を 指 定 したことになります "full" - 公 開 / 非 公 開 に 加 え いつからいつまで 公 開 のような 公 開 予 約 を 指 定 することができます "on-off" - 公 開 / 非 公 開 を 設 定 できるようにします また full よりも 若 干 処 理 速 度 が 向 上 します 公 開 予 約 までは 必 要 ない 場 合 はこちらを 指 定 して 下 さい "none" - 公 開 管 理 を 行 いません 全 てのエントリが 自 動 的 に 公 開 されます その 代 わり 処 理 速 度 が 向 上 します 処 理 速 度 が 気 になる 場 合 はこちらを 指 定 して 下 さい entrypageurl 可 エントリ 1 件 表 示 を 行 うページの URL を 指 定 する 事 で コンテンツ 管 理 画 面 から 表 示 の 確 認 をすることができるようになります " 指 定 してください 表 示 の 確 認 では 非 公 開 エントリも 表 示 させることができる 為 簡 易 的 なプレビューとしても 利 用 できて 便 利 です 例 )entrypageurl=" listpageurl 可 エントリ 一 覧 表 示 を 行 うページの URL を 指 定 する 事 で コンテンツ 管 理 画 面 から 表 示 の 確 認 をすることができるようになります " 指 定 してください 例 )listpageurl=" 前 のページの 例 で 同 じスキーマに 対 して 二 つのエントリ 定 義 が 入 っていることに 注 目 してください この 例 では news というスキーマを 元 にして news1 と news2 というエントリ 定 義 を 作 っています 片 方 は 新 着 情 報 としてサイトの 更 新 情 報 を もう 片 方 はお 知 らせとしてお 店 からのお 知 らせを 配 信 する 為 に 用 いることができます このように 1つのスキーマに 対 して 複 数 のエントリ 定 義 を 作 ることができます スキーマは 型 で すから その 型 を 元 に 別 の 用 途 のエントリ 定 義 を 作 ることで スキーマを 再 利 用 することができます [ 最 終 更 新 日 2015/08/28 16:32:00] 29 / 127

30 4. エントリ 定 義 4.5 区 切 り 表 示 用 のエントリ 定 義 について 補 足 的 な 機 能 として コンテンツ 管 理 画 面 のエントリフォルダ 一 覧 (エントリ 定 義 一 覧 )に 表 示 す る 際 の 区 切 り を 設 定 することができます 例 えば サイトに 商 品 関 係 のエントリ 定 義 が4 種 類 お 知 らせ 関 係 のエントリ 定 義 が2 種 類 お 客 様 の 声 のエントリ 定 義 が3 種 類 あったとしたら エントリフォルダ 一 覧 には9 個 のエントリ 定 義 が 並 ぶ 事 になり サイト 管 理 者 にとって 多 少 見 づらい 画 面 になってしまいます そこで それらのエントリ 定 義 のグループの 間 に 区 切 りを 入 れてやることで 見 やすい 画 面 を 作 ることができます 区 切 りの 設 定 は エントリ 定 義 と 同 じ entry タグを 用 います 但 し 以 下 のように 属 性 を 設 定 する 必 要 があります 表 示 の 為 の 設 定 なので schema 属 性 は 不 要 です name 属 性 と type 属 性 だけを 指 定 した 場 合 細 い 横 線 が 入 ります caption 属 性 を 指 定 すると 大 きな 文 字 でその caption が 区 切 り 線 内 に 表 示 されます description 属 性 を 指 定 すると 小 さな 文 字 でその description が 区 切 り 線 内 に 表 示 されます caption と description を 両 方 同 時 に 指 定 することもできます 用 途 によって 使 い 分 けて 下 さい 区 切 り の 場 合 の entry タグの 設 定 内 容 属 性 値 省 略 内 容 name 不 可 半 角 英 数 字 で 設 定 します( 先 頭 は 必 ず 英 字 ) 本 来 不 要 です が 他 の entry タグと 合 わせる 為 "separator1"などの 適 当 な 名 前 をつけて 下 さい システム 内 で 一 意 の( 他 とかぶらない) 名 前 をつけてください type 不 可 "separator"と 指 定 します caption 可 能 区 切 り 線 の 内 部 に 大 き な 文 字 で 見 出 し を 表 示 し ま す separator を 大 見 出 し 代 わりに 使 いたい 場 合 に 指 定 します description 可 能 区 切 り 線 の 内 部 に 小 さな 文 字 で 説 明 文 を 表 示 します separator を 小 見 出 し 又 は 補 足 表 示 代 わりに 使 いたい 場 合 に 指 定 します 例 ) <entry name="separator1" type="separator" caption=" 商 品 関 係 " description=" 各 種 商 品 情 報 の 追 加 や 削 除 更 新 の 際 に 編 集 します " /> [ 最 終 更 新 日 2015/08/28 16:32:00] 30 / 127

31 4. エントリ 定 義 4.6 画 像 キャッシュの 指 定 CMS Designer にはアップロードした 画 像 を 表 示 する 際 に 指 定 した width と height で 縮 小 して 表 示 する 機 能 があります サムネイルなどを 別 途 用 意 する 必 要 がない 為 便 利 な 機 能 ですが サーバへ 要 求 がある 度 に 毎 回 画 像 を 縮 小 する 処 理 が 実 行 される 為 サーバの 負 荷 が 高 く 一 度 に 大 量 のサム ネイルを 表 示 するようなページを 作 った 場 合 には 表 示 の 遅 れが 目 立 つことがありました これを 回 避 する 為 一 度 生 成 した 縮 小 画 像 をキャッシングしておき 次 に 同 じ width と height で 縮 小 表 示 要 求 があった 場 合 には 元 画 像 から 縮 小 処 理 を 行 うのではなく キャッシュ 画 像 をそのままブ ラウザへ 送 り 返 す 機 能 を 利 用 することができます 画 像 キャッシュの 指 定 はエントリフォルダ 単 位 に 行 います 例 えば 次 のような 例 で 説 明 します とあるデザイン 定 義 にて 次 のような 画 像 縮 小 表 示 を 行 っているとします 例 ) <img src="{photo}&w=120&h=180" /> width=120 height=180 の 範 囲 内 に 収 まるように 画 像 が 縮 小 して 表 示 されます この 縮 小 画 像 を キャッシングする 場 合 には site.config.xml の entry タグに 次 のような imagecache タグを 追 加 しま す <?xml version="1.0" encoding="utf-8"?> <site> <entries> <entry name="news1" schema="news" caption=" 新 着 情 報 " > <imagecache width="120" height="180" /> </entry> </entries> </site> entry タグが これまでのように /> で 終 わる 空 要 素 ではなく 開 始 タグと 終 了 タグに 分 かれている 点 に 注 意 して 下 さい entry の 開 始 タグと 終 了 タグの 間 に imagecache タグを 記 述 します 画 像 キャッシュが 作 成 されるのは この 例 では news1 のエントリフォルダ 内 の 画 像 に 対 して w=120&h=180 の 縮 小 表 示 指 定 がされた 場 合 のみです 全 ての 画 像 に 対 して 自 動 的 にキャッシュを 作 るような 仕 様 になっていない 理 由 は 悪 意 のある 攻 撃 によって 大 量 の(ちょっとサイズを 変 えただけの) 画 像 キャッシュが 勝 手 に 作 成 されるようなことがな いようにする 為 です imagecache タグの width と height は どちらか 片 方 だけを 指 定 することもできます width="120" とだけ 指 定 した 場 合 は 同 様 に w=120 の 縮 小 指 定 がされた 場 合 のみキャッシュが 作 成 されます ( w=120&h=180 のように 両 方 指 定 された 場 合 には 作 成 されません) また width="all"のように 記 述 することで 全 ての 縮 小 幅 指 定 に 対 して 画 像 キャッシュを 作 るように 指 示 することもできます "all"を 指 定 した 場 合 先 ほどの 攻 撃 に 対 して 脆 弱 になりますので 注 意 して 下 さい [ 最 終 更 新 日 2015/08/28 16:32:00] 31 / 127

32 4. エントリ 定 義 画 像 キャッシュは 以 下 のフォルダに 自 動 的 に 作 成 されます cache フォルダのパーミッションは 707 以 上 に 設 定 して 下 さい cmsdesigner/cache/ (707) 作 成 された 画 像 キャッシュは 対 象 となる 画 像 を 含 むエントリが 更 新 されたり 削 除 された 時 などに 自 動 的 に 削 除 されます [ 最 終 更 新 日 2015/08/28 16:32:00] 32 / 127

33 4. エントリ 定 義 4.7 ユーザー 権 限 ユーザー 権 限 について エントリフォルダ 単 位 で このエントリフォルダはこのユーザーしか 見 れない 一 覧 表 示 はでき るが 編 集 はできない 編 集 はできるが 新 規 追 加 や 削 除 はできない といったユーザー 権 限 を 設 定 することができます これにより 複 数 人 でサイトを 更 新 する 場 合 でも あるユーザーには 編 集 さ せたくないようなエントリフォルダを 作 ることが 出 来 ます ユーザー 権 限 の 指 定 方 法 指 定 方 法 は 個 々のエントリフォルダに 対 して ユーザー1 は 一 覧 表 示 と 編 集 ができる のよう な 形 で 指 定 します 何 も 指 定 しなかった 場 合 そのエントリフォルダは 誰 もが 管 理 者 権 限 を 持 つ 状 態 となります 尚 管 理 者 権 限 を 持 つユーザーは どのエントリフォルダに 対 しても 必 ず 全 ての 権 限 を 持 ちます 指 定 は site.config.xml の entry 要 素 の 子 要 素 として 指 定 します 例 えば user1 user2 user3 及 び admin の 4 つのユーザーが 存 在 し(admin 以 外 は 全 員 編 集 者 ユーザー です) 新 着 情 報 のエントリフォルダについては user1 以 外 には 全 く 触 らせたくな い という 場 合 次 のように 指 定 します 例 )user1 に news1 へのアクセス 権 限 を 与 える <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1" /> </entry> permit 要 素 は users に 指 定 したユーザーに 対 して そのエントリフォルダにアクセスする 権 限 を 与 える 設 定 を 行 う 為 の 要 素 です 上 記 の 指 定 だと user2 と user3 は このエントリフォルダへアク セスすることができなくなります(コンテンツ 一 覧 自 体 にもこのエントリフォルダ 名 が 表 示 されませ ん) 管 理 者 ユーザーである admin については 指 定 がなくとも 全 てのエントリフォルダへアクセスす ることが 可 能 です ここが /> になっている とエラーになるので 注 意 複 数 のユーザーに 同 時 に 権 限 を 与 える 場 合 は 次 のようにカンマ 区 切 りで 複 数 のユーザーID を 指 定 することができます 例 )user1 と user2 に news1 へのアクセス 権 限 を 与 える <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1,user2 " /> </entry> [ 最 終 更 新 日 2015/08/28 16:32:00] 33 / 127

34 4. エントリ 定 義 詳 細 な 指 定 方 法 もう 少 し 細 かい 権 限 設 定 を 行 う 事 もできます 一 覧 表 示 新 規 追 加 編 集 削 除 の 権 限 を 自 分 が 投 稿 したエントリ 他 の 人 が 投 稿 した エントリ のそれぞれに 対 して 設 定 することができます 例 えば そのユーザーの 投 稿 したエントリについては 全 ての 操 作 が 可 能 だが 他 の 人 の 投 稿 し たエントリについては 一 覧 にすら 表 示 させない という 指 定 は 次 のようにします <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1" mine="all" others="none" /> </entry> こうすると user1 が 新 着 情 報 エントリフォルダを 開 くと 自 分 (user1)が 投 稿 したエントリのみ が 一 覧 に 表 示 されるようになります mine 属 性 には 自 分 が 投 稿 したエントリに 対 する 権 限 を 指 定 します others 属 性 には 他 の 人 が 投 稿 したエントリに 対 する 権 限 を 指 定 します "all"を 指 定 すると 全 ての 権 限 を 与 える 事 に なります "none"を 指 定 すると 全 ての 権 限 を 与 えないという 意 味 になります 指 定 できる 権 限 の 種 類 は 次 の 通 りです カンマ 区 切 りで 複 数 指 定 できます permit タグの mine 属 性 others 属 性 の 設 定 内 容 属 性 値 list edit add delete all none deny 意 味 エントリ 一 覧 にエントリを 表 示 できる edit,add,delete のいずれかを 指 定 した 場 合 は list は 省 略 可 能 エントリを 編 集 / 保 存 できる エントリを 新 規 追 加 できる エントリを 削 除 できる 全 ての 権 限 を 許 可 する 全 ての 権 限 を 許 可 しない 全 ての 権 限 を 拒 否 する ( 省 略 時 ) 省 略 時 は"all"を 指 定 した 事 になります mine 属 性 others 属 性 に 空 文 字 を 指 定 したり 属 性 そのものを 省 略 したりすると "all"を 指 定 した のと 同 じ 意 味 になります "none"ではありませんのでご 注 意 下 さい [ 最 終 更 新 日 2015/08/28 16:32:00] 34 / 127

35 4. エントリ 定 義 例 えば 先 ほどの 例 を 少 し 変 更 して 自 分 の 投 稿 したエントリは 全 ての 操 作 が 可 能 だが 他 の 人 の 投 稿 したエントリについては 一 覧 に 表 示 されるだけ としたい 場 合 には 次 のようにします <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1" mine="all" others="list" /> </entry> もちろん ユーザー 毎 に 別 々の 権 限 を 設 定 することもできます <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1" mine="all" others="list" /> <permit users="user2" mine="all" others="none" /> </entry> ユーザー 全 体 への 権 限 設 定 次 のように 括 弧 付 きで(publisher)と 指 定 すると ユーザー 個 別 ではなく 全 ての 管 理 者 以 外 の ユーザー つまり 編 集 者 ユーザー に 対 する 権 限 をまとめて 行 う 事 ができます <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="(publisher)" mine="all" others="list" /> </entry> (publisher)の 指 定 を 使 うと 全 てのユーザーは 基 本 的 に 自 分 のエントリを 編 集 することしかで きないが user1 だけは 他 のユーザーのエントリも 編 集 できる というような 複 雑 な 指 定 が 可 能 とな ります <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="(publisher)" mine="edit" others="list" /> <permit users="user1" mine="edit" others="edit" /> </entry> ここで 各 ユーザーに 編 集 (edit) 権 限 だけ 与 えても 新 規 追 加 (add)が 出 来 ない 状 態 では 意 味 が な い の で は な い か? と い う 疑 問 を 持 つ 方 も い ら っ し ゃ る と 思 い ま す 実 は 管 理 者 (Administrator)ユーザーは エントリ 投 稿 時 に 作 成 者 ユーザー 名 を 選 択 することができます これを 使 って 例 えば 複 合 店 舗 (ショッピングモール)サイトを 運 営 する 際 などに 管 理 者 ユーザー で 各 店 舗 のエントリをそれぞれの 店 舗 ユーザー 名 で1つずつ 作 成 しておき 店 舗 ユーザーには mine="edit"のみ 与 えておくという 利 用 方 法 が 考 えられます こうすることで 店 舗 ユーザーが 間 違 えて 自 分 のエントリを 削 除 してしまったり 勝 手 に 別 の 店 舗 エントリを 作 成 してしまうというような ミスを 防 ぐことができます [ 最 終 更 新 日 2015/08/28 16:32:00] 35 / 127

36 4. エントリ 定 義 権 限 の 拒 否 (deny) permit 要 素 では 権 限 の 許 可 以 外 に 拒 否 を 指 定 することもできます 拒 否 は 既 に 与 え られた 権 限 を 取 り 消 す 指 定 です 権 限 の 拒 否 は "-edit"とか"-list"のように mine 属 性 や others 属 性 の 設 定 値 に 対 してマイナス (-)をつけて 指 定 します 全 ての 権 限 を 拒 否 する 場 合 には "deny"と 指 定 します("-all"ではないの で 注 意 して 下 さい) 通 常 は 許 可 を 指 定 しなければ 自 動 的 に 権 限 が 無 い 状 態 となる 為 拒 否 を 使 うことはありませ ん これは ユーザー 全 体 への 権 限 設 定 と 組 み 合 わせた 場 合 に 使 用 します 例 を 示 します 全 ユーザーに 対 して 全 ての 権 限 を 与 えるが user1 に 対 しては 権 限 を 与 えない としたい 場 合 次 のようにしても 無 効 となります <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="(publisher)" mine="all" others="all" /> <permit users="user1" mine="none" others="none" /> </entry> この 指 定 は 無 効 となる none は 権 限 を 与 えない という 指 定 ですが 既 に 与 えられた 権 限 を 取 り 消 すまでの 効 果 は 持 ち ません この 例 だと (publisher)を 使 って 全 ユーザーに all の 権 限 が 与 えられている 為 user1 で 別 途 none を 指 定 しても all 権 限 は 消 えません この 場 合 次 のように deny を 使 います <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="(publisher)" mine="all" others="all" /> <permit users="user1" mine="deny" others="deny" /> </entry> 全 権 限 拒 否 とまではいかずとも 自 分 のエントリの 編 集 (edit) 以 外 はできないようにしたい とい う 場 合 には 次 のように edit 以 外 の 権 限 をマイナス 付 きで 指 定 します(-list を 指 定 すると 一 覧 表 示 自 体 が 出 来 なくなるのでご 注 意 下 さい) <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="(publisher)" mine="all" others="all" /> <permit users="user1" mine="edit,-add,-delete" others="deny" /> </entry> ここで user1 の mine 属 性 を"-add,-delete"のように edit を 省 略 することも 可 能 です(publisher に 対 して 既 に 与 えられている 為 です) しかし 場 合 によっては user1 に 何 をさせたいかを 明 確 に する 為 に 敢 えて 指 定 して 置 いても 害 はありません [ 最 終 更 新 日 2015/08/28 16:32:00] 36 / 127

37 4. エントリ 定 義 許 可 しない(none) と 拒 否 (deny) の 違 い 権 限 の 指 定 は 許 可 しない(none) 許 可 拒 否 (deny)の 順 に 優 先 度 が 高 くなります 許 可 を none で 取 り 消 すことはできません また 拒 否 を 指 定 されたものを 許 可 で 上 書 きすること もできません permit 要 素 の 記 述 順 序 は 結 果 に 影 響 しません 組 み 合 わせの 例 と 結 果 を 表 で 表 します ( 間 違 え 易 い 部 分 には 色 をつけてあります) 編 集 者 (publisher) user1 edit edit edit none none edit none none list list list edit edit list edit -edit -edit edit all deny deny all user1 に 対 する edit に 対 する 権 限 の 結 果 ( : 編 集 可 能 : 編 集 不 可 ) コンテンツ 一 覧 への 表 示 / 非 表 示 あるユーザーに 対 してコンテンツ 一 覧 にエントリフォルダを 表 示 するかどうかは 自 動 的 に 決 まり ます 具 体 的 にはそのユーザーが 該 当 エントリフォルダに 対 していかなる 権 限 も 持 っていない 場 合 にのみ 非 表 示 となります [ 最 終 更 新 日 2015/08/28 16:32:00] 37 / 127

38 4. エントリ 定 義 権 限 設 定 事 例 集 (1) 特 定 ユーザー 専 用 エントリフォルダ user1 は サイト 更 新 者 ユーザー <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1" /> </entry> (2) 管 理 者 専 用 エントリフォルダ <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="(administrator)" /> </entry> (3) user1: 準 管 理 者 user2:アルバイト( 既 存 エントリの 編 集 のみ 可 能 ) user1,user2 共 に サイト 更 新 者 ユーザー <entry name="news1" schema="news" caption=" 新 着 情 報 " > <permit users="user1" /> <permit users="user2" mine="none" others="edit" /> </entry> (4) 複 合 店 舗 サイト 各 店 舗 担 当 者 (user1~user3) 事 務 局 担 当 者 (center) admin user1~user3 には 自 分 の 店 舗 のエントリしか 編 集 させない( 新 規 削 除 は 不 可 ) center は 全 店 舗 のエントリを 編 集 できる( 新 規 削 除 は 不 可 ) 新 規 店 舗 の 追 加 は admin のみが 行 える( 該 当 ユーザー 名 でエントリを 作 る) user1~user3 center は サイト 更 新 者 ユーザー admin は システム 管 理 者 ユーザー <entry name="shop" schema="shop" caption=" 各 店 舗 情 報 " > <permit users="(publisher)" mine="edit" others="none" /> <permit users="center" mine="deny" others="edit" /> </entry> その 他 の 留 意 事 項 (1) エントリ 作 成 者 名 について ver.1.1.7a より 前 のバージョンで 保 存 したエントリには 作 成 者 名 が 含 まれていない 為 そのエ ントリの 作 成 者 名 は 未 設 定 としてコンテンツ 管 理 画 面 上 で 表 示 されます [ 最 終 更 新 日 2015/08/28 16:32:00] 38 / 127

39 5. デザイン 定 義 5 デザイン 定 義 5.デザイン 定 義 5.1 デザイン 定 義 とは 何 か コンテンツ 管 理 画 面 から 入 力 されたエントリデータは あくまでデータでしかない 為 見 栄 え 良 く HTML タグで 飾 りつけをする 必 要 があります デザイン 定 義 とは エントリデータ(XML データ)を HTML に 変 換 する 際 のテンプレートを 作 成 する 作 業 です エントリ 一 件 用 のデザイン 定 義 もしくは 複 数 のエントリを 表 示 する 為 のエントリ 一 覧 用 のデ ザイン 定 義 を 作 成 することができます エントリ: 育 児 日 記 1 件 <title> 件 名 1</title> <body> 本 文 です </body> 一 件 用 デザイン 定 義 title body 一 件 分 の 出 力 結 果 件 名 1 本 文 です エントリ: 育 児 日 記 複 数 件 <title> 件 名 1</title> <body> 本 文 です </body> <title> 件 名 2</title> <body> 本 文 2です </body> <title> 件 名 3</title> <body> 本 文 3です </body> 一 覧 用 デザイン 定 義 title 一 覧 の 出 力 結 果 件 名 1 件 名 2 件 名 3 デザイン 定 義 には 画 面 の 一 部 分 のみを 記 述 します デザイン 定 義 に<html>~</html>を 全 て 含 めるような 事 もできますが 通 常 は 更 新 したい 範 囲 のみを 記 述 します 画 面 全 体 の HTML の 記 述 はこれまで 通 り dreamweaver などのツールを 使 って 作 成 し 更 新 したい 一 部 分 のみを デザイン 定 義 として 別 に 作 成 するようにします そして 作 成 したデザイン 定 義 を 画 面 全 体 の HTML へと 埋 め 込 みます 画 面 全 体 の HTML にデザイン 定 義 を 埋 め 込 む 方 法 については 6.ウェブサイトへの 埋 め 込 み を 参 照 してください [ 最 終 更 新 日 2015/08/28 16:32:00] 39 / 127

40 5. デザイン 定 義 5.2 XSLT(XML Stylesheet Language Transformations)について CMS Designer では XML 形 式 で 保 存 されたエントリデータを HTML に 変 換 するための テンプレー ト を 記 述 する 仕 組 みとして XSLT を 利 用 しています XSLT は XML 技 術 の 標 準 技 術 で CMS Designer だけでなく 他 の 様 々な XML システムで 利 用 され ている 使 い 勝 手 の 良 い 技 術 です XSLT は 奥 が 深 く 非 常 にきめ 細 かい 処 理 を 行 うことができますが デザイナーが 覚 えなければなら ない 機 能 はごくわずかです(もちろん XSLT を 極 めてもらっても 構 いませんよ!) 例 えば 次 のようなエントリデータがあったとします(これは CMS Designer が 実 際 に 出 力 するエント リデータの 一 例 です) <?xml version="1.0" encoding="utf-8"?> <entry> <title> 件 名 1 </title> <body> 本 文 1です </body> </entry> これを 次 のような HTML に 変 換 したいとします <table border="1"> <tr><td> 件 名 </td><td> 件 名 1 </td></tr> <tr><td> 本 文 </td><td> 本 文 1です </td></tr> </table> この 場 合 次 のようなデザイン 定 義 (XSLT)を 記 述 します <?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet xmlns:xsl=" version="1.0"> <xsl:output method="html" encoding="utf-8" omit-xml-declaration="yes" /> <xsl:template match="/entry"> <table border="1"> <tr><td> 件 名 </td><td><xsl:value-of select="title" /></td></tr> <tr><td> 本 文 </td><td><xsl:value-of select="body" /></td></tr> </table> </xsl:template> </xsl:stylesheet> 注 目 して 欲 しいのは 5 行 目 から 10 行 目 あたりの xsl:template タグで 囲 まれた 部 分 です 出 力 した HTML がほとんどそのまま 記 述 されています データを 出 力 したい 部 分 だけ xsl:value-of というタグが 記 述 されています 基 本 はこれだけです おそらく すぐに 理 解 できるでしょう [ 最 終 更 新 日 2015/08/28 16:32:00] 40 / 127

41 5. デザイン 定 義 [!] HTML 形 式 XML(XHTML) 形 式 での 出 力 xsl ファイル 中 の<xsl:output method="html"... />の method 属 性 によって 最 終 的 に 出 力 される HTML/XML データに 若 干 違 いが 生 まれます method="html"と 指 定 すると HTML4.0 の 規 約 に 沿 ったタグが 出 力 されます xsl 中 で<br />と 記 述 していても <br>と 出 力 されます <input... /> なども <input... >のようになり ます これは HTML4.0 としては 便 利 ですが XHTML としては 正 しくありません method="xml"と 指 定 すると 通 常 の XML の 規 約 に 沿 った 形 でタグが 出 力 されます よって XHTML として 出 力 したい 場 合 にはこちらを 指 定 して 下 さい もちろん XML として 出 力 したい 場 合 もこちらになります 一 部 のサーバ 環 境 では method="xhtml"という 指 定 が 使 える 場 合 もあります これは method="xml" 指 定 だと 空 要 素 が 例 えば<br />ではなく<br/>のように /> の 前 の 空 白 が 詰 められてしまうような 仕 様 を 回 避 できます method="xml"の 場 合 のこの 仕 様 は XML とし ては 正 しいのですが HTML4.0 との 互 換 性 を 意 識 した XHTML の 仕 様 としては 正 しくありませ ん 但 し CMSD は method="xml"の 場 合 でも 内 部 的 に<br/>や<hr/>を<br /><hr />の ように 空 白 を 空 けたものに 変 換 して 出 力 していますので method="xml"でも 問 題 はありませ ん(ver.1.1.3a 以 降 のみ) [ 最 終 更 新 日 2015/08/28 16:32:00] 41 / 127

42 5. デザイン 定 義 5.3 エントリ1 件 用 のデザイン 定 義 例 えばお 店 情 報 のエントリがあったとして 一 覧 ではなく 1 件 分 のお 店 の 詳 細 情 報 を 画 面 に 表 示 したい 場 合 があります この 場 合 エントリ1 件 用 のデザイン 定 義 を 作 成 します エントリ1 件 用 のデザイン 定 義 は 以 下 のように 行 います まず デザイン 名 を 決 めます デザイン 名 は 半 角 英 数 でつけます( 全 角 文 字 は 不 可 ) そのデザイン 名 によって デザイン 定 義 ファイル 名 は 次 のように 決 まります スキーマ 名.デザイン 名.design.xsl 例 えば "diary"スキーマに"default"という 名 前 の 一 件 用 デザインを 作 成 する 場 合 は diary.default.design.xsl というファイル 名 になります エントリ1 件 分 を 画 面 に 表 示 する 場 合 のデザイン 定 義 は 以 下 のようになります <?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet xmlns:xsl=" version="1.0"> ヘッダ <xsl:output method="html" encoding="utf-8" omit-xml-declaration="yes" /> <xsl:template match="/entry"> <table border="1"> <tr><td> 件 名 </td><td><xsl:value-of select="title" /></td></tr> デザイン <tr><td> 本 文 </td><td><xsl:value-of select="body" /></td></tr> </table> </xsl:template> </xsl:stylesheet> フッタ ヘッダ 部 とフッタ 部 は 常 にこのまま 記 述 すれば OK です デザイン 部 の 記 述 方 法 は 5.5 デザイン リファレンス を 参 照 してください このファイルは スキーマ 定 義 ファイルと 同 じフォルダにアップロードしてください [ 最 終 更 新 日 2015/08/28 16:32:00] 42 / 127

43 5. デザイン 定 義 5.4 エントリ 一 覧 用 のデザイン 定 義 例 えばお 店 情 報 のエントリがあったとして 登 録 されている 全 てのエントリについて お 店 の 名 前 を 一 覧 表 示 したい 場 合 があります この 場 合 エントリ 一 覧 用 のデザイン 定 義 を 作 成 します エントリ 一 覧 用 のデザイン 定 義 は 以 下 のように 行 います まず デザイン 名 を 決 めます デザイン 名 は 半 角 英 数 でつけます( 全 角 文 字 は 不 可 ) そのデザイン 名 によって デザイン 定 義 ファイル 名 は 次 のように 決 まります スキーマ 名.list.デザイン 名.design.xsl スキーマ 名 の 後 に list という 文 字 が 入 っているのがミソです 例 えば "diary"スキーマに"default"という 名 前 の 一 覧 用 デザインを 作 成 する 場 合 は diary.list.default.design.xsl というファイル 名 になります エントリ 一 覧 用 のデザイン 定 義 は 以 下 のようになります <?xml version="1.0" encoding="utf-8"?> <xsl:stylesheet xmlns:xsl=" version="1.0"> ヘッダ <xsl:output method="html" encoding="utf-8" omit-xml-declaration="yes" /> <xsl:template match="/entrylist"> <xsl:for-each select="entry"> <table border="1"> <tr><td> 件 名 </td><td><xsl:value-of select="title" /></td></tr> デザイン <tr><td> 本 文 </td><td><xsl:value-of select="body" /></td></tr> </table> </xsl:for-each> </xsl:template> フッタ </xsl:stylesheet> ヘッダ 部 とフッタ 部 は 常 にこのまま 記 述 すれば OK です デザイン 部 の 記 述 方 法 は 5.5 デザイン リファレンス を 参 照 してください このファイルは スキーマ 定 義 ファイルと 同 じフォルダにアップロードしてください [ 最 終 更 新 日 2015/08/28 16:32:00] 43 / 127

44 5. デザイン 定 義 5.5 デザイン リファレンス 指 定 の 箇 所 へデータ 項 目 を 埋 め 込 む 指 定 の 箇 所 へスキーマの text 項 目 textarea 項 目 int 項 目 を 埋 め 込 む 場 合 xsl:value-of タグ を 使 います <xsl:value-of select="データ 名 " /> 例 ) <tr><td> 件 名 </td><td><xsl:value-of select="title" /></td></tr> 最 も 使 用 頻 度 の 高 いタグです 注 意 事 項 として 出 力 したい text 項 目 又 は textarea の output 属 性 が"text1" 以 外 の 場 合 は 次 のように disable-output-escaping 属 性 を"yes"に 設 定 しなければなりません <xsl:value-of select="データ 名 " disable-output-escaping="yes" /> 例 ) <tr><td> 件 名 </td><td><xsl:value-of select="title" disable-output-escaping="yes" /></td></tr> disable-output-escaping 属 性 の 意 味 を 考 える 必 要 は 特 にありませんが 気 になる 方 の 為 に 説 明 します disable-output-escaping 属 性 は データ 中 の"<"や">"などの HTML として 表 示 できない 文 字 を 自 動 的 に < な ど の コ ー ド に 変 換 し て 表 示 し な い こ と を 指 定 し ま す "yes" と 指 定 す る と 変 換 し ま せ ん disable-output-escaping 属 性 を 省 略 すると"no"を 指 定 したことになり 変 換 されてしまいます スキーマの output 属 性 を"html1"などにした 場 合 そのまま 出 力 したい HTML コードまで 変 換 されてしまう 為 その 場 合 はここで"yes" を 指 定 する 必 要 があります [ 最 終 更 新 日 2015/08/28 16:32:00] 44 / 127

45 5. デザイン 定 義 画 像 項 目 (img 項 目 )を 出 力 する img 項 目 を 画 像 として 表 示 したい 場 合 以 下 のようにします img 項 目 はエントリデータ 中 では 画 像 への URL として 保 存 されている 為 次 のように 記 述 できま す <img src="{データ 項 目 名 }" /> 例 ) <img src="{photo}" /> ここで 次 のように 書 くことはできません <img src="<xsl:value-of select="photo" />" /> 属 性 の 中 に 画 像 の URL を 入 れればいい 訳 ですから 上 記 のように 書 きたくなりますが XML では タグの 途 中 にタグが 出 現 することはできない 為 これはエラーとなります 属 性 の 中 にデータを 埋 め 込 みたい 場 合 そのデータ 名 を"{}"で 囲 えば OK です "{}"を 使 った 書 き 方 は 属 性 の 中 でしか 使 用 できません 例 えば 画 像 をそのまま 表 示 するのではなくリンクとして 表 示 し リンクをクリックしたら 別 ウィンド ウで 画 像 を 表 示 したい 場 合 は 次 のように 書 きます <a href="{データ 項 目 名 }" target="_blank"> 画 像 を 表 示 する!</a> スキーマで alt 属 性 を"True"に 指 定 した 場 合 alt 用 の 文 字 列 を 使 うことができます <img src="{データ 項 目 名 }" alt="{データ 項 目 名 /@alt}"/> 例 ) <img src="{photo}" alt="{photo/@alt}" /> ここで"photo/@alt"という 表 現 が 出 てきましたが これは photo 項 目 のalt 属 性 を 取 得 する とい う XSLT の 表 現 です スキーマの img 項 目 からは alt 属 性 以 外 に width 属 性 や height 属 性 も 取 得 できます <img src="{データ 項 目 名 }" width="{データ 項 目 名 /@width}" height="{データ 項 目 名 /@height}" /> 画 像 ファイルが 存 在 する 時 だけ 画 像 を 表 示 する 等 の 方 法 については データ 値 の 内 容 によって 処 理 を 変 える を 参 照 してください [ 最 終 更 新 日 2015/08/28 16:32:00] 45 / 127

46 5. デザイン 定 義 画 像 項 目 (img 項 目 )を 縮 小 / 拡 大 して 表 示 する(サムネイル 等 ) img 項 目 を 拡 大 / 縮 小 して 表 示 したい 場 合 次 のように 幅 か 高 さを 指 定 します <img src="{データ 項 目 名 }&w= 幅 " /> 又 は <img src="{データ 項 目 名 }&h= 高 さ" /> 例 ) <img src="{photo}&w=240" /> & という 文 字 は そのまま 入 力 してください XML 文 書 中 で & という 文 字 列 を 出 力 したい 場 合 はこのように 書 きます(HTML と 同 じですね) 幅 又 は 高 さを 指 定 すると その 幅 又 は 高 さにピッタリ 収 まるように 拡 大 又 は 縮 小 されて 表 示 され ます 尚 拡 大 / 縮 小 表 示 した 場 合 width や height は 取 得 できません( 拡 大 / 縮 小 前 の 値 が 取 得 さ れます)のでご 注 意 ください サンプルとして サムネイルをクリックすると 元 の 大 きさの 画 像 を 別 ウィンドウで 表 示 するデザイ ン 定 義 の 例 を 示 します <a href="{photo}" target="_blank"><img src="{photo}&w=240" /></a> 簡 単 な 応 用 ですね ところで ここで HTML の img タグの 書 き 方 が <img src="xxx"> ではなく <img src="xxx" /> であることに 注 意 してください 前 述 の 通 り XML では 開 始 タグと 終 了 タグ が 必 ず 対 になってい なければなりません しかし HTML では img タグのように 終 了 タグがないタグも 存 在 する 為 <img src="xxx" /> のように "/>"でタグを 終 わるようにします この 書 き 方 は 他 にも HTML の input タグや br タグも 同 じようにしなくてはいけません 4.6 画 像 キャッシュの 指 定 も 併 せてご 覧 下 さい [ 最 終 更 新 日 2015/08/28 16:32:00] 46 / 127

47 5. デザイン 定 義 ファイル 項 目 (file 項 目 )を 出 力 する file 項 目 を 表 示 したい 場 合 以 下 のようにします file 項 目 はエントリデータ 中 ではファイルへの URL として 保 存 されている 為 次 のように 記 述 でき ます ファイル 項 目 の URL をブラウザ 上 でクリックすると 該 当 ファイルのダウンロードが 開 始 され ます(ダウンロードでなくブラウザにインライン 表 示 したい 場 合 については 後 述 します) <a href="{データ 項 目 名 }" ><xsl:value-of select="データ 項 目 名 /></a> 例 ) <a href="{myfile}" ><xsl:value-of select="myfile/@org" /></a> ここで"myfile/@org"という 表 現 が 出 てきましたが これは myfile 項 目 の org 属 性 を 取 得 する という XSLT の 表 現 です org 属 性 には アップロードした 際 のファイル 名 が 入 っています 他 "myfile/@filesize"でファイルサイズを 取 得 できます 例 ) <xsl:value-of select="myfile/@filesize" />bytes ファイルサイズはバイト 数 で 格 納 されている 為 そのままですと 見 難 い 場 合 があります もしこれを MB 単 位 で 表 示 したい 場 合 は 1024 バイト=1KB 1024KB=1MB という 関 係 を 使 い 1024*1024= で 割 り 結 果 を format-number という XSL の 命 令 文 で 整 形 します 例 ) <xsl:value-of select="format-number(myfile/@filesize div , 0.00 ) " />MB format-number の 二 つ 目 の 値 として 0.00 というものを 指 定 していますが これは 1 桁 目 と 小 数 点 以 下 2 桁 までは 必 ず 表 示 する というフォーマット 指 定 です 結 果 がちょうど 8 でも 8.00 のように 出 力 されます これが 嫌 な 場 合 は 0 の 代 わりに#を 指 定 し 0.## のようにして 下 は 画 像 項 目 でも 使 用 できます ときにはファイル 項 目 を ダウンロードさせずにブラウザにインライン 表 示 させたいことがあります 例 えばPDFファイルをブラウザ 内 に 表 示 させたり(ブラウザが 対 応 している 必 要 があります) 音 楽 や 動 画 ファイルを 再 生 したり といった 用 途 です この 場 合 次 のように URL の 末 尾 に &disp=inline を 付 けてください HTML 中 では & を & と 記 述 しなければいけない 点 にご 注 意 ください 例 1) <a href="{myfile}&disp=inline" ><xsl:value-of select="myfile/@org" /></a> 例 2) <iframe src="{myfile}&disp=inline" height= 450 width= 500 ></iframe> 例 2) <video src="{myfile}&disp=inline"></video> [ 最 終 更 新 日 2015/08/28 16:32:00] 47 / 127