Fasttoggle
コンテンツページから直接、ノードやコメントのプロパティをAJAXによるワンクリックで切り替える機能を提供します。
fasttoggle
インストール
composer require 'drupal/fasttoggle:^4.0'
概要
Fasttoggleは、管理設定やコンテンツの値をAJAXベースで切り替える機能を提供し、サイト管理を簡素化・高速化するDrupalモジュールです。公開状態、フロントページへの掲載、リストの先頭に固定といった一般的なノードプロパティを変更するために編集フォームに移動する代わりに、管理者はコンテンツ表示ページから直接ワンクリックでこれらの値を切り替えることができます。
このモジュールはノードとコメントの操作にトグルリンクを追加し、ページをリロードせずに素早くステータスを変更できます。設定可能なラベルスタイルをサポートしており、現在の状態を表示する形式（例：「公開済み」「掲載中」）と、クリック時に実行されるアクションを表示する形式（例：「非公開にする」「掲載を解除する」）のいずれかを選択できます。各コンテンツタイプを個別に設定して、特定のトグルオプションを有効または無効にできるため、異なるコンテンツタイプごとにどのトグルを利用可能にするか詳細に制御できます。
Features
- ノードの公開状態（公開/非公開）をAJAXによるワンクリックで切り替え
- ノードのフロントページへの掲載（掲載/非掲載）をAJAXによるワンクリックで切り替え
- ノードの固定表示状態（固定/固定解除）をAJAXによるワンクリックで切り替え
- コメントの公開状態（公開/非公開）をAJAXによるワンクリックで切り替え
- 2つの設定可能なラベルスタイル：現在の状態を表示するステータスベースのラベル、またはクリック時に何が起こるかを表示するアクションベースのラベル
- コンテンツタイプごとの設定により、管理者は各ノードタイプに対して特定のトグルを有効/無効にできる
- コメントステータスのトグルに対応したコメントタイプごとの設定
- トグルリンクはページリロードなしでノードおよびコメントの操作リンクに表示される
Use Cases
迅速なコンテンツモデレーション
ニュースサイトを管理するサイト編集者は、編集フォームに移動せずにノード表示ページから直接記事を素早く公開・非公開にできます。コンテンツをレビューする際、「公開」または「非公開にする」リンクをクリックするだけで、即座にコンテンツのステータスを変更できます。
フロントページコンテンツ管理
コンテンツ管理者はトグルリンクをクリックするだけで、フロントページへのコンテンツの掲載・掲載解除を簡単に行えます。これはホームページにコンテンツを表示し、どの記事を表示するか素早くローテーションする必要があるサイトに便利です。
重要なお知らせの固定表示
重要なお知らせをリストページの先頭に表示し続ける必要がある場合、管理者は「固定にする」リンクをクリックしてコンテンツを固定できます。重要性がなくなったら、「固定解除する」をクリックして先頭位置から外すことができます。
コメントモデレーション
コメントモデレーターは、コメントが表示されているノードページから直接、個々のコメントを素早く公開・非公開にできます。これにより、別の管理ページを訪問する必要がなくなり、モデレーションワークフローが高速化されます。
大量コンテンツレビューワークフロー
複数のコンテンツをレビューする際、管理者はコンテンツページをスキャンしながら様々なプロパティを素早く切り替えることができ、各ノードを個別に編集するよりも効率的にレビュープロセスを進められます。
Tips
- インターフェースをすっきりさせ、誤った変更を防ぐため、各コンテンツタイプで実際に必要なトグルのみを有効にしてください
- より直感的なユーザー体験のために、アクションベースのラベルスタイル（オプション1）の使用を検討してください - ユーザーはクリックすると何が起こるかすぐにわかります
- Fasttoggleリンクはノードリンクエリアに表示されますが、テーマによって異なるスタイルが適用される場合があります
- このモジュールはDrupalの権限システムと連携するため、'use fasttoggle'権限を「コンテンツ編集者」などの特定のロールに付与し、'administer fasttoggle'は管理者に限定できます
- トグルアクションはAJAXで実行され、ページリロードなしで即座にフィードバックが得られますが、変更は直ちにデータベースに保存されます
Technical Details
Admin Pages 3
/admin/config/system/fasttoggle
Fasttoggleのグローバル設定、特にトグルリンクがユーザーにどのように表示されるかを決定するラベルスタイルを設定します。
/admin/structure/types/manage/{node_type}
各コンテンツタイプの編集フォームにはFasttoggle垂直タブが含まれており、管理者はそのコンテンツタイプの特定のトグルオプションを有効または無効にできます。これにより、どのコンテンツタイプがどのトグルアクションをサポートするか詳細に制御できます。
/admin/structure/comment/manage/{comment_type}
各コメントタイプの編集フォームにはFasttoggle垂直タブが含まれており、管理者はそのタイプのコメントに対するステータストグルを有効または無効にできます。
権限 2
Hooks 5
hook_node_links_alter
コンテンツタイプの設定に基づいて、ノードの操作リンクにFasttoggleアクションリンクを追加します
hook_comment_links_alter
コメントタイプの設定に基づいて、コメントの操作リンクにFasttoggleアクションリンクを追加します
hook_form_node_type_edit_form_alter
ノードタイプ編集フォームにFasttoggle設定オプションを垂直タブとして追加し、ステータス、掲載、固定表示のトグルを有効にするチェックボックスを表示します
hook_form_comment_type_edit_form_alter
コメントタイプ編集フォームにFasttoggle設定オプションを垂直タブとして追加し、ステータストグルを有効にするチェックボックスを表示します
hook_help
モジュールのヘルプページにREADME.mdの内容を表示します
Troubleshooting 4
以下を確認してください：1) ユーザーが'use fasttoggle'権限を持っている、2) 特定のコンテンツタイプでFasttoggleオプションが有効になっている（管理 > サイト構築 > コンテンツタイプ > [タイプ] > 編集）、3) 設定変更後にキャッシュをクリアしている。
以下を確認してください：1) ユーザーが'use fasttoggle'権限を持っている、2) コメントタイプでステータストグルが有効になっている（管理 > サイト構築 > コメントタイプ > [タイプ] > 編集）、3) 設定変更後にキャッシュをクリアしている。
DrupalのAJAXライブラリが正しく読み込まれていること、ブラウザコンソールにJavaScriptエラーがないことを確認してください。トグルリンクはDrupalコアのAJAX機能を必要とする'use-ajax'クラスを使用しています。
管理 > 環境設定 > システム > Fasttoggleに移動し、ラベルスタイルの設定を確認してください。スタイル0は現在のステータス（例：'公開済み'）を表示し、スタイル1はアクション（例：'非公開にする'）を表示します。
Security Notes 4
- このモジュールはDrupalの権限システムを使用しています - 'use fasttoggle'権限を持つユーザーのみがトグルアクションを実行できます
- トグルアクションはエンティティのステータス、掲載、固定表示の値を変更するため、サイトの表示やコンテンツ表示に影響を与える可能性があります
- 'use fasttoggle'権限はコンテンツの公開ステータスを素早く変更できるため、どのロールにこの権限を付与するか慎重に検討してください
- 'administer fasttoggle'権限はラベルスタイル設定の影響を理解している信頼できる管理者に限定すべきです