設置方法
ファイル構成
ダウンロードした圧縮ファイルを解凍すると、freo/ 内に以下のファイルとフォルダが作成されます。(フォルダ内に dummy.txt が格納されていることがありますが、ダミーファイルなので削除しても大丈夫です。)
configs/- 設定ファイル格納ディレクトリ
css/- CSSファイル格納ディレクトリ
database/- データベース格納ディレクトリ(SQLite用)
files/- アップロードファイル格納ディレクトリ
images/- 画像ファイル格納ディレクトリ
js/- JSファイル格納ディレクトリ
libs/- メインプログラム格納ディレクトリ
mails/- メールテンプレート格納ディレクトリ
templates/- テンプレート格納ディレクトリ
templates_c/- コンパイル済みテンプレート格納ディレクトリ
tiny_mce/- TinyMCE(エディタ)格納ディレクトリ
config.php- 設定ファイル
index.php- 起動プログラム
ファイル構成について補足
配布プログラムには、freo本体以外に以下のプログラムが含まれています。
js/jquery.js- jQuery
js/jquery.tablesorter.js- tablesorter
js/jquery.colorbox.js- ColorBox
libs/smarty/- Smarty
libs/smarty/plugins/modifier.autolink.php- autolink(Smarty用の自作プラグイン)
libs/smarty/plugins/modifier.explode.php- explode(Smarty用の自作プラグイン)
libs/smarty/plugins/modifier.mb_truncate.php- mb_truncate(Smarty用の自作プラグイン)
libs/smarty/plugins/modifier.nl2p.php- nl2p(Smarty用の自作プラグイン)
libs/smarty/plugins/modifier.regex_match.php- regex_match(Smarty用の自作プラグイン)
tiny_mce/- TinyMCE
設定項目の編集
freo/config.php をエディタで開き、各設定項目を編集します。基本設定の「設置URL」は、freoの設置URLを環境に合わせて必ず設定します。例えば、freo本体へのURLが http://www.example.com/~mypage/freo/index.php となる場合は http://www.example.com/~mypage/freo/ と設定します。
さらに、SQLite3以外のデータベースを使用する場合は、同ファイルの「データベースの設定」も変更します。
- SQLite2を使用する場合、データベースの設定の「データベースの種類」は
sqlite2に設定してください。 - MySQLを使用する場合、データベースの設定の「データベースの種類」は
mysqlに設定してください。また、「接続先」など他の項目も環境に合わせて設定してください。 - どのデータベースにすればいいか判らない場合、ひとまず初期設定のデータベース(SQLite3)のままお試しください。
MySQLの設定について補足
MySQLを使う場合、例えばMySQLの設定が
- 接続先
mysql.example.com- ユーザー名
example- パスワード
1234- データベース名
mydatabase
と指定されていれば、「データベースの設定」は以下のように設定します。
//データベースの種類(sqlite3 ... SQLite3 / sqlite2 ... SQLite2 / mysql ... MySQL)
define('FREO_DATABASE_TYPE', 'mysql');
//接続先(MySQL用)
define('FREO_DATABASE_HOST', 'mysql.example.com');
//ポート(MySQL用)
define('FREO_DATABASE_PORT', '');
//ユーザー名(MySQL用)
define('FREO_DATABASE_USER', 'example');
//パスワード(MySQL用)
define('FREO_DATABASE_PASSWORD', '1234');
//文字コード(MySQL用)
define('FREO_DATABASE_CHARSET', '');
//データベース格納ディレクトリ(SQLite用)
define('FREO_DATABASE_DIR', 'database/');
//データベース名
define('FREO_DATABASE_NAME', 'mydatabase');
//テーブル名のプレフィックス
define('FREO_DATABASE_PREFIX', 'freo_');
「ポート」や「文字コード」は、大抵の環境では何も設定しなくても大丈夫です。
MySQLを使用する場合は「データベース格納ディレクトリ」の設定は無視されるので、値は何でも大丈夫です。(空欄でも大丈夫です。)
「データベース名」は初期設定では freo.db となっていますが、これはSQLiteを想定した設定です。MySQLではデータベー名に . を利用できないため、MySQLを利用する場合でデータベース名を自由に決定できる場合でも、任意のデータベース名に変更する必要があります。
次に freo/js/common.js をエディタで開き、「設置パス」を環境に合わせて設定します。この値は、freoを設置するURLのドメイン以降を設定してください。例えば http://www.example.com/ に設置する場合は /、http://www.example.com/freo/ に設置する場合は /freo/、http://www.example.com/~mypage/freo/ に設置する場合は /~mypage/freo/ と設定します。
ファイルのアップロード
freo/ フォルダごと、すべてのファイルをアップロードします。(サイト全体をfreoで構築する場合、公開フォルダ直下に freo/ の内容をすべてアップロードしても大丈夫です。)
なお、以下のファイルはアスキーモードでアップロードしてください。(FFFTPなら、あらかじめ転送モードの自動切換えの設定を行っておくと楽です。)
- 拡張子が
txtのファイル - 拡張子が
htmlのファイル - 拡張子が
htmのファイル - 拡張子が
logのファイル - 拡張子が
jsのファイル - 拡張子が
cssのファイル - 拡張子が
iniのファイル - 拡張子が
phpのファイル - 拡張子が
xmlのファイル .htaccess
セットアップ
ブラウザソフトで freo/index.php/setup にアクセスします。セットアップ画面が表示されるので、「メールアドレス」「ユーザーID」「パスワード」を入力してセットアップを実行します。
メールアドレスはfreoからメールを送信する際に利用するので、実在するメールアドレスを入力してください。ユーザーIDとパスワードは、freoの管理ページにログインするための情報です。半角英数字で任意の値を入力してください。また、これらの情報は忘れないようにしてください。
完了
ブラウザソフトで freo/index.php にアクセスし、エラーが表示されなければ完了です。
管理者ページにログイン後、管理メニューから「システム」→「設定管理」を選択すると、各種設定を行えます。「基本設定」は設置サイトに合わせて変更してください。
動作しなければ、トラブルシューティングをご覧ください。