テンプレート修正が必要なバージョンとライセンス

テーマ内にあるテンプレートファイルについては自動変更されません。以下のドキュメントを参考にテンプレートファイルの修正をお願いします。

バージョンごとのアップデート方法

ライセンス別のアップデート方法

Ver.3.0以上へのアップデート

Ver.3.0以上へのアップデートする際に気をつけることは下記の4点です。

  • 簡単アップデートを使用する
  • 事前に新しいライセンスファイルを用意する
  • データベースのアップデートを実行する
  • すでに「api」が使われている箇所があれば変更する

簡単アップデートを使用する

Ver.3.0はメジャーバージョンです。Ver.3.0よりも低いバージョンからアップデートする時はメジャーバージョンアップをすることになります。
オンラインアップデートでは、マイナーバージョンとパッチバージョンのみに対応しているため、今回は対象外となるため利用できません。
より簡単に手動アップデートを行う方法として、「簡単アップデート」を用意しています。

詳しくは以下のドキュメントをご覧ください

事前に新しいライセンスファイルを用意する

Ver.3.0以上では、プログラムの暗号化が廃止され ionCube Loader が必要なくなりました。この変更によりライセンスファイルの内容もアップデートされ、正しく動作するには新しいライセンスファイルの適用が必要になります。
正しいライセンスファイルを適用しないと予期せぬ表示を起こすことがありますので、差し替える時間を短縮するためにアップデート作業時には事前にマイページよりダウンロードすることを推奨いたします。

ライセンスファイルをダウンロードする方法

  1. マイページにログインする
  2. 「所有ライセンス」のページへ移動する
  3. 該当するライセンスをさがし、「ライセンスDL」項目の「Ver.3.0以上」を選んでライセンスファイルをダウンロードする

「ライセンスDL」項目の「Ver.3.0以上」を選択してください

データベースのアップデートを実行する

データベースに変更があるため、データベースのアップデートを実行する必要があります。
1.テンプレートファイルのアップデート後、メンテナンスメニュー（http://ドメイン/〇〇（setupフォルダをリネームしたもの）/index.php）にアクセスしてください。アクセスするためにはログイン情報が必要です。 2.メンテナンスメニューにアクセスしたら、アップデートを実行するために「アップデート実行画面へ」のリンクをクリックします。

3.進んでいくと、削除するテーブルを聞かれますが削除するかは任意で構いません。バックアップをとっておきたい場合は選択せず、アップデートを完了してください。

4.完了画面が現れたら、setupフォルダをリネームします。

すでに「api」が使われている箇所があれば変更する

API機能が新しく追加されたことにより、「api」が予約語に登録されました。
制作したサイトでテーマフォルダ内に同じ名前のディレクトリやカテゴリコードに指定していると思わぬ不具合につながりますので、リネームまたはconfig.server.phpのAPI_SEGMENTの値を「api」以外のものを指定してください。
※API_SEGMENTを「api」以外のものを指定すると、API機能を使う際に「api」と指定していたものはAPI_SEGMENTで指定した値に差し替えてご使用いただくことになります。

config.server.phpのAPI_SEGMENTの設定は以下のコードになります。 define('API_SEGMENT', 'api');

アップデート完了後の確認

アップデート完了後は、念のためバージョンが正常に上がっているかダッシュボードで確認しましょう。

Cookieの使用目的

a-blog cms が使用するデフォルトの Cookie をリストアップし、それらが何のために使用されるのかについて説明します。

＊ ここでは、Ver. 3.0 系の a-blog cms をもとに解説しております。

PHPセッション

a-blog cms では PHPセッションに依存して、Web リクエストにまたがるセッションを維持します。
このCookieの名前は、デフォルトだと 「sid」 と名前になります。ただし、config.server.phpで名前を変更することもできます。

define('SESSION_NAME', 'sid');

PHPセッションは、以下のような機能について利用されます。

ログイン維持

ログインした時に、ページを移動してもログイン状態にできるように、PHPセッションを利用しています。

CSRF

フォームなどの POSTリクエスト の CSRF（クロス・サイト・リクエスト・フォージェリ） 対策のためにPHPセッションを利用しています。

カート機能

カート機能で、カート内の商品内容維持のため、PHPセッションを利用しています。

SNSログイン認証

SNS認証時に、一時的に値を保持するため、PHPセッションを利用しています。

ダイレクト編集

エントリーを直接編集できる「ダイレクト編集」機能のON/OFF状態維持のため、　「acms_config_entry_edit_inplace_enable[0]」 という名前のCookieを使用しています。

a-blog cms と GDPR について

GDPRの観点から、a-blog cms のデフォルトCookieは個人情報や機密情報を収集しないようにしております。 また保存された情報は、開発元の有限会社アップルップルや第三者に送信されることはありません。

a-blog cms のデフォルトCookieは、ユーザー認証、セキュリティ、および基本的なウェブアプリケーション操作の目的のみに使用されます。

EC・カート機能について

a-blog cms でEC・カート機能を利用するには、Shopping Cart 拡張アプリの使用を推奨しています。

Shopping Cart 拡張アプリとは

Shopping Cart 拡張アプリとは、1エントリーを1商品として扱い、カート機能や在庫管理機能、クレジットカード決済などのECサイトとしての基本的な機能を提供する拡張アプリです。

具体的には以下の機能を提供しています。

  • 1エントリーを1商品として扱うカート機能
  • 在庫管理機能
  • クレジットカード決済機能（Square）
  • 決済手数料の設定
  • 税金設定（税率、内税・外税）
  • 送料設定
  • 配送オプション（配送希望日時と追加手数料）
  • マイページ機能（閲覧ページ上でのユーザー情報の編集）

また、サンプルテーマとして EC テーマを同梱しています。カスタマイズの際はサンプルテーマを参考に実装することができます。

動作環境

  • a-blog cms： Ver. 3.0.0 ~
  • PHP： 7.4.x ~ 8.3.x
  • ブラウザ：Chrome、Firefox、Safari（>= 12）、Edge、iOS:Safari（>= 12）、Android Chrome

会員機能について

Shopping Cart拡張アプリと a-blog cms 標準の機能である会員機能は組み合わせて使用することで会員登録制のECサイトを作成することができるようになります。会員機能を有効にすることで、自由にユーザーを登録することができるようになるためです。さらに、読者権限ユーザーでユーザー登録をするように設定することで会員数が多くなっても安心の会員登録制のECサイトを構築できます。会員機能を利用するには管理画面>ご利用のコンフィグセットのコンフィグ管理 > ログイン設定 に移動し「ユーザー登録の外部申請」にチェックを入れてください。

会員機能について、詳しく知りたい方はこちらのドキュメントをお読みください。

同梱されているサンプルテーマについて

Shopping Cart 拡張アプリにはサンプルテーマとして、以下のテーマが同梱されています。ShoppingCart 拡張アプリを使用した EC サイト制作の参考にご利用ください。

  • ec
  • square@ec

まとめ

ここまで読んだあなたは、 a-blog cms で EC サイトを作るための学習をする準備が整いました。それでは実際に、Shopping Cart 拡張アプリをインストールして初期設定を行ってみましょう。

Shopping Cart 拡張アプリのインストールから基本設定までを解説したドキュメントはこちら​です。
一緒に、a-blog cms で ECサイトを作ってみましょう。

インストール方法

このエントリーでは、Shopping Cart 拡張アプリ及びサンプルテーマのインストール方法を説明します。Shopping Cart 拡張アプリのインストール方法は以下の2つの方法があります。

  • 簡単セットアップ for square@ec テーマを使用してインストールする
  • 手動でインストールして、メンテナンスページからサンプルテーマのデータをインポートする

それぞれ説明します。

簡単セットアップ for square@ec テーマを使用してインストールする

まず、簡単セットアップを使用してShopping Cart 拡張アプリ及びサンプルテーマのインストールをする方法をご紹介します。この方法が最も簡単にShopping Cart 拡張アプリ及びサンプルテーマのインストールができ、サンプルテーマのデータまで一括でインストールできるため、基本的には簡単セットアップを使用してインストールすることを推奨します。

簡単セットアップ for square@ec テーマ の使用方法

簡単セットアップ for square@ec テーマ をダウンロード

  1. 上記のボタンから簡単セットアップ for square@ec テーマ の zip ファイルをダウンロードしてください。
  2. ダウンロードした zip ファイルを解凍し、 setup.php を入手します。
  3. setup.phpをサーバーのインストールしたいディレクトリに設置します。
  4. setup.phpを設置したURLにブラウザからアクセスして、 setup.php を実行します。
  5. セットアップページが表示されたら、セットアップページのメッセージに従ってセットアップを進めてください。

手動でインストールして、メンテナンスページからサンプルテーマのデータをインポートする

次に紹介する方法は Shopping Cart 拡張アプリを手動でインストールする方法です。通常の拡張アプリを使用したことがある方や、a-blog cms に慣れている方はもしかしたらこちらの方法のほうがやりやすいかもしれません。

また、既に a-blog cms で制作しているサイトに EC 機能を追加したい場合にもこちらの方法がおすすめです。

この方法では、Shopping Cart 拡張アプリを extension/plugins/ に設置して、Shopping Cart 拡張アプリをダウンロード後、メンテナンスページのインポート機能を利用して、サンプルテーマのデータをインポートします。​

Shopping Cart 拡張アプリをダウンロード

  1. 上記のボタンからShopping Cart 拡張アプリ の zip ファイルをダウンロードしてください。
  2. ダウンロードした zip ファイルを解凍し、 plugins ディレクトリから、ShoppingCart 拡張アプリを入手します。
  3. 入手した ShoppingCart 拡張アプリを extension/plugins に設置してください。
  4. config.server.php で HOOK_ENABLE を有効化してください
  5. 管理画面 > 拡張アプリ から「インストール」ボタンをクリックして、インストールを行います。インストール後は拡張アプリが有効化された状態になります。
  6. ShoppingCart 拡張アプリのインストール時に themes ディレクトリに サンプルテーマがない場合、サンプルテーマがダウンロードされます。
  7. a-blog cms 設置ディレクトリ直下の setup_xxxx ディレクトリ（存在しない場合はご利用のa-blog cmsと同じバージョンをダウンロードし、パッケージ内にある setup ディレクトリを設置してください）内の bin ディレクトリ直下に ダウンロードしたファイル内のbinディレクトリから、利用したいテーマ名の フォルダ（例：square@ec）を設置します
  8. https://ドメイン/setup_xxxx/index.php にアクセスします。
  9. メンテナンスページのガイドに従ってサンプルテーマのデータをインポートします。（メンテナンスページのインポート手順に関してはこちらのドキュメントを参考にしてください）

まとめ

ここまでで、Shopping Cart 拡張アプリ のインストール方法について学びました。ここまでの内容を理解することができたら、次は Shopping Cart 拡張アプリの基本設定を学ぶと良いでしょう。Shopping Cart 拡張アプリの基本設定についてはこちらのエントリーで解説しています。