"Varchar", "OnCompleteMessage" => "HTMLText", "ShowClearButton" => "Boolean", 'DisableSaveSubmissions' => 'Boolean' ); /** * @var Array Default values of variables when this page is created */ static $defaults = array( 'Content' => '$UserDefinedForm', 'DisableSaveSubmissions' => 0, 'OnCompleteMessage' => '
Thanks, we\'ve received your submission.
' ); static $extensions = array( "Versioned('Stage', 'Live')" ); /** * @var Array */ static $has_many = array( "Fields" => "EditableFormField", "Submissions" => "SubmittedForm", "EmailRecipients" => "UserDefinedForm_EmailRecipient" ); /** * Setup the CMS Fields for the User Defined Form * * @return FieldSet */ public function getCMSFields() { $fields = parent::getCMSFields(); // define tabs $fields->findOrMakeTab('Root.Content.Form', _t('UserDefinedForm.FORM', 'Form')); $fields->findOrMakeTab('Root.Content.Options', _t('UserDefinedForm.OPTIONS', 'Options')); $fields->findOrMakeTab('Root.Content.EmailRecipients', _t('UserDefinedForm.EMAILRECIPIENTS', 'Email Recipients')); $fields->findOrMakeTab('Root.Content.OnComplete', _t('UserDefinedForm.ONCOMPLETE', 'On Complete')); $fields->findOrMakeTab('Root.Content.Submissions', _t('UserDefinedForm.SUBMISSIONS', 'Submissions')); // field editor $fields->addFieldToTab("Root.Content.Form", new FieldEditor("Fields", 'Fields', "", $this )); // view the submissions $fields->addFieldToTab("Root.Content.Submissions", new CheckboxField('DisableSaveSubmissions',_t('UserDefinedForm.SAVESUBMISSIONS',"Disable Saving Submissions to Server"))); $fields->addFieldToTab("Root.Content.Submissions", new SubmittedFormReportField( "Reports", _t('UserDefinedForm.RECEIVED', 'Received Submissions'), "", $this ) ); // who do we email on submission $emailRecipients = new ComplexTableField( $this, 'EmailRecipients', 'UserDefinedForm_EmailRecipient', array( 'EmailAddress' => _t('UserDefinedForm.EMAILADDRESS', 'Email'), 'EmailSubject' => _t('UserDefinedForm.EMAILSUBJECT', 'Subject'), 'EmailFrom' => _t('UserDefinedForm.EMAILFROM', 'From') ), 'getCMSFields_forPopup', "\"FormID\" = '$this->ID'" ); $emailRecipients->setAddTitle(_t('UserDefinedForm.AEMAILRECIPIENT', 'A Email Recipient')); $fields->addFieldToTab("Root.Content.EmailRecipients", $emailRecipients); // text to show on complete $onCompleteFieldSet = new FieldSet( new HtmlEditorField( "OnCompleteMessage", _t('UserDefinedForm.ONCOMPLETELABEL', 'Show on completion'),3,"",_t('UserDefinedForm.ONCOMPLETEMESSAGE', $this->OnCompleteMessage), $this ) ); $fields->addFieldsToTab("Root.Content.OnComplete", $onCompleteFieldSet); $fields->addFieldsToTab("Root.Content.Options", $this->getFormOptions()); return $fields; } /** * Publishing Versioning support. * * When publishing copy the editable form fields to the live database * Not going to version emails and submissions as they are likely to * persist over multiple versions * * @return void */ public function doPublish() { // remove fields on the live table which could have been orphaned. $live = Versioned::get_by_stage("EditableFormField", "Live", "\"EditableFormField\".\"ParentID\" = $this->ID"); if($live) { foreach($live as $field) { $field->doDeleteFromStage('Live'); } } // publish the draft pages if($this->Fields()) { foreach($this->Fields() as $field) { $field->doPublish('Stage', 'Live'); } } parent::doPublish(); } /** * Unpublishing Versioning support * * When unpublishing the page it has to remove all the fields from * the live database table * * @return void */ public function doUnpublish() { if($this->Fields()) { foreach($this->Fields() as $field) { $field->doDeleteFromStage('Live'); } } parent::doUnpublish(); } /** * Roll back a form to a previous version. * * @param String|int Version to roll back to */ public function doRollbackTo($version) { parent::doRollbackTo($version); /* Not implemented yet // get the older version $reverted = Versioned::get_version($this->ClassName, $this->ID, $version); if($reverted) { // using the lastedited date of the reverted object we can work out which // form fields to revert back to if($this->Fields()) { foreach($this->Fields() as $field) { // query to see when the version of the page was pumped $editedDate = DB::query(" SELECT LastEdited FROM \"SiteTree_versions\" WHERE \"RecordID\" = '$this->ID' AND \"Version\" = $version ")->value(); // find a the latest version which has been edited $versionToGet = DB::query(" SELECT * FROM \"EditableFormField_versions\" WHERE \"RecordID\" = '$field->ID' AND \"LastEdited\" <= '$editedDate' ORDER BY Version DESC LIMIT 1 ")->record(); if($versionToGet) { Debug::show('publishing field'. $field->Name); Debug::show($versionToGet); $field->publish($versionToGet, "Stage", true); $field->writeWithoutVersion(); } else { Debug::show('deleting field'. $field->Name); $this->Fields()->remove($field); $field->delete(); $field->destroy(); } } } // @todo Emails } */ } /** * Revert the draft site to the current live site * * @return void */ public function doRevertToLive() { if($this->Fields()) { foreach($this->Fields() as $field) { $field->publish("Live", "Stage", false); $field->writeWithoutVersion(); } } parent::doRevertToLive(); } /** * Duplicate this UserDefinedForm page, and its form fields. * Submissions, on the other hand, won't be duplicated. * * @return Page */ public function duplicate() { $page = parent::duplicate(); // the form fields if($this->Fields()) { foreach($this->Fields() as $field) { $newField = $field->duplicate(); $newField->ParentID = $page->ID; $newField->write(); } } // the emails if($this->EmailRecipients()) { foreach($this->EmailRecipients() as $email) { $newEmail = $email->duplicate(); $newEmail->FormID = $page->ID; $newEmail->write(); } } return $page; } /** * Custom options for the form. You can extend the built in options by * using {@link updateFormOptions()} * * @return FieldSet */ public function getFormOptions() { $submit = ($this->SubmitButtonText) ? $this->SubmitButtonText : _t('UserDefinedForm.SUBMITBUTTON', 'Submit'); $options = new FieldSet( new TextField("SubmitButtonText", _t('UserDefinedForm.TEXTONSUBMIT', 'Text on submit button:'), $submit), new CheckboxField("ShowClearButton", _t('UserDefinedForm.SHOWCLEARFORM', 'Show Clear Form Button'), $this->ShowClearButton) ); $this->extend('updateFormOptions', $options); return $options; } /** * Return if this form has been modified on the stage site and not published. * this is used on the workflow module and for a couple highlighting things * * @todo make this a bit smarter - the issue with userforms is that it uses several * relationships to form fields which has a undefined amount of options so * for now just say its always modified */ public function getIsModifiedOnStage() { return true; } } /** * Controller for the {@link UserDefinedForm} page type. * * @package userform * @subpackage pagetypes */ class UserDefinedForm_Controller extends Page_Controller { /** * Load all the custom jquery needed to run the custom * validation */ public function init() { parent::init(); // block prototype validation Validator::set_javascript_validation_handler('none'); // load the jquery Requirements::javascript(SAPPHIRE_DIR .'/thirdparty/jquery/jquery.js'); Requirements::javascript('userforms/thirdparty/jquery-validate/jquery.validate.min.js'); } /** * Using $UserDefinedForm in the Content area of the page shows * where the form should be rendered into. If it does not exist * then default back to $Form * * @return Array */ public function index() { if($this->Content && $form = $this->Form()) { $hasLocation = stristr($this->Content, '$UserDefinedForm'); if($hasLocation) { $content = str_ireplace('$UserDefinedForm', $form->forTemplate(), $this->Content); return array( 'Content' => DBField::create('HTMLText', $content), 'Form' => "" ); } } return array( 'Content' => DBField::create('HTMLText', $this->Content), 'Form' => $this->Form() ); } /** * Get the form for the page. Form can be modified by calling {@link updateForm()} * on a UserDefinedForm extension * * @return Form */ function Form() { $fields = $this->getFormFields(); $actions = $this->getFormActions(); // get the required fields including the validation $required = $this->getRequiredFields(); // generate the conditional logic $this->generateConditionalJavascript(); $form = new Form($this, "Form", $fields, $actions, $required); $this->extend('updateForm', $form); return $form; } /** * Get the form fields for the form on this page. Can modify this FieldSet * by using {@link updateFormFields()} on an {@link Extension} subclass which * is applied to this controller * * @return FieldSet */ function getFormFields() { $fields = new FieldSet(); if($this->Fields()) { foreach($this->Fields() as $editableField) { // get the raw form field from the editable version $field = $editableField->getFormField(); if(!$field) break; // set the error / formatting messages $title = strip_tags("'". ($editableField->Title ? $editableField->Title : $editableField->Name) . "'"); $errorMessage = sprintf(_t('Form.FIELDISREQUIRED', '%s is required').'.', $title); $errorMessage = ($editableField->CustomErrorMessage) ? $editableField->CustomErrorMessage : $errorMessage; $field->setCustomValidationMessage($errorMessage); // set the right title on this field if($right = $editableField->getSetting('RightTitle')) { $field->setRightTitle($right); } // if this field is required add some if($editableField->Required) { $field->addExtraClass('requiredField'); if($identifier = UserDefinedForm::$required_identifier) { $title = $field->Title() ." ". $identifier . ""; $field->setTitle($title); } } $fields->push($field); } } $this->extend('updateFormFields', $fields); return $fields; } /** * Generate the form actions for the UserDefinedForm. You * can manipulate these by using {@link updateFormActions()} on * a decorator. * * @todo Make form actions editable via their own field editor. * * @return FieldSet */ function getFormActions() { $submitText = ($this->SubmitButtonText) ? $this->SubmitButtonText : _t('UserDefinedForm.SUBMITBUTTON', 'Submit'); $actions = new FieldSet( new FormAction("process", $submitText) ); if($this->ShowClearButton) { $actions->push(new ResetFormAction("clearForm")); } $this->extend('updateFormActions', $actions); return $actions; } /** * Get the required form fields for this form. Includes building the jQuery * validate structure * * @return RequiredFields */ function getRequiredFields() { $required = new RequiredFields(); $rules = array(); $validation = array(); if($this->Fields()) { foreach($this->Fields() as $field) { if($field->Required) { $validation[$field->Name] = $field->getFormField()->getCustomValidationMessage(); $rules[$field->Name] = array_merge(array('required'), $field->getValidation()); $required->addRequiredField($field->Name); } } } // Set the Form Name $rules = $this->array2json($rules); $messages = $this->array2json($validation); // set the custom script for this form Requirements::customScript(<<