admin_email_form.php

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Admin email form.
 *
 * @package    block_quickmail
 * @copyright  2008-2017 Louisiana State University
 * @copyright  2008-2017 Adam Zapletal, Chad Mazilly, Philip Cali, Robert Russo
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die;

require_once($CFG->libdir . '/formslib.php');

/**
 * Admin email form.
 *
 * @package    block_quickmail
 * @copyright  2008-2017 Louisiana State University
 * @copyright  2008-2017 Adam Zapletal, Chad Mazilly, Philip Cali, Robert Russo
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class admin_email_form extends moodleform {
    /**
     * The form definition.
     *
     * @return void
     * @throws coding_exception
     */
    protected function definition(): void {
        $mform =& $this->_form;

        $mform->addElement('text', 'subject', get_string('subject', 'block_quickmail'));
        $mform->setType('subject', PARAM_TEXT);

        $mform->addElement('text', 'noreply', get_string('noreply', 'block_quickmail'));
        $mform->setType('noreply', PARAM_EMAIL);

        $mform->addElement(
            'editor',
            'message_editor',
            get_string('body', 'block_quickmail'),
            null,
            $this->_customdata['editor_options']
        );
        $mform->setType('message', PARAM_RAW);

        $buttons = [
            $mform->createElement('submit', 'send', get_string('send_email', 'block_quickmail')),
            $mform->createElement('cancel', 'cancel', get_string('cancel')),
        ];
        $mform->addGroup($buttons, 'actions', '&nbsp;', [' '], false);

        $mform->addRule('subject', null, 'required', 'client');
        $mform->addRule('noreply', null, 'required', 'client');
        $mform->addRule('message_editor', null, 'required');
    }

    /**
     * Performs additional form validation steps.
     *
     * @param array $data Submitted form data.
     * @param array $files Uploaded form files.
     * @return array A list of validation errors.
     */
    public function validation($data, $files): array {
        $errors = [];
        foreach (['subject', 'message_editor'] as $field) {
            if (empty($data[$field])) {
                $errors[$field] = get_string('email_error_field', 'block_quickmail', $field);
            }
        }
        return $errors;
    }
}