HoneypotField::Title() - Code Metrics - Inspection of "SS 4 Support" - studiobonito/silverstripe-spamprotection-honeypot - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#13)

by Nathan

created 2018-01-19 05:57 UTC

HoneypotField::Title() A

↳ Parent: HoneypotField

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes

Metric	Value
c	0
b	0
f	0
dl	0
loc	4
ccs	0
cts	0
cp	0
rs	10
cc	1
eloc	2
nc	1
nop	0
crap	2

<?php namespace StudioBonito\SilverStripe\SpamProtection\Honeypot\FormField;

use SilverStripe\View\HTML;
use SilverStripe\Core\Config\Config;
use SilverStripe\Forms\TextField;

class HoneypotField extends TextField
{
    /**
     * The number of seconds before you can submit a valid request.
     *
     * @var int
     * @config
     */
    private static $time_limit = 5;


    /**
     * Reject the field if the honeypot has been filled or if the form has been submitted to quickly.
     *
     * @param $validator
     *
     * @return bool
     */
    public function validate($validator)
    {
        $timeLimit = $this->config()->time_limit;

        $timestamp = $this->getForm()->getController()->getRequest()->postVar($this->getName() . '_Timestamp');

        if (!empty($this->value) || ($timeLimit > 0 && ($timestamp + $timeLimit) > time())) {
            $validator->validationError(
                $this->name,
                _t(
                    'HoneypotField.SPAM',
                    'Your submission has been rejected because it was treated as spam.'
                ),
                'error'
            );

            return false;
        }

        return true;
    }

    /**
     * Since this isn't a hidden field, the title will continue to show in the form.
     * This prevents that from happening, since a hidden field will not show the validation message.
     *
     * @codeCoverageIgnore
     *
     * @return string
     */
    public function Title()
    {
        return '';
    }

    /**
     * Override the Type to remove the class namespace.
     *
     * @codeCoverageIgnore
     *
     * @return string
     */
    public function Type()
    {
        return 'honeypotspamprotector';
    }

    /**
     * Override the Field to add the Captcha and Timestamp fields.
     *
     * @codeCoverageIgnore
     *
     * @param array $properties
     *
     * @return string
     */
    public function Field($properties = array())
    {
        return $this->createHoneypotField() . $this->createTimestampField();
class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}
    }

    /**
     * Create the Captcha Field.
     *
     * @codeCoverageIgnore
     *
     * @return string
     */
    protected function createHoneypotField()
    {
        return HTML::createTag(
            'input',
            array(
                'type'  => 'text',
                'id'    => $this->ID(),
                'name'  => $this->getName(),
                'value' => $this->Value(),
                'style' => $this->getFieldStyle(),
            )
        );
    }

    /**
     * Create the Timestamp Field.
     *
     * @codeCoverageIgnore
     *
     * @return string
     */
    protected function createTimestampField()
    {
        return HTML::createTag(
            'input',
            array(
                'type'  => 'text',
                'id'    => $this->ID() . '_Timestamp',
                'name'  => $this->getName() . '_Timestamp',
                'value' => time(),
                'style' => $this->getFieldStyle(),
            )
        );
    }
    
    /**
     * Return a configured style rule for the fields, if none is configured use a default display:none rule
     *
     * @codeCoverageIgnore
     *
     * @return string
     */
    public function getFieldStyle()
    {
        $default_css_rule = 'display:none!important';
        $css_rule = Config::inst()->get(__CLASS__, 'field_style_rule');
        if (!$css_rule) {
            return $default_css_rule;
        } else {
            return $css_rule;
        }
    }
}


1		<?php namespace StudioBonito\SilverStripe\SpamProtection\Honeypot\FormField;
2
3		use SilverStripe\View\HTML;
4		use SilverStripe\Core\Config\Config;
5		use SilverStripe\Forms\TextField;
6
7		class HoneypotField extends TextField
8		{
9		/**
10		* The number of seconds before you can submit a valid request.
11		*
12		* @var int
13		* @config
14		*/
15		private static $time_limit = 5;
		0 ignored issues – show Unused Code introduced 2015-12-10 20:45 UTC by Report Bug Copy Issue Report The property `$time_limit` is not used and could be removed. This check marks private properties in classes that are never used. Those properties can be removed. Loading history...
16
17		/**
18		* Reject the field if the honeypot has been filled or if the form has been submitted to quickly.
19		*
20		* @param $validator
21		*
22	6	* @return bool
23		*/
24	6	public function validate($validator)
25		{
26	6	$timeLimit = $this->config()->time_limit;
27
28	6	$timestamp = $this->getForm()->getController()->getRequest()->postVar($this->getName() . '_Timestamp');
29	3
30	3	if (!empty($this->value) \|\| ($timeLimit > 0 && ($timestamp + $timeLimit) > time())) {
31	3	$validator->validationError(
32	3	$this->name,
33		_t(
34	3	'HoneypotField.SPAM',
35		'Your submission has been rejected because it was treated as spam.'
36	3	),
37		'error'
38	3	);
39
40		return false;
41	3	}
42
43		return true;
44		}
45
46		/**
47		* Since this isn't a hidden field, the title will continue to show in the form.
48		* This prevents that from happening, since a hidden field will not show the validation message.
49		*
50		* @codeCoverageIgnore
51		*
52		* @return string
53		*/
54		public function Title()
55		{
56		return '';
57		}
58
59		/**
60		* Override the Type to remove the class namespace.
61		*
62		* @codeCoverageIgnore
63		*
64		* @return string
65		*/
66		public function Type()
67		{
68		return 'honeypotspamprotector';
69		}
70
71		/**
72		* Override the Field to add the Captcha and Timestamp fields.
73		*
74		* @codeCoverageIgnore
75		*
76		* @param array $properties
77		*
78		* @return string
79		*/
80		public function Field($properties = array())
81		{
82		return $this->createHoneypotField() . $this->createTimestampField();
		0 ignored issues – show Bug Best Practice introduced 2018-01-19 04:34 UTC by Report Bug Copy Issue Report The return type of `return $this->createHone...createTimestampField();` (`string`) is incompatible with the return type of the parent method `SilverStripe\Forms\FormField::Field` of type `SilverStripe\ORM\FieldType\DBHTMLText`. If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design. Let’s take a look at an example: class Author { private $name; public function __construct($name) { $this->name = $name; } public function getName() { return $this->name; } } abstract class Post { public function getAuthor() { return 'Johannes'; } } class BlogPost extends Post { public function getAuthor() { return new Author('Johannes'); } } class ForumPost extends Post { /* ... */ } function my_function(Post $post) { echo strtoupper($post->getAuthor()); } Our function `my_function` expects a `Post` object, and outputs the author of the post. The base class `Post` returns a simple string and outputting a simple string will work just fine. However, the child class `BlogPost` which is a sub-type of `Post` instead decided to return an `object`, and is therefore violating the SOLID principles. If a `BlogPost` were passed to `my_function`, PHP would not complain, but ultimately fail when executing the `strtoupper` call in its body. Loading history...
83		}
84
85		/**
86		* Create the Captcha Field.
87		*
88		* @codeCoverageIgnore
89		*
90		* @return string
91		*/
92		protected function createHoneypotField()
93		{
94		return HTML::createTag(
95		'input',
96		array(
97		'type' => 'text',
98		'id' => $this->ID(),
99		'name' => $this->getName(),
100		'value' => $this->Value(),
101		'style' => $this->getFieldStyle(),
102		)
103		);
104		}
105
106		/**
107		* Create the Timestamp Field.
108		*
109		* @codeCoverageIgnore
110		*
111		* @return string
112		*/
113		protected function createTimestampField()
114		{
115		return HTML::createTag(
116		'input',
117		array(
118		'type' => 'text',
119		'id' => $this->ID() . '_Timestamp',
120		'name' => $this->getName() . '_Timestamp',
121		'value' => time(),
122		'style' => $this->getFieldStyle(),
123		)
124		);
125		}
126
127		/**
128		* Return a configured style rule for the fields, if none is configured use a default display:none rule
129		*
130		* @codeCoverageIgnore
131		*
132		* @return string
133		*/
134		public function getFieldStyle()
135		{
136		$default_css_rule = 'display:none!important';
137		$css_rule = Config::inst()->get(__CLASS__, 'field_style_rule');
138		if (!$css_rule) {
139		return $default_css_rule;
140		} else {
141		return $css_rule;
142		}
143		}
144		}
145

studiobonito / silverstripe-spamprotection-honeypot

Pull Request — master (#13)

HoneypotField::Title() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like