「すぐ使えるCMS」Ver. 5.x から Ver. 6.0 のデザインテンプレートの変更

「すぐ使えるCMS」Ver. 6.0 では、デザインテンプレートの仕様が大きく変更されました。このページでは変更内容を説明します。

後方互換性

「すぐ使えるCMS」Ver. 5.x 以前(「すぐ使えるCGI」を含む)のテンプレートは「すぐ使えるCMS」Ver. 6.0 以降のプログラムで問題なく動作します。既に Ver. 5.x 以前のバージョンに合わせたデザインテンプレートをお使いの場合、バージョンアップのためだけにデザインテンプレートを編集しなおす必要はありません。

「すぐ使えるCMS」Ver. 6.0 の変更点

  1. タグセットの採用とファイルの統合
  2. 固定画像(ファイル)の表示方法の選択肢増加

タグセットの採用とファイルの統合

「すぐ使える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 以上)