各機能の設定

pitcmsプロジェクトの各機能を使用するために必要な設定方法を説明します。

設定には、左のサイドバーの「設定」からアクセスでき、現在設定できる項目は以下の通りです。

一般

プロジェクト名の変更やプランの確認・変更ができます。

プロジェクト名を指定しない場合、GitHubリポジトリ名がプロジェクト名として使用されます。

pitcmsで使用可能なブランチを設定できます。

ここで設定したブランチは「環境」として表示され、各環境ごとにコンテンツの編集やプレビューが可能になります。

コンテンツの変更は、選択中の環境のブランチに反映されます。編集セッションを有効にしている場合は、その環境に対するプルリクエストを経由して反映されます。

pitcmsでは、設定はエンジニアの方に行ってもらうことを想定していますが、実際にCMSを利用してコンテンツを入力するのは、非エンジニアの方々を想定しています。したがって、ブランチ名をはじめとしたGit・GitHub用語をできるだけ排除できるようにしています。

画像アップロード用のプロバイダを設定できます。現在サポートされているプロバイダは以下の通りです。

ここで設定したプロバイダは、pitcmsの画像フィールドや、リッチテキストフィールド内で画像をアップロードする際に使用されます。

ホスティングプロバイダを選択し、プレビュー機能を有効にできます。現在サポートされているホスティングプロバイダは以下の通りです。

ホスティングプロバイダーを選択すると、pitcmsは編集セッションで作られたブランチのデプロイを自動的に検出し、プレビューリンクダッシュボード上に表示します。

プレビューは編集セッション単位で発行されるため、この機能を使うには編集セッションを有効にする必要があります。

Vercelにはプレビューデプロイへのアクセスを制限する Deployment Protection という機能があります。この機能が有効になっている場合、VercelプロジェクトのチームメンバーでないユーザーはプレビューURLにアクセスできません。

pitcmsでプレビューリンクを開いた際に認証画面が表示されてプレビューが確認できない場合は、この Deployment Protection が原因の可能性があります。

pitcmsのユーザー全員がプレビューを確認できるようにしたい場合は、Vercelダッシュボードの Settings → Deployment Protection から Standard Protection を無効にしてください。

コンテンツをどのように保存・公開するかを設定できます。

編集セッション: 有効にすると、変更は編集セッションとしてまとめて管理され、「変更を反映」するまで公開されません。無効の場合はコンテンツをそのまま編集でき、保存すると選択中の環境に直接反映されます。新しく作成したプロジェクトでは無効になっています。
レビュー: 編集セッションの反映にレビューを必須にします。変更を反映できるのがレビューを依頼された人のみになります。編集セッションが有効な場合のみ設定できます。

これらの設定を変更できるのは、オーナーまたは管理者のみです。