You are browsing a read-only backup copy of Wikitech. The live site can be found at wikitech.wikimedia.org

Fundraising/External-facing/E-mail preferences: Difference between revisions

From Wikitech-static
Jump to navigation Jump to search
imported>Cstone
No edit summary
imported>Wfan
(wip)
Line 4: Line 4:
https://phabricator.wikimedia.org/T125272
https://phabricator.wikimedia.org/T125272


* local test link: <nowiki>https://localhost:9002/index.php/Special:EmailPreferences/emailPreferences?contact_hash=2261039855&contact_id=6</nowiki>
* local test link: https://localhost:9002/index.php/Special:EmailPreferences/emailPreferences?checksum=705239735920094e8b2cf6c1f9b04215_1645597635_168&contact_id=208
* local Json response test link: <nowiki>https://localhost:9005/rest.php?entity=civiproxy&action=getpreferences&key=SITE_KEY&version=3&json=1&api_key=API_KEY&hash=2261039855&contact_id=6</nowiki>
* local Json response test link: https://localhost:9005/rest.php?entity=civiproxy&action=getpreferences&key=SITE_KEY&version=3&json=1&checksum=705239735920094e8b2cf6c1f9b04215_1645597635_168&api_key=API_KEY&contact_id=208
* Queue consume
* Queue consume


Line 17: Line 17:


* Css file: src/email-pref-ctr/extensions/DonationInterface/modules/css/emailPreferences.css
* Css file: src/email-pref-ctr/extensions/DonationInterface/modules/css/emailPreferences.css
 
* Js file: src/email-pref-ctr/extensions/DonationInterface/modules/js/ext.donationInterface.emailPreferences.js
* Cmd to consume email preference update queue: drush cvapi Preferencesqueue.consume time_limit=1000 max_batch_size=1


== Queue ==
== Queue ==


<code>drush cvapi Preferencesqueue.consume time_limit=1000 max_batch_size=1</code>
<code>drush cvapi Preferencesqueue.consume time_limit=1000 max_batch_size=1</code>
== Unit Test ==
<syntaxhighlight lang="bash">
./vendor/bin/phpunit --filter testEmailPreferenceCenterUpdateApi
</syntaxhighlight>


== Civiproxy ==
== Civiproxy ==
Official documentation: https://docs.civicrm.org/civiproxy/en/latest/
Official documentation: https://docs.civicrm.org/civiproxy/en/latest/


Link to test from docker add in key and hash from a test contact:  
* Link to test from docker add in key and hash from a test contact (need checksum and contact_id): [https://localhost:9005/rest.php?entity=civiproxy&action=getpreferences&key=SITE_KEY&version=3&json=1&checksum=705239735920094e8b2cf6c1f9b04215_1645597635_168&api_key=API_KEY&contact_id=208 https://localhost:9005/rest.php?entity=civiproxy&action=getpreferences&key=SITE_KEY&version=3&json=1&checksum=&api_key=API_KEY&contact_id=]
https://localhost:9005/rest.php?entity=civiproxy&action=getpreferences&key=SITE_KEY&version=3&json=1&api_key=API_KEY&hash=&contact_id=
 
* Local civi url to see the api : http://wmff.localhost:32353/civicrm/api3#explorer: select contact -> get -> then input the contact id and the checksum there to see the donor info
 
* Check user from civi edit, and you will see the opt in, email, and their prefer language, and the country only for Email preference center.


[[File:Email Prefs CiviProxy 1.png|left|frameless|500x500px|Diagram of the Email Preference Center and Civiproxy flow from 2021]]
[[File:Email Prefs CiviProxy 1.png|left|frameless|500x500px|Diagram of the Email Preference Center and Civiproxy flow from 2021]]

Revision as of 18:34, 28 February 2022

Overview

The email preference center is a standalone wiki that uses civiproxy to talk to civicrm.

https://phabricator.wikimedia.org/T125272

  1. /src/civi-sites/wmff/drupal/sites/default/civicrm/extensions/wmf-civicrm/CRM/Queue/PreferencesQueueConsumer.php
  2. /src/civi-sites/wmff/drupal/sites/default/civicrm/extensions/wmf-civicrm/api/v3/Preferencesqueue/Consume.php
  3. /src/civi-sites/wmff/drupal/sites/default/civicrm/extensions/wmf-civicrm/api/v3/Preferences/Create.php
  • Documentation of Email Preference: https://docs.google.com/document/d/1wKtGxJn06bs6OGAFV7DKUfVw2salKdU_NAUn5SMGks0/edit#
  • Design: https://design.bytrilogy.com/wikimedia-email-preference-center?frequency=cat&button=&s=#epc-form-col-content-salutation-email-edit
  • Css file: src/email-pref-ctr/extensions/DonationInterface/modules/css/emailPreferences.css
  • Js file: src/email-pref-ctr/extensions/DonationInterface/modules/js/ext.donationInterface.emailPreferences.js

Queue

drush cvapi Preferencesqueue.consume time_limit=1000 max_batch_size=1

Unit Test

./vendor/bin/phpunit --filter testEmailPreferenceCenterUpdateApi

Civiproxy

Official documentation: https://docs.civicrm.org/civiproxy/en/latest/

  • Check user from civi edit, and you will see the opt in, email, and their prefer language, and the country only for Email preference center.