docs/fsf-drupal-auth.md

   1 # About fsfdrupalauth / README
   2
   3 This code is based off of the [sqlauth][1] module in upstream SimpleSAMLphp. It
   4 queries whether people are FSF CAS users, and/or whether they are FSF members
   5 or staff.
   6
   7 SQL queries in `config/authsources.php` should be something like the following:
   8
   9     'my-drupalauth' => [
  10
  11         // custom fsf authentication source wrapped by ratelimit auth source
  12         'fsfdrupalauth:FSFDrupalAuth',
  13         'nomination_process_contrib_start_date' => '2017-01-01',
  14         'nomination_process_contrib_end_date' => '2022-01-01',
  15         'dsn' => 'mysql:host=example.com;port=3306;dbname=drupal',
  16         'username' => '$DB_USERNAME',
  17         'password' => '$DB_PASSWORD',
  18         'query_main' => 'SELECT pass, mail FROM users WHERE name = :username AND status = "1" limit 1;',
  19         // don't filter with 'and c.is_test = 0' because these may be useful for FSF staff
  20         'query_membership' => "select c.status_id from drupal.users a inner join civicrm.civicrm_uf_match b on a.uid=b.uf_id inner join civicrm.civicrm_membership c on b.contact_id=c.contact_id inner join civicrm.civicrm_contact d on c.contact_id=d.id where a.status = 1 and d.is_deleted = 0 and c.status_id is not NULL and a.name = :username and (c.status_id = 1 or c.status_id = 2 or c.status_id = 3 or c.status_id = 4) order by c.status_id limit 10;",
  21         'query_staff' => "select a.name as is_fsf_staff from drupal.users a inner join civicrm.civicrm_uf_match b on a.uid=b.uf_id inner join civicrm.civicrm_contact c on b.contact_id=c.id inner join civicrm.civicrm_relationship d on c.id=d.contact_id_a where a.name=:username and a.status=1 and c.is_deleted=0 and d.relationship_type_id=4 and d.contact_id_b=FOOBAR and d.is_active=1 and (d.end_date>NOW() or d.end_date is NULL) limit 1;",
  22         'query_nomination_process_donations' => "select sum(d.total_amount) from drupal.users a inner join civicrm.civicrm_uf_match b on a.uid=b.uf_id inner join civicrm.civicrm_contact c on b.contact_id=c.id inner join civicrm.civicrm_contribution d on c.id=d.contact_id where a.name = :username and (d.financial_type_id = '2' or :all_contribs) and d.receive_date > :start_date and d.receive_date < :end_date;",
  23         'query_nomination_process_gift_receipt' => "select count(*) from drupal.users a inner join civicrm.civicrm_uf_match b on a.uid=b.uf_id inner join civicrm.civicrm_contact c on b.contact_id=c.id inner join civicrm.civicrm_contribution d on c.id=d.contact_id where a.name = :username and d.contribution_page_id = :gift_redeem_page and d.receive_date > :start_date and d.receive_date < :end_date;",
  24
  25     ],
  26
  27 ## License
  28
  29 See COPYING file.
  30
  31 ---
  32
  33 [1]: https://github.com/simplesamlphp/simplesamlphp-module-sqlauth
  34