この章では、Community Blogsモジュールによって提供されるデフォルトのブログ・コンポーネントについて説明します。これらのコンポーネントはそのまま使用可能で、サンプル・ブログ・ページをレンダリングします。
この章には次の項が含まれます。
ブログ・ページは、ブログ・アセット、ブログ作成者アセット、右側のナビゲーション・パネル、ヘッダーおよびフッターによって構成されます。ブログ・ページは、デフォルトのブログ・テンプレート、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
によってレンダリングされます。
この項では、デフォルトのブログ・テンプレート、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
)を表示してください。このページを表示することによって、他のサンプル・ブログ・ページで必要なパラメータが初期化されるためです。
サンプル・ブログ・ページのコンポーネントの詳細は、次のトピックを参照してください。
Community Blogsモジュールは、デフォルトのCSElementsを提供します。これには、サンプル・ブログ・ページを構築するための再利用可能なコード(XMLまたはJSPおよびJavaの形式)が格納されています。たとえば、3つのサンプル・ブログ・ページすべてに「共有」リンクが表示されているため、リンク機能の完全なコードを含む、CSElementが作成されています(FW_Blogs/Utils/AddThisWidget
)。
表89-1に、Community BlogsモジュールのデフォルトのCSElementを一覧表示して説明します。
表89-1 デフォルトのブログのCSElement
名前およびElementCatalogエントリ | 説明 |
---|---|
|
Community Blogsモジュールのサンプル・ページのラッパー。 |
|
「共有」リンクをレンダリングします。訪問者はこのリンクを使用してWebサイト間でブログを共有できます。 |
|
|
|
|
|
ブログ・アセットのデータを取得します。たとえば、このエレメントはブログ・アセットが親から継承した属性を取得できます。 |
|
指定したブログ作成者の作成者アセットから完全な名前とプロファイル・イメージを取得します(存在する場合)。 |
|
作成者のリストを取得し、それぞれの作成者へのリンクを提供します。 |
|
カテゴリのリストを取得し、それぞれのカテゴリへのリンクを提供します。 |
|
月のリストを取得し、それぞれの月へのリンクを提供します。 |
|
特定のブログの親の子を取得します。 |
|
ブログ・アセットの外部URLを作成します。そのタイトルとサマリーは、RSSフィードでリストされます。デフォルトでは、このエレメントはローカルのWebCenter SitesのURLを作成します。URLを変更するには、このエレメントをカスタマイズする必要があります。第90.3項「RSSフィードのURLのカスタマイズ」を参照してください。 |
|
最近公開されたブログのリストを取得し、それらの詳細ページへのリンクを提供します。 |
Community BlogsモジュールのSiteEntryアセットはページレットを表し、サンプル・ページのラッパーを生成するルート・エレメントであるFW_Wrapper
CSElementに関連付けられています。Community BlogsモジュールのSiteEntryアセットによって、blogsperpage
ページレット・パラメータが指定されます。これは、ページに一度に表示可能なブログの数を定義します。
表89-2は、FW_BlogWrapper
SiteEntryアセットのデフォルトのページレット・パラメータを示しています。
表89-2 FW_BlogWrapper SiteEntryアセットのページレット・パラメータ
ページレット・パラメータ | 値 |
---|---|
|
|
|
|
|
この値は自動的に生成されます。 |
|
Community Blogsモジュールをインストールしたサイトの名前。 |
1ページ当たりのブログ数
1ページ当たりのブログ数は、FW_BlogWrapper
SiteEntryアセットからblogsperpage
パラメータとして渡されます。何も渡されない場合、1ページ当たりのブログ数のデフォルト値として10
が指定されます。サイトのブログ・ページに一度に表示可能なブログ数を指定する方法については、第90.2.4項「サイトのSiteEntryアセットへのブログ・パラメータの追加」を参照してください。
Community Blogsモジュールは、サンプル・ブログ・ページをレンダリングするデフォルト・テンプレートを提供します。リンクをクリックすると対応するテンプレートが呼び出され、コンテンツがレンダリングされます。たとえば、ブログ投稿の「詳細」リンクをクリックすると、関連付けられた詳細テンプレートによって投稿の完全なコンテンツがレンダリングされます。
サイトのページ・レイアウトは、独自のヘッダー、フッター、ナビゲーションおよびコンテンツ・コンテナによってレンダリングされます。Webサイトにブログ・ページを追加するには、Community Blogsモジュールのデフォルト・テンプレート内に指定されている必要なコードをサイトのテンプレートに追加します。表89-3に、Community Blogsモジュールのデフォルト・テンプレートを一覧表示して説明します。
表89-3 デフォルトのブログのテンプレート
テンプレート | デフォルトの名前 | アセット・タイプ | 説明 |
---|---|---|---|
詳細 |
|
ページ |
「ブログ・アーカイブ」ページにリストされるブログのレンダリングに使用されます。 |
詳細 |
|
ページ |
「この作成者によるブログ」ページにリストされるブログのレンダリングに使用されます。 |
詳細 |
|
|
選択したブログの完全なコンテンツのレンダリングに使用されます。 |
詳細 |
|
|
右側のナビゲーション・パネルの「カテゴリ」セクションにリストされるブログ・カテゴリのレンダリングに使用されます。 |
詳細 |
|
ページ |
最近公開されたすべてのブログをリストするブログ・ホーム・ページのレンダリングに使用されます。 |
コンテナ |
|
ページ |
詳細テンプレートのコールに使用されます。 |
コンテナ |
|
|
詳細テンプレートのコールに使用されます。 |
コンテナ |
|
|
詳細テンプレートのコールに使用されます。 |
ブログ・レイアウト |
|
なし |
サンプル・ブログ・ページのメイン・レイアウトのレンダリングに使用されます。 |
ブログRSS |
|
なし |
(型なし) |
ブログRSS |
|
|
(型付き)WebページにRSSフィードをレンダリングします。 |
サマリー |
|
|
各ブログ・アセットのサマリーを一覧表示するために使用されます。ブログ・アセットのサマリーには、タイトル、概要、作成者の完全な名前とプロファイル・イメージ、日付および時刻が含まれます。 |
リンク |
|
|
ブログ・カテゴリのリンクのレンダリングに使用されます。 |
リンク |
|
|
ブログのリンクのレンダリングに使用されます。 |
ナビゲーション |
|
|
各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。 |
ナビゲーション |
|
|
各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。 |
ナビゲーション |
|
なし |
各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。 |
ナビゲーション |
|
ページ |
各詳細テンプレートには、すべてのエレメント(最近の投稿、カテゴリ、作成者およびアーカイブ)を内部的に呼び出すナビゲーション・リンクがあります。 |
右側のナビゲーション・パネルの「アーカイブ」セクションの隣にある「詳細」リンクは、「アーカイブ」ページに関連する追加データをフェッチするために使用されます。デフォルトでは、「アーカイブ」ページには過去12か月のブログがリストされます。「詳細」リンクを複数回クリックすると、1回のクリックごとにさらに12か月分のブログ・データが取得されます。
「詳細」リンクは、Community Blogsモジュールのデフォルト・レイアウト・テンプレート内にコーディングされています。レイアウト・テンプレートのコードの詳細は、第90章「Community Blogs: ブログ・コンポーネントのカスタマイズ」の第90.2.2項「ブログ・コードの追加」を参照してください。
ガイドのこの項では、ここまで、Blog
フレックス・ファミリ、およびサンプル・ブログ・ページを構成するデフォルトのコンポーネントについて説明してきました。以降の各章では、その手順について説明します。第90章「Community Blogs: ブログ・コンポーネントのカスタマイズ」には、開発者向けの情報が記載されており、カスタム・ページにブログ機能を追加するための手順とコードについて説明しています。『Oracle Fusion Middleware WebCenter Sites管理者ガイド』には、管理者向けの情報が記載されており、コンテンツ・プロバイダ用のブログ・アセット・タイプを有効にする方法について説明しています。『Oracle Fusion Middleware WebCenter Sitesユーザーズ・ガイド』には、データ・モデルのテスト、およびブログ・アセットの作成と公開に関する情報が記載されています。