Laravel-Backpack / CRUD

src/resources/views-elfinder/tinymce4.php

Spacing +2 added lines, -2 removed lines

@@ -17,7 +17,7 @@ 
     <!-- elFinder JS (REQUIRED) -->
     <script src="<?= asset($dir.'/js/elfinder.min.js') ?>"></script>
 
-    <?php if($locale){ ?>
+    <?php if ($locale) { ?>
         <!-- elFinder translation (OPTIONAL) -->
         <script src="<?= asset($dir."/js/i18n/elfinder.$locale.js") ?>"></script>
     <?php } ?>
@@ -40,7 +40,7 @@ 
         $().ready(function() {
             var elf = $('#elfinder').elfinder({
                 // set your elFinder options here
-                <?php if($locale){ ?>
+                <?php if ($locale) { ?>
                     lang: '<?= $locale ?>', // locale
                 <?php } ?>
                 customData: {

src/resources/views-elfinder/elfinder.blade.php

Spacing +2 added lines, -2 removed lines

@@ -17,7 +17,7 @@ 
     <!-- elFinder JS (REQUIRED) -->
     <script src="<?= asset($dir.'/js/elfinder.min.js') ?>"></script>
 
-    <?php if($locale){ ?>
+    <?php if ($locale) { ?>
         <!-- elFinder translation (OPTIONAL) -->
         <script src="<?= asset($dir."/js/i18n/elfinder.$locale.js") ?>"></script>
     <?php } ?>
@@ -40,7 +40,7 @@ 
         $().ready(function() {
             var elf = $('#elfinder').elfinder({
                 // set your elFinder options here
-                <?php if($locale){ ?>
+                <?php if ($locale) { ?>
                     lang: '<?= $locale ?>', // locale
                 <?php } ?>
                 customData: {

src/resources/views-elfinder/tinymce.php

Spacing +2 added lines, -2 removed lines

@@ -17,7 +17,7 @@ 
     <!-- elFinder JS (REQUIRED) -->
     <script src="<?= asset($dir.'/js/elfinder.min.js') ?>"></script>
 
-    <?php if($locale){ ?>
+    <?php if ($locale) { ?>
         <!-- elFinder translation (OPTIONAL) -->
         <script src="<?= asset($dir."/js/i18n/elfinder.$locale.js") ?>"></script>
     <?php } ?>
@@ -40,7 +40,7 @@ 
         $().ready(function() {
             var elf = $('#elfinder').elfinder({
                 // set your elFinder options here
-                <?php if($locale){ ?>
+                <?php if ($locale) { ?>
                     lang: '<?= $locale ?>', // locale
                 <?php } ?>
                 customData: {

src/resources/views-elfinder/ckeditor4.php

Spacing +2 added lines, -2 removed lines

@@ -17,7 +17,7 @@ 
     <!-- elFinder JS (REQUIRED) -->
     <script src="<?= asset($dir.'/js/elfinder.min.js') ?>"></script>
 
-    <?php if($locale){ ?>
+    <?php if ($locale) { ?>
         <!-- elFinder translation (OPTIONAL) -->
         <script src="<?= asset($dir."/js/i18n/elfinder.$locale.js") ?>"></script>
     <?php } ?>
@@ -40,7 +40,7 @@ 
         $().ready(function() {
             var elf = $('#elfinder').elfinder({
                 // set your elFinder options here
-                <?php if($locale){ ?>
+                <?php if ($locale) { ?>
                     lang: '<?= $locale ?>', // locale
                 <?php } ?>
                 customData: {

src/CrudTrait.php

Spacing +4 added lines, -4 removed lines

@@ -12,14 +12,14 @@
     |--------------------------------------------------------------------------
     */
 
-    public static function getPossibleEnumValues($field_name){
+    public static function getPossibleEnumValues($field_name) {
         $instance = new static; // create an instance of the model to be able to get the table name
-        $type = DB::select( DB::raw('SHOW COLUMNS FROM '.$instance->getTable().' WHERE Field = "'.$field_name.'"') )[0]->Type;
+        $type = DB::select(DB::raw('SHOW COLUMNS FROM '.$instance->getTable().' WHERE Field = "'.$field_name.'"'))[0]->Type;
         preg_match('/^enum\((.*)\)$/', $type, $matches);
         $enum = array();
         $exploded = explode(',', $matches[1]);
-        foreach($exploded as $value){
-            $v = trim( $value, "'" );
+        foreach ($exploded as $value) {
+            $v = trim($value, "'");
             $enum[] = $v;
         }
         return $enum;

src/app/Http/Controllers/CrudController.php

Doc Comments +1 added lines, -1 removed lines

@@ -161,7 +161,7 @@
 	 * Remove the specified resource from storage.
 	 *
 	 * @param  int  $id
-	 * @return string
+	 * @return \Illuminate\Http\Response
 	 */
 	public function destroy($id)
 	{

src/app/Http/Controllers/ToneCrudNestedController.php

Doc Comments +2 added lines, -2 removed lines

@@ -54,7 +54,7 @@ 
      * Store a newly created resource in storage.
      *
      * @param  \Illuminate\Http\Request  $request
-     * @return \Illuminate\Http\Response
+     * @return \Illuminate\Http\RedirectResponse
      */
     public function crudStore(Request $request = null)
     {
@@ -101,7 +101,7 @@ 
      *
      * @param  \Illuminate\Http\Request  $request
      * @param  int  $id
-     * @return \Illuminate\Http\Response
+     * @return \Illuminate\Http\RedirectResponse
      */
     public function crudUpdate($parentId, $id, Request $request = null)
     {

src/Crud.php

Doc Comments +24 added lines, -2 removed lines

@@ -286,6 +286,7 @@ 
      * Delete a row from the database.
      *
      * @param  [int] The id of the item to be deleted.
+     * @param integer $id
      * @return [bool] Deletion confirmation.
      *
      * TODO: should this delete items with relations to it too?
@@ -404,7 +405,8 @@ 
      * Check if a permission is enabled for a Crud Panel. Fail if not.
      *
      * @param  [string] Permission.
-     * @return boolean
+     * @param string $permission
+     * @return boolean|null
      */
     public function hasAccessOrFail($permission)
     {
@@ -433,6 +435,7 @@ 
      * All Create-Read-Update-Delete operations are done using that Eloquent Collection.
      *
      * @param [string] Full model namespace. Ex: App\Models\Article
+     * @param string $model_namespace
      */
     public function setModel($model_namespace)
     {
@@ -460,6 +463,7 @@ 
      *
      * @param [string] Route name.
      * @param [array] Parameters.
+     * @param string $route
      */
     public function setRoute($route)
     {
@@ -492,7 +496,7 @@ 
      * - $this->crud->setRouteName('admin.article')
      * - $this->crud->route = "admin/article"
      *
-     * @return [string]
+     * @return string
      */
     public function getRoute()
     {
@@ -505,6 +509,8 @@ 
      *
      * @param [string] Entity name, in singular. Ex: article
      * @param [string] Entity name, in plural. Ex: articles
+     * @param string $singular
+     * @param string $plural
      */
     public function setEntityNameStrings($singular, $plural) {
         $this->entity_name = $singular;
@@ -1237,6 +1243,9 @@ 
         return array_filter($this->{$entity}[] = $this->syncField($field));
     }
 
+    /**
+     * @param string $entity
+     */
     public function addMultiple($entity, $field)
     {
         $this->{$entity} = array_filter(array_map([$this, 'syncField'], $fields));
@@ -1256,16 +1265,25 @@ 
 
 
 
+    /**
+     * @param string $entity
+     */
     public function remove($entity, $fields)
     {
         return array_values(array_filter($this->{$entity}, function($field) use ($fields) { return !in_array($field['name'], (array)$fields);}));
     }
 
+    /**
+     * @param string $items
+     */
     public function setSort($items, $order)
     {
         $this->sort[$items] = $order;
     }
 
+    /**
+     * @param string $items
+     */
     public function sort($items)
     {
         if (array_key_exists($items, $this->sort))
@@ -1301,6 +1319,10 @@ 
     }
 
     // face un fel de merge intre ce ii dai si ce e in CRUD
+
+    /**
+     * @param string $entity
+     */
     public function syncRelations($entity)
     {
         foreach ($this->relations as $field => $relation) {

Spacing +32 added lines, -32 removed lines

@@ -80,7 +80,7 @@ 
      */
     public function getCreateFields()
     {
-        return $this->prepareFields(empty($this->create_fields)?$this->fields:$this->create_fields);
+        return $this->prepareFields(empty($this->create_fields) ? $this->fields : $this->create_fields);
     }
 
     /**
@@ -91,16 +91,16 @@ 
      */
     public function getRelationFields($form = 'create')
     {
-        if( $form == 'create' ){
-            $fields = empty($this->create_fields)?$this->fields:$this->create_fields;
-        }else{
-            $fields = empty($this->update_fields)?$this->fields:$this->update_fields;
+        if ($form == 'create') {
+            $fields = empty($this->create_fields) ? $this->fields : $this->create_fields;
+        } else {
+            $fields = empty($this->update_fields) ? $this->fields : $this->update_fields;
         }
 
         $relationFields = [];
 
-        foreach($fields as $field){
-            if(isset($field['model']) || isset($field['dependencies'])){
+        foreach ($fields as $field) {
+            if (isset($field['model']) || isset($field['dependencies'])) {
                 array_push($relationFields, $field);
             }
         }
@@ -116,22 +116,22 @@ 
         
         foreach ($relations as $key => $relation)
         {
-            if ( (isset($relation['pivot']) && $relation['pivot'] ) || isset($relation['dependencies']) ){
-                if(is_array($relation['name'])){
-                    foreach($relation['name'] as $relation){
-                        if(isset($data[$relation])){
+            if ((isset($relation['pivot']) && $relation['pivot']) || isset($relation['dependencies'])) {
+                if (is_array($relation['name'])) {
+                    foreach ($relation['name'] as $relation) {
+                        if (isset($data[$relation])) {
                             $model->{$relation}()->sync($data[$relation]);
-                        }else{
+                        } else {
                              $model->{$relation}()->sync([]);
                         }
                     }
-                }else{
+                } else {
                     $model->{$relation['name']}()->sync($data[$relation['name']]);
                 }
 
-                if( isset($relation['pivotFields']) ){
-                    foreach($relation['pivotFields'] as $pivotField){
-                       foreach($data[$pivotField] as $pivot_id =>  $field){
+                if (isset($relation['pivotFields'])) {
+                    foreach ($relation['pivotFields'] as $pivotField) {
+                       foreach ($data[$pivotField] as $pivot_id =>  $field) {
                          $model->{$relation['name']}()->updateExistingPivot($pivot_id, [$pivotField => $field]);
                        }
                     }
@@ -289,21 +289,21 @@ 
      */
     public function getUpdateFields($id)
     {
-        $fields = $this->prepareFields(empty($this->update_fields)?$this->fields:$this->update_fields);
+        $fields = $this->prepareFields(empty($this->update_fields) ? $this->fields : $this->update_fields);
         $entry = $this->getEntry($id);
 
         foreach ($fields as $k => $field) {
             // set the value
             if (!isset($fields[$k]['value']))
             {
-                if(is_array($field['name'])){
+                if (is_array($field['name'])) {
                     
                     $fields[$k]['value'] = [];
-                    foreach($field['name'] as  $key => $relation){
+                    foreach ($field['name'] as  $key => $relation) {
                         $fields[$k]['value'][] = $entry->{$relation};
                     }
                 
-                }else{
+                } else {
                     $fields[$k]['value'] = $entry->{$field['name']};
                 }
             }
@@ -422,13 +422,13 @@ 
     public function allowAccess($access)
     {
         // $this->addButtons((array)$access);
-        return $this->access = array_merge(array_diff((array)$access, $this->access), $this->access);
+        return $this->access = array_merge(array_diff((array) $access, $this->access), $this->access);
     }
 
     public function denyAccess($access)
     {
         // $this->removeButtons((array)$access);
-        return $this->access = array_diff($this->access, (array)$access);
+        return $this->access = array_diff($this->access, (array) $access);
     }
 
     /**
@@ -641,7 +641,7 @@ 
      */
     public function addDefaultTypeToColumn($column)
     {
-        if (array_key_exists('name', (array)$column))
+        if (array_key_exists('name', (array) $column))
         {
             $default_type = $this->getFieldTypeFromDbColumnType($column['name']);
             return array_merge(['type' => $default_type], $column);
@@ -657,7 +657,7 @@ 
      * @param [field or column]
      */
     public function addDefaultLabel($array) {
-        if (!array_key_exists('label', (array)$array) && array_key_exists('name', (array)$array)) {
+        if (!array_key_exists('label', (array) $array) && array_key_exists('name', (array) $array)) {
             $array = array_merge(['label' => ucfirst($this->makeLabel($array['name']))], $array);
             return $array;
         }
@@ -831,7 +831,7 @@ 
         array_map(function($field) {
             // $this->labels[$field] = $this->makeLabel($field);
 
-            $this->fields[] =  [
+            $this->fields[] = [
                                 'name' => $field,
                                 'label' => ucfirst($field),
                                 'value' => '', 'default' => $this->field_types[$field]['default'],
@@ -1173,7 +1173,7 @@ 
 
     public function orderColumns($order)
     {
-        $this->setSort('columns', (array)$order);
+        $this->setSort('columns', (array) $order);
     }
 
 
@@ -1248,13 +1248,13 @@ 
 
     public function orderFields($order)
     {
-        $this->setSort('fields', (array)$order);
+        $this->setSort('fields', (array) $order);
     }
 
 
     public function syncField($field)
     {
-        if (array_key_exists('name', (array)$field)) return array_merge(['type' => $this->getFieldTypeFromDbColumnType($field['name']), 'value' => '', 'default' => null, 'values' => [], 'attributes' => []], $field);
+        if (array_key_exists('name', (array) $field)) return array_merge(['type' => $this->getFieldTypeFromDbColumnType($field['name']), 'value' => '', 'default' => null, 'values' => [], 'attributes' => []], $field);
 
         return false;
     }
@@ -1293,7 +1293,7 @@ 
         if (!empty($this->{$type}))
         {
             $this->{$type} = array_map(function($field) use ($fields, $attributes) {
-                if (in_array($field['name'], (array)$fields)) $field = array_merge($field, $attributes);
+                if (in_array($field['name'], (array) $fields)) $field = array_merge($field, $attributes);
 
                 return $field;
             }, $this->{$type});
@@ -1304,7 +1304,7 @@ 
 
     public function remove($entity, $fields)
     {
-        return array_values(array_filter($this->{$entity}, function($field) use ($fields) { return !in_array($field['name'], (array)$fields);}));
+        return array_values(array_filter($this->{$entity}, function($field) use ($fields) { return !in_array($field['name'], (array) $fields); }));
     }
 
     public function setSort($items, $order)
@@ -1323,7 +1323,7 @@ 
                 if (is_numeric($key = array_search($item, array_column($this->{$items}, 'name')))) $elements[] = $this->{$items}[$key];
             }
 
-            return $this->{$items} = array_merge($elements, array_filter($this->{$items}, function($item) use($items) {return !in_array($item['name'], $this->sort[$items]);}));
+            return $this->{$items} = array_merge($elements, array_filter($this->{$items}, function($item) use($items) {return !in_array($item['name'], $this->sort[$items]); }));
         }
 
         return $this->{$items};
@@ -1336,7 +1336,7 @@ 
     // cred ca ia valorile din tabela de legatura ca sa ti le afiseze in select
     public function getRelationValues($model, $field, $where = [], $order = [])
     {
-        $order = (array)$order;
+        $order = (array) $order;
         $values = $model->select('*');
 
         if (!empty($where)) call_user_func_array([$values, $where[0]], array_slice($where, 1));

src/ToneCrud.php

Doc Comments +25 added lines

@@ -38,6 +38,9 @@ 
         $this->initState();
     }
 
+    /**
+     * @param string $model
+     */
     public function setModel($model)
     {
         if (!class_exists($model)) throw new \Exception('This model does not exist.', 404);
@@ -54,6 +57,10 @@ 
     }
 
     // TODO: make this work without having to specify "index"
+
+    /**
+     * @param string $route
+     */
     public function setRoute($route, $parameters = [])
     {
         if (!\Route::has($route)) throw new \Exception('This route does not exist.', 404);
@@ -259,6 +266,9 @@ 
         return $model;
     }
 
+    /**
+     * @param integer $id
+     */
     public function delete($id) // DONE
     {
         return $this->model->destroy($id);
@@ -489,6 +499,9 @@ 
         return array_filter($this->{$entity}[] = $this->syncField($field));
     }
 
+    /**
+     * @param string $entity
+     */
     private function addMultiple($entity, $field)
     {
         $this->{$entity} = array_filter(array_map([$this, 'syncField'], $fields));
@@ -506,16 +519,25 @@ 
         }
     }
 
+    /**
+     * @param string $entity
+     */
     private function remove($entity, $fields)
     {
         return array_values(array_filter($this->{$entity}, function($field) use ($fields) { return !in_array($field['name'], (array)$fields);}));
     }
 
+    /**
+     * @param string $items
+     */
     private function setSort($items, $order)
     {
         $this->sort[$items] = $order;
     }
 
+    /**
+     * @param string $items
+     */
     private function sort($items)
     {
         if (array_key_exists($items, $this->sort))
@@ -561,6 +583,9 @@ 
         return $values->get()->lists($field, $model->getKeyName())->toArray();
     }
 
+    /**
+     * @param string $entity
+     */
     private function syncRelations($entity)
     {
         foreach ($this->relations as $field => $relation) {

Spacing +15 added lines, -15 removed lines

@@ -125,9 +125,9 @@ 
 
     public function removePermissions($permissions) // DONE
     {
-        $this->removeButtons((array)$permissions);
+        $this->removeButtons((array) $permissions);
 
-        return $this->permissions = array_diff($this->permissions, (array)$permissions);
+        return $this->permissions = array_diff($this->permissions, (array) $permissions);
     }
 
     public function setColumns($columns)
@@ -158,7 +158,7 @@ 
 
     public function orderColumns($order)
     {
-        $this->setSort('columns', (array)$order);
+        $this->setSort('columns', (array) $order);
     }
 
     public function setFields($fields)
@@ -228,7 +228,7 @@ 
 
     public function orderFields($order)
     {
-        $this->setSort('fields', (array)$order);
+        $this->setSort('fields', (array) $order);
     }
 
     public function items()
@@ -287,7 +287,7 @@ 
 
     public function unsetListActions($actions)
     {
-        return $this->listActions = array_diff($this->listActions, (array)$actions);
+        return $this->listActions = array_diff($this->listActions, (array) $actions);
     }
 
     public function checkListAction($action)
@@ -312,7 +312,7 @@ 
 
     public function setRequired($fields)
     {
-        $this->required = array_merge($this->required, (array)$fields);
+        $this->required = array_merge($this->required, (array) $fields);
     }
 
     public function required()
@@ -380,14 +380,14 @@ 
 
     private function syncColumn($column)
     {
-        if (array_key_exists('name', (array)$column)) return array_merge(['type' => $this->getType($column['name'])], $column);
+        if (array_key_exists('name', (array) $column)) return array_merge(['type' => $this->getType($column['name'])], $column);
 
         return false;
     }
 
     private function syncField($field)
     {
-        if (array_key_exists('name', (array)$field)) return array_merge(['type' => $this->getType($field['name']), 'value' => '', 'default' => null, 'values' => [], 'attributes' => []], $field);
+        if (array_key_exists('name', (array) $field)) return array_merge(['type' => $this->getType($field['name']), 'value' => '', 'default' => null, 'values' => [], 'attributes' => []], $field);
 
         return false;
     }
@@ -499,7 +499,7 @@ 
         if (!empty($this->{$type}))
         {
             $this->{$type} = array_map(function($field) use ($fields, $attributes) {
-                if (in_array($field['name'], (array)$fields)) $field = array_merge($field, $attributes);
+                if (in_array($field['name'], (array) $fields)) $field = array_merge($field, $attributes);
 
                 return $field;
             }, $this->{$type});
@@ -508,7 +508,7 @@ 
 
     private function remove($entity, $fields)
     {
-        return array_values(array_filter($this->{$entity}, function($field) use ($fields) { return !in_array($field['name'], (array)$fields);}));
+        return array_values(array_filter($this->{$entity}, function($field) use ($fields) { return !in_array($field['name'], (array) $fields); }));
     }
 
     private function setSort($items, $order)
@@ -527,7 +527,7 @@ 
                 if (is_numeric($key = array_search($item, array_column($this->{$items}, 'name')))) $elements[] = $this->{$items}[$key];
             }
 
-            return $this->{$items} = array_merge($elements, array_filter($this->{$items}, function($item) use($items) {return !in_array($item['name'], $this->sort[$items]);}));
+            return $this->{$items} = array_merge($elements, array_filter($this->{$items}, function($item) use($items) {return !in_array($item['name'], $this->sort[$items]); }));
         }
 
         return $this->{$items};
@@ -537,11 +537,11 @@ 
     {
         foreach ($this->relations as $key => $relation)
         {
-            if ($relation['pivot']){
+            if ($relation['pivot']) {
                 $model->{$relation['name']}()->sync($data[$key]);
 
-                foreach($relation['pivotFields'] as $pivotField){
-                   foreach($data[$pivotField] as $pivot_id =>  $field){
+                foreach ($relation['pivotFields'] as $pivotField) {
+                   foreach ($data[$pivotField] as $pivot_id =>  $field) {
                      $model->{$relation['name']}()->updateExistingPivot($pivot_id, [$pivotField => $field]);
                    }
                 }
@@ -551,7 +551,7 @@ 
 
     private function getRelationValues($model, $field, $where = [], $order = [])
     {
-        $order = (array)$order;
+        $order = (array) $order;
         $values = $model->select('*');
 
         if (!empty($where)) call_user_func_array([$values, $where[0]], array_slice($where, 1));