Find messages by custom search criteria

Author: Webklex

README.md

@@ -276,6 +276,11 @@ $aMessage = $oFolder->query()
 $aMessage = $oFolder->query()->notText('hello world')->get();
 $aMessage = $oFolder->query()->not_text('hello world')->get();
 $aMessage = $oFolder->query()->not()->text('hello world')->get();
+
+//Get all messages by custom search criteria
+/** @var \Webklex\IMAP\Support\MessageCollection $aMessage */
+$aMessage = $oFolder->query()->where(["CUSTOM_FOOBAR" => "fooBar"]])->get();
+
 ```
 
 Available search aliases for a better code reading:

src/IMAP/Query/WhereQuery.php

@@ -99,6 +99,9 @@ public function __call($name, $arguments) {
     protected function validate_criteria($criteria) {
         $criteria = strtoupper($criteria);
 
+        if (substr($criteria, 0, 6) === "CUSTOM") {
+            return substr($criteria, 6);
+        }
         if(in_array($criteria, $this->available_criteria) === false) {
             throw new InvalidWhereQueryCriteriaException();
         }
@@ -391,16 +394,6 @@ public function whereUnseen() {
         return $this->where('UNSEEN');
     }
 
-    /**
-     * @param $msg_id
-     *
-     * @return WhereQuery
-     * @throws InvalidWhereQueryCriteriaException
-     */
-    public function whereMessageId($msg_id) {
-        return $this->where("Message-ID <$msg_id>");
-    }
-
     /**
      * @return WhereQuery
      * @throws InvalidWhereQueryCriteriaException