content-management-systems

コンテンツ管理システム

ユーザーがコンテンツ管理システム、またはそれに類する動作をするソフトウェアを扱っている場合に、このスキルを使用します。

このスキルでは、CMS の作業で重要となる次の境界に焦点を当てます。

• テーマとテンプレート
• プラグイン、アプリ、モジュール、拡張機能
• 管理画面とエディターのインターフェース
• メディアとアップロードの処理
• コンテンツモデル、分類体系、メタデータ
• レンダリングパイプラインと静的エクスポートのフロー

このスキルを使用するタイミング

• ユーザーが WordPress、Shopify、Drupal、Joomla、Webflow、Squarespace、Wix、WooCommerce、HubSpot CMS Hub、Adobe Experience Manager などの CMS プラットフォームに言及している。
• CMS 内のテーマ開発、テンプレートの変更、デザインシステムの作業に関するタスクである。
• プラグイン、モジュール、アプリ、拡張ポイントに関するタスクである。
• エディターの UX、プレビュー、分類体系、スラッグ、SEO フィールド、公開動作に関わるタスクである。
• アップロード、メディアライブラリ、作成者が追加したアセット、Markdown のレンダリング、静的エクスポートに関わるタスクである。

最初の確認

1. プラットフォームのカテゴリを特定します。セルフホスト型 CMS、SaaS サイトビルダー、コマースプラットフォーム、ハイブリッド型またはヘッドレスシステムのいずれかです。
2. 編集を始める前に、対象となる実装の境界を特定します。
   • テーマまたはテンプレートのレイヤー
   • プラグイン、アプリ、モジュール、拡張機能のレイヤー
   • 管理画面またはエディターの画面
   • コンテンツモデルまたはストレージレイヤー
   • メディアパイプライン
   • エクスポート、デプロイ、レンダリングのパイプライン
3. アプローチを決める前に、プラットフォームの制約を確認します。
   • ローカルで編集できるもの
   • 作成者が追加したコンテンツとコードの区別
   • メディアの保存場所
   • 最終的なサイトがサーバーでレンダリングされるのか、静的エクスポートされるのか、リモートでホストされるのか

CMS のルール

• テーマ、モジュール、テンプレートパーツ、セクションには、プラットフォームの命名規則とフォルダー構成に従います。
• プラットフォームで明示的に統合されている場合を除き、テーマのアセットはユーザーがアップロードしたメディアと分けて管理します。
• 重要なメタデータをプレゼンテーション用マークアップに保存するより、構造化されたコンテンツフィールドを優先します。
• プレビュー、スラッグ、分類体系、抜粋、メタフィールド、公開状態は、CMS の主要な要素として扱います。
• 設定、テーマの選択、コンテンツ入力が無効な場合に備え、安全なデフォルト値と適切なフォールバック動作を優先します。
• エディターや管理画面の動作を変更するときは、保存されるフィールド、検証ルール、プレビューの経路、最終的なレンダリング経路をまとめて確認します。

よくあるワークフロー

テーマとテンプレート

• 下流のインクルードではなく、テンプレートローダーまたはテーマのランタイムから確認を始めます。
• プラットフォームのテンプレート階層とパーシャルの命名規則を維持します。
• 表示に関する変更は、テンプレートと共有テーマヘルパーの近くに配置します。

プラグイン、アプリ、モジュール

• ロジックをテンプレートに分散させず、プラットフォームの拡張ポイントで動作を追加します。
• マイグレーション、シードデータ、設定の更新は明示し、バージョン管理します。
• プラットフォームで有効化や登録が必要な場合は、拡張機能のセットアップ要件を文書化します。

管理画面とエディターの UX

• フォームを保存されるコンテンツモデルに合わせます。
• コンテンツの変換が複雑な場合は、作成者向けのプレビューを優先します。
• 検証、CSRF などの同等の保護策、権限を、周辺の管理画面コードと一貫させます。

メディアとアップロード

• 作成者が追加するメディアには、専用のアップロード先を使用します。
• 装飾用の画像やテーマ所有の画像は、アクティブなテーマフォルダーに保存します。
• プラットフォームでより厳密な規則が定められていない限り、作成者が追加するメディアには uploads/、テーマのアセットには img/ など、一般的な場所をデフォルトとして使用します。
• CMS がメディアディレクトリを設定できる場合は、安全なフォールバックを用意して設定を公開します。

コンテンツモデルとマイグレーション

• ページ、投稿、商品、エントリー、コレクション、分類体系、設定などのコンテンツエンティティを明確に区別します。
• その場しのぎのランタイム変更より、マイグレーションファイルやエクスポート可能なスキーマ定義を優先します。
• スラッグ、公開日、抜粋、正規メタデータ、分類体系との関連を構造化して管理します。

Markdown、HTML、静的エクスポート

• レンダラーを変更する前に、Markdown が作成時の入力、中間コンテンツ、ビルド出力のいずれにあたるかを判断します。
• 可能であれば、レンダラーの変更にプレビューまたは検証を組み合わせます。
• 静的エクスポートを行う CMS では、ビルドを変更した後に、書き換えられたパーマリンクとアセットのパスを検証します。

変更箇所の特定

プラットフォームを問わず、編集する前に、コードベースを次の CMS の役割に照らし合わせて、変更箇所を特定します。

• ランタイムの初期化とリクエストのルーティング
• 管理画面またはエディターのコントローラーとビューのテンプレート
• テーマの読み込み、テンプレート階層、共有テンプレートヘルパー
• コンテンツ、分類、設定のリポジトリ、モデル、スキーマ／マイグレーションファイル
• Markdown またはコンテンツの変換ユーティリティ
• 静的エクスポート、デプロイ、レンダリングパイプラインのエントリーポイント

まず該当する箇所を確認し、CMS の構造を維持する最小限の変更を行います。

プラットフォームに関する注意事項

一般的な CMS プラットフォーム、拡張ポイント、メディアの規約を簡潔にまとめた一覧は、references/cms-platform-workflows.md を参照してください。