CKEditor 5 Plugin Pack
Drupal向けの21種類のCKEditor 5プラグインコレクション。フォントカスタマイズ、文字数カウント、検索と置換、テンプレート、ハイライトなどの機能を提供します。
ckeditor5_plugin_pack
インストール
composer require 'drupal/ckeditor5_plugin_pack:^1.4'
概要
CKEditor 5 Plugin Packは、Drupal向けにパッケージ化されたCKEditor 5プラグインの包括的なコレクションです。ベースモジュールと21のサブモジュールを提供し、各サブモジュールが特定のエディタ機能を追加します。このモジュールはCDN（デフォルト）またはローカルDLLファイルによるプラグイン読み込みを処理し、Drupalのテキストフォーマット設定とシームレスに統合されます。
このプラグインパックには無料機能とプレミアム機能の両方が含まれています（TemplatesやWProofreaderなどのプレミアム機能はDrupalユーザーは無料で利用可能）。各サブモジュールはCKEditor 5プラグインを登録し、標準のDrupalエディタ設定インターフェースを通じてテキストフォーマットごとの設定を提供します。
主な機能には、テキストスタイリング（フォント、色、ハイライト）、生産性ツール（検索/置換、文字数カウント、テンプレート）、コンテンツ強化（絵文字、メディア埋め込み、ブックマーク）、エディタ動作（フルスクリーンモード、テキスト変換、Markdownからの貼り付け）が含まれます。
Features
- CDNフォールバックとローカルファイルサポートを備えたDLL読み込みインフラストラクチャを提供するベースモジュール
- 包括的なテキストスタイリングのためのFont Family、Font Size、Font Colorプラグイン
- リアルタイムの単語数と文字数を表示するWord Countプラグイン
- 大文字小文字の区別と単語全体のマッチングオプションを備えた検索と置換ダイアログ
- 事前定義されたHTML構造を挿入できるContent Templatesシステム（プレミアム機能、Drupalでは無料）
- カスタマイズ可能なマーカーの色とタイプを持つText Highlightプラグイン
- 集中して執筆できるフルスクリーン編集モード
- チェック可能なタスクリストのためのTo-do Listプラグイン
- 印刷に適したドキュメントのためのPage Break挿入
- 外部ビデオ/オーディオコンテンツ（YouTube、Vimeoなど）のMedia Embed
- 絵文字文字を挿入するためのEmojiピッカー
- ドキュメント内ナビゲーション用のBookmarks/アンカー
- リンクにカスタム属性を追加するためのLink Attributes
- 段落レベルのインデント制御のためのBlock Indentation
- Markdownからの貼り付け時の自動変換
- スマートタイポグラフィ（カーリークォート、ダッシュ）のためのText Transformation
- 生のHTML挿入のためのHTML Embed（セキュリティ上の理由から明示的な有効化が必要）
- すべて選択機能
- 画像URL自動変換のためのAuto Image
- 拡張テーブル構造のためのLayout Table
- WProofreader文法・スペルチェック統合（Premium Featuresモジュールが必要）
Use Cases
企業ドキュメントのスタイリング
Fontプラグインを使用して承認された企業フォントとブランドカラーを定義します。Font Familyに組織のフォントスタックを設定し、Font Colorにブランド承認済みの色を設定して、すべてのコンテンツエディタ間で一貫したドキュメントスタイリングを確保します。
コンテンツライターの生産性向上
Word Countを有効にしてライターがコンテンツの長さ要件を満たせるようにします。長文コンテンツの効率的な編集のためにFind and Replaceと組み合わせます。プレスリリース、製品説明、ブログ投稿フォーマットなどの一般的なコンテンツ構造用にTemplatesを追加します。
技術文書作成
印刷可能なドキュメントにはPage Breakを、長いドキュメント内のナビゲーションにはBookmarksを、ドキュメント内のタスク追跡にはTo-do Listsを使用します。Paste from Markdownは開発者がコードドキュメントをエディタに直接コピーするのに役立ちます。
マーケティングコンテンツの作成
ソーシャルメディア向けのコンテンツにはEmojiを、ビデオ統合にはMedia Embedを、重要なメッセージを強調するにはHighlightを有効にします。Fullscreenモードは長文マーケティングコンテンツの集中執筆を提供します。
多言語コンテンツ管理
翻訳サポート付きのTemplates機能を使用して、言語間で一貫したコンテンツ構造を維持します。テンプレートはDrupalの設定翻訳システムを通じて翻訳できます。
Tips
- CKEditor 5が更新されたときの自動バージョン置換のために、DLLパスに@tokenプレースホルダーを使用してください
- グローバル設定を期待するのではなく、各プラグインのテキストフォーマット固有の設定を構成してください
- エディタツールバーをクリーンに保ち、JavaScript読み込みを減らすために、必要なサブモジュールのみを有効にしてください
- Templatesの場合、保存前にアイコンプレビューとテンプレートプレビューボタンを使用してコンテンツを確認してください
- Block CDNオプションは、ローカルDLLファイルが正しくインストールされていることを確認した場合にのみ使用してください
Technical Details
Admin Pages 3
/admin/config/ckeditor5-plugin-pack
DLLファイルの場所やCDNブロックオプションなど、CKEditor 5 Plugin Packのグローバル設定を構成します。
/admin/config/ckeditor5-templates/content-templates
ユーザーがエディタに挿入できる事前定義されたコンテンツテンプレートを管理します。テンプレートの作成、編集、削除、並べ替えができます。
/admin/config/ckeditor5-templates/content-templates/add
HTMLコンテンツ、オプションのアイコン、テキストフォーマットの割り当てを含む新しいコンテンツテンプレートを作成します。
権限 1
Troubleshooting 5
CDNにアクセス可能かどうか、またはローカルDLLファイルが正しく配置されているかを確認してください。設定のDLLの場所パスを確認してください。ローカルファイルを使用する場合は、ディレクトリ構造が一致していることを確認してください：/path/@token/dll/[plugin]/[plugin].js
テンプレートが有効で、正しいテキストフォーマットに割り当てられていることを確認してください。ユーザーがテキストフォーマットにアクセスできることを確認してください。/admin/config/ckeditor5-templates/content-templatesでテンプレートが作成されていることを確認してください。
まず/admin/config/ckeditor5-plugin-packで「HTML Embedモジュールのインストールを許可」チェックボックスを有効にしてから、サブモジュールをインストールしてください
各サブモジュールのinfo.ymlのcore_version_requirementを確認してください。一部の機能にはDrupal 10.2以降、10.3以降、10.5以降、または11.xが必要です。必要に応じてDrupal coreをアップグレードしてください。
Highlightプラグイン設定で「レンダリングされたコンテンツのスタイルを自動的に追加」を有効にして、カスタムマーカー用のCSSを生成してください
Security Notes 3
- HTML Embedプラグインは生のHTML挿入を許可するため、セキュリティリスクになる可能性があります。インストールには明示的な許可が必要で、信頼できるユーザーにのみ有効にすべきです。
- テンプレートコンテンツは設定として保存され、任意のHTMLを含むことができるため、デプロイ前に確認する必要があります
- このモジュールはDrupalの標準的な権限システムを使用します - 「administer ckeditor5 templates」権限は信頼できる管理者にのみ付与されていることを確認してください