Add ability to optionally manipulate the model query

Author: DivineOmega

README.md

@@ -26,7 +26,10 @@ class UsersController extends Controller
 	public function dataTable(Request $request)
 	{
 		return (new DataTableResponder(User::class, $request))
-			->setPerPage(10)    // Optional, default: 15
+            ->query(function($query) {  // Optional, default: none
+                $query->where('name', 'like', 'B%');
+            })
+			->setPerPage(10)            // Optional, default: 15
 			->respond();
 	}
 }

src/DataTableResponder.php

@@ -21,6 +21,11 @@ class DataTableResponder
      */
     private $request;
 
+    /**
+     * @var callable
+     */
+    private $queryManipulator;
+
     /**
      * @var int
      */
@@ -58,6 +63,18 @@ public function setPerPage($perPage)
         return $this;
     }
 
+    /**
+     * Sets the callable used to manipulate the model query.
+     *
+     * @param callable $queryManipulator
+     * @return DataTableResponder
+     */
+    public function query(callable $queryManipulator)
+    {
+        $this->queryManipulator = $queryManipulator;
+        return $this;
+    }
+
     /**
      * Builds the Eloquent query based on the request.
      *
@@ -75,6 +92,11 @@ private function buildQuery(Request $request)
             $query->orderBy($orderByField, $orderByDirection);
         }
 
+        $queryManipulator = $this->queryManipulator;
+        if ($queryManipulator) {
+            $queryManipulator($query);
+        }
+
         return $query;
     }