Amazon Reporter

インストール・設定

ここ から適当なアーカイブをもってきて展開してください。

依存するライブラリのインストール

以下のPEARライブラリを利用しています

• MDB2
  • ↑とそのDBドライバ
• XML_Serializer
• HTTP
• Net_URL

さらに外部ライブラリでsavant2というのを使っているのでこれもいれる必要があります。

入れ方がよくわからなかったらreleasesの所に置いてあるpear.tar.gzというのを展開してドバっとpear/の下に置いてください。

設定

config/conf.phpに定数がベタっと書いてあるのでそれを書き換えてください。

• ADMIN_ID: 管理者のID、変えた方が良いでしょう
• ADMIN_PASSWD: 管理者のパスワード。md5した値を使います。プレインなものは与えない方が良いでしょう。
• PHP_SELF: xreaとかの一部のサーバでは環境変数SCRIPT_NAMEがあやしい事があるので、その場合は設置したURLをベチっと書いておくと動くかもしれません
• APPTITLE: H1タグとかにあらわれるものです。必要に応じて変えときましょう
• DSN: DBへの接続名(Data Source Name)。後述します。
• PERMIT_USER_USE_ALL: 月別売上表示でユーザに全てを表示させる「all」というものを許可するかしないか。許可した場合はallでガシガシ取られるのもある程度覚悟しときましょう。
• CHECK_ASIN_DATE: ASINとDATEを比較して既に存在している組合せを弾いてしまいます。これがtrueになっていないと重複したアイテムが入る可能性がありますし、trueにしているとアイテムに抜けがある可能性もあります。最初の一回目のインポートはfalseにしておいて、以降、月別データをいれるときにfalseにしてみるのも良いでしょう。
• IMGDIR: 画像が入るディレクトリ。現在はグラフ画像しかありませんが、PHP側からファイルを生成できるパーミッションを与えてください。
• Amazonの画像URL関連: 特に弄る必要はないのですがうまく表示されなくなったら変更しなくてはいけないかもしれません。こことかが参考になります。
  • AMAZON_IMG_URL_BASE
  • AMAZON_IMG_THUMB_SUFFIX
  • AMAZON_IMG_MEDIUM_SUFFIX
• AMAZON_AFFITAG: 自分の所のタグに適当に変更してください(moccoricom-22に儲けさせたいのであれば変更する必要はありませんが;-))
• DEBUG_MODE: 普段はfalseにして何かおかしいなと思ったらtrueにしてみるのが良いでしょう。ただ、まともに動き出すまではtrueにしといた方が良いでしょう。

DSNについて

以下のURLを参照してください

http://pear.php.net/manual/ja/package.database.mdb2.intro-dsn.php

SQLite(ver.2)での動作確認は取っていて、mysqlでも一応動くみたいなんですが他はわかりません。よくわからなければそのままにしておけば./data/amarepo.SQLiteが読み込まれまれる事になっています。

パーミッションの設定

以下のディレクトリのパーミッションを777とかにしてください

• ./data
• ./images

ただし、dataはSQLiteを利用しないのであれば必要ありません。
SQLiteを利用する場合はデータディレクトリをwebから参照されないようにしておくと良いでしょう。デフォルトでは.htaccessが設置されてありますが、サーバの設定によっては効かないかもしれません。

DBのセットアップ

DSNの適切に設定し、init.php.txtをinit.phpにリネームして、叩けば(Webからアクセスしてもいいし、コマンドラインから叩けるならそれでも良い(が、カレントディレクトリに注意))自動的にテーブルは作成されます(SQLiteの場合はDBファイルも作成されます)。テーブルを作成したらこのファイルは厳密に必ず廃棄してください。

(デフォルト設定のままだと./data/amarepo.sqliteとかいうのが出来ます。なおSQLiteの場合はトランザクションでディレクトリへの書き込み権限を必要とするのでこれだけwriteできれば良いというわけではないのに注意してください)

グラフ

JpGraphでやってます。これは(フォントと共に)同梱されています。GDやらfreetypeの設定が必要になってきます。動かなかったら諦めてください。グラフが動かなくてもレポートは作成されます。

サンプル

http://moccorine.s313.xrea.com/amarepo/

インタフェースの改造

面倒なのでthemeの下を適当に見て書き換えるなりしてください。

subversion版

http://svn.moccori.com/amarepo をチェックアウトしてください。

ライセンス・連絡先

本プログラムは無償・無保証・著作権放棄(Public Domainと同じ扱い)としていますので、改変しようが儲けようが何をしようが勝手にやってくれればいいと思いますが、ソフトウェアの実行結果に対しての責は一切負わないものとします。

ただし同梱されているライブラリ(PEARやtablesort.js)などはそれぞれライセンスが明記されておりますので、そちらのライセンスに従ってください。

以上