DMM API for Wordpress
ショートコード - ida_show_item
DMM WEBサービスにリクエストして得られた商品情報を一覧表示するショートコードです。
記述方法
以下の設定例は、
サービス:mono(通販)
フロア:book(本・コミック)
取得件数:8件
ソート順:新着
テンプレート配置フォルダ:テーマフォルダ内
テンプレートファイル:item_list.php
としています。
記事本文内などでの記述例
[ida_show_item service="mono" floor="book" hits="8" sort="date" tpl_dir="theme" tpl="item_list.php"]
テーマファイル内での記述例
<?php do_shortcode('[ida_show_item service="mono" floor="book" hits="8" sort="date" tpl_dir="theme" tpl="item_list.php"]'); ?>
テンプレートタグとしての記述例
<?php $param['service']="mono"; $param['floor']="book"; $param['hits']="8"; $param['sort']="date"; $param['tpl_dir']="theme"; $param['tpl']="item_list.php"; ida_show_item($param); ?>
パラメータ
緑色で表記された文字列を変数名として使用してください。
- サービス[service]
- 商品のカテゴリである”サービス”を限定したい場合に設定して下さい。
- フロア[floor]
- 上記の”サービス”に付随する”フロア”を限定したい場合に設定して下さい。設定した”フロア”が上記サービスに関連しない場合は無効となります。
- 取得件数[hits]
- 取得したい商品の件数を指定します。最大100件まで取得することができます。指定しない場合は100件の商品情報が返されます。
- 検索開始位置[offset]
- 商品を取得する先頭の位置を指定します。指定しない場合は1が設定されます。
- ソート順[sort]
- 商品情報の並び順です。
- キーワード[keyword]
- 取得したい商品に関するキーワードを予め設定できます。
- 商品ID[cid]
- 商品を指定するIDです。この値はDMMのWEBサイトで当該商品を直接確認してください。
- 絞りこみ項目[article]
- 特定の絞り込み要素で抽出したいときに使用します。
- 絞り込みID[article_id]
- 上記”絞り込み項目”のIDを指定します。
- 発売日絞り込み[gte_date・lte_date]
- 発売日の範囲を指定できます。
- 在庫絞り込み[mono_stock]
- 在庫の状況で絞り込む場合はに使用します。
- 商品表示テンプレート配置フォルダ[tpl_dir]
- 商品の表示に使用するテンプレートファイルが置かれたフォルダを指定します。
テーマフォルダ内であれば、”theme”を、プラグインフォルダ内の場合は”plugin”を記述します。 - 商品表示テンプレートファイル[tpl]
- 商品の表示に使用するテンプレートファイルを指定します。