silverstripe-spamprotection/code/Extension/FormSpamProtectionExtension.php

133 lines
3.4 KiB
PHP
Raw Normal View History

<?php
namespace SilverStripe\SpamProtection\Extension;
2016-10-10 07:44:28 +02:00
use SilverStripe\Core\Config\Configurable;
2016-10-10 07:44:28 +02:00
use SilverStripe\Core\Extension;
use SilverStripe\Core\Injector\Injector;
/**
* An extension to the {@link Form} class which provides the method
* {@link enableSpamProtection()} helper.
*
* @package spamprotection
*/
2015-11-21 07:15:15 +01:00
class FormSpamProtectionExtension extends Extension
{
use Configurable;
2015-11-21 07:15:15 +01:00
/**
* @config
*
* The default spam protector class name to use. Class should implement the
* {@link SpamProtector} interface.
*
* @var string $spam_protector
*/
private static $default_spam_protector;
2015-11-21 07:15:15 +01:00
/**
* @config
*
* The {@link enableSpamProtection} method will define which of the form
2015-11-21 07:15:15 +01:00
* values correlates to this form mapped fields list. Totally custom forms
* and subclassed SpamProtector instances are define their own mapping
*
* @var array $mappable_fields
*/
private static $mappable_fields = array(
'id',
'title',
'body',
'contextUrl',
'contextTitle',
'authorName',
'authorMail',
'authorUrl',
'authorIp',
'authorId'
);
/**
* @config
*
* The field name to use for the {@link SpamProtector} {@link FormField}
*
* @var string $spam_protector
*/
private static $field_name = "Captcha";
2015-11-21 07:15:15 +01:00
/**
* Instantiate a SpamProtector instance
*
* @param array $options Configuration options
* @return SpamProtector|null
2015-11-21 07:15:15 +01:00
*/
public static function get_protector($options = null)
{
// generate the spam protector
if (isset($options['protector'])) {
$protector = $options['protector'];
} else {
$protector = self::config()->get('default_spam_protector');
2015-11-21 07:15:15 +01:00
}
2022-04-13 03:47:43 +02:00
if ($protector && class_exists($protector ?? '')) {
2015-11-21 07:15:15 +01:00
return Injector::inst()->create($protector);
} else {
return null;
}
}
2015-11-21 07:15:15 +01:00
/**
* Activates the spam protection module.
*
* @param array $options
2016-10-10 07:44:28 +02:00
* @return Object
2015-11-21 07:15:15 +01:00
*/
public function enableSpamProtection($options = array())
{
2015-11-21 07:15:15 +01:00
// captcha form field name (must be unique)
if (isset($options['name'])) {
$name = $options['name'];
} else {
$name = $this->config()->get('field_name');
2015-11-21 07:15:15 +01:00
}
2015-11-21 07:15:15 +01:00
// captcha field title
if (isset($options['title'])) {
$title = $options['title'];
} else {
$title = '';
}
2015-11-21 07:15:15 +01:00
// set custom mapping on this form
$protector = self::get_protector($options);
2015-11-21 07:15:15 +01:00
if (isset($options['mapping'])) {
$protector->setFieldMapping($options['mapping']);
}
2015-11-21 07:15:15 +01:00
if ($protector) {
// add the form field
if ($field = $protector->getFormField($name, $title)) {
$field->setForm($this->owner);
2015-11-21 07:15:15 +01:00
// Add before field specified by insertBefore
$inserted = false;
if (!empty($options['insertBefore'])) {
$inserted = $this->owner->Fields()->insertBefore($field, $options['insertBefore']);
}
if (!$inserted) {
// Add field to end if not added already
$this->owner->Fields()->push($field);
}
}
}
2015-11-21 07:15:15 +01:00
return $this->owner;
}
}