Merge pull request #124 from moisespsena/form_element_select_add_load…

…_options_query_preparer

Add callback for prepare load options Query.

src/Form/Element/Select.php

@@ -55,6 +55,11 @@ class Select extends NamedFormElement
      */
     protected $fetchColumns = [];
 
+    /**
+     * @var function|\Closure|object callable
+     */
+    protected $loadOptionsQueryPreparer;
+
     /**
      * @param string      $path
      * @param string|null $label
@@ -251,6 +256,41 @@ public function getFetchColumns()
         return $this->fetchColumns;
     }
 
+    /**
+     * Set Callback for prepare load options Query.
+     *
+     * Example:
+     * <code>
+     * <?php
+     * AdminFormElement::select('column', 'Label')
+     *     ->modelForOptions(MyModel::class)
+     *     ->setLoadOptionsQueryPreparer(function($item, QueryBuilder $query) {
+     *         return $query
+     *             ->where('column', 'value')
+     *             ->were('owner_id', Auth::user()->id)
+     *     });
+     * ?>
+     * </code>
+     *
+     * @param callable $callback The Callback with $item and $options args.
+     * @return $this
+     */
+    public function setLoadOptionsQueryPreparer($callback)
+    {
+        $this->loadOptionsQueryPreparer = $callback;
+
+        return $this;
+    }
+
+    /**
+     * Get Callback for prepare load options Query.
+     * @return callable
+     */
+    public function getLoadOptionsQueryPreparer()
+    {
+        return $this->loadOptionsQueryPreparer;
+    }
+
     /**
      * @param array $keys
      *
@@ -342,6 +382,11 @@ protected function loadOptions()
             $options->select($columns);
         }
 
+        // call the pre load options query preparer if has be set
+        if (! is_null($preparer = $this->getLoadOptionsQueryPreparer())) {
+            $options = $preparer($this, $options);
+        }
+
         $options = $options->get();
 
         if (is_callable($this->getDisplay())) {