Fields::beforeField() - Code Metrics - Inspection of "Merge branch 'b8ne-add_field_column_ordering'" - Laravel-Backpack/CRUD - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 13df59...0ad3ab )

by Cristian

created 2016-12-14 07:41 UTC

Fields::beforeField() B

↳ Parent: Fields

Complexity

Conditions	5
Paths	9

Size

Total Lines	18
Code Lines	13

Duplication

Lines	14
Ratio	77.78 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	5
eloc	13
nc	9
nop	1
dl	14
loc	18
rs	8.8571
c	1
b	0
f	0

<?php

namespace Backpack\CRUD\PanelTraits;

trait Fields
{
    // ------------
    // FIELDS
    // ------------

    /**
     * Add a field to the create/update form or both.
     *
     * @param string   $form    The form to add the field to (create/update/both)
     */
    public function addField($field, $form = 'both')
    {
        // if the field_defition_array array is a string, it means the programmer was lazy and has only passed the name
        // set some default values, so the field will still work
        if (is_string($field)) {
            $complete_field_array['name'] = $field;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        } else {
            $complete_field_array = $field;
        }

        // if the label is missing, we should set it
        if (! isset($complete_field_array['label'])) {
            $complete_field_array['label'] = ucfirst($complete_field_array['name']);
        }

        // if the field type is missing, we should set it
        if (! isset($complete_field_array['type'])) {
            $complete_field_array['type'] = $this->getFieldTypeFromDbColumnType($complete_field_array['name']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        }

        // store the field information into the correct variable on the CRUD object
        switch (strtolower($form)) {
            case 'create':
                $this->create_fields[$complete_field_array['name']] = $complete_field_array;
class MyClass { }

$x = new MyClass();
$x->foo = true;
                break;

            case 'update':
                $this->update_fields[$complete_field_array['name']] = $complete_field_array;
class MyClass { }

$x = new MyClass();
$x->foo = true;
                break;

            default:
                $this->create_fields[$complete_field_array['name']] = $complete_field_array;
                $this->update_fields[$complete_field_array['name']] = $complete_field_array;
                break;
        }

        return $this;
    }

    public function addFields($fields, $form = 'both')
    {
        if (count($fields)) {
            foreach ($fields as $field) {
                $this->addField($field, $form);
            }
        }
    }

    /**
     * Moves the recently added field to 'after' the $target_field
     *
     * @param $target_field
     */
    public function afterField($target_field) {

        foreach ($this->create_fields as $field => $value) {

            if ($value['name'] == $target_field) {
                array_splice($this->create_fields, $field + 1, 0, [$field => array_pop($this->create_fields)]);
                break;
            }
        }
        foreach ($this->update_fields as $field => $value) {

            if ($value['name'] == $target_field) {
                array_splice($this->update_fields, $field + 1, 0, [$field => array_pop($this->update_fields)]);
                break;
            }
        }
    }

    /**
     * Moves the recently added field to 'before' the $target_field
     *
     * @param $target_field
     */
    public function beforeField($target_field) {

        $key = 0;
        foreach ($this->create_fields as $field => $value) {

            if ($value['name'] == $target_field) {
                array_splice($this->create_fields, $key, 0, [$field => array_pop($this->create_fields)]);
                break;
            }
            $key++;
        }
        $key = 0;
        foreach ($this->update_fields as $field => $value) {

            if ($value['name'] == $target_field) {
                array_splice($this->update_fields, $key, 0, [$field => array_pop($this->update_fields)]);
                break;
            }
            $key++;
        }
    }

    /**
     * Remove a certain field from the create/update/both forms by its name.
     *
     * @param string $name Field name (as defined with the addField() procedure)
     * @param string $form update/create/both
     */
    public function removeField($name, $form = 'both')
    {
        switch (strtolower($form)) {
            case 'create':
                array_forget($this->create_fields, $name);
                break;

            case 'update':
                array_forget($this->update_fields, $name);
                break;

            default:
                array_forget($this->create_fields, $name);
                array_forget($this->update_fields, $name);
                break;
        }
    }

    /**
     * Remove many fields from the create/update/both forms by their name.
     *
     * @param array  $array_of_names A simple array of the names of the fields to be removed.
     * @param string $form           update/create/both
     */
    public function removeFields($array_of_names, $form = 'both')

    {
        if (! empty($array_of_names)) {
            foreach ($array_of_names as $name) {
                $this->removeField($name, $form);
            }
        }
    }

    /**
     * Check if field is the first of its type in the given fields array.
     * It's used in each field_type.blade.php to determine wether to push the css and js content or not (we only need to push the js and css for a field the first time it's loaded in the form, not any subsequent times).

     *
     * @param array $field        The current field being tested if it's the first of its type.
     * @param array $fields_array All the fields in that particular form.
     *
     * @return bool true/false
     */
    public function checkIfFieldIsFirstOfItsType($field, $fields_array)

    {
        if ($field['name'] == $this->getFirstOfItsTypeInArray($field['type'], $fields_array)['name']) {
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
            return true;
        }

        return false;
    }

    /**
     * Order the fields in a certain way.
     *
     * @param [string] Column name.
     * @param [attributes and values array]
     */
    public function setFieldOrder($fields)

    {
        // TODO
    }

    // ALIAS of setFieldOrder($fields)
    public function setFieldsOrder($fields)
    {
        $this->setFieldOrder($fields);
    }

    // ------------
    // TONE FUNCTIONS - UNDOCUMENTED, UNTESTED, SOME MAY BE USED
    // ------------
    // TODO: check them

    public function orderFields($order)
    {
        $this->setSort('fields', (array) $order);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
    }
}


1		<?php
2
3		namespace Backpack\CRUD\PanelTraits;
4
5		trait Fields
6		{
7		// ------------
8		// FIELDS
9		// ------------
10
11		/**
12		* Add a field to the create/update form or both.
13		*
14		* @param string $form The form to add the field to (create/update/both)
15		*/
16		public function addField($field, $form = 'both')
17		{
18		// if the field_defition_array array is a string, it means the programmer was lazy and has only passed the name
19		// set some default values, so the field will still work
20		if (is_string($field)) {
21		$complete_field_array['name'] = $field;
		0 ignored issues – show Coding Style Comprehensibility introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report `$complete_field_array` was never initialized. Although not strictly required by PHP, it is generally a good practice to add `$complete_field_array = array();` before regardless. Adding an explicit array definition is generally preferable to implicit array definition as it guarantees a stable state of the code. Let’s take a look at an example: foreach ($collection as $item) { $myArray['foo'] = $item->getFoo(); if ($item->hasBar()) { $myArray['bar'] = $item->getBar(); } // do something with $myArray } As you can see in this example, the array `$myArray` is initialized the first time when the foreach loop is entered. You can also see that the value of the `bar` key is only written conditionally; thus, its value might result from a previous iteration. This might or might not be intended. To make your intention clear, your code more readible and to avoid accidental bugs, we recommend to add an explicit initialization `$myArray = array()` either outside or inside the foreach loop. Loading history...
22		} else {
23		$complete_field_array = $field;
24		}
25
26		// if the label is missing, we should set it
27		if (! isset($complete_field_array['label'])) {
28		$complete_field_array['label'] = ucfirst($complete_field_array['name']);
29		}
30
31		// if the field type is missing, we should set it
32		if (! isset($complete_field_array['type'])) {
33		$complete_field_array['type'] = $this->getFieldTypeFromDbColumnType($complete_field_array['name']);
		0 ignored issues – show Bug introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report It seems like `getFieldTypeFromDbColumnType()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
34		}
35
36		// store the field information into the correct variable on the CRUD object
37		switch (strtolower($form)) {
38		case 'create':
39		$this->create_fields[$complete_field_array['name']] = $complete_field_array;
		0 ignored issues – show Bug introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report The property `create_fields` does not exist. Did you maybe forget to declare it? In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code: class MyClass { } $x = new MyClass(); $x->foo = true; Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: class MyClass { public $foo; } $x = new MyClass(); $x->foo = true; Loading history...
40		break;
41
42		case 'update':
43		$this->update_fields[$complete_field_array['name']] = $complete_field_array;
		0 ignored issues – show Bug introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report The property `update_fields` does not exist. Did you maybe forget to declare it? In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code: class MyClass { } $x = new MyClass(); $x->foo = true; Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion: class MyClass { public $foo; } $x = new MyClass(); $x->foo = true; Loading history...
44		break;
45
46		default:
47		$this->create_fields[$complete_field_array['name']] = $complete_field_array;
48		$this->update_fields[$complete_field_array['name']] = $complete_field_array;
49		break;
50		}
51
52		return $this;
53		}
54
55		public function addFields($fields, $form = 'both')
56		{
57		if (count($fields)) {
58		foreach ($fields as $field) {
59		$this->addField($field, $form);
60		}
61		}
62		}
63
64		/**
65		* Moves the recently added field to 'after' the $target_field
66		*
67		* @param $target_field
68		*/
69		public function afterField($target_field) {
		0 ignored issues – show Coding Style Naming introduced 2016-12-03 07:03 UTC by Report Bug Copy Issue Report The parameter $target_field is not named in camelCase. This check marks parameter names that have not been written in camelCase. In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection string becomes `databaseConnectionString`. Loading history...
70	View Code Duplication	foreach ($this->create_fields as $field => $value) {
		0 ignored issues – show Duplication introduced 2016-12-03 07:03 UTC by Report Bug Copy Issue Report This code seems to be duplicated across your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
71		if ($value['name'] == $target_field) {
72		array_splice($this->create_fields, $field + 1, 0, [$field => array_pop($this->create_fields)]);
73		break;
74		}
75		}
76	View Code Duplication	foreach ($this->update_fields as $field => $value) {
		0 ignored issues – show Duplication introduced 2016-12-03 07:03 UTC by Report Bug Copy Issue Report This code seems to be duplicated across your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
77		if ($value['name'] == $target_field) {
78		array_splice($this->update_fields, $field + 1, 0, [$field => array_pop($this->update_fields)]);
79		break;
80		}
81		}
82		}
83
84		/**
85		* Moves the recently added field to 'before' the $target_field
86		*
87		* @param $target_field
88		*/
89		public function beforeField($target_field) {
		0 ignored issues – show Coding Style Naming introduced 2016-12-03 07:03 UTC by Report Bug Copy Issue Report The parameter $target_field is not named in camelCase. This check marks parameter names that have not been written in camelCase. In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection string becomes `databaseConnectionString`. Loading history...
90		$key = 0;
91	View Code Duplication	foreach ($this->create_fields as $field => $value) {
		0 ignored issues – show Duplication introduced 2016-12-03 07:03 UTC by Report Bug Copy Issue Report This code seems to be duplicated across your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
92		if ($value['name'] == $target_field) {
93		array_splice($this->create_fields, $key, 0, [$field => array_pop($this->create_fields)]);
94		break;
95		}
96		$key++;
97		}
98		$key = 0;
99	View Code Duplication	foreach ($this->update_fields as $field => $value) {
		0 ignored issues – show Duplication introduced 2016-12-03 07:03 UTC by Report Bug Copy Issue Report This code seems to be duplicated across your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
100		if ($value['name'] == $target_field) {
101		array_splice($this->update_fields, $key, 0, [$field => array_pop($this->update_fields)]);
102		break;
103		}
104		$key++;
105		}
106		}
107
108		/**
109		* Remove a certain field from the create/update/both forms by its name.
110		*
111		* @param string $name Field name (as defined with the addField() procedure)
112		* @param string $form update/create/both
113		*/
114		public function removeField($name, $form = 'both')
115		{
116		switch (strtolower($form)) {
117		case 'create':
118		array_forget($this->create_fields, $name);
119		break;
120
121		case 'update':
122		array_forget($this->update_fields, $name);
123		break;
124
125		default:
126		array_forget($this->create_fields, $name);
127		array_forget($this->update_fields, $name);
128		break;
129		}
130		}
131
132		/**
133		* Remove many fields from the create/update/both forms by their name.
134		*
135		* @param array $array_of_names A simple array of the names of the fields to be removed.
136		* @param string $form update/create/both
137		*/
138		public function removeFields($array_of_names, $form = 'both')
		0 ignored issues – show Coding Style Naming introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report The parameter $array_of_names is not named in camelCase. This check marks parameter names that have not been written in camelCase. In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection string becomes `databaseConnectionString`. Loading history...
139		{
140		if (! empty($array_of_names)) {
141		foreach ($array_of_names as $name) {
142		$this->removeField($name, $form);
143		}
144		}
145		}
146
147		/**
148		* Check if field is the first of its type in the given fields array.
149		* It's used in each field_type.blade.php to determine wether to push the css and js content or not (we only need to push the js and css for a field the first time it's loaded in the form, not any subsequent times).
		0 ignored issues – show Coding Style introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report This line exceeds maximum limit of 120 characters; contains 219 characters Overly long lines are hard to read on any screen. Most code styles therefor impose a maximum limit on the number of characters in a line. Loading history...
150		*
151		* @param array $field The current field being tested if it's the first of its type.
152		* @param array $fields_array All the fields in that particular form.
153		*
154		* @return bool true/false
155		*/
156		public function checkIfFieldIsFirstOfItsType($field, $fields_array)
		0 ignored issues – show Coding Style Naming introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report The parameter $fields_array is not named in camelCase. This check marks parameter names that have not been written in camelCase. In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection string becomes `databaseConnectionString`. Loading history...
157		{
158		if ($field['name'] == $this->getFirstOfItsTypeInArray($field['type'], $fields_array)['name']) {
		0 ignored issues – show Bug introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report It seems like `getFirstOfItsTypeInArray()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history... Unused Code introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report This `if` statement, and the following `return` statement can be replaced with `return $field['name'] ==...$fields_array)['name'];`. Loading history...
159		return true;
160		}
161
162		return false;
163		}
164
165		/**
166		* Order the fields in a certain way.
167		*
168		* @param [string] Column name.
169		* @param [attributes and values array]
170		*/
171		public function setFieldOrder($fields)
		0 ignored issues – show Unused Code introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report The parameter `$fields` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
172		{
173		// TODO
174		}
175
176		// ALIAS of setFieldOrder($fields)
177		public function setFieldsOrder($fields)
178		{
179		$this->setFieldOrder($fields);
180		}
181
182		// ------------
183		// TONE FUNCTIONS - UNDOCUMENTED, UNTESTED, SOME MAY BE USED
184		// ------------
185		// TODO: check them
186
187		public function orderFields($order)
188		{
189		$this->setSort('fields', (array) $order);
		0 ignored issues – show Bug introduced 2016-06-16 14:52 UTC by Report Bug Copy Issue Report It seems like `setSort()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
190		}
191		}
192

Laravel-Backpack / CRUD

Scrutinizer GitHub App not installed

Push — master ( 13df59...0ad3ab )

Fields::beforeField() B

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like