89 Community Blogs: サンプル・ブログ・ページ

この章では、Community Blogsモジュールによって提供されるデフォルトのブログ・コンポーネントについて説明します。これらのコンポーネントはそのまま使用可能で、サンプル・ブログ・ページをレンダリングします。

この章には次の項が含まれます。

• 第89.1項「サンプル・ブログ・ページの概要」

• 第89.2項「サンプル・ブログ・ページのコンポーネント」

• 第89.3項「次の手順」

89.1 サンプル・ブログ・ページの概要

ブログ・ページは、ブログ・アセット、ブログ作成者アセット、右側のナビゲーション・パネル、ヘッダーおよびフッターによって構成されます。ブログ・ページは、デフォルトのブログ・テンプレート、CSElementおよびSiteEntryアセットによってレンダリングされます(図89-1を参照)。デフォルトでは、すべてのブログ・ページがキャッシュされます(ラッパー・ページを除く)。

FW_RecentBlogsページは、Community Blogsモジュールのメイン・ページです。このページは、FW_RecentBlogsDetailテンプレートによって呼び出されます。

ラッパー・エレメントがサンプル・レイアウト・テンプレート(FW_BlogLayout)を呼び出します。このレイアウトはサンプル・ブログ・ページの全体的な外観を定義し、FW_BlogContainerテンプレートを呼び出します。このテンプレートが、ページとアセット・タイプBlog CategoryおよびBlog Asset用の対応する詳細なテンプレートを呼び出します。

ラッパーのパラメータ(ページに一度に表示するブログの数など)は、デフォルトのSiteEntryアセットによって定義されます。Community BlogsモジュールのSiteEntryアセットは、FW_Blogwrapper CSElementによってレンダリングされます。

図89-1 サンプル・ホーム・ページ

「図89-1 サンプル・ホーム・ページ」の説明

89.2 サンプル・ブログ・ページのコンポーネント

この項では、デフォルトのブログ・テンプレート、CSElementおよびSiteEntryアセットについて説明します。これらのコンポーネントは、サンプル・ブログ・ページをレンダリングするデフォルトのパラメータおよびコードによってあらかじめ構成されています。

WebCenter Sitesは、サンプル・ページ名に関連付けられたコードを実行することによってサンプル・ブログ・ページをレンダリングします。Webサイトの外観に適した独自のブログ・ページを作成するため、このサンプル・ブログ・ページを参照用として利用できます。

注意: ページ・アセットはサイト間で共有できません。各種のCMサイトでCommunity Blogsモジュールを使用するには、それらのサイト用の新しいブログ・ページを作成する必要があります。他のすべてのコンポーネントは共有できます。サイトのブログ機能を完全にカスタマイズするには、サイトのコンポーネントに必要なブログ・コードを追加し、それらを要件に適合するように再構成します。ページを作成する方法については、第90章「Community Blogs: ブログ・コンポーネントのカスタマイズ」の第90.2.1項「ブログ・ページの作成」を参照してください。

サンプル・ブログ・ページはWebCenter Sitesのツリーの中にあります(「サイト・プラン」タブ→「未配置ページ」を選択します)。次に、サンプル・ページについて説明します。

• FW_RecentBlogs: このページはCommunity Blogsモジュールのサンプル・ホーム・ページであり、最近公開されたすべてのブログが表示されます。

• FW_AuthorBlogs: このページには、選択した作成者によって投稿されたブログが表示されます。右側のナビゲーション・パネルの「作成者」セクションで作成者の名前をクリックすると、ブログがレンダリングされます。

• FW_ArchiveBlogs: このページには、指定された月に投稿されたすべてのブログが表示されます。右側のナビゲーション・パネルの「アーカイブ」セクションで月の名前をクリックすると、このページにブログがレンダリングされます。

これらのページは、FW_BlogLayoutテンプレートによってレンダリングされます。ただし、ページ間を移動するには、最初にサンプル・ホーム・ページ(FW_RecentBlogs)を表示してください。このページを表示することによって、他のサンプル・ブログ・ページで必要なパラメータが初期化されるためです。

サンプル・ブログ・ページのコンポーネントの詳細は、次のトピックを参照してください。

• 第89.2.1項「デフォルトのブログのCSElement」

• 第89.2.2項「デフォルトのブログのSiteEntryアセット」

• 第89.2.3項「デフォルトのブログのテンプレート」

• 第89.2.4項「ブログ・アーカイブの「詳細」リンク機能」

89.2.1 デフォルトのブログのCSElement

Community Blogsモジュールは、デフォルトのCSElementsを提供します。これには、サンプル・ブログ・ページを構築するための再利用可能なコード(XMLまたはJSPおよびJavaの形式)が格納されています。たとえば、3つのサンプル・ブログ・ページすべてに「共有」リンクが表示されているため、リンク機能の完全なコードを含む、CSElementが作成されています(FW_Blogs/Utils/AddThisWidget)。

表89-1に、Community BlogsモジュールのデフォルトのCSElementを一覧表示して説明します。

表89-1 デフォルトのブログのCSElement

名前およびElementCatalogエントリ	説明
FW_BlogWrapper	Community Blogsモジュールのサンプル・ページのラッパー。
FW_Blogs/Utils/AddThisWidget	「共有」リンクをレンダリングします。訪問者はこのリンクを使用してWebサイト間でブログを共有できます。
FW_Blogs/Utils/CreateArchiveLink	FW_ArchiveBlogsテンプレートを呼び出すリンクをレンダリングします。
FW_Blogs/Utils/CreateAuthorLink	FW_AuthorBlogsDetailテンプレートを呼び出すリンクをレンダリングします。
FW_Blogs/Utils/GetAssetData	ブログ・アセットのデータを取得します。たとえば、このエレメントはブログ・アセットが親から継承した属性を取得できます。
FW_Blogs/Utils/GetAuthor	指定したブログ作成者の作成者アセットから完全な名前とプロファイル・イメージを取得します(存在する場合)。
FW_Blogs/Utils/GetBlogAuthors	作成者のリストを取得し、それぞれの作成者へのリンクを提供します。
FW_Blogs/Utils/GetBlogCategories	カテゴリのリストを取得し、それぞれのカテゴリへのリンクを提供します。
FW_Blogs/Utils/GetBlogsByMonth	月のリストを取得し、それぞれの月へのリンクを提供します。
FW_Blogs/Utils/GetChildren	特定のブログの親の子を取得します。
FW_Blogs/Utils/GetExternalURL	ブログ・アセットの外部URLを作成します。そのタイトルとサマリーは、RSSフィードでリストされます。デフォルトでは、このエレメントはローカルのWebCenter SitesのURLを作成します。URLを変更するには、このエレメントをカスタマイズする必要があります。第90.3項「RSSフィードのURLのカスタマイズ」を参照してください。
FW_Blogs/Utils/GetRecentBlogs	最近公開されたブログのリストを取得し、それらの詳細ページへのリンクを提供します。

89.2.2 デフォルトのブログのSiteEntryアセット

Community BlogsモジュールのSiteEntryアセットはページレットを表し、サンプル・ページのラッパーを生成するルート・エレメントであるFW_Wrapper CSElementに関連付けられています。Community BlogsモジュールのSiteEntryアセットによって、blogsperpageページレット・パラメータが指定されます。これは、ページに一度に表示可能なブログの数を定義します。

表89-2は、FW_BlogWrapper SiteEntryアセットのデフォルトのページレット・パラメータを示しています。

表89-2 FW_BlogWrapper SiteEntryアセットのページレット・パラメータ

ページレット・パラメータ	値
blogsperpage	5
rendermode	live
seid	この値は自動的に生成されます。
site	Community Blogsモジュールをインストールしたサイトの名前。

1ページ当たりのブログ数

1ページ当たりのブログ数は、FW_BlogWrapper SiteEntryアセットからblogsperpageパラメータとして渡されます。何も渡されない場合、1ページ当たりのブログ数のデフォルト値として10が指定されます。サイトのブログ・ページに一度に表示可能なブログ数を指定する方法については、第90.2.4項「サイトのSiteEntryアセットへのブログ・パラメータの追加」を参照してください。

89.2.3 デフォルトのブログのテンプレート

Community Blogsモジュールは、サンプル・ブログ・ページをレンダリングするデフォルト・テンプレートを提供します。リンクをクリックすると対応するテンプレートが呼び出され、コンテンツがレンダリングされます。たとえば、ブログ投稿の「詳細」リンクをクリックすると、関連付けられた詳細テンプレートによって投稿の完全なコンテンツがレンダリングされます。

サイトのページ・レイアウトは、独自のヘッダー、フッター、ナビゲーションおよびコンテンツ・コンテナによってレンダリングされます。Webサイトにブログ・ページを追加するには、Community Blogsモジュールのデフォルト・テンプレート内に指定されている必要なコードをサイトのテンプレートに追加します。表89-3に、Community Blogsモジュールのデフォルト・テンプレートを一覧表示して説明します。

表89-3 デフォルトのブログのテンプレート

テンプレート	デフォルトの名前	アセット・タイプ	説明
詳細	FW_ArchiveBlogsDetail	ページ	「ブログ・アーカイブ」ページにリストされるブログのレンダリングに使用されます。
詳細	FW_AuthorBlogsDetail	ページ	「この作成者によるブログ」ページにリストされるブログのレンダリングに使用されます。
詳細	FW_BlogAssetDetail	FW_BlogAsset	選択したブログの完全なコンテンツのレンダリングに使用されます。
詳細	FW_BlogCategoryDetail	FW_BlogParent	右側のナビゲーション・パネルの「カテゴリ」セクションにリストされるブログ・カテゴリのレンダリングに使用されます。
詳細	FW_RecentBlogsDetail	ページ	最近公開されたすべてのブログをリストするブログ・ホーム・ページのレンダリングに使用されます。
コンテナ	FW_BlogContainer	ページ	詳細テンプレートのコールに使用されます。
コンテナ	FW_BlogContainer	FW_BlogParent	詳細テンプレートのコールに使用されます。
コンテナ	FW_BlogContainer	FW_BlogAsset	詳細テンプレートのコールに使用されます。
ブログ・レイアウト	FW_BlogLayout	なし	サンプル・ブログ・ページのメイン・レイアウトのレンダリングに使用されます。
ブログRSS	FW_BlogRSS	なし	(型なし)FW_BlogSummaryRSSのレンダリングに使用されます。
ブログRSS	FW_BlogSummaryRSS	FW_BlogAsset	(型付き)WebページにRSSフィードをレンダリングします。FW_BlogRSSによって呼び出されます。
サマリー	FW_BlogSummary	FW_BlogAsset	各ブログ・アセットのサマリーを一覧表示するために使用されます。ブログ・アセットのサマリーには、タイトル、概要、作成者の完全な名前とプロファイル・イメージ、日付および時刻が含まれます。
リンク	FW_Link	FW_BlogParent	ブログ・カテゴリのリンクのレンダリングに使用されます。
リンク	FW_Link	FW_BlogAsset	ブログのリンクのレンダリングに使用されます。
ナビゲーション	FW_Nav	FW_BlogParent	各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。
ナビゲーション	FW_Nav	FW_BlogAsset	各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。
ナビゲーション	FW_Nav	なし	各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。
ナビゲーション	FW_Nav	ページ	各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。

89.2.4 ブログ・アーカイブの「詳細」リンク機能

右側のナビゲーション・パネルの「アーカイブ」セクションの隣にある「詳細」リンクは、「アーカイブ」ページに関連する追加データをフェッチするために使用されます。デフォルトでは、「アーカイブ」ページには過去12か月のブログがリストされます。「詳細」リンクを複数回クリックすると、1回のクリックごとにさらに12か月分のブログ・データが取得されます。

図blog_more_link.pngの説明

「詳細」リンクは、Community Blogsモジュールのデフォルト・レイアウト・テンプレート内にコーディングされています。レイアウト・テンプレートのコードの詳細は、第90章「Community Blogs: ブログ・コンポーネントのカスタマイズ」の第90.2.2項「ブログ・コードの追加」を参照してください。

89.3 次の手順

ガイドのこの項では、ここまで、Blogフレックス・ファミリ、およびサンプル・ブログ・ページを構成するデフォルトのコンポーネントについて説明してきました。以降の各章では、その手順について説明します。第90章「Community Blogs: ブログ・コンポーネントのカスタマイズ」には、開発者向けの情報が記載されており、カスタム・ページにブログ機能を追加するための手順とコードについて説明しています。『Oracle Fusion Middleware WebCenter Sites管理者ガイド』には、管理者向けの情報が記載されており、コンテンツ・プロバイダ用のブログ・アセット・タイプを有効にする方法について説明しています。『Oracle Fusion Middleware WebCenter Sitesユーザーズ・ガイド』には、データ・モデルのテスト、およびブログ・アセットの作成と公開に関する情報が記載されています。