Added 'dontParseTerm' method

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to `laravel-cross-eloquent-search` will be documented in this file
 
+## 1.1.0 - 2020-08-10
+
+- option to disable the parsing of the search term
+
 ## 1.0.0 - 2020-07-08
 
 - initial release

README.md

@@ -80,6 +80,15 @@ Search::add(Post::class, 'title')
     ->get('"macos big sur"');
 ```
 
+You can disable the parsing of the search term by calling the `dontParseTerm` method, which gives you the same results as using double-quotes.
+
+```php
+Search::add(Post::class, 'title')
+    ->add(Video::class, 'title')
+    ->dontParseTerm()
+    ->get('macos big sur');
+```
+
 ### Pagination
 
 We highly recommend to paginate your results. Call the `paginate` method before the `get` method, and you'll get an instance of `\Illuminate\Contracts\Pagination\LengthAwarePaginator` as a result. The `paginate` method takes three (optional) parameters to customize the paginator. These arguments are [the same](https://laravel.com/docs/master/pagination#introduction) as Laravel's database paginator.

src/Searcher.php

@@ -41,6 +41,11 @@ class Searcher
      */
     private string $pageName = 'page';
 
+    /**
+     * Parse the search term into multiple terms.
+     */
+    private bool $parseTerm = true;
+
     /**
      * Current page.
      *
@@ -82,6 +87,16 @@ public function orderByDesc(): self
         return $this;
     }
 
+    /**
+     * Disable the parsing of the search term.
+     */
+    public function dontParseTerm(): self
+    {
+        $this->parseTerm = false;
+
+        return $this;
+    }
+
     /**
      * Add a model to search through.
      *
@@ -142,7 +157,9 @@ public function paginate($perPage = 15, $pageName = 'page', $page = null): self
      */
     private function initializeTerms(string $terms): self
     {
-        $this->terms = Collection::make(str_getcsv($terms, ' ', '"'))
+        $terms = $this->parseTerm ? str_getcsv($terms, ' ', '"') : $terms;
+
+        $this->terms = Collection::wrap($terms)
             ->filter()
             ->map(fn ($term) => ($this->startWithWildcard ? '%' : '') . "{$term}%");
 

tests/SearchTest.php

@@ -71,6 +71,24 @@ public function it_can_search_for_a_phrase()
         $this->assertTrue($results->contains($postB));
     }
 
+    /** @test */
+    public function it_has_an_option_to_dont_split_the_search_term()
+    {
+        $postA  = Post::create(['title' => 'foo']);
+        $postB  = Post::create(['title' => 'bar bar']);
+        $videoA = Video::create(['title' => 'foo']);
+        $videoB = Video::create(['title' => 'bar']);
+
+        $results = Search::add(Post::class, 'title')
+            ->add(Video::class, 'title')
+            ->dontParseTerm()
+            ->get('bar bar');
+
+        $this->assertCount(1, $results);
+
+        $this->assertTrue($results->contains($postB));
+    }
+
     /** @test */
     public function it_throws_an_exception_when_the_query_is_empty()
     {