[Ready] Release 3.5 - this is HUUUUGE

CHANGELOG.md

@@ -20,6 +20,42 @@ All Notable changes to `Backpack CRUD` will be documented in this file
 - Nothing
 -----------
 
+## [3.5.0] - 2018-09-xx
+
+### BREAKING
+- #1535 - orderBy gets ignored when the user clicks on a column heading to reoder the datatable;
+- #1658 - model function button did not pass $crud to button;
+- #1680 - Backpack checks that CrudTrait is used on the Model; otherwise it throws a 500 error with a clear message;
+
+### Added
+- #1675 - design facelift for the list view - a lot cleaner;
+- #1516 - setters and getters for the current operation;
+- #1527 - custom titles, headings and subheadings;
+- #1518 - CrudPanel class is now macroable;
+- #1687 - ```select2_nested``` field type;
+- #1703 - ```visibleInTable``` option to columns;
+- #1703 - ```visibleInExport``` option to columns;
+- #1706 - added ```visibleInShow``` option to columns;
+- #1704 - added ```orderLogic``` option for columns;
+- #1694 - ```options``` option to ```select```, ```select2```, ```select_multiple```, ```select2_multiple```, that allows developers to filter or order the options shown, using a scope or custom query;
+- #1695 - added ```select_and_order``` field type;
+- #1708 - added ```Clone``` operation;
+- #1712 - added ```address_google``` field type;
+- #1674 - you can now pass parameters to ```model_function``` and ```model_function_attribute``` column types; 
+- #1484 - added dependant select2s with ajax;
+- #1484 - added ```method``` attribute to ajax select2s;
+- #1484 - added ```dependencies``` attribute to ajax select2s;
+- #1702 - added ```persistent_table``` functionality, and save state datatables;
+
+### Fixed
+- #1390 - using our own helper ```mb_ucfirst()``` instead of ```ucfirst()```;
+- #791 - could not revert changes made in fake field holders;
+- #1712 - renamed ```address``` field type to ```address_algolia```; alias keeps backwards-compatibility;
+- #1714 - autoset getting tables now happens only once;
+- #1692 - we can now use arrays for field names, like ```category[0][name]```, the only thing that needed to be fixed was the ```old()``` value which did not work;
+
+----
+
 ## [3.4.43] - 2018-11-21
 
 ## Fixed

composer.json

@@ -46,6 +46,7 @@
         "psr-4": {
             "Backpack\\CRUD\\Tests\\": "tests"
         },
+        "files": ["vendor/backpack/base/src/helpers.php"],
         "exclude-from-classmap": [
             "**/config"
         ]

src/CrudPanel.php

@@ -19,15 +19,21 @@
 use Backpack\CRUD\PanelTraits\Filters;
 use Backpack\CRUD\PanelTraits\Reorder;
 use Backpack\CRUD\PanelTraits\AutoFocus;
+use Backpack\CRUD\PanelTraits\Macroable;
 use Backpack\CRUD\PanelTraits\FakeFields;
+use Backpack\CRUD\PanelTraits\Operations;
 use Backpack\CRUD\PanelTraits\FakeColumns;
 use Illuminate\Database\Eloquent\Collection;
 use Backpack\CRUD\PanelTraits\RequiredFields;
+use Backpack\CRUD\PanelTraits\HeadingsAndTitle;
 use Backpack\CRUD\PanelTraits\ViewsAndRestoresRevisions;
 
 class CrudPanel
 {
-    use Create, Read, Search, Update, Delete, Errors, Reorder, Access, Columns, Fields, Query, Buttons, AutoSet, FakeFields, FakeColumns, ViewsAndRestoresRevisions, AutoFocus, Filters, Tabs, Views, RequiredFields;
+    // load all the default CrudPanel features
+    use Create, Read, Search, Update, Delete, Errors, Reorder, Access, Columns, Fields, Query, Buttons, AutoSet, FakeFields, FakeColumns, ViewsAndRestoresRevisions, AutoFocus, Filters, Tabs, Views, RequiredFields, HeadingsAndTitle, Operations;
+    // allow developers to add their own closures to this object
+    use Macroable;
 
     // --------------
     // CRUD variables
@@ -43,6 +49,16 @@ class CrudPanel
     public $entity_name = 'entry'; // what name will show up on the buttons, in singural (ex: Add entity)
     public $entity_name_plural = 'entries'; // what name will show up on the buttons, in plural (ex: Delete 5 entities)
     public $request;
+    public $settings = [
+        'create' => [],
+        'update' => [],
+        'list' => [],
+        'delete' => [],
+        'clone' => [],
+        'reorder' => [],
+        'revisions' => [],
+        'show' => [],
+    ];
 
     public $access = ['list', 'create', 'update', 'delete'/* 'revisions', reorder', 'show', 'details_row' */];
 
@@ -91,7 +107,11 @@ public function __construct()
     public function setModel($model_namespace)
     {
         if (! class_exists($model_namespace)) {
-            throw new \Exception('This model does not exist.', 404);
+            throw new \Exception('The model does not exist.', 500);
+        }
+
+        if (! method_exists($model_namespace, 'hasCrudTrait')) {
+            throw new \Exception('Please use CrudTrait on the model.', 500);
         }
 
         $this->model = new $model_namespace();

src/CrudRouter.php

@@ -58,6 +58,16 @@ public function __construct($name, $controller, $options)
             'as' => 'crud.'.$this->name.'.restoreRevision',
             'uses' => $this->controller.'@restoreRevision',
         ]);
+
+        Route::get($this->name.'/{id}/clone', [
+            'as' => 'crud.'.$this->name.'.clone',
+            'uses' => $this->controller.'@clone',
+        ]);
+
+        Route::post($this->name.'/bulk-clone', [
+            'as' => 'crud.'.$this->name.'.bulkClone',
+            'uses' => $this->controller.'@bulkClone',
+        ]);
     }
 
     /**

src/CrudServiceProvider.php

@@ -9,7 +9,7 @@ class CrudServiceProvider extends ServiceProvider
 {
     use CrudUsageStats;
 
-    const VERSION = '3.4.43';
+    const VERSION = '3.5.0';
 
     protected $commands = [
         \Backpack\CRUD\app\Console\Commands\Install::class,
@@ -92,6 +92,9 @@ public function register()
             return new CRUD($app);
         });
 
+        // register the helper functions
+        $this->loadHelpers();
+
         // register the artisan commands
         $this->commands($this->commands);
 
@@ -106,6 +109,14 @@ public static function resource($name, $controller, array $options = [])
         return new CrudRouter($name, $controller, $options);
     }
 
+    /**
+     * Load the Backpack helper methods, for convenience.
+     */
+    public function loadHelpers()
+    {
+        require_once __DIR__.'/helpers.php';
+    }
+
     /**
      * Checks to see if we should automatically publish
      * vendor files from the public tag.

src/CrudTrait.php

@@ -9,6 +9,11 @@
 
 trait CrudTrait
 {
+    public static function hasCrudTrait()
+    {
+        return true;
+    }
+
     /*
     |--------------------------------------------------------------------------
     | Methods for ENUM and SELECT crud fields.

src/PanelTraits/AutoSet.php

@@ -56,11 +56,7 @@ public function setFromDb()
      */
     public function getDbColumnTypes()
     {
-        $table = $this->model->getTable();
-        $conn = $this->model->getConnection();
-        $table_columns = $conn->getDoctrineSchemaManager()->listTableColumns($table);
-
-        foreach ($table_columns as $key => $column) {
+        foreach ($this->getDbTableColumns() as $key => $column) {
             $column_type = $column->getType()->getName();
             $this->db_column_types[$column->getName()]['type'] = trim(preg_replace('/\(\d+\)(.*)/i', '', $column_type));
             $this->db_column_types[$column->getName()]['default'] = $column->getDefault();
@@ -69,6 +65,26 @@ public function getDbColumnTypes()
         return $this->db_column_types;
     }
 
+    /**
+     * Get all columns in the database table.
+     *
+     * @return array
+     */
+    public function getDbTableColumns()
+    {
+        if (isset($this->table_columns) && $this->table_columns) {
+            return $this->table_columns;
+        }
+
+        $table = $this->model->getTable();
+        $conn = $this->model->getConnection();
+        $columns = $conn->getDoctrineSchemaManager()->listTableColumns($table);
+
+        $this->table_columns = $columns;
+
+        return $this->table_columns;
+    }
+
     /**
      * Intuit a field type, judging from the database column type.
      *
@@ -97,46 +113,44 @@ public function getFieldTypeFromDbColumnType($field)
             case 'mediumint':
             case 'longint':
                 return 'number';
-            break;
+                break;
 
             case 'string':
             case 'varchar':
             case 'set':
                 return 'text';
-            break;
+                break;
 
             // case 'enum':
             //     return 'enum';
             // break;
 
             case 'tinyint':
                 return 'active';
-            break;
+                break;
 
             case 'text':
-                return 'textarea';
-            break;
-
             case 'mediumtext':
             case 'longtext':
                 return 'textarea';
-            break;
+                break;
 
             case 'date':
                 return 'date';
-            break;
+                break;
 
             case 'datetime':
             case 'timestamp':
                 return 'datetime';
-            break;
+                break;
+
             case 'time':
                 return 'time';
-            break;
+                break;
 
             default:
                 return 'text';
-            break;
+                break;
         }
     }
 
@@ -165,7 +179,7 @@ public function makeLabel($value)
             return ($this->labeller)($value);
         }
 
-        return trim(preg_replace('/(id|at|\[\])$/i', '', ucfirst(str_replace('_', ' ', $value))));
+        return trim(preg_replace('/(id|at|\[\])$/i', '', mb_ucfirst(str_replace('_', ' ', $value))));
     }
 
     /**

src/PanelTraits/Buttons.php

@@ -85,6 +85,7 @@ public function initButtons()
         $this->addButton('line', 'show', 'view', 'crud::buttons.show', 'end');
         $this->addButton('line', 'update', 'view', 'crud::buttons.update', 'end');
         $this->addButton('line', 'revisions', 'view', 'crud::buttons.revisions', 'end');
+        $this->addButton('line', 'clone', 'view', 'crud::buttons.clone', 'end');
         $this->addButton('line', 'delete', 'view', 'crud::buttons.delete', 'end');
 
         // top stack

src/PanelTraits/Columns.php

@@ -39,7 +39,7 @@ public function setColumns($columns)
                 } else {
                     $this->addColumn([
                                     'name'  => $column,
-                                    'label' => ucfirst($column),
+                                    'label' => mb_ucfirst($column),
                                     'type'  => 'text',
                                 ]);
                 }
@@ -49,7 +49,7 @@ public function setColumns($columns)
         if (is_string($columns)) {
             $this->addColumn([
                                 'name'  => $columns,
-                                'label' => ucfirst($columns),
+                                'label' => mb_ucfirst($columns),
                                 'type'  => 'text',
                                 ]);
         }
@@ -226,7 +226,7 @@ public function addDefaultTypeToColumn($column)
     public function addDefaultLabel($array)
     {
         if (! array_key_exists('label', (array) $array) && array_key_exists('name', (array) $array)) {
-            $array = array_merge(['label' => ucfirst($this->makeLabel($array['name']))], $array);
+            $array = array_merge(['label' => mb_ucfirst($this->makeLabel($array['name']))], $array);
 
             return $array;
         }

src/PanelTraits/Fields.php

@@ -34,7 +34,7 @@ public function addField($field, $form = 'both')
 
         // if the label is missing, we should set it
         if (! isset($completeFieldsArray['label'])) {
-            $completeFieldsArray['label'] = ucfirst($completeFieldsArray['name']);
+            $completeFieldsArray['label'] = mb_ucfirst(str_replace('_', ' ', $completeFieldsArray['name']));
         }
 
         // if the field type is missing, we should set it