issue #94: add support for autocomplete user profile field

Author: dmitriim

classes/condition_base.php

@@ -55,6 +55,11 @@ abstract class condition_base {
      */
     public const FIELD_DATA_TYPE_DATETIME = 'datetime';
 
+    /**
+     * Value for date field types.
+     */
+    public const FIELD_DATA_TYPE_AUTOCOMPLETE = 'autocomplete';
+
     /**
      * Value for operator text contains.
      */

classes/local/tool_dynamic_cohorts/condition/fields_trait.php

@@ -411,4 +411,67 @@ protected function get_date_sql(string $tablealias, string $fieldname): conditio
 
         return new condition_sql('', $where, $params);
     }
+
+    /**
+     * Get SQl data for autocomplete type fields.
+     *
+     * @param string $tablealias Alias for a table.
+     * @param string $fieldname Field name.
+     * @return condition_sql
+     */
+    protected function get_autocomplete_sql(string $tablealias, string $fieldname): condition_sql {
+        global $DB;
+
+        $fieldvalue = $this->get_field_value();
+        $operatorvalue = $this->get_operator_value();
+
+        if ($this->is_broken()) {
+            return new condition_sql('', '', []);
+        }
+
+        // User data for autocomplete field is stored like  Option 1, Option 2, Option 3.
+        // So to be accurate in our SQL we have to cover three scenarios:
+        // 1. Value is in the beginning of the string.
+        // 2. Value is somewhere in the middle.
+        // 3. Value is at the end of the string.
+        // So our SQL should like:
+        // WHERE data like 'value%' OR data like '% value, %' OR data like '%, value'
+        // This is a bit hacky, but should give us accurate results.
+        $startparam = condition_sql::generate_param_alias();
+        $middleparam = condition_sql::generate_param_alias();
+        $endparam = condition_sql::generate_param_alias();
+
+        switch ($operatorvalue) {
+            case self::TEXT_IS_EQUAL_TO:
+                $value = $DB->sql_like_escape($fieldvalue);
+
+                $where = $DB->sql_like("$tablealias.$fieldname", ":$startparam", false, false);
+                $params[$startparam] = "$value%";
+
+                $where .= ' OR ' . $DB->sql_like("$tablealias.$fieldname", ":$middleparam", false, false);
+                $params[$middleparam] = "%, $value, %";
+
+                $where .= ' OR ' . $DB->sql_like("$tablealias.$fieldname", ":$endparam", false, false);
+                $params[$endparam] = "%, $value";
+
+                break;
+            case self::TEXT_IS_NOT_EQUAL_TO:
+                $value = $DB->sql_like_escape($fieldvalue);
+
+                $where = $DB->sql_like("$tablealias.$fieldname", ":$startparam", false, false, true);
+                $params[$startparam] = "$value%";
+
+                $where .= ' AND ' . $DB->sql_like("$tablealias.$fieldname", ":$middleparam", false, false, true);
+                $params[$middleparam] = "%, $value, %";
+
+                $where .= ' AND ' . $DB->sql_like("$tablealias.$fieldname", ":$endparam", false, false, true);
+                $params[$endparam] = "%, $value";
+
+                break;
+            default:
+                return new condition_sql('', '', []);
+        }
+
+        return new condition_sql('', $where, $params);
+    }
 }

classes/local/tool_dynamic_cohorts/condition/user_custom_profile.php

@@ -53,8 +53,13 @@ public function get_name(): string {
      * @return array
      */
     protected function get_supported_custom_fields(): array {
-        return [self::FIELD_DATA_TYPE_TEXT, self::FIELD_DATA_TYPE_MENU,
-            self::FIELD_DATA_TYPE_CHECKBOX, self::FIELD_DATA_TYPE_DATETIME];
+        return [
+            self::FIELD_DATA_TYPE_TEXT,
+            self::FIELD_DATA_TYPE_MENU,
+            self::FIELD_DATA_TYPE_CHECKBOX,
+            self::FIELD_DATA_TYPE_DATETIME,
+            self::FIELD_DATA_TYPE_AUTOCOMPLETE,
+        ];
     }
 
     /**
@@ -79,7 +84,8 @@ protected function get_fields_info(): array {
 
             switch ($field->datatype) {
                 case self::FIELD_DATA_TYPE_MENU:
-                    $options = explode("\n", $field->param1);
+                case self::FIELD_DATA_TYPE_AUTOCOMPLETE:
+                $options = explode("\n", $field->param1);
                     $field->param1 = array_combine($options, $options);
                     break;
                 case self::FIELD_DATA_TYPE_TEXT:
@@ -124,7 +130,8 @@ public function config_form_add(\MoodleQuickForm $mform): void {
                     $this->add_text_field($mform, $group, $field, $shortname);
                     break;
                 case self::FIELD_DATA_TYPE_MENU:
-                    $this->add_menu_field($mform, $group, $field, $shortname);
+                case self::FIELD_DATA_TYPE_AUTOCOMPLETE:
+                $this->add_menu_field($mform, $group, $field, $shortname);
                     break;
                 case self::FIELD_DATA_TYPE_CHECKBOX:
                     $this->add_checkbox_field($mform, $group, $field, $shortname);
@@ -192,6 +199,9 @@ public function get_sql(): condition_sql {
             case self::FIELD_DATA_TYPE_DATETIME:
                 $result = $this->get_date_sql($ud, 'data');
                 break;
+            case self::FIELD_DATA_TYPE_AUTOCOMPLETE:
+                $result = $this->get_autocomplete_sql($ud, 'data');
+                break;
         }
 
         if (!empty($result->get_params())) {