add option to track institutional agreements

Author: hugosolar

plugins/cc-global-network/admin/user-application-page.php

@@ -215,6 +215,55 @@ function ccgn_application_mc_review_form ( $applicant_id ) {
         );
     }
 }
+function ccgn_application_institutional_agreement_form ( $applicant_id, $state ) {
+    if ( ccgn_current_user_is_legal_team() && ($state == CCGN_APPLICATION_STATE_LEGAL ) ) {
+        echo '<h2>Institutional Agreement</h2>';
+        $institutional_agreement_meta = get_user_meta($applicant_id, 'ccgn-institutional-agreement', true);
+        if (!empty($institutional_agreement_meta) && ($institutional_agreement_meta['status'] == 'sent-agreement')) {
+            $now = new DateTime('now');
+            $agreement_date = new DateTime($institutional_agreement_meta['date']);
+            echo '<p>Agreement sent: '.date('Y-m-d',strtotime($institutional_agreement_meta['date'])).' ('.$agreement_date->diff($now)->days.' days ago)';
+        }
+        $existing_entry = ccgn_entries_referring_to_user (
+            $applicant_id,
+            CCGN_GF_INSTITUTIONAL_AGREEMENT,
+            CCGN_GF_INSTITUTIONAL_AGREEMENT_ID
+        )[0];
+        gravity_form(
+            CCGN_GF_INSTITUTIONAL_AGREEMENT,
+            false,
+            false,
+            false,
+            array(
+                CCGN_GF_INSTITUTIONAL_AGREEMENT_CHECKBOX_PARAMETER
+                => $existing_entry[
+                    CCGN_GF_INSTITUTIONAL_AGREEMENT_CHECKBOX
+                ],
+                CCGN_GF_INSTITUTIONAL_AGREEMENT_ID_PARAMETER
+                => $applicant_id
+            )
+        );
+    }
+}
+function ccgn_application_institutional_agreement_submit_handler( $entry, $form ) {
+    if ( $form[ 'title' ] == CCGN_GF_INSTITUTIONAL_AGREEMENT ) {
+        $applicant_id = $entry[ CCGN_GF_INSTITUTIONAL_AGREEMENT_ID ];
+        if ($entry[ CCGN_GF_INSTITUTIONAL_AGREEMENT_CHECKBOX ] == 'yes') {
+            //The institutional agreement has been sent
+            $institutional_agreement_meta = array(
+                'status' => 'sent-agreement',
+                'date' => date('Y-m-d H:i:s', strtotime('now')),    
+            );
+            update_user_meta($applicant_id, 'ccgn-institutional-agreement', $institutional_agreement_meta);
+        } else {
+            $institutional_agreement_meta = array(
+                'status' => 'agreement-not-sent',
+                'date' => date('Y-m-d H:i:s', strtotime('now')),    
+            );
+            update_user_meta($applicant_id, 'ccgn-institutional-agreement', $institutional_agreement_meta);
+        }
+    }
+}
 function ccgn_application_mc_review_submit_handler( $entry, $form ) {
     if ( $form[ 'title' ] == CCGN_GF_MC_REVIEW ) {
         $applicant_id = $entry[ CCGN_GF_MC_REVIEW_APPLICANT_ID ];
@@ -811,6 +860,7 @@ function ccgn_application_users_page () {
     ccgn_application_users_page_render_details( $applicant_id, $state );
     ccgn_application_users_page_render_state( $applicant_id, $state );
     if ( ccgn_user_is_institutional_applicant( $applicant_id ) ) {
+        ccgn_application_institutional_agreement_form( $applicant_id, $state );
         ccgn_application_format_legal_approval( $applicant_id, $state );
     }
 }

plugins/cc-global-network/cc-global-network.php

@@ -255,6 +255,13 @@ function ccgn_sanitize_user_not_strict($user, $raw_user, $strict)
     2
 );
 
+add_action(
+    'gform_after_submission',
+    'ccgn_application_institutional_agreement_submit_handler',
+    10,
+    2
+);
+
 ////////////////////////////////////////////////////////////////////////////////
 // Forms for existing members
 ////////////////////////////////////////////////////////////////////////////////

plugins/cc-global-network/cron/remove-marked-users.php

@@ -45,18 +45,30 @@ function ccgn_check_accounts_to_be_removed()
       CCGN_APPLICATION_STATE_DELETE,
       CCGN_APPLICATION_STATE_DIDNT_UPDATE_VOUCHERS,
       CCGN_APPLICATION_STATE_CHARTER,
-      CCGN_APPLICATION_STATE_DETAILS
+      CCGN_APPLICATION_STATE_DETAILS,
+      CCGN_APPLICATION_STATE_LEGAL
     );
     $now = new DateTime('now');
     foreach ($states_to_delete as $state) {
       $applicants = ccgn_applicant_ids_with_state( $state );
       foreach ($applicants as $applicant_id) {
+        if ( $state == CCGN_APPLICATION_STATE_LEGAL) {
+          $stage = get_user_meta($applicant_id, 'ccgn-institutional-agreement', true);
+          if (!empty($stage) && ($stage['status'] == 'sent-agreement')) {
+            $agreement_date = new DateTime($stage['date']);
+            $days_in_state = $agreement_date->diff($now)->days;
+            if ($days_in_state > CCGN_REMOVE_APPLICATION_AFTER_DAYS) {
+              ccgn_close_and_remove_retention_data_applicant($applicant_id);
+            } 
+          }
+        } else {
           $status_date = get_user_meta($applicant_id, 'ccgn-application-state-date', true);
           $state_date = new DateTime($status_date);
           $days_in_state = $state_date->diff($now)->days;
           if ($days_in_state > CCGN_REMOVE_APPLICATION_AFTER_DAYS) {
             ccgn_close_and_remove_retention_data_applicant($applicant_id);
           } 
+        }
       }
     }
 }

plugins/cc-global-network/includes/application-state.php

@@ -108,6 +108,8 @@ function ccgn_applicant_type_desc ( $user_id ) {
 define( 'CCGN_APPLICATION_STATE_REVIEW', 'to-be-reviewed' );
 // This state applies to the new data retention policy, which should retain the data for no more than 30 days
 define('CCGN_APPLICATION_STATE_DELETE', 'to-be-deleted' );
+//legal is waiting for institutional agreement 30 days countdown to be deleted
+define('CCGN_APPLICATION_STATE_INSTITUTIONAL_AGREEMENT', 'waiting-institutional-agreement' );
 
 define(
     'CCGN_APPLICATION_STATE_CAN_BE_PRE_APPROVED',

plugins/cc-global-network/includes/gravityforms-interaction.php

@@ -31,6 +31,7 @@
 
 define('CCGN_GF_VOUCH', 'Vouch For Applicant');
 define('CCGN_GF_MC_REVIEW', 'MC user review');
+define('CCGN_GF_INSTITUTIONAL_AGREEMENT', 'Institutional Agreement');
 
 // Admin approval of applicant
 
@@ -208,6 +209,11 @@
 define('CCGN_GF_MC_REVIEW_NOTE_PARAMETER', 'mc-review-note');
 define('CCGN_GF_MC_REVIEW_APPLICANT_ID_PARAMETER', 'applicant_id');
 
+define('CCGN_GF_INSTITUTIONAL_AGREEMENT_CHECKBOX', '1.1');
+define('CCGN_GF_INSTITUTIONAL_AGREEMENT_CHECKBOX_PARAMETER', 'institutional_agreement_sent');
+define('CCGN_GF_INSTITUTIONAL_AGREEMENT_ID', '2');
+define('CCGN_GF_INSTITUTIONAL_AGREEMENT_ID_PARAMETER', 'applicant_id');
+
 // Field values that we need to check
 
 define('CCGN_GF_VOUCH_DO_YOU_VOUCH_YES', 'Yes');