Minimal Kojin-site CMS
======================

Minimal Kojin-site CMS は、個人サイト・創作サイト向けの軽量CMSです。
PHP と SQLite が利用できるレンタルサーバーにアップロードして、作品、日記、つぶやき、ギャラリーを投稿できるサイトを作成できます。


動作環境
--------

- PHP 8系推奨
- SQLite / PDO SQLite が利用できるサーバー
- .htaccess が利用できるサーバー
- GD拡張が利用できるサーバー推奨

GD拡張は、アップロード画像のサムネイル自動生成に使用します。
GD拡張が使えないサーバーでも表示自体はできますが、画像の多いサイトでは一覧ページの表示が重くなる場合があります。


インストール方法
----------------

1. 配布zipを自分のPC上で解凍します。
2. 解凍した中身をFTPツールでサーバーの公開フォルダにアップロードします。
   zipファイルそのものではなく、中のファイル一式をアップロードしてください。
3. ブラウザで install.php にアクセスします。
4. サイト名、管理ID、パスワードを入力してインストールします。
5. インストール完了後、サーバー上の install.php を必ず削除してください。

例:

- サイト直下に設置した場合: https://example.com/install.php
- cms フォルダに設置した場合: https://example.com/cms/install.php


管理画面
--------

管理画面は、設置したURLの後ろに admin/ を付けてアクセスします。

例:

- https://example.com/admin/
- https://example.com/cms/admin/

ログインには、インストール時に設定した管理IDとパスワードを使用します。


アップロード後のパーミッション
------------------------------

多くのレンタルサーバーでは、アップロード直後の状態で以下のようになっていれば問題ありません。

- フォルダ: 755
- ファイル: 644
- .htaccess: 644

通常は手動で変更する必要はありません。
インストール時に data または uploads に書き込みできないエラーが出た場合のみ、FTPツールで該当フォルダのパーミッションを確認してください。

安易に 777 にすることはおすすめしません。
必要な場合は、サーバー会社の案内に従って最小限の範囲で変更してください。


バックアップ
------------

投稿データや設定は主に data フォルダ内に保存されます。
アップロードした画像は uploads フォルダに保存されます。

特に大切なもの:

- data フォルダ
- uploads フォルダ
- 自分で編集した assets/custom.css やテンプレートファイル

サイト更新前、サーバー移転前、テーマ編集前にはバックアップを取ることをおすすめします。


カスタマイズ
------------

見た目だけを少し変更したい場合は、できるだけ assets/custom.css に追記してください。

assets/style.css はCMS本体の基本デザインです。
大きく編集すると、あとから更新版を入れるときに差し替えが難しくなることがあります。

PHPファイルやテンプレートを編集する場合は、編集前に必ずバックアップを取ってください。


セキュリティ上の注意
--------------------

- インストール後は install.php を必ず削除してください。
- 管理IDは admin のままにせず、推測されにくいものに変更することをおすすめします。
- パスワードは長く、他のサービスと使い回さないでください。
- サーバー上に配布zipやバックアップzipを置いたままにしないでください。
- 設置後、https://example.com/data/site.sqlite のようなURLにアクセスして、表示・ダウンロードされないことを確認するとより安心です。

詳しい注意点は SECURITY.txt も確認してください。


配布ページ
----------

最新情報、詳しい設置方法、注意事項は配布ページを確認してください。

https://web-tool-public.boo.jp/minimal-kojinsite-cms/


ライセンス
----------

この配布ファイルは MIT License で配布しています。
詳しくは LICENSE.txt を確認してください。
