CHAPTER 02

管理画面の基本操作ガイド

ダッシュボードでの更新指示、サイトマップ直接編集、記事の投稿・管理、共通パーツの編集方法を解説します。

管理画面の基本操作ガイド

ダッシュボードのUpdater

ログイン後のダッシュボードでは、CMSモードのUpdaterを表示します。更新指示を入力すると、cms/srcのHTMLとCMS記事DBから候補を検索します。

更新できるもの

種別対象確定するとどうなるか
HTML固定ページのHTMLsrcと公開ページの両方を更新
パーツ共通パーツ(_で始まるHTML)srcだけ更新。全体再構築が必要
記事テンプレ_entry.htmlsrcだけ更新。全体再構築が必要
アーカイブページ分割のある一覧の元HTMLsrcだけ更新。全体再構築が必要
DB記事記事のタイトル・本文・カスタムフィールドDBと記事詳細ページを更新

選び方と進め方

見つかった候補は、種別のラベル付きで一覧に並びます。複数見つかった場合は、まとめて処理できます。

  1. 直したいものにチェックを入れます。「すべて選択」「すべて解除」も使えます。
  2. 「N件をプレビューする」を押すと、選んだ数だけ確認用ページを作ります。
  3. 一覧が確認用の行に変わります。行ごとに「プレビュー」「差分を見る」「確認OK」「破棄」があります。
  4. 「確認OK」を押すと、その行の下に確認欄が開きます。もう一度押すとその1件だけが反映されます。
  5. 何件か見て問題なければ、一覧の下の「残りN件をまとめて反映」で残りを一度に処理できます。

反映は1件ずつ行われます。 まとめて反映する場合も上から順に処理し、途中で失敗したものは更新前のまま残して、最後に「N件適用 / M件スキップ」と表示します。

不要な候補は行ごとに「破棄」できます。破棄した行だけが取り消され、ほかの行はそのまま残ります。

プレビューについて

  • 確認用ページはランダムな名前で公開先へ一時的に作られ、noindex,nofollowが付きます。
  • 有効期限は30分です。確定・破棄・次回のプレビュー作成時に削除されます。
  • 確定も破棄もしないまま画面を閉じた場合も、しばらくすると自動で片付けられます。片付ける時間はaihp/updater/config.phpのCMS_PREVIEW_CLEANUP_MINUTESで変えられます(既定30分、0にすると片付けません)。
  • 共通パーツは、それを直接使用している代表ページを1件プレビューします。トップページ、階層の浅い固定ページ、記事詳細の順で選ばれます。
  • 共通パーツを2件以上まとめて選んだとき、たまたま同じページが代表になることがあります。その場合、それぞれのプレビューにはその1件の変更だけが入ります。両方入った状態は表示されないため、行ごとにプレビューを開いて確認してください。画面にも同じ案内を表示します。
  • 記事テンプレは、そのコンテンツタイプの最新の公開記事を1件流し込んで表示します。
  • 管理画面(サイトマップ管理・固定ページ編集)からのプレビューは、/aihp/cms/src/{パス}というURLで開きます。本番と同じ階層になるため、CSSや画像が本番どおりに表示されます。
  • このプレビューはaihp/cms/src/.htaccessで動いています。srcの中身をまとめて入れ替えるときは、このファイルが消えないようにご注意ください。消えると、設計図のHTML(data-aihpが残った状態)がそのまま表示されます。
  • アーカイブは文言の確認用です。一覧の中身、年・月・カテゴリの分類名、ページ送りは表示されません。

置き換えの範囲

同じ対象の中に変更前の文字列が複数あるときは、そのすべてを置き換えます。 2箇所以上ある場合は確認画面にその旨を表示します。1箇所だけにしたいときは、検索キーワードへ前後の文字を足して絞り込んでください。

次のものは、まだ確定更新できません。

  • パーツを経由する入れ子include
  • 新しいページやカテゴリの作成
  • 画像・ファイル項目の変更
  • 記事の「掲載日」「選択肢」「チェック」「繰り返し項目」などの書き直し (検索には出ますが、書き直しの対象外です。断りとあわせて、CMSの編集画面へのリンクを表示します)

文章の追加・削除・書き直し

「変更前」と「変更後」がはっきりしない指示も扱えます。

例   ネットスケールが選ばれる理由 の下に
     『新春のエンジニア大募集キャンペーン開始!』という見出しで、
     ワクワクするような告知を追加して

このときは、AIが該当箇所の前後を読み取って文章を作ります。1件あたり20〜30秒かかります。 複数選んだ場合は1件ずつ順に処理し、ボタンに「AIが書き換え中… (2 / 3)」と進み具合が出ます。

置き換えとの違いは次のとおりです。

置き換え追加・削除・書き直し
画面の表示変更前・変更後の入力欄AIへの指示の入力欄
かかる時間数秒1件あたり20〜30秒
対象すべての種別下記のとおり

記事の項目によって、扱いが変わります。

項目追加・削除・書き直し
固定ページ・共通パーツ・記事テンプレ・アーカイブできます
記事の本文できます
記事のタイトルできます(60文字以内)
カスタム項目のうち1行入力・複数行入力できます
そのほかのカスタム項目できません。編集画面へのリンクが出ます

AIが判断に迷うと、確認事項を返すことがあります。 その場合は指示をより具体的にして、もう一度お試しください。

確定したあと

更新前のsrcは/aihp/sitebackup/cms-src/へ日時つきで保存されます。プレビュー後にsrcが別操作で変わっていた場合は、上書きせず再プレビューを求めます。

固定ページ以外を更新したときは、一覧の下に「全体再構築へ」が1つだけ表示されます。サイトマップ管理を開いて全体再構築してください。種別が混ざっていても、全体再構築ですべて反映されます。

記事を作成する

  1. ダッシュボードでコンテンツタイプを開きます。
  2. 「+新規作成」を押します。
  3. タイトル、slug、本文、カテゴリ、カスタム項目を入力します。
  4. 「保存して公開」または「下書き保存」を押します。
  5. 保存済みプレビューで表示を確認します。

src/{type.path}/_entry.htmlがないコンテンツタイプは、記事ごとの詳細HTMLを生成しません。一覧データとしてだけ使用できます。

本文を入力する

本文の入力方法は次の3種類です。

入力方法保存時の処理
プレーンHTMLエスケープし、改行をHTMLへ変換
MarkdownMarkdownからHTMLへ変換
HTMLビジュアルとHTMLソースを切り替えて編集

保存後はすべてHTMLとしてcontentへ保存します。プレーンやMarkdownの元形式には戻りません。HTMLは保存時と表示時に安全化されます。

公開・下書き・削除

  • 公開記事を保存すると、その記事の詳細HTMLを生成・更新します。
  • 下書きへ戻すと、現在解決できる記事詳細HTMLを削除します。
  • 記事を削除すると、DB記事と現在解決できる詳細HTMLを削除します。

記事操作だけでは、トップページ、一覧、アーカイブ、sitemap.xmlは更新しません。確認中の記事がほかのページへ影響しないようにするためです。

関連ページへ反映するときは、左メニューの通知からサイト管理を開き、対象タイプの「関連ページを再構築」を実行します。全サイトを更新したい場合は「全体を再構築」を使います。

slugやカテゴリを変更しても、変更前URLの古い記事HTMLは自動削除されません。サーバー上の古いファイルを確認してください。

固定HTMLとテンプレート

サイト管理ではsrc/内のHTMLを次の4種類で表示します。

表示用途
HTMLそのファイル自身を公開する固定HTML・通常一覧
アーカイブ複数ページの一覧を生成する元HTML
記事テンプレDB記事詳細を生成する_entry.html
パーツinclude・一覧部品などの_付きHTML

_で始まるHTMLは、そのファイル自身を直接公開しません。

通常のHTMLでは次の操作ができます。

  • プレビュー: 保存済みHTMLをCMSのレンダリングで表示
  • 編集: src内のHTMLを上書き
  • 複製: 同じディレクトリへ別名のHTMLを新規作成

未保存の変更はプレビューできません。保存してから確認します。

コンテンツタイプ

設定画面で表示名、公開パス、カスタムフィールドschemaを管理します。公開パスは記事URLとテンプレート配置に使われます。

既存schemaを変更するときは、既存記事の値が新しい定義で検証できるか確認してから保存します。

カテゴリ

カテゴリは親子関係を設定できます。

  • typeの公開パスとカテゴリを合わせて3階層以内です。
  • 循環する親子関係は保存できません。
  • 別のコンテンツタイプに属するカテゴリは親にできません。
  • 記事は選択したカテゴリの公開パスへ生成されます。

パスワードとログイン

  • 5回連続でログインに失敗すると15分間ロックします。
  • 無操作が2時間続くとセッションが終了します。
  • 現行v2では、管理者ごとの権限区分はありません。
  • パスワード再設定はサーバー上でphp bin/create_admin.php ユーザー名を実行します。