「すぐ使えるCMS」Ver. 6.0 では、デザインテンプレートの仕様が大きく変更されました。このページでは変更内容を説明します。
後方互換性
「すぐ使えるCMS」Ver. 5.x 以前(「すぐ使えるCGI」を含む)のテンプレートは「すぐ使えるCMS」Ver. 6.0 以降のプログラムで問題なく動作します。既に Ver. 5.x 以前のバージョンに合わせたデザインテンプレートをお使いの場合、バージョンアップのためだけにデザインテンプレートを編集しなおす必要はありません。
「すぐ使えるCMS」Ver. 6.0 の変更点
- タグセットの採用とファイルの統合
- 固定画像(ファイル)の表示方法の選択肢増加
タグセットの採用とファイルの統合
「すぐ使えるCMS」Ver. 5.x 以下では、複数のファイルを使って一つの記事ページのデザインを設定していました(詳細下表)。Ver. 6.0 以降では、指定コメントでHTMLタグを囲うことにより、Ver. 5.x までは別ファイル(.txt)に切り出していた部分のHTMLコードを一つの .html ファイルにまとめて指定できます。
タグセットのコメントタグの構成
タグセットは以下の2つのコメントタグで挟まれたHTMLコードです。
<!-- sugu_(タグセット名を表すアルファベット)_begin -->
<!-- sugu_(タグセット名を表すアルファベット)_end -->
「(タグセット名を表すアルファベット)」の部分以外は共通で固定です。1組のタグセットで「タグセット名を表すアルファベット」には同じ文字列が入り、どのテンプレートファイルでどのタグセットが使えるかは決まっています。
同じ名前のタグセットを一つのテンプレートファイルに複数指定できます。同じ名前のタグセットを一つのテンプレートファイルに複数指定する場合、中身のタグは異なっていても同じでも構いません。
タグセットの例
<ul>
<!-- sugu_file_begin -->
<li>
<a href="%_d_%/%_filename_escaped_%" target="_blank" class="filelink %_icon_class_%" title="ファイル名: %_filename_%">%_filetext_%</a>
</li>
<!-- sugu_file_end -->
</ul>
上記コードの <!-- sugu_file_begin --> から <!-- sugu_file_end --> までが一組のタグセットです。この例では、複数ファイルアップロードされた時に繰り返し使われるHTMLコードがタグセットとなっています。
タグセット(Ver. 6.0 以上)とデザインテンプレートファイルの対応
ページとデザインテンプレートファイルの対応、また、従来の分割テンプレートファイルとタグセットの対応は以下の通りです。
記事ページ | メインテンプレートファイル | 分割テンプレートファイル(Ver. 5.x以前) | タグセット(Ver. 6.0以降) | 内容 |
---|---|---|---|---|
詳細ページ | article.html | article_file.txt | file | 複数ファイル欄にアップロードしたファイル(アップロードされた時のみ表示) |
詳細ページ | article.html | article_image_#.txt | image_# | 固定画像(アップロードされた時のみ表示)。#は1から5までの数字。 |
全一覧(目次) | article_list.html | article_list.txt | list_item | 登録記事1件分 |
全一覧(目次) | article_list.html | article_file.txt | list_item 内 file | 複数ファイル |
全一覧(目次) | article_list.html | (Ver. 6.0 で実装) | list_item 内 image_# | 固定画像。#は1から5までの数字。 |
短い一覧(新着情報) | short_list.html | short_list.txt | list_item | 登録記事1件分 |
短い一覧(新着情報) | short_list.html | article_file.txt | list_item 内 file | 添付ファイル |
短い一覧(新着情報) | short_list.html | (Ver. 6.0 で実装) | list_item 内 image_# | 固定画像。#は1から5までの数字。 |
RSSファイル | rss_list.html | rss_list.txt | list_item | 登録記事1件分 |
タグセット内で使えるテンプレート変数は決まっています。詳しくは「テンプレート一覧」(2021年6月ころ公開予定)をご覧下さい。
固定画像(ファイル)の表示方法の選択肢増加
「すぐ使えるCMS」Ver. 5.x 以下では、詳細ページと一覧ページでは、固定画像(ファイル)表示の指定の仕方が異なりました。「すぐ使えるCMS」Ver. 5.x 以下では、詳細ページでは分割したテンプレートファイル article_image_#.txt に画像関連HTMLコードを指定していた一方、全一覧と短い一覧(目次と新着情報)では、画像(ファイル)タグ(例: <img src="%_d_%/%_imagename_escaped_#_%">)を直接デザインテンプレート(article_list.txt や short_list.txt)に指定していました。
Ver. 6.0 以降では、すべてのページのデザインテンプレートファイルでこれらのどちらも使えるようになりました。また、分割テンプレートファイル方式(article_image_#.txt)の改良方式として、タグセット方式も使えます。
方式 | 例 | Ver. 5.x まで | Ver. 6.0 以降 |
---|---|---|---|
分割ファイル | article_image_#.txt | 詳細ページ(article.html) | 詳細ページ(article.html) |
タグセット | <!-- sugu_image_#_begin --> | (対応なし) | 詳細ページ(article.html)、一覧ページ(article_list.html、short_list.html) |
画像(ファイル)タグ | <img src="%_d_%/%_imagename_escaped_#_%"> | 一覧ページ(article_list.html、short_list.html) | 詳細ページ(article.html)、一覧ページ(article_list.html、short_list.html) |
タグセットは分割ファイル方式の後継です。これら2つと画像(ファイル)タグ指定の場合の違いについては、下記ページをご覧下さい。
固定画像(ファイル)の表示方法の選択(Ver. 6.0 以上)