Webform CiviCRM Integration

DrupalのWebformモジュールとCiviCRMを統合し、シームレスなデータ収集とCRM機能を実現する強力なフォームビルダー。

webform_civicrm
2,379 sites
23
drupal.org

インストール

Drupal 10, 9 v6.3.1
composer require 'drupal/webform_civicrm:^6.3'

概要

Webform CiviCRM Integrationは、DrupalのWebformモジュールとオープンソースの顧客関係管理システムであるCiviCRMを橋渡しする包括的なモジュールです。WebformをCiviCRMデータベースと直接連携する強力なデータ収集ツールに変換します。

このモジュールを使用すると、シンプルなニュースレター登録フォームから、複雑なマルチステップの登録システム、イベント登録、会員登録、寄付フォームまで、あらゆるフォームを作成できます。すべてのフォーム送信で、連絡先の自動作成・更新、決済処理、イベント参加者登録、会員資格の作成、活動の記録、関係の管理などが自動的に行えます。

直感的な管理インターフェースにより、サイト構築者はコードを書くことなく、Webformに公開するCiviCRMエンティティやフィールドの設定、重複を防ぐための自動連絡先マッチングルールの設定、DrupalとCiviCRM間のデータフローの制御が可能です。

Features

  • 設定可能なマッチングルールを使用した自動重複検出機能付きで、Webform送信からCiviCRM連絡先(個人、組織、世帯)を作成・更新
  • サポートされている決済プロセッサ(Stripe、IATS、その他のオンサイトプロセッサ)を通じてオンライン決済を処理し、定期支払いにも対応
  • 設定可能な登録オプション、価格設定、定員検証機能付きでCiviCRMイベントへの参加者登録
  • 自動期間計算と決済統合によるCiviCRM会員資格の作成と更新
  • 設定可能な活動タイプ、ステータス、担当者割り当てにより、連絡先にリンクされた活動やケースを記録
  • 雇用者/従業員やカスタム関係タイプをサポートし、同一フォーム上の複数連絡先間の関係を管理
  • セレクトリストの静的およびライブオプション読み込みを備えたCiviCRMカスタムフィールドのサポート
  • フォーム送信に基づいて連絡先をグループに追加し、タグを割り当て。メーリングリストのオプションのダブルオプトイン対応
  • 明細項目、ソフトクレジット、設定可能な領収書メールを含む寄付金の処理
  • ステータス追跡とカスタムフィールドサポート付きの助成金申請フォーム
  • ログインユーザー向けのフォーム事前入力、またはCiviMailチェックサムリンクによるパーソナライズされた匿名アクセス
  • グループ、タグ、関係、連絡先サブタイプによる設定可能なフィルター付き連絡先オートコンプリート選択
  • 連絡先住所からのコピーオプション付き請求先住所フィールド
  • 1回の送信で複数人の登録をサポートするマルチコンタクトフォーム

Use Cases

寄付フォーム

寄付者情報を収集し、サポートされている決済プロセッサを通じてクレジットカード決済を処理し、CiviCRMで寄付者の連絡先レコードを作成または更新し、オプションの定期支払い設定付きで寄付を記録し、自動領収書メールを送信する寄付フォームを作成します。

イベント登録

ユーザーが自分自身と追加の参加者をCiviCRMイベントに登録できるイベント登録フォームを構築します。複数のイベントからの参加者選択、価格セット統合、ウェイトリスト処理、自動参加者ステータス管理をサポートします。

会員登録と更新

新規会員の登録と既存会員の更新を可能にする会員フォームを作成します。複数の会員タイプ、自動期間計算、決済収集、会員コミュニケーション設定をサポートします。

ニュースレター登録

CiviCRMグループ(メーリングリスト)に連絡先を追加するシンプルまたは複雑なニュースレター登録フォーム。公開メーリングリスト用のダブルオプトイン確認メールをサポートし、追加の連絡先情報を収集できます。

ボランティア申請

連絡先詳細、興味、利用可能時間、スキルを収集するボランティア受付フォームを作成します。活動を使用して申請を追跡し、ボランティアをグループに割り当て、スタッフ連絡先との関係を確立します。

助成金申請

設定可能な助成金タイプ、金額、ステータス追跡を備えたCiviCRMで助成金レコードを作成する助成金申請フォームを構築します。申請者情報とサポート文書を収集します。

連絡先更新フォーム

チェックサム付きのパーソナライズされたリンクをCiviMail経由で送信することで、既存の連絡先が自分の情報を更新できるようにします。フォームは既存のデータで事前入力され、送信時にCiviCRMレコードを更新します。

マルチコンタクト関係フォーム

親がプログラムに子供を登録する場合など、1つのフォームで複数の関連する連絡先の情報を収集します。CiviCRMで連絡先間の関係レコードを自動的に作成します。

Tips

  • 送信者が誰かを自動的に認識すべきフォームには、「静的」ウィジェットと「現在のユーザー」デフォルトを設定した「既存の連絡先」フィールドを使用してください。
  • イベントと会員資格タイプフィールドに「ライブオプション」を有効にすると、Webformを更新せずにCiviCRMでの変更が自動的に反映されます。
  • URLにCiviMailチェックサムを使用して、匿名ユーザーが連絡先情報が事前入力されたフォームにアクセスできるようにします。形式は次のとおりです:/form-url?cid1={contact.id}&{contact.checksum}
  • CiviCRMで適切な重複排除ルールを設定し、Webformのマッチングルール設定で選択して重複連絡先を防止してください。
  • 既知の連絡先のみがアクセスすべき機密性の高いフォームには「不明なユーザーをブロック」オプションを使用してください。
  • 決済を含むマルチページフォームの場合、決済フィールドは自動的に別の「決済」ページに配置されます。
  • 本番稼働前に決済フォームをテストモードで十分にテストしてください。ほとんどの決済プロセッサには開発中に使用すべきテスト/サンドボックスモードがあります。
  • 既存の連絡先フィールド設定の「ロックするフィールド」オプションを使用すると、連絡先が既に選択されている場合にユーザーが特定のフィールドを編集できないようにできます。
  • CiviCRMデータを確認する際に連絡先やその他のエンティティの発生元を追跡するために「ソースラベル」設定を使用してください。

Technical Details

Admin Pages 1
CiviCRM設定 /admin/structure/webform/manage/{webform}/civicrm

特定のWebformのCiviCRM統合を設定します。この包括的な設定ページでは、フォーム送信用のすべてのCiviCRMエンティティ、フィールド、処理オプションを有効化および設定できます。

権限 1
CiviCRMにアクセス

WebformのCiviCRMタブにアクセスするために必要です。この権限はCiviCRMモジュールによって提供されます。

Hooks 1
hook_civicrm_alterMailParams

Webformの領収書設定を寄付および会員資格メールに含めるためにCiviCRMメールパラメータを変更できます。

Troubleshooting 5
決済プロセッサが表示されない、または決済が失敗する

決済プロセッサがCiviCRMで適切に設定され、寄付に対して有効になっていることを確認してください。オンサイト決済プロセッサのみがサポートされています(PayPal Standardのようなリダイレクトベースのプロセッサはサポートされていません)。プロセッサで必要な場合は請求フィールドが有効になっているか確認してください。

連絡先が正しくマッチングされない、重複が作成される

CiviCRMタブのマッチングルール設定を確認してください。重複排除ルールで使用されるフィールドがWebformに存在し、必須になっていることを確認してください。既知の連絡先には「既存の連絡先」フィールドの使用を検討してください。

カスタムフィールドが管理インターフェースに表示されない

カスタムフィールドグループはCiviCRMで関連するエンティティタイプと連絡先タイプに対して有効になっている必要があります。カスタムグループの「extends」設定がフォームで使用しようとしているものと一致していることを確認してください。

イベントや会員資格がセレクトフィールドに読み込まれない

イベントがアクティブで終了していないことを確認してください(「過去のイベントを表示」が設定されていない場合)。会員資格については、会員資格タイプがアクティブでCiviCRMで適切に設定されていることを確認してください。

ログインユーザーにフォームが自動入力されない

「既存の連絡先」フィールドに適切なデフォルト値設定を構成してください。連絡先1を個人として設定する場合は、デフォルトを「現在のユーザー」に設定します。DrupalユーザーにリンクされたCiviCRM連絡先があることを確認してください。

Security Notes 4
  • 別のアクセス制御方法がない限り、既存の連絡先フィールドで「権限を強制」を常に有効にしてください。これにより、ユーザーはCiviCRMで表示権限を持つ連絡先のみを表示および選択できるようになります。
  • 連絡先IDに「URLによる自動入力を許可」を使用する際は注意が必要です。チェックサムやその他の検証で適切に保護されていない場合、ユーザーが他の連絡先のデータにアクセスできる可能性があります。
  • 決済プロセッサの資格情報と機密設定はDrupalではなくCiviCRMに保存され、CiviCRMのセキュリティプラクティスに従います。
  • クレジットカードの不正使用を防ぐため、決済処理を含むフォームには送信制限を有効にすることを検討してください。