include_blogs、exclude_blogs、blog_ids、blog_id モディファイア
このモディファイアは、テンプレートタグの対象として、読み込むブログ、読み込まないブログを指定します。以下のテンプレートタグで指定可能です。
- MTEntries
- MTEntryAssets
- MTCategories
- MTPages
- MTFolders
- MTTags
- MTComments
- MTAssets
- MTAuthors
- MTAuthorCommentResponses
- MTAuthorComments
- MTBlogs
- MTBlogPingCount
- MTBlogCategoryCount
- MTBlogCommentCount
- MTBlogEntryCount
- MTBlogPageCount
- blog_ids="all | children | siblings | ID"
- include_blogs="all | children | siblings | ID"
-
複数のブログを対象にできます。ブログ ID を列記 (カンマ区切り) して、対象のブログを指定します。all を指定すると、PowerCMS のすべてのブログを対象にします。 children および siblings を指定すると、そのブログが属するウェブサイト内のブログを対象にします。children はウェブサイトのコンテキストでウェブサイト内のブログを対象にし、siblings は、ブログのコンテキストで同一ウェブサイト内のブログを対象にします。include_with_website="1" を同時に指定すると、ブログに加えて所属するウェブサイトを対象にします。
- exclude_blogs="ID | children | siblings"
-
除外するブログを指定します。ブログ ID を列記 (カンマ区切り) します。include_blogs と exclude_blogs は同時に指定できます。以下の例は、ブログ ID が 2 と 4 のブログを除いて、子ブログから記事を集めて表示します。
<mt:Entries include_blogs="children" exclude_blogs="2,4" category="ニュース"> <$mt:Include module="記事の概要"$> </mt:Entries>
blog_id は、他のブログからテンプレートモジュールを読み込むときに利用します。
- blog_id="ID"
- 読み込むブログを指定します。テンプレートモジュールを読み込む場合、自ブログ以外のブログからモジュールを読み込むことが可能です。テンプレートモジュールが含まれているブログの ID を指定します。
blog_id モディファイアを利用できるテンプレートタグには、以下のものがあります。
include_websites、exclude_websites、site_ids モディファイア
このモディファイアは、include_blogs、exclude_blogs、blog_ids、blog_id のウェブサイト版です。ウェブサイトが対象となりますが、それ以外の挙動は同じです。
- include_websites="all | ID"
- 読み込むウェブサイトを指定します。all の場合は、すべてのウェブサイトを対象とします。また、ウェブサイト ID を列記 (カンマ区切り) すると、指定したウェブサイトのみを対象とします。
- site_ids="all | ID"
- include_websites と同様に動作します。
- exclude_websites="ID"
- 除外するウェブサイトを指定します。ウェブサイト ID を列記 (カンマ区切り) します。include_websites と exclude_websites は同時に指定できます。
include_websites の使用例
<h2>全ウェブサイトの一覧</h2>
<ul>
<MTWebsites include_websites="all">
<li><a href="<$mt:WebsiteURL$>"><$mt:WebsiteName$></a> <span class="count">[<$mt:WebsitePageCount$> pages]</span></li>
</MTWebsites>
</ul>
exclude_websites の使用例
<h2>サイト ID が 2 と 4 以外のウェブサイトの一覧</h2>
<ul>
<MTWebsites exclude_websites="2,4">
<li><a href="<$mt:WebsiteURL$>"><$mt:WebsiteName$></a> <span class="count">[<$mt:WebsitePageCount$> pages]</span></li>
</MTWebsites>
</ul>
MTMultiBlog タグ
MTMultiBlog タグも同様に、複数のブログの情報を表示します。
MTMultiBlog での、include_blogs および exclude_blogs モディファイアの指定は、プラグインの設定としても指定できます。
MTMultiBlog タグは、include_blogs、exclude_blogs モディファイアに加えて、以下のモディファイアを利用できます。
- mode
- コンテンツを表示する順番を指定します。loop を指定すると、複数のブログの情報をブログ単位にまとめて表示します。context を指定すると、ブログの情報を全体でソートして表示します。
MTMultiBlog タグは、以下のように使用します。
<mt:MultiBlog mode="loop">
<mt:Entries>
<mt:EntriesHeader>
<h3><mt:BlogName /></h3>
<ul>
</mt:EntriesHeader>
<li><a href="<mt:EntryPermalink />"><mt:EntryTitle /></a> (<mt:EntryDate />)</li>
<mt:EntriesFooter></ul></mt:EntriesFooter>
</mt:Entries>
</mt:MultiBlog>
ローカルブログの利用
MultiBlogタグで、ブログのコンテンツをアグリゲーションするときに、MultiBlogを利用するブログ (ローカルブログ) を対象にできます。mt:MultiBlog ブロックタグ内で、一時的にローカルブログの内容を表示するには、mt:MultiBlogLocalBlog ブロックタグを利用します。
<mt:MultiBlog mode="loop">
<mt:Entries>
<mt:EntriesHeader>
<mt:MultiBlogLocalBlog>
<h3><$mt:BlogName$></h3>
<p><$mt:BlogDescription$></p>
</mt:MultiBlogLocalBlog>
<h3><$mt:BlogName$></h3>
<ul>
</mt:EntriesHeader>
<li><a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a> (<$mt:EntryDate$>)</li>
<mt:EntriesFooter></ul></mt:EntriesFooter>
</mt:Entries>
</mt:MultiBlog>
また、mt:MultiBlog ブロックタグ内で、ローカルブログかどうかを判断するには、mt:MultiBlogLocalBlog コンディショナルタグを、次のように記述します。
<mt:MultiBlog mode="loop">
<mt:Entries>
<mt:EntriesHeader>
<h3><$mt:BlogName$></h3>
<mt:MultiBlogIfLocalBlog>
<p>このブログはローカルブログです。</p>
</mt:MultiBlogIfLocalBlog>
<ul>
</mt:EntriesHeader>
<li><a href="<$mt:EntryPermalink$>"><$mt:EntryTitle$></a> (<$mt:EntryDate$>)</li>
<mt:EntriesFooter></ul></mt:EntriesFooter>
</mt:Entries>
</mt:MultiBlog>