CS-Cart 注文単位でのメッセージ送受信機能

コメントとレビュー」アドオン導入時、注文に関する「メッセージの送受信機能」が利用できるようになる。
参照 http://manual.cs-cart.jp/?page_id=431 (中段)

管理画面 注文内容の確認>アドオンタブ>コメントとレビュー >メッセージ項目を有効に。
(注文単位なので、注文ごとにメッセージ機能を有効にする必要がある。)

アドオンタブの右側にメッセージタブが現れるのでクリック。以降、メッセージ送信と閲覧はこの画面で行う。

管理側
130802-0002
130802-0003

ショップフロントでは、マイアカウント>注文 から個々の注文に入ってメッセージタブの中でやり取りする。

ショップフロント
130802-0005

履歴は時系列で管理画面、ショップフロントのマイページで確認可能。
また、メッセージへの返信機能はないため毎回新規メッセージを送信する形をとる。

メッセージ内容はメールでも送信される。

CS-Cart インストールしてまず行うべき設定

CS-Cart初期設定

基本的にはオンラインマニュアルを見ればほぼ書いてある。
が、一通りの設定すべき項目をまとめて記述しておく。

基本設定

  • 会社概要 > 全部
  • Eメール > 全部
  • 全般 > デフォルト住所

一般設定

  • アドオン > 日本語版アドオン > Eメール > SMTPサーバーのポート番号

デザイン

  • ロケーションタブ「トップページ」の歯車アイコンクリック > 「ページタイトル」
    (他のロケーションも必要に応じて設定。トップページ以外のカテゴリ、商品、ページの個々のコンテンツでも指定可能)

支払い方法
配送方法

  • 必要に応じて。

 

CS-Cartはインストール時の設定項目は少なめ。その代わりインストール後に設定する項目は多め。
上記の設定項目は最低限の項目であり、利用機能が多ければ当然のことながら設定項目は相応に増える。

いずれ「目的別設定マニュアル」も作る必要があると感じている。

CS-Cart用アドオン いくつか出来上がってきてます

ひとまず速報的に。

  • ショップ側ソート順拡張アドオン:ショップ側商品一覧の「ソート順」に「登録日順」を追加する
  • 詳細検索結果の拡張アドオン:新着商品、全商品を詳細検索の検索結果として一覧表示する
  • 管理側受注一覧検索拡張アドオン:受注一覧の詳細検索に「支払方法」を追加する
  • 受注商品のソート順指定アドオン:納品書や配送表等で受注商品の並び順をコントロールする

個々のネーミングは未定です。。

リリースタイミングも未定です。

先日告知した「日付オプション追加アドオンの機能追加」と同時にリリースしようかなと思ってます。

CS-Cart 日付オプション追加アドオンの拡張

先日リリースした日付オプション追加アドオンですが、必要に迫られていくつか機能拡張しました。

基本機能は下記の通りです。

  • オプションに日付を追加
  • 入力にカレンダーからの選択機能を追加
  • 携帯対応(通常のテキストフィールド)

これに下記の機能を追加しました。

  • 入力文字列の正規表現バリデート(デフォルトで持っている機能を当該アドオンでも利用するようにしただけですが。)
  • 特定の日付指定に対応(カンマ区切りで複数指定可 ex 2012/03/15,2012/03/30)
  • 日付範囲の指定に対応(入力可能な日付範囲を指定 ex 2012/04/01%%2012/05/26)
  • 当日より前の日付の指定禁止に対応(当日以降の日付選択のみに)
  • 携帯アドオンに完全対応(日付をセレクトボックスで生成 指定日も範囲も当日以降の日付表示も対応)

指定範囲を外れた入力に対してはPHP側でチェックします。
正規表現をうまく使えばデフォルトのバリデーションでチェックできます。
(上記画像の正規表現項目に設定してあるのは日付フォーマットのチェック用です)

これらの設定は商品の編集画面のオプションタブで行います。
携帯アドオンをご利用の場合には携帯用言語に切り替えてそちらでも設定する必要がありますので注意が必要です。

性質上「特定の日付指定」と「日付範囲の指定」は排他関係にありますが、それぞれの設定項目の入力制限は実装していませんので設定時にはどちらか片方のみにするようにしてください。(アップデートのリリース時には対応するかもしれませんが未定です)

このアドオンは某サイトのチケット販売でご利用頂いています。
(公開が可能であればご紹介させていただきますが現段階では導入サイトは非公開です)

ちなみに、CS-Cartでは jQuery UI のDatepicker が採用されています。

CS-Cart アドオンの構成

まず、アドオンには決められた作法があります。

ディレクトリ構成、ファイル構成、それらの名称が下記のように定められています。

 

ディレクトリ構成

/addons/[アドオン名]
アドオンのPHPファイルを格納するディレクトリ

/var/skins_repository/base/customer/addons/[アドオン名]
ショップフロント側で使用するアドオン用スキンファイルを格納するディレクトリ

/var/skins_repository/base/admin/addons/[アドオン名]
管理者用パネル側で使用するアドオン用スキンファイルを格納するディレクトリ

/var/skins_repository/base/mail/addons/[アドオン名]
アドオン用Eメールテンプレートを格納するディレクトリ

※ /addons/[アドオン名] 以外のディレクトリはアドオンの構成上必要な場合のみ作成(下位階層も同様)

ファイル構成

/addons/[アドオン名]のディレクトリに配置するファイルは下記の通り。

addon.xml
アドオンの設定ファイル。アドオンのインストールやアンインストールに必要。

func.php
アドオンのコントローラー内で使用する関数を定義するファイル。

init.php
アドオンで使用するフックを登録するファイル。

config.php
アドオンで使用する定数や各種設定値を登録するファイル。

/controllers
アドオンで使用するコントローラーおよびCS-Cart標準コントローラーのプレコントローラーおよびポストコントローラーを格納するディレクトリ。

/schemas
管理者用パネル内のメニューや管理者に付与する権限など、既存のスキーマを拡張するファイルを格納するディレクトリ。

 

全てのアドオンは上記のような構成で成り立っています。

上記のディレクトリ構成を見ると分かりますが、/var/skins_repository/以下に置くディレクトリの下位階層について触れていません。(テンプレートでの表示側ですね)

これらは必要に応じてと書いていますが、おおざっぱに言うとCS-Cart本体のディレクトリ構成に準じた命名規則と配置で設置します。
admin側、customer側、mail以下ではその構成が異なりますが多くのアドオンは下記のようなディレクトリを持っています。
(一部CS-Cart本体に無いディレクトリ名を使っている物もあります。が理由が無い限りCS-Cart本体のディレクトリ構成に則った方が良いと思います。)

/var/skins_repository/base/admin/addons/[アドオン名]以下

  • common_templates
  • hooks
  • views

/var/skins_repository/base/customer/addons/[アドオン名]以下

  • blocks
  • hooks
  • views

/var/skins_repository/base/mail/addons/[アドオン名]以下

  • hooks

 

まずはアドオンがどういった構成で成り立っているのか上記を念頭においてください。

 

下記は実際のアドオンの構成例です。