AIHP CMS + Updater
==================

このファイルを最初にお読みください。

はじめる前に　ご用意いただくもの
--------------------------------

  CMS（記事や固定ページの管理機能）をお使いになる場合

    空のMySQLデータベースを1つ、サーバーの管理画面で作成し、
    次の4つを控えておいてください。設置のときに画面へ入力します。

      ・データベース名     例）example_db
      ・ユーザー名         例）example_user
      ・パスワード
      ・ホスト名           例）localhost
                          ※ サーバーによっては mysql000.example.jp のような
                             名前が指定されています。サーバーの管理画面に
                             書かれています。

    ご用意いただくのはこの4つだけです。
    設定ファイルを手で書き換える必要はありません。

  Updaterだけをお使いになる場合

    データベースは必要ありません。ご用意いただくものもありません。

  ※ 先にご用意いただくことをお勧めします。
    アップロードしてから準備を始めると、設置が終わるまでの間、
    サイトが無防備な状態になります。

同梱内容
--------

  readme.txt   このファイル
  VERSION      バージョン番号
  aihp/        プログラム本体
  uploads/     画像の置き場所（空）

サーバーへ置くもの
------------------

ドメインルートへ次の2つだけを配置します。

  ドメインルート/aihp/
  ドメインルート/uploads/

  ドメインルート/
  ├── index.html          CMSが生成する公開ページ
  ├── uploads/            画像
  └── aihp/
      ├── cms/            CMS本体
      └── updater/        Updater

readme.txt と VERSION はサーバーへ置かないでください。
公開領域に置くと、誰でも読める状態になります。

CMSをほかの階層へ配置すると、公開HTMLとアップロードの出力先がずれます。

導入手順
--------

1. aihp/ と uploads/ を、サイトのドメインルートへアップロードします。

   CMSを使わない場合は、アップロードする前に aihp/cms/ フォルダを
   削除してください。Updaterだけで動きます。
   あとから使いたくなったら、ZIPから aihp/cms/ をアップロードし直せば
   使えるようになります。

2. サーバーの管理画面で、/aihp/ にBasic認証を設定します。
   設定方法はご利用のサーバーの説明をご覧ください。

3. ブラウザで次を開きます。

     https://お客様のドメイン/aihp/

4. 画面の指示に従って進めてください。
   CMSを使うかどうかも、この画面で選べます。

   設定が終わったら、CMSへログインし、コンテンツタイプ、カテゴリ、
   src内HTMLを設定して、全体再構築を実行してください。


アクセス制限を設定したのに警告が出る場合
----------------------------------------

  /aihp/ にアクセス制限を設定したにもかかわらず、
  「アクセス制限がかかっていません」と表示されることがあります。

  サーバーの構成によっては、設定を自動で確認できないためです。
  故障ではありません。

  この場合は、次のURLを直接開いてセットアップを進めてください。

     https://お客様のドメイン/aihp/setup.php


書き込み権限について
--------------------

  PHPが次へ書き込めるようにしてください。

     公開ルート
     uploads/
     aihp/cms/src/
     aihp/cms/runtime/
     aihp/sitebackup/
     aihp/cms/config.php   ※設置のときだけ。書けない場合は画面で案内します


バージョンアップのしかた
------------------------

  新しいZIPを解凍し、aihp/ の中身を上書きアップロードします。
  ただし、次のものは上書きしないでください。お客様の設定とデータです。

  上書きしないもの

     aihp/cms/config.php        データベース接続情報、サイトのURL
     aihp/updater/config.php    サービスの利用キー
     aihp/cms/src/              お客様の設計図（HTML・画像など）
     aihp/cms/runtime/          作業データ
     aihp/sitebackup/           Updaterが取った控え
     aihp/page_map.json         サイト構造マップ
     uploads/                   アップロードした画像

  上書きするもの

     aihp/index.php
     aihp/setup.php
     aihp/cms/ の上記以外
     aihp/updater/ の上記以外

  手順

     1. ZIPを解凍します。
     2. 解凍したフォルダから、上の「上書きしないもの」を削除します。
     3. 残った aihp/ を、サーバーの aihp/ へ上書きアップロードします。
     4. aihp/cms/src/.htaccess があることを確認します。
        （プレビュー用のファイルです。次の項をご覧ください）
     5. VERSION ファイルで、版数が変わったことを確認します。

  データベースの変更が必要な場合は、そのバージョンの案内でお知らせします。


削除しないでください
--------------------

  aihp/cms/src/.htaccess

  管理画面の「プレビュー」で、CSSや画像を正しく表示するためのファイルです。
  隠しファイルのため、FTPソフトの設定によっては見えないことがあります。

  aihp/cms/src/ の中身をまとめて入れ替えるときは、このファイルが
  消えないようにご注意ください。

  消えた場合、プレビューが崩れて表示されます。
  （公開中のページには影響しません）
  ZIPから aihp/cms/src/.htaccess をアップロードし直せば元に戻ります。

BASE_URL
--------

BASE_URLはCMSのURLではなく、末尾スラッシュなしのドメインルートです。

  正しい: https://example.jp
  誤り:   https://example.jp/aihp/cms

マニュアル
----------

マニュアルは同梱していません。次のサイトで公開しています。

  https://aihp.jp/

注意
----

- CSS、JavaScript、デザイン画像はCMSがsrcから公開ルートへコピーしません。
- 本番公開前にDB、src、uploads、config.phpのバックアップ方法を決めてください。
- 配布物に開発用doc、tests、tools、テストHTMLは含まれていません。
