HeartCore
extension 機能概要マニュアル
改訂履歴
改訂日 改訂内容
初版 2011 年 4 月 新規作成
Ver2.0 2013 年 10 月 RSS 設定マニュアル及びパンくず機能設定マニュアルを統合 フォーマット改訂
目次
1. 本文書の目的と対象ライセンス ... - 4 - 1.1. 目的 ... - 4 - 2. 機能概要 ... - 4 - 2.1. extension機能一覧 ... - 4 - 3. hello.jsp（標準） ... - 5 - 4. breadcrumbs.jsp (標準) ... - 5 - 4.1. 関連コンテンツの設定 ... - 6 - 5. calculate.jsp（標準） ... - 10 - 6. calender.jsp （標準） ... - 11 - 7. dayscalender （標準） ... - 12 - 8. date.jsp（標準） ... - 13 - 9. menu.jsp（標準） ... - 14 - 10. rssChannel.jsp（標準） ... - 15 - 10.1. RSS Channelのインポート方法について ... - 16 - 10.2. RSSの設定について ... - 17 - 10.3. RSS確認方法 ... - 18 - 10.4. RSS仕様について ... - 19 - 11. user.jsp（標準） ... - 19 - 12. redirect.jsp（標準） ... - 24 - 13. scheduled.jsp（標準） ... - 24 - 14. sitemap.jsp（標準） ... - 26 - 15. referral.jsp（オプション機能） ... - 27 - 16. database.jsp （Enterprise以上） ... - 27 - 17. 制限事項について ... - 28 -1. 本文書の目的と対象ライセンス
1.1. 目的 本文書は、HeartCore の extension 機能操作方法を説明しております。 ※本資料は「Small Business」エディションは対象外となります。2. 機能概要
2.1. extension機能一覧 webadmin/extension 直下に配置されているファイルをご紹介いたします。 1. hello.jsp（標準）：extension 内に記述された文字列を出力する為のサンプルです。 2. breadcrumbs.jsp (標準)：パンくずを動的に生成するための機能です。 3. calculate.jsp（標準）：計算を行うための機能です。 4. calender.jsp （標準）：カレンダー表示を行うための機能です。 5. dayscalender.jsp (標準)：週表示の無い日付のみのカレンダー機能です。 6. date.jsp（標準）：時間表示を行うための機能です。 7. menu.jsp（標準）：メニューを動的に生成するための機能です。 8. rssChannel.jsp（標準）：RSS 配信等で使用する機能です。 9. user.jsp（標準）：ユーザ情報の出力などを行う機能です。 10. redirect.jsp（標準）：リダイレクトの制御を行うための機能です。 11. scheduled.jsp（標準）：コンテンツの公開予約などの拡張を行うための機能です。 12. sitemap.jsp（標準）：サイトマップ自動生成を行う機能です。 13. referral.jsp（オプション機能）：リファラー機能を用いるための機能です。（LPO 機能）各エディションの大小につきましては次の通りとなります。 【小】 【大】 [ Professional ] < [ Enterprise ]
3. hello.jsp（標準）
例 ： @@@extension:hello(World)@@@ 参考例 1【記述図】 参考例 2【閲覧】4. breadcrumbs.jsp (標準)
例 ： @@@extension:breadcrumbs( > )@@@ パンくずリストを表示させる箇所に記述します。表示には「関連コンテンツ」の設定が必要と なります。 参考例 3【記述図】4.1. 関連コンテンツの設定 Breadcrumbs を利用するには、関連コンテンツの設定が必要となります。 関連コンテンツの設定方法は、下記の２パターンで設定を行います。 ・設定パターン 1： 各コンテンツの「関連コンテンツ」欄の項目にコンテンツから見た「ページトップ」「ページアップ」 「前のページ」「次のページ」などを設定します。 参考例 4 ※上記は、ページ 1・2・3・4 を用意した場合の「ページ 3」の設定となります。 ■ ページトップ このコンテンツのために最高水準のスタートページを定義します ■ ページアップ このコンテンツと関連する最高水準のコンテンツを定義します ■ 前のページ このコンテンツと関連する前に続くコンテンツを定義します ■ 次のページ このコンテンツと関連する次に続くコンテンツを定義します
・設定後、「ページ 3」を表示して確認するとパンくずが出力表示されている事が確認できます。 ※下図の赤枠部分が「@@@extension:breadcrumbs( ＞ )@@@」の記述部分となります。 参考例 5【閲覧】 ・設定パターン 2： ヘッダーメニューの「ウェブサイト構造」を選択して設定を行います。 「ウェブサイト構造」を選択すると、サイト構造がツリー上で表示されます。 ※サイト構造のツリーは、コンテンツのタイトルとコンテンツＩＤでツリー表示されます。 参考例 6 ウェブサイト構造のツリー表示されているコンテンツのタイトルをマウスで選択した状態で、 ドラッグ＆ドロップする事でウェブサイト構造を設定します。 コンテンツのドラッグ中にて、マウスに■が表示されている場合は、ウェブサイト構造に更新や 変更は発生していません。 参考例 7
コンテンツのドラッグ中にて、マウスに■が表示されている場合は、ウェブサイト構造に更新や 変更が発生します。 参考例 8 マウスに■が表示された状態でマウスをドロップするとコンテンツのツリーが更新表示されます。 参考例 9 ウェブサイト構造を変更後に『保存』ボタンをクリックする事で、サイト構造の設定を保存します。 参考例 10
『保存』ボタンをクリックすると、ウェブサイト構造の変更されたコンテンツがリスト 表示されます。 ※下図は、ページ 1・2・3・4 のウェブサイト構造を変更した再の画像となります。 参考例 11 ウェブサイト構造変更後に、再度ウェブサイト構造を確認すると、コンテンツがツリー表示される 事が確認できます。 参考例 12
5. calculate.jsp（標準）
@@@extension:calculate()@@@を利用する事で、数式等が計算されさまざまな形式で値が 出力されます。 例 ： @@@extension:calculate((1+2)*3+4+(5/10)+(0.5))@@@ 参考例 13【記述図】 参考例 14【閲覧】6. calender.jsp （標準）
@@@extension:calendar()関数を利用する事で、カレンダー表示が可能となります。 尚、デフォルトのカレンダーは日本版ではございませんが、日本版への変更は直接「calender.jsp」 ファイルを修正する事で可能となります。 例 ： @@@extension:calendar(date=###date###:id=@@@id@@@:published:pages)@@@ 参考例 15 【記述図】 参考例 16 【閲覧】7. dayscalender （標準）
dayscalender.jsp は v8.1.2 以降のバージョンから追加されたファイルとなります。 @@@extension:dayscalendar()関数を利用する事で、週表示の無いカレンダー表示されますが その他の動作や表示につきましては、calender.jsp と同じ内容となります。 尚、デフォルトのカレンダーは日本版ではございませんが、日本版への変更は直接 「dayscalender.jsp」ファイルを修正する事で可能となります。 例 ： @@@extension:dayscalendar(date=###date###:id=@@@id@@@:published:pages)@@@ 参考例 17【記述図】 参考例 18【閲覧】8. date.jsp（標準）
@@@extension:date()@@@関数を利用する事で、「コンピュータ形式」の日時（YYYY-MM-DD hh:mm:ss）でも、様々な日時フォーマットで出力することが可能となります。 例 ： @@@extension:date(2011-01-01 23:59:59,%Y 年%m 月%d 日)@@@ 参考例 19 【記述図】 参考例 20 【閲覧】9. menu.jsp（標準）
@@@extension:menu()@@@関数を利用する事で、メニューを自動生成する事が可能となります。 表示には「関連コンテンツ」の設定が必要です。 例 ： @@@extension:menu(id=48:levels=2:list=ul:item=li:class=menuitem:selected=menuselec t)@@@ 参考例 21 【記述図】 参考例 22 【閲覧】10. rssChannel.jsp（標準）
@@@extension:rssChannel()@@@関数を利用する事で、RSS 配信が可能となります。 例 ： @@extension:rssChannel(contentgroup=News)@@@
参考例 23 【記述図】
10.1. RSS Channelのインポート方法について 設定＞システム＞データベース＞追加モジュールにて「Add-On - RSS Channel」 「追加モジュールの選択」ボタンを押下します。 参考例 25 参考例 26 押下すると、次のページが表示されますので、タイトル名を変更、または変更せずにそのまま 「追加モジュールのインポート」ボタンを押下するとインポートが開始されます。 参考例 27
インポート完了しますと、コンテンツグループ「なし」に「RSSchannel」というコンテンツの名 前でインポートされます。 参考例 28 10.2. RSSの設定について 「2.追加モジュールのインポート」でインポートしたコンテンツグループ「RSSchannel」に対して 編集します。RSS で配信する対象のコンテンツページを次の通りとします。 参考例 29 次にコンテンツグループ「なし」の「RSS Channel」コンテンツを更新します。 参考例 30
@@@extension:rssChannel(contentgroup=RSS Channel)@@@ contentgroup=（RSS 配信するグループ名を指定します。） ※RSS 配信をする際には配信するコンテンツを指定することが可能です。 「ページグループを指定する方法」と、「データベース名を指定する方法」、「バージョンを指定する 方法」の 3 種類あります。その他の設定記述に関しましては、ユーザガイドをご確認下さい。 10.3. RSS確認方法 確認する際は、「@@@extension:rssChannel(contentgroup=RSS Channel)@@@」指定されている コンテンツに対して、http://domain/xml.jsp?id=XXX でアクセスして下さい。 アクセスすると下記のように表示されます。下記図は FireFox でアクセスした結果となります。 参考例 31
10.4. RSS仕様について HeartCore RSS 機能は RSS2.0 対応となります。RSS1.0、atom 対応ではございません。 また、下記のアクセス方法がございます。 http://127.0.0.1/xml.xxx?id=ID http://127.0.0.1/atom.xxx?id=ID http://127.0.0.1/rss.xxx?id=ID “xml.xxx”、“atom.xxx”、“rss.xxx”でアクセスするのは、HTTP ヘッダの些細な違いを除いては同一の ものとなります。 “xml.xxx”スクリプトは、コンテンツを“application/xml”として識別し、“atom.xxx” スクリプトは “application/atom＋xml”として、“rss.xxx”スクリプトは“application/rss＋xml”として識別します。 http://127.0.0.1/atom.xxx?id=ID でアクセスしても、atom 対応のソースで配信されるわけでは ございません。例えば、atom 対応で配信させる場合は、別途ファイル作成が必要となります。
11. user.jsp（標準）
@@@extension:user()@@@関数を利用する事でログインユーザ情報を抽出する事が可能となります。 【UserGuide より抜粋】 @@@extension:user(username)@@@ 現在ログインしているユーザのユーザ 名が挿入される場所を定義します。 @@@extension:user(name)@@@ 現在ログインしているユーザの名前が 挿入される場所を定義します。 @@@extension:user(email)@@@ 現在ログインしているユーザの E メー ルアドレスが挿入される場所を定義し ます。 @@@extension:user(group)@@@ 現在ログインしているユーザのプライ マリのユーザグループが挿入される場 所を定義します。 @@@extension:user(type)@@@ 現在ログインしているユーザのプライ マリのユーザタイプ挿入される場所を@@@extension:user(types)@@@ 現在ログインしているユーザのその他 のユーザタイプ挿入される場所が定義 します。 @@@extension:user(organizations)@@@ 現在ログインしているユーザの組織が 挿入される場所を定義します。 @@@extension:user(created)@@@ 現在ログインしているユーザの作成日 時を挿入される場所を定義します。 @@@extension:user(updated)@@@ 現在ログインしているユーザの更新日 時が挿入される場所を定義します。 @@@extension:user(activation)@@@ 現在ログインしているユーザのアクテ ィベーション日時が挿入される場所を 定義します。 @@@extension:user(notification)@@@ 現在ログインしているユーザのスケジ ュールされた通知日時が挿入される場 所を定義します。 @@@extension:user(expiration)@@@ 現在ログインしているユーザのスケジ ュールされた失効日時が挿入される場 所を定義します。 @@@extension:user(card_type)@@@ 現在ログインしているユーザのカード タイプが挿入される場所を定義しま す。 @@@extension:user(card_number)@@@ 現在ログインしているユーザのカード 番号が挿入される場所を定義します。 @@@extension:user(card_issuemonth)@@@ 現在ログインしているユーザのカード 発行月が挿入される場所を定義しま す。 @@@extension:user(card_issueyear)@@@ 現在ログインしているユーザのカード 発行年が挿入される場所を定義しま す。 @@@extension:user(card_expirymonth)@@@ 現在ログインしているユーザのカード 失効月が挿入される場所を定義しま す。 @@@extension:user(card_expiryyear)@@@ 現在ログインしているユーザのカード 失効年が挿入される場所を定義しま す。 @@@extension:user(card_name)@@@ 現在ログインしているユーザのカード
@@@extension:user(card_cvc)@@@ 現在ログインしているユーザのカード CVC 番号が挿入される場所を定義しま す。 @@@extension:user(card_issue)@@@ 現在ログインしているユーザのカード 発行番号が挿入される場所を定義しま す。 @@@extension:user(card_postalcode)@@@ 現在ログインしているユーザのカード 郵便番号が挿入される場所を定義しま す。 @@@extension:user(delivery_name)@@@ 現在ログインしているユーザの配送名 が挿入される場所を定義します。 @@@extension:user(delivery_organisation)@@@ 現在ログインしているユーザの配送組 織が挿入される場所を定義します。 @@@extension:user(delivery_address)@@@ 現在ログインしているユーザの配送住 所が挿入される場所を定義します。 @@@extension:user(delivery_postalcode)@@@ 現在ログインしているユーザの配送郵 便番号が挿入される場所を定義しま す。 @@@extension:user(delivery_city)@@@ 現在ログインしているユーザの配送市 が挿入される場所を定義します。 @@@extension:user(delivery_state)@@@ 現在ログインしているユーザの配送都 道府県が挿入される場所を定義しま す。 @@@extension:user(delivery_country)@@@ 現在ログインしているユーザの配送国 が挿入される場所を定義します。 @@@extension:user(delivery_phone)@@@ 現在ログインしているユーザの配送電 話番号される場所を定義します。 @@@extension:user(delivery_fax)@@@ 現在ログインしているユーザの配送フ ァックス番号が挿入される場所を定義 します。 @@@extension:user(delivery_email)@@@ 現在ログインしているユーザの配送 E メールアドレスが挿入される場所を定 義します。 @@@extension:user(delivery_website)@@@ 現在ログインしているユーザの配送 Web サイトが挿入される場所を定義し ます。 @@@extension:user(invoice_name)@@@ 現在ログインしているユーザのインボ
@@@extension:user(invoice_organisation)@@@ 現在ログインしているユーザのインボ イス組織が挿入される場所を定義しま す。 @@@extension:user(invoice_address)@@@ 現在ログインしているユーザのインボ イス住所が挿入される場所を定義しま す。 @@@extension:user(invoice_postalcode)@@@ 現在ログインしているユーザのインボ イス郵便番号が挿入される場所を定義 します。 @@@extension:user(invoice_city)@@@ 現在ログインしているユーザのインボ イス市が挿入される場所を定義しま す。 @@@extension:user(invoice_state)@@@ 現在ログインしているユーザのインボ イス都道府県が挿入される場所を定義 します。 @@@extension:user(invoice_country)@@@ 現在ログインしているユーザのインボ イス国が挿入される場所を定義しま す。 @@@extension:user(invoice_phone)@@@ 現在ログインしているユーザのインボ イス電話番号が挿入される場所を定義 します。 @@@extension:user(invoice_fax)@@@ 現在ログインしているユーザのインボ イスファックス番号が挿入される場所 を定義します。 @@@extension:user(invoice_email@@@ 現在ログインしているユーザのインボ イス E メールアドレスが挿入される場 所を定義します。 @@@extension:user(invoice_website)@@@ 現在ログインしているユーザのインボ イス Web サイトが挿入される場所を定 義します。
参考例 29【記述図】
12. redirect.jsp（標準）
@@@extension:redirect( )@@@の『( )』の中にリダイレクトしたいアドレスを記述します。 例 ： @@@extension:redirect(http://www.xyxon.co.jp)@@@ 参考例 33 上記コンテンツに対してアクセスすると指定 URL にリダイレクトされます。 ※リダイレクトの動作を確認する場合は、管理画面からログアウトした状態で確認します。13. scheduled.jsp（標準）
@@@extension:scheduled()@@@関数を利用する事で、１ページに対し連続での公開スケジュールを 設定することが可能となります。 例 ： １日ごとにコンテンツの内容を切り替える ページを例では３ページ利用します。それぞれの ID を 101、102、103 とします。 @@@extension:scheduled(101=2008-11-20,102=2008-11-20,103=2008-11-22)@@@ 上記のように日付を YYYY-MM-DD、日付と ID を=で結びます。 上記のコンテンツを参照した際に 11 月 20 日であれば ID101 のページを 11 月 21 日であれば ID102 のページを 11 月 22 日以降は ID103 のページを表示し続けます。 また下記のように時間を追加指定することも可能です。 例 2 ： 時間指定を追加する @@@extension:scheduled(101=2008-11-20 12:00,102=2008-11-21 12:00,103=2008-11-22上記が基本となる使用方法ですが応用として下記のような設定も行えます。 応用編 @@@extension:scheduled(101<2008-11-20,102=2008-11-21,103>2008-11-22)@@@ 11 月 20 以前は 101、21 日は 102、22 日以降は 103 を表示します。 下記の使い方も可能です。 @@@extension:scheduled(101=2008-11-20,102=2008-11-21,103=2008-11-22)@@@ @@@extension:scheduled(101<=2008-11-20,102=2008-11-21,103>=2008-11-22)@@@ 当然時間指定もできます。 @@@extension:scheduled(101<2008-11-20 12:00,102>=2008-11-20 12:00)@@@ 特定時間指定も可能です。 @@@extension:scheduled(101<=2008-11-20,102=2008-11-21-2008-11-25,103>=2008-11-26)@@@ 11 月 20 日以前は 101、21 日から 25 日は 102、26 日以降は 103 を表示 複数設定も可能です。 @@@extension:scheduled(101>=2008-12-01,102=>2008-12-02,103>=2008-12-03,104>=2008-12-04,105>=2008-12-05)@@@ 12 月 1 日以降 101、2 日には 101 と 102、3 日には 101 と 102 と 103、4 日には 101 と 102 と 103 と 104、5 日には全部が表示されます。
