ご利用マニュアル
納品〜公開〜日常運用まで、画像付きの完全ガイド。所要時間はざっくり 30-60 分です。
install.php ウィザードを完了 → 即運用開始、の 3 ステップ。
Xserver の契約
当サービスは Xserver（エックスサーバー）でのご利用を推奨しています。
- Xserver 公式サイト へアクセス
- 「お申し込み」→「スタンダードプラン」を選択
- サーバー ID、メールアドレスを入力 → メール認証
- 個人情報・支払情報を入力（クレジット推奨）
- 契約完了メールを保管
独自ドメインの取得
「tanaka-tax.jp」のような、事務所専用の URL を取得します。
- Xserver の管理画面に「Xserver Domain」タブ
- 希望のドメイン名を入力 → 検索
- 空きがあれば「申し込む」
- .jp または .com 推奨。.comは年 1,300 円程度、.jpは年 3,000 円程度
ドメインの設定 (SSL 化)
- Xserver サーバーパネル → 「ドメイン設定」
- 「ドメイン設定追加」→ 取得したドメインを入力
- 「無料独自 SSL を利用する」に ✅ チェック
- 反映に 5-30 分かかります（コーヒー休憩を）
アップローダーで CMS を設置
FTP クライアントは不要です。当方提供の 専用アップローダー (Python 製、Mac/Windows 共通) で、tools/uploader/ から 1 コマンドで設置できます。
事前準備
- Python 3.8 以上 (Mac は標準搭載 / Windows は python.org からインストール)
- 当方からお送りする CMS 一式 (
zeirishi-web-cms.zip) を解凍 - Xserver の FTP 情報 (サーバーパネル → アカウント情報)
- ホスト (例
sv1234.xserver.jp) - FTP ユーザー名 / パスワード
- ドキュメントルート (例
/home/USER/yourdomain.com/public_html/)
- ホスト (例
実行
tools\uploader\upload-windows.bat をダブルクリックmacOS: ターミナルで
tools/uploader/upload-mac.command を実行
対話形式で FTP 情報を入力 → ⏎ → 数十秒で全ファイル展開完了。
install.php ウィザードで初期セットアップ
ブラウザで https://yourdomain.com/install.php を開きます。1 回限りのセットアップウィザードが表示されます。
入力項目
- 事務所名 (日本語) *
- 事務所名 (英語表記)
- 代表者役職 (例: 代表税理士) / 氏名 *
- 管理者メールアドレス *
- 所在地・電話番号
自動的に行われる処理
- 16 桁のランダムパスワードを生成 (
bcryptハッシュで保存) config.local.phpを自動生成 (パスワードと管理者メアドの保存先)data/client_site.jsonを入力値で初期化 (法令ページの placeholder にも事務所情報を伝播)- 登録メアド宛に「ようこそ」メールを送信 (ログイン URL + 初期パスワード)
install.php は自動でロックされ、再度開いてもセットアップ画面は表示されません。
管理画面ログイン (OTP 認証)
- ブラウザで
https://yourdomain.com/admin/にアクセス - 登録メアド + 初期パスワードでログイン
- 登録メアド宛に 6 桁の認証コードが届く (5 分間有効)
- OTP 入力画面で 6 桁を入力 → 管理画面に入る
※ ログイン失敗 5 回で 15 分間ロックアウト / 30 分非アクティブで自動ログアウト
編集・公開
サイドバーから編集したいタブを選択し、内容を変更 → 「保存する」ボタンで反映。
10 個の編集タブ
https://yourdomain.com/ に反映されます (所要 1 秒)。
日常の運用
📷 画像のアップロード
各タブの画像欄に ファイル選択ボタンがあります。
- 受入形式: PNG / JPG / WebP / SVG / GIF
- 最大サイズ: 20MB (実用は 5MB 以下推奨)
- WebP が最も軽量で表示も速い (推奨)
- アップロード後は
/assets/uploads/にランダムファイル名で保存
📦 バックアップと復元
設定タブの末尾にバックアップセクションがあります。
- 「📥 バックアップをダウンロード」ボタンで全データ (設定 + 受信履歴 + 画像) を ZIP で保存
- 復元時は ZIP をアップロード → 同意チェック → 「⚠ 復元する」
- 復元前のデータは
storage/_backup/auto/に 7 日間自動保管 - 推奨頻度: 月 1 回 + 大幅編集の前
📨 お問合せの確認
サイドバー「📨 受信箱」タブ (バッジで未読件数表示)。
- 新しい順で一覧、最新は自動展開
- 「✉ 返信メール作成」ボタンでメールクライアントが起動 (件名プリフィル)
- 「📊 CSV ダウンロード」で Excel 互換 CSV 出力 (UTF-8 BOM)
- 個別削除は SSH 経由 (誤操作防止のため画面からは不可)
🔑 パスワード変更・忘れた時
- 変更: ログイン画面の「パスワードをお忘れですか？」→ メアド入力 → リセット URL がメールに届く → 新パスワード設定 (1 時間以内)
- 強度: 12 文字以上必須・推奨は
1PasswordやBitwardenで生成した 16 文字以上のランダム文字列
🎨 トンマナ・配色の変更
設定 → デザインタブから:
- 7 種の配色テンプレ (Cloud DX / Trad Premium / Warm Family / Bold Modern / Soft Pastel / Fresh Green / Mono)
- レイアウト切替 (Bento / Classic)
- 写真配置 (案 F: Hero と外観写真並列 / 案 B: 代表者カードに統合)
- フォント (Noto Sans JP / Noto Serif JP / Inter / M PLUS 1p / Shippori Mincho / Zen Kaku Gothic New)
→ 公開ページに即反映、admin の側面色も同期して切替されます。
🛠 メンテナンスモード
設定タブのチェックボックスを ON にすると、公開ページが「準備中」(503) 表示になります。管理画面は引き続き利用可能。大幅リニューアル時に活用してください。
困ったときは
サイトが表示されない
DNS の反映には最大 24 時間かかる場合があります。Xserver サーバーパネルでドメイン設定が「反映済み」になっているか確認してください。
install.php が「セットアップは完了しています」と表示される
既にセットアップ済の状態です。https://yourdomain.com/admin/login.php から直接ログインしてください。再セットアップしたい場合は SSH/FTP で config.local.php から CLIENT_*_OVERRIDE の行を削除すると install.php が再起動できます。
パスワードを忘れた
ログイン画面の「パスワードをお忘れですか？」リンク → 登録メアド入力 → メールに届く再設定 URL から 1 時間以内に新パスワード設定。メールが届かない場合は迷惑メールフォルダもご確認ください。
OTP コードのメールが届かない
迷惑メールフォルダ確認 → 届かない場合は OTP 入力画面の「再送する」ボタン。それでもダメな場合は SPF/DKIM 設定 (連絡先タブ → 送信元メアドが独自ドメイン化されているか) を確認してください。
「保存に失敗しました」と表示された
data/ ディレクトリの書き込み権限を確認 (パーミッション 755 or 775)。アップローダー設置時は自動付与されますが、手動 FTP の場合は要確認。
画像のアップロードが失敗する
サイズ上限 20MB を超えていないか / 受入形式 (PNG/JPG/WebP/SVG/GIF) か確認。php.ini の upload_max_filesize 設定が小さい場合は Xserver のサーバーパネル → PHP 設定で 20M 以上に変更してください。
バックアップ ZIP が大きすぎてダウンロードできない
画像が増えすぎている可能性。不要な画像を SSH/FTP で assets/uploads/ から削除してください (どの画像が使われているかは data/client_site.json 内を grep で検索)。
それでも解決しない
X (@kita_yysskk) への DM、または お問合せフォームからご連絡ください。24 時間以内に返信します。