mirror of
https://github.com/silverstripe/silverstripe-userforms.git
synced 2024-10-22 17:05:42 +02:00
377 lines
11 KiB
PHP
377 lines
11 KiB
PHP
<?php
|
|
|
|
|
|
/**
|
|
* A Form can have multiply members / emails to email the submission
|
|
* to and custom subjects
|
|
*
|
|
* @package userforms
|
|
*/
|
|
class UserDefinedForm_EmailRecipient extends DataObject {
|
|
|
|
private static $db = array(
|
|
'EmailAddress' => 'Varchar(200)',
|
|
'EmailSubject' => 'Varchar(200)',
|
|
'EmailFrom' => 'Varchar(200)',
|
|
'EmailReplyTo' => 'Varchar(200)',
|
|
'EmailBody' => 'Text',
|
|
'EmailBodyHtml' => 'HTMLText',
|
|
'EmailTemplate' => 'Varchar',
|
|
'SendPlain' => 'Boolean',
|
|
'HideFormData' => 'Boolean',
|
|
'CustomRulesCondition' => 'Enum("And,Or")'
|
|
);
|
|
|
|
private static $has_one = array(
|
|
'Form' => 'UserDefinedForm',
|
|
'SendEmailFromField' => 'EditableFormField',
|
|
'SendEmailToField' => 'EditableFormField',
|
|
'SendEmailSubjectField' => 'EditableFormField'
|
|
);
|
|
|
|
private static $has_many = array(
|
|
'CustomRules' => 'UserDefinedForm_EmailRecipientCondition'
|
|
);
|
|
|
|
private static $summary_fields = array(
|
|
'EmailAddress',
|
|
'EmailSubject',
|
|
'EmailFrom'
|
|
);
|
|
|
|
public function summaryFields() {
|
|
$fields = parent::summaryFields();
|
|
if(isset($fields['EmailAddress'])) {
|
|
$fields['EmailAddress'] = _t('UserDefinedForm.EMAILADDRESS', 'Email');
|
|
}
|
|
if(isset($fields['EmailSubject'])) {
|
|
$fields['EmailSubject'] = _t('UserDefinedForm.EMAILSUBJECT', 'Subject');
|
|
}
|
|
if(isset($fields['EmailFrom'])) {
|
|
$fields['EmailFrom'] = _t('UserDefinedForm.EMAILFROM', 'From');
|
|
}
|
|
return $fields;
|
|
}
|
|
|
|
/**
|
|
* Get instance of UserDefinedForm when editing in getCMSFields
|
|
*
|
|
* @return UserDefinedFrom
|
|
*/
|
|
protected function getFormParent() {
|
|
$formID = $this->FormID
|
|
? $this->FormID
|
|
: Session::get('CMSMain.currentPage');
|
|
return UserDefinedForm::get()->byID($formID);
|
|
}
|
|
|
|
public function getTitle() {
|
|
if($this->EmailAddress) {
|
|
return $this->EmailAddress;
|
|
}
|
|
if($this->EmailSubject) {
|
|
return $this->EmailSubject;
|
|
}
|
|
return parent::getTitle();
|
|
}
|
|
|
|
/**
|
|
* Generate a gridfield config for editing filter rules
|
|
*
|
|
* @return GridFieldConfig
|
|
*/
|
|
protected function getRulesConfig() {
|
|
$formFields = $this->getFormParent()->Fields();
|
|
|
|
$config = GridFieldConfig::create()
|
|
->addComponents(
|
|
new GridFieldButtonRow('before'),
|
|
new GridFieldToolbarHeader(),
|
|
new GridFieldAddNewInlineButton(),
|
|
new GridFieldDeleteAction(),
|
|
$columns = new GridFieldEditableColumns()
|
|
);
|
|
|
|
$columns->setDisplayFields(array(
|
|
'ConditionFieldID' => function($record, $column, $grid) use ($formFields) {
|
|
return DropdownField::create($column, false, $formFields->map('ID', 'Title'));
|
|
},
|
|
'ConditionOption' => function($record, $column, $grid) {
|
|
$options = UserDefinedForm_EmailRecipientCondition::config()->condition_options;
|
|
return DropdownField::create($column, false, $options);
|
|
},
|
|
'ConditionValue' => function($record, $column, $grid) {
|
|
return TextField::create($column);
|
|
}
|
|
));
|
|
|
|
return $config;
|
|
}
|
|
|
|
/**
|
|
* @return FieldList
|
|
*/
|
|
public function getCMSFields() {
|
|
Requirements::javascript(USERFORMS_DIR . '/javascript/Recipient.js');
|
|
|
|
// Determine optional field values
|
|
$form = $this->getFormParent();
|
|
|
|
// predefined choices are also candidates
|
|
$multiOptionFields = EditableMultipleOptionField::get()->filter('ParentID', $form->ID);
|
|
|
|
// if they have email fields then we could send from it
|
|
$validEmailFromFields = EditableEmailField::get()->filter('ParentID', $form->ID);
|
|
|
|
// For the subject, only one-line entry boxes make sense
|
|
$validSubjectFields = ArrayList::create(
|
|
EditableTextField::get()
|
|
->filter('ParentID', $form->ID)
|
|
->exclude('Rows:GreaterThan', 1)
|
|
->toArray()
|
|
);
|
|
$validSubjectFields->merge($multiOptionFields);
|
|
|
|
// To address cannot be unbound, so restrict to pre-defined lists
|
|
$validEmailToFields = $multiOptionFields;
|
|
|
|
// Build fieldlist
|
|
$fields = FieldList::create(Tabset::create('Root')->addExtraClass('EmailRecipientForm'));
|
|
|
|
// Configuration fields
|
|
$fields->addFieldsToTab('Root.EmailDetails', array(
|
|
// Subject
|
|
FieldGroup::create(
|
|
TextField::create('EmailSubject', _t('UserDefinedForm.TYPESUBJECT', 'Type subject'))
|
|
->setAttribute('style', 'min-width: 400px;'),
|
|
DropdownField::create(
|
|
'SendEmailSubjectFieldID',
|
|
_t('UserDefinedForm.SELECTAFIELDTOSETSUBJECT', '.. or select a field to use as the subject'),
|
|
$validSubjectFields->map('ID', 'Title')
|
|
)->setEmptyString('')
|
|
)
|
|
->setTitle(_t('UserDefinedForm.EMAILSUBJECT', 'Email subject')),
|
|
|
|
// To
|
|
FieldGroup::create(
|
|
TextField::create('EmailAddress', _t('UserDefinedForm.TYPETO', 'Type to address'))
|
|
->setAttribute('style', 'min-width: 400px;'),
|
|
DropdownField::create(
|
|
'SendEmailToFieldID',
|
|
_t('UserDefinedForm.ORSELECTAFIELDTOUSEASTO', '.. or select a field to use as the to address'),
|
|
$validEmailToFields->map('ID', 'Title')
|
|
)->setEmptyString(' ')
|
|
)
|
|
->setTitle(_t('UserDefinedForm.SENDEMAILTO','Send email to'))
|
|
->setDescription(_t(
|
|
'UserDefinedForm.SENDEMAILTO_DESCRIPTION',
|
|
'You may enter multiple email addresses as a comma separated list.'
|
|
)),
|
|
|
|
|
|
// From
|
|
TextField::create('EmailFrom', _t('UserDefinedForm.FROMADDRESS','Send email from'))
|
|
->setDescription(_t(
|
|
'UserDefinedForm.EmailFromContent',
|
|
"The from address allows you to set who the email comes from. On most servers this ".
|
|
"will need to be set to an email address on the same domain name as your site. ".
|
|
"For example on yoursite.com the from address may need to be something@yoursite.com. ".
|
|
"You can however, set any email address you wish as the reply to address."
|
|
)),
|
|
|
|
|
|
// Reply-To
|
|
FieldGroup::create(
|
|
TextField::create('EmailReplyTo', _t('UserDefinedForm.TYPEREPLY', 'Type reply address'))
|
|
->setAttribute('style', 'min-width: 400px;'),
|
|
DropdownField::create(
|
|
'SendEmailFromFieldID',
|
|
_t('UserDefinedForm.ORSELECTAFIELDTOUSEASFROM', '.. or select a field to use as reply to address'),
|
|
$validEmailFromFields->map('ID', 'Title')
|
|
)->setEmptyString(' ')
|
|
)
|
|
->setTitle(_t('UserDefinedForm.REPLYADDRESS', 'Email for reply to'))
|
|
->setDescription(_t(
|
|
'UserDefinedForm.REPLYADDRESS_DESCRIPTION',
|
|
'The email address which the recipient is able to \'reply\' to.'
|
|
))
|
|
));
|
|
|
|
// Only show the preview link if the recipient has been saved.
|
|
if (!empty($this->EmailTemplate)) {
|
|
$preview = sprintf(
|
|
'<p><a href="%s" target="_blank" class="ss-ui-button">%s</a></p><em>%s</em>',
|
|
"admin/pages/edit/EditForm/field/EmailRecipients/item/{$this->ID}/preview",
|
|
_t('UserDefinedForm.PREVIEW_EMAIL', 'Preview email'),
|
|
_t('UserDefinedForm.PREVIEW_EMAIL_DESCRIPTION', 'Note: Unsaved changes will not appear in the preview.')
|
|
);
|
|
} else {
|
|
$preview = sprintf(
|
|
'<em>%s</em>',
|
|
_t(
|
|
'UserDefinedForm.PREVIEW_EMAIL_UNAVAILABLE',
|
|
'You can preview this email once you have saved the Recipient.'
|
|
)
|
|
);
|
|
}
|
|
|
|
// Email templates
|
|
$fields->addFieldsToTab('Root.EmailContent', array(
|
|
CheckboxField::create('HideFormData', _t('UserDefinedForm.HIDEFORMDATA', 'Hide form data from email?')),
|
|
CheckboxField::create(
|
|
'SendPlain',
|
|
_t('UserDefinedForm.SENDPLAIN', 'Send email as plain text? (HTML will be stripped)')
|
|
),
|
|
DropdownField::create(
|
|
'EmailTemplate',
|
|
_t('UserDefinedForm.EMAILTEMPLATE', 'Email template'),
|
|
$this->getEmailTemplateDropdownValues()
|
|
)->addExtraClass('toggle-html-only'),
|
|
HTMLEditorField::create('EmailBodyHtml', _t('UserDefinedForm.EMAILBODYHTML','Body'))
|
|
->addExtraClass('toggle-html-only'),
|
|
TextareaField::create('EmailBody', _t('UserDefinedForm.EMAILBODY','Body'))
|
|
->addExtraClass('toggle-plain-only'),
|
|
LiteralField::create(
|
|
'EmailPreview',
|
|
'<div id="EmailPreview" class="field toggle-html-only">' . $preview . '</div>'
|
|
)
|
|
));
|
|
|
|
// Custom rules for sending this field
|
|
$grid = new GridField(
|
|
"CustomRules",
|
|
_t('EditableFormField.CUSTOMRULES', 'Custom Rules'),
|
|
$this->CustomRules(),
|
|
$this->getRulesConfig()
|
|
);
|
|
$grid->setDescription(_t(
|
|
'UserDefinedForm.RulesDescription',
|
|
'Emails will only be sent to the recipient if the custom rules are met. If no rules are defined, this receipient will receive notifications for every submission.'
|
|
));
|
|
$fields->addFieldsToTab('Root.CustomRules', array(
|
|
new DropdownField(
|
|
'CustomRulesCondition',
|
|
_t('UserDefinedForm.SENDIF', 'Send condition'),
|
|
array(
|
|
'Or' => 'Any conditions are true',
|
|
'And' => 'All conditions are true'
|
|
)
|
|
),
|
|
$grid
|
|
));
|
|
|
|
$this->extend('updateCMSFields', $fields);
|
|
return $fields;
|
|
}
|
|
|
|
/**
|
|
* @param Member
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function canCreate($member = null) {
|
|
return $this->Form()->canCreate();
|
|
}
|
|
|
|
/**
|
|
* @param Member
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function canView($member = null) {
|
|
return $this->Form()->canView();
|
|
}
|
|
|
|
/**
|
|
* @param Member
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function canEdit($member = null) {
|
|
return $this->Form()->canEdit();
|
|
}
|
|
|
|
/**
|
|
* @param Member
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function canDelete($member = null) {
|
|
return $this->Form()->canDelete();
|
|
}
|
|
|
|
/*
|
|
* Determine if this recipient may receive notifications for this submission
|
|
*
|
|
* @param array $data
|
|
* @param Form $form
|
|
* @return bool
|
|
*/
|
|
public function canSend($data, $form) {
|
|
// Skip if no rules configured
|
|
$customRules = $this->CustomRules();
|
|
if(!$customRules->count()) {
|
|
return true;
|
|
}
|
|
|
|
// Check all rules
|
|
$isAnd = $this->CustomRulesCondition === 'And';
|
|
foreach($customRules as $customRule) {
|
|
$matches = $customRule->matches($data, $form);
|
|
if($isAnd && !$matches) {
|
|
return false;
|
|
}
|
|
if(!$isAnd && $matches) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
// Once all rules are checked
|
|
return $isAnd;
|
|
}
|
|
|
|
/**
|
|
* Make sure the email template saved against the recipient exists on the file system.
|
|
*
|
|
* @param string
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function emailTemplateExists($template = '') {
|
|
$t = ($template ? $template : $this->EmailTemplate);
|
|
|
|
return in_array($t, $this->getEmailTemplateDropdownValues());
|
|
}
|
|
|
|
/**
|
|
* Get the email body for the current email format
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getEmailBodyContent() {
|
|
return $this->SendPlain ? $this->EmailBody : $this->EmailBodyHtml;
|
|
}
|
|
|
|
/**
|
|
* Gets a list of email templates suitable for populating the email template dropdown.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getEmailTemplateDropdownValues() {
|
|
$templates = array();
|
|
|
|
$finder = new SS_FileFinder();
|
|
$finder->setOption('name_regex', '/^.*\.ss$/');
|
|
|
|
$found = $finder->find(BASE_PATH . '/' . UserDefinedForm::config()->email_template_directory);
|
|
|
|
foreach ($found as $key => $value) {
|
|
$template = pathinfo($value);
|
|
|
|
$templates[$template['filename']] = $template['filename'];
|
|
}
|
|
|
|
return $templates;
|
|
}
|
|
}
|