     SOY CMS
    ブロック
    http://www.soycms.net/manual/index.php?%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF
    Return to Front Page
    [ トップ ]   [ 編集 | 凍結解除 | 差分 | バックアップ | 添付 | リロード ]   [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]
    最新の17件
    2008-03-11

        * ブロック

    2008-02-18

        * ページの作り方
        * FrontPage
        * SOY CMSの概要

    2007-12-21

        * 標準ページ

    2007-12-18

        * ブログページ

    2007-12-12

        * ラベル
        * エントリー

    2007-11-22

        * サイトの設定

    2007-11-15

        * インストール

    2007-11-14

        * サイト作成時に自動的に作成されるページ

    2007-11-10

        * ログイン

    2007-11-09

        * 標準ページの作り方

    2007-11-08

        * ページ
        * 管理者の設定
        * InterWikiName

    2006-10-21

        * MenuBar

    ブロック †

    ページのテンプレートの中で、どの部分をどのようにエントリーの内容に置き換えるかを決定するのがブロックの役割です。

    ブロックには、全てのページで利用可能なブロックと、ブログページでのみ利用可能なブロックがあります。
    ↑
    目次 †

        * ブロック
              o 目次
              o 全てのページで利用可能なブロック
              o ブログページで利用可能なブロック
                    + エントリーリストブロック
                    + 次ページリンクブロック
                    + 前ページリンクブロック
                    + カテゴリーブロック
                    + カレンダーブロック
                    + アーカイブブロック
                    + 新着コメントブロック
                    + コメントリストブロック
                    + エントリーブロック
                    + コメントフォームブロック
                    + トラックバックリンク
                    + トラックバックリストブロック
                    + 新着エントリーブロック
                    + 新着トラックバックブロック(実装予定)

    ↑
    全てのページで利用可能なブロック †

     <body>
       <div block:id="sampleblock">
         <h1 class="title" cms:id="title">ここがタイトルに書き換わる</h1>

         <h2>関係ない見出し</h2>
         <p id="p_1" cms:id="content">ここが本文に書き換わる</p>
         <p cms:id="more">ここが追記に書き換わる</p>

       </div block:id="sampleblock">
     </body>

    上の書式のブロックは、全てのページで利用可能ですが、ブロック追加時の設定で二種類のブロックに分かれます。

        * エントリー単体ブロック

    ブロックに指定した箇所の中の、cms:idが指定されている箇所を、ブロックで設定する特定のエントリーの内容に置換えます。企業ページであれば企業情報や、ナビゲーションなど、変更する可能性はあるが頻度は高くない情報の書き換えに利用できます。

        * エントリー繰返しブロック

    置換えの内容はエントリー単体ブロックと同じですが、ブロックで設定したラベルのついたエントリーを、ブロックで指定した個数だけ表示します。表示する順番は、エントリー管理でラベルごとに設定できる表示順です。表示順が設定されていない場合、新しいエントリーほど先に表示されます。
    ↑
    ブログページで利用可能なブロック †

    ブログページでだけ利用可能なブロックをブログブロックと呼びます。ブログブロックを設定する場合、block:idではなくb_block:idをブロックの開始位置と終了位置のタグに追加します。b_block:idはブログブロックの種類ごとに決まっており、任意に設定することはできません。また、ブログブロックはテンプレートにb_block:idを追加するだけで機能するので、テンプレート更新後にブロックを追加する必要はありません（ブロックリストには現れません）。
    ↑
    エントリーリストブロック †

        * b_block:id="entry_list"

    エントリーを複数個表示するブロックです。ブログトップページ、アーカイブページで利用します。表示件数の設定はブロックではなく、ブログページの設定で行います。

        * cms:id="title"

    エントリーのタイトルが表示されます。

        * cms:id="create_date"

    エントリーの作成日が表示されます。cms:formatで日付・時刻の書式を指定する必要があります。指定できる日付・時刻の書式はPHPのdate()と同じです。

        * cms:id="content"

    エントリーの「本文」が表示されます。

        * cms:id="more"

    エントリーの「追記」が表示されます。

        * cms:id="more_link"

    エントリーページの追記部分へのリンクが表示されます。必ず<a>タグに設定してください。

        * cms:id="entry_link"

    エントリーページへのリンクが表示されます。必ず<a>タグに設定してください。

    <div b_block:id="entry_list">

       <h1 cms:id="title">タイトル</h1>
       <hr>
       <span cms:id="create_date" cms:format="Y年n月d日">2008年1月24日</span>

       <div cms:id="content">本文</div>

       <a cms:id="more_link">続きを表示</a>
       <a cms:id="entry_link">この記事を読む</a>

       投稿時刻 <span cms:id="create_date" cms:format="h:i">11:22</span>
     　<a cms:id="comment_link">コメント(<span cms:id="comment_count">0</span>)</a>

     　<a cms:id="trackback_link">トラックバック(<span cms:id="trackback_count">0</span>)</a>
    </div b_block:id="entry_list">

    ↑
    次ページリンクブロック †

        * b_block:id="next_link"

    ブログトップページ、アーカイブページで利用します。表示件数を超えるエントリーがある場合、次の表示件数分のページへのリンクが表示されます。必ず<a>タグに設定してください。

    <a b_block:id="next_link">次の１０件へ</a>

    ↑
    前ページリンクブロック †

        * b_block:id="prev_link"

    ブログトップページ、アーカイブページで利用します。表示件数を超えるエントリーがある場合、前の表示件数分のページへのリンクが表示されます。必ず<a>タグに設定してください。

    <a b_block:id="prev_link">前の１０件へ</a>

    ↑
    カテゴリーブロック †

        * b_block:id="category"

    カテゴリブロックは、カテゴリー（カテゴリーとして利用するように設定されているラベル）一覧を表示します。一覧のそれぞれの項目はカテゴリー別アーカイブページへのリンクが生成されるので、必ず<a>タグに設定してください。

    <ul>
    <!-- b_block:id="category" -->

    	<li><a cms:id="category_link">
    			<span cms:id="category_name"></span>(<span cms:id="entry_count">0</span>)
    		</a>

    	</li>
    <!-- /b_block:id="category" -->
    </ul>

    ↑
    カレンダーブロック †

        * cms:plugin="calendar"

    カレンダーブロックはカレンダーを表示します。

    <div cms:plugin="calendar"></div>

    「プラグイン」から「カレンダープラグイン」を有効にしてください。
    ↑
    アーカイブブロック †

        * b_block:id="archive"

    アーカイブブロックは、月別アーカイブページへのリンクになっている月別アーカイブ一覧を表示します。

    cms:formatで表示フォーマットを指定します。Yで年、mで月です。

    cms:id="archive_link"は必ず<a>タグに設定してください。

    <ul>
    <!-- b_block:id="archive" -->

    					<li><a cms:id="archive_link" href="#"><span cms:id="archive_month" cms:format="Y年m月"></span>
    						(<span cms:id="entry_count">948</span>)</a></li>

    <!-- /b_block:id="archive" -->
    </ul>

    ↑
    新着コメントブロック †

        * b_block:id="recent_comment_list"

    新着コメントブロックは、新着コメントの一覧を表示します。

    cms:id="entry_link"は必ず<a>タグに設定してください。

    <ul>
    <!-- b_block:id="recent_comment_list" -->
    <li>
    	<a cms:id="entry_link">
    		<span cms:id="title">コメントのタイトル</span>

    		<span cms:id="entry_title">記事のタイトル</span>
    		<span cms:id="submit_date" cms:format="Y-m-d H:i:s">投稿日時</span>
    	</a>

    </li>
    <!--/b_block:id="recent_comment_list" -->
    </ul>

    ↑
    コメントリストブロック †

        * b_block:id="comment_list"

    コメントリストブロックは、単エントリーページで使用します。そのエントリーに対し投稿されたコメントの一覧を表示します。

    <ul>

    <!-- b_block:id="comment_list" -->
    <li>
    <div cms:id="title">タイトル</div>
    <a cms:id="mail_address">
        <div cms:id="author">名前</div>

    </a>
    <div cms:id="body">本文</div>
    <div cms:id="submit_date">本文</div>
    <div cms:id="url">本文</div>

    </li>
    <!--/b_block:id="comment_list" -->
    </ul>

    ↑
    エントリーブロック †

        * b_block:id="entry"

    エントリーブロックは、単エントリーページで使用します。エントリーの情報が表示されます。

    <div b_block:id="entry">

       <h1 cms:id="title">タイトル</h1>
       <hr>
       <div cms:id="content">本文</div>

       <a cms:id="more_link">続きを表示</a>

       <a cms:id="entry_link">この記事を読む</a>
       <a cms:id="comment_link">コメント(<span cms:id="comment_count">0</span>)</a>

       <a cms:id="trackback_link">コメント(<span cms:id="trackback_count">0</span>)</a>
    </div b_block:id="entry">

    ↑
    コメントフォームブロック †

        * b_block:id="comment_form"

    エントリーブロックは、単エントリーページで使用します。そのページのエントリーに対するコメントを投稿するためのフォームが表示されます。

    必ず<form><input><textarea>タグに設定してください。

    <form b_block:id="comment_form">
    <input cms:id="title">
    <input cms:id="author">
    <input cms:id="mail_address">

    <input cms:id="url">
    <textarea cms:id="body"></textarea>
    <input type="submit" value="投稿" onclick="this.disabled=true;">
    </form>

    ↑
    トラックバックリンク †

        * b_block:id="trackback_link"

    ページのエントリーに対するトラックバック送信先URLを表示します。

    必ず<input>タグに設定してください。

    <input b_block:id="trackback_link">

    ↑
    トラックバックリストブロック †

        * b_block:id="trackback_list"

    トラックバックリストブロックは、単エントリーページで使用します。そのエントリーに対し送信されたトラックバックの一覧を表示します。

    <ul>

    <!-- b_block:id="trackback_list" -->
    <li>
    <div cms:id="title">タイトル</div>
    <div cms:id="url">URL</div>

    <div cms:id="blog_name">ブログ名</div>
    <div cms:id="excerpt">要約</div>
    <div cms:id="submit_date">送信日時</div>
    </li>

    <!--/b_block:id="trackback_list" -->
    </ul>

    ↑
    新着エントリーブロック †

        * b_block:id="recent_entry_list"

    新着エントリーブロックはどこでも使用可能です。最新のエントリーを表示します。

    表示件数はフィードに出力する個数と同じです。

    <ul>
    <!-- b_block:id="recent_entry_list" -->

    <li><a cms:id="entry_link">ああああああ</a></li>
    <!--/b_block:id="recent_entry_list" -->
    </ul>

    ↑
    新着トラックバックブロック(実装予定) †

        * b_block:id="recent_trackback_list"

    新着トラックバックブロックはどこでも使用可能です。最新のトラックバックを表示します。

    <ul>
    <!-- b_block:id="recent_trackback_list" -->
    <li>
    	<span cms:id="title">タイトル</span>

    	<a cms:id="url">ブログへのリンク</a>
    	<a cms:id="entry_link">記事へのリンク</a>
    	<span cms:id="entry_title"></span>

    	<span cms:id="blog_name">ブログ名</span>
    	<span cms:id="excerpt">要約</span>
    	<span cms:id="submit_date" cms:format="Y-m-d H:i;s">送信日時</span>

    </li>
    <!--/b_block:id="recent_trackback_list" -->
    </ul>

    FrontPageへ戻る
    Last-modified: 2008-03-11 (火) 16:09:31 (1d)
    Link: ページの作り方(22d) FrontPage(22d) 標準ページの作り方(124d)
    Site admin: Nippon Institute of Agroinformatics Ltd.

    PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
    Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 5.2.5. HTML convert time: 0.044 sec.