Additional search information added

Author: Webklex

README.md

@@ -30,33 +30,33 @@ Laravel IMAP is an easy way to integrate the native php imap library into your *
 
 ## Installation
 
-1) Install the php-imap library if it isn't already installed:
+1. Install the php-imap library if it isn't already installed:
 
 ``` shell
 sudo apt-get install php*-imap && sudo apache2ctl graceful
 ```
 
 You might also want to check `phpinfo()` if the extension is enabled.
 
-2) Now install the Laravel IMAP package by running the following command:
+2. Now install the Laravel IMAP package by running the following command:
 
 ``` shell
 composer require webklex/laravel-imap
 ```
 
-3) Open your `config/app.php` file and add the following to the `providers` array:
+3. Open your `config/app.php` file and add the following to the `providers` array:
 
 ``` php
 Webklex\IMAP\Providers\LaravelServiceProvider::class,
 ```
 
-4) In the same `config/app.php` file add the following to the `aliases ` array: 
+4. In the same `config/app.php` file add the following to the `aliases ` array: 
 
 ``` php
 'Client' => Webklex\IMAP\Facades\Client::class,
 ```
 
-5) Run the command below to publish the package config file [config/imap.php](src/config/imap.php):
+5. Run the command below to publish the package config file [config/imap.php](src/config/imap.php):
 
 ``` shell
 php artisan vendor:publish
@@ -84,18 +84,18 @@ The following encryption methods are supported:
 Detailed [config/imap.php](src/config/imap.php) configuration:
  - `default` — by default this the imap handler will use this given account.
  - `accounts` — all available accounts
-  - `default` — account identifier
-    - `host` — imap host
-    - `port` — imap port
-    - `encryption` — desired encryption method
-    - `validate_cert` — decide weather you want to verify the certificate or not
-    - `username` — imap account username
-    - `password` — imap account password
-  - `options` — additional fetch options
-    - `delimiter` — you can use any supported char such as ".", "/", etc
-    - `fetch` — `FT_UID` (message marked as read by fetching the message) or `FT_PEEK` (fetch the message without setting the "read" flag)
-    - `open` — special configuration for imap_open()
-      - `DISABLE_AUTHENTICATOR` — Disable authentication properties.
+   - `default` — account identifier
+     - `host` — imap host
+     - `port` — imap port
+     - `encryption` — desired encryption method
+     - `validate_cert` — decide weather you want to verify the certificate or not
+     - `username` — imap account username
+     - `password` — imap account password
+   - `options` — additional fetch options
+     - `delimiter` — you can use any supported char such as ".", "/", etc
+     - `fetch` — `FT_UID` (message marked as read by fetching the message) or `FT_PEEK` (fetch the message without setting the "read" flag)
+     - `open` — special configuration for imap_open()
+       - `DISABLE_AUTHENTICATOR` — Disable authentication properties.
 
 ## Usage
 
@@ -200,6 +200,37 @@ foreach($aMessage as $oMessage){
 }
 ```
 
+Available search criteria:
+- `ALL` — return all messages matching the rest of the criteria
+- `ANSWERED` — match messages with the \\ANSWERED flag set
+- `BCC` "string" — match messages with "string" in the Bcc: field
+- `BEFORE` "date" — match messages with Date: before "date"
+- `BODY` "string" — match messages with "string" in the body of the message
+- `CC` "string" — match messages with "string" in the Cc: field
+- `DELETED` — match deleted messages
+- `FLAGGED` — match messages with the \\FLAGGED (sometimes referred to as Important or Urgent) flag set
+- `FROM` "string" — match messages with "string" in the From: field
+- `KEYWORD` "string" — match messages with "string" as a keyword
+- `NEW` — match new messages
+- `OLD` — match old messages
+- `ON` "date" — match messages with Date: matching "date"
+- `RECENT` — match messages with the \\RECENT flag set
+- `SEEN` — match messages that have been read (the \\SEEN flag is set)
+- `SINCE` "date" — match messages with Date: after "date"
+- `SUBJECT` "string" — match messages with "string" in the Subject:
+- `TEXT` "string" — match messages with text "string"
+- `TO` "string" — match messages with "string" in the To:
+- `UNANSWERED` — match messages that have not been answered
+- `UNDELETED` — match messages that are not deleted
+- `UNFLAGGED` — match messages that are not flagged
+- `UNKEYWORD` "string" — match messages that do not have the keyword "string"
+- `UNSEEN` — match messages which have not been read yet
+
+Further information:
+- http://php.net/manual/en/function.imap-search.php
+- https://tools.ietf.org/html/rfc1064
+- https://tools.ietf.org/html/rfc822
+     
 Paginate a message collection:
 ``` php
 use Webklex\IMAP\Facades\Client;