設置方法

ファイル構成

ダウンロードした圧縮ファイルを解凍すると、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 にアクセスし、エラーが表示されなければ完了です。

管理者ページにログイン後、管理メニューから「システム」→「設定管理」を選択すると、各種設定を行えます。「基本設定」は設置サイトに合わせて変更してください。

動作しなければ、トラブルシューティングをご覧ください。