CIVIMM-261: Support automatic email filing for case type categories o…

…ther than cases

CRM/Civicase/Hook/alterMailParams/SubjectProcessor.php

@@ -0,0 +1,60 @@
+<?php
+
+use CRM_Civicase_Helper_CaseCategory as CaseCategoryHelper;
+
+/**
+ * Class CRM_Civicase_Hook_alterMailParams_SubjectProcessor.
+ */
+class CRM_Civicase_Hook_alterMailParams_SubjectProcessor {
+
+  /**
+   * A substring of email subject that should be removed.
+   *
+   * @var string
+   *   This substring will be removed.
+   */
+  private $toRemove = '[case ';
+
+  /**
+   * Email subject processor.
+   *
+   * Remove word 'case' in email subject.
+   *
+   * @param array $params
+   *   Mail parameters.
+   * @param string $context
+   *   Mail context.
+   */
+  public function run(array &$params, $context) {
+    $caseId = CRM_Utils_Request::retrieve('caseid', 'Integer');
+    if (!$this->shouldRun($params, $context, $caseId)) {
+      return;
+    }
+
+    // Make sure we make just 1 replacement.
+    $subject = explode($this->toRemove, $params['subject'], 2);
+    $params['subject'] = '[' . $subject[1];
+  }
+
+  /**
+   * Determines if the hook will run.
+   *
+   * @param array $params
+   *   Mail parameters.
+   * @param string $context
+   *   Mail context.
+   * @param int $caseId
+   *   Case id.
+   *
+   * @return bool
+   *   returns TRUE if hook should run, FALSE otherwise.
+   */
+  private function shouldRun(array $params, $context, $caseId) {
+    if (empty($params['subject'])) {
+      return FALSE;
+    }
+    // If case id is set and email subject starts with '[case '.
+    return $caseId && strpos($params['subject'], $this->toRemove) === 0;
+  }
+
+}

civicase.php

@@ -573,7 +573,7 @@ function _civicase_add_case_category_case_type_entity(array &$entityTypes) {
  */
 function civicase_civicrm_alterMailParams(&$params, $context) {
   $hooks = [
-    new CRM_Civicase_Hook_alterMailParams_SubjectCaseTypeCategoryProcessor(),
+    new CRM_Civicase_Hook_alterMailParams_SubjectProcessor(),
     new CRM_Civicase_Hook_alterMailParams_AttachQuotation(),
   ];
 
@@ -660,3 +660,8 @@ function civicase_civicrm_alterContent(&$content, $context, $tplName, &$object)
     $hook->run();
   }
 }
+
+function civicase_civicrm_caseEmailSubjectPatterns(&$subjectPatterns) {
+  $subjectPatterns[] = '/\[[a-z0-9\s]*#([0-9a-f]{7})\]/i';
+  $subjectPatterns[] = '/\[[a-z0-9\s]*#(\d+)\]/i';
+}