MailTemplateForm.java

/**
* OLAT - Online Learning and Training<br>
* http://www.olat.org
* <p>
* Licensed under the Apache License, Version 2.0 (the "License"); <br>
* you may not use this file except in compliance with the License.<br>
* You may obtain a copy of the License at
* <p>
* http://www.apache.org/licenses/LICENSE-2.0
* <p>
* Unless required by applicable law or agreed to in writing,<br>
* software distributed under the License is distributed on an "AS IS" BASIS, <br>
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. <br>
* See the License for the specific language governing permissions and <br>
* limitations under the License.
* <p>
* Copyright (c) since 2004 at Multimedia- & E-Learning Services (MELS),<br>
* University of Zurich, Switzerland.
* <hr>
* <a href="http://www.openolat.org">
* OpenOLAT - Online Learning and Training</a><br>
* This file has been modified by the OpenOLAT community. Changes are licensed
* under the Apache 2.0 license as the original file.  
* <p>
*/ 
package org.olat.core.util.mail;

import org.olat.core.gui.UserRequest;
import org.olat.core.gui.components.form.flexible.FormItem;
import org.olat.core.gui.components.form.flexible.FormItemContainer;
import org.olat.core.gui.components.form.flexible.elements.SelectionElement;
import org.olat.core.gui.components.form.flexible.elements.TextElement;
import org.olat.core.gui.components.form.flexible.impl.Form;
import org.olat.core.gui.components.form.flexible.impl.FormBasicController;
import org.olat.core.gui.components.form.flexible.impl.FormEvent;
import org.olat.core.gui.components.form.flexible.impl.FormLayoutContainer;
import org.olat.core.gui.control.Controller;
import org.olat.core.gui.control.Event;
import org.olat.core.gui.control.WindowControl;

/**
 * Description:<br>
 * The MailTemplateForm allows the user to enter a mailtext based on the MailTemplate
 * <p>
 * Initial Date: 21.11.2006 <br>
 * 
 * @author Florian Gnaegi, frentix GmbH<br>
 * http://www.frentix.com
 */
public class MailTemplateForm extends FormBasicController {

	private TextElement subjectElem;
	private TextElement bodyElem;
	private SelectionElement sendMail;
	private SelectionElement ccSender;
	private final static String NLS_CONTACT_SEND_CP_FROM = "contact.cp.from";
	
	private final boolean cc;
	private final boolean useCancel;
	private final boolean useSubmit;
	private MailTemplate template;
	private final boolean mandatoryEmail;
	/**
	 * Constructor for the mail notification form
	 * @param locale
	 * @param template Default values taken from this template
	 * @param useCancel 
	 * @param listeningController Controller that listens to form events
	 */
	public MailTemplateForm(UserRequest ureq, WindowControl wControl, MailTemplate template,
			boolean useCancel, boolean mandatoryEmail, boolean cc) {
		super(ureq, wControl);
		this.cc = cc;
		this.template = template;
		this.useCancel = useCancel;
		this.useSubmit = true;
		this.mandatoryEmail = mandatoryEmail;
		initForm (ureq);
	}
	
	public MailTemplateForm(UserRequest ureq, WindowControl wControl, MailTemplate template, boolean mandatoryEmail, Form rootForm) {
		super(ureq, wControl, LAYOUT_DEFAULT, null, rootForm);
		this.cc = true;
		this.template = template;
		useCancel = useSubmit = false;
		this.mandatoryEmail = mandatoryEmail;
		initForm (ureq);
	}

	/**
	 * Update the given templates with the values entered in the form
	 * @param mailTemplate 
	 */
	public void updateTemplateFromForm(MailTemplate mailTemplate) {
		mailTemplate.setSubjectTemplate(subjectElem.getValue());
		mailTemplate.setBodyTemplate(bodyElem.getValue());
		mailTemplate.setCpfrom(ccSender.isVisible() && ccSender.isSelected(0));
	}

	@Override
	protected void formOK(UserRequest ureq) {
		fireEvent (ureq, Event.DONE_EVENT);
	}
	
	@Override
	protected void formCancelled(UserRequest ureq) {
		fireEvent (ureq, Event.CANCELLED_EVENT);
	}
	
	@Override
	public boolean validateFormLogic (UserRequest ureq) {
		// validate only when sendMail is enabled
		if (mandatoryEmail || sendMail.isSelected(0)) {
			if (subjectElem.getValue().trim().length() == 0) {
				subjectElem.setErrorKey("mailtemplateform.error.emptyfield", null);
				return false;
			}
			
			if (bodyElem.getValue().trim().length() == 0) {
				bodyElem.setErrorKey("mailtemplateform.error.emptyfield", null);
				return false;
			}
			
			if (subjectElem.getValue().indexOf("#") != -1) {
					subjectElem.setErrorKey("mailtemplateform.error.velocity", null);
					return false;
			}
			
			if (bodyElem.getValue().indexOf("#") != -1) {
				bodyElem.setErrorKey("mailtemplateform.error.velocity", null);
				return false;
			}
		}
		return true;
	}
	
	@Override
	protected void initForm(FormItemContainer formLayout, Controller listener, UserRequest ureq) {
		if(!mandatoryEmail) {
			sendMail = uifactory.addCheckboxesVertical("sendmail", "", formLayout, new String[]{"xx"}, new String[]{translate("mailtemplateform.sendMailSwitchElem")}, 1);
			sendMail.addActionListener(FormEvent.ONCLICK);
		}

		subjectElem = uifactory.addTextElement("subjectElem", "mailtemplateform.subject", 128, template.getSubjectTemplate(), formLayout);
		subjectElem.setDisplaySize(60);
		subjectElem.setMandatory(true);
		
		bodyElem = uifactory.addTextAreaElement("bodyElem", "mailtemplateform.body", -1, 15, 60, true, template.getBodyTemplate(), formLayout);
		bodyElem.setMandatory(true);
		
		ccSender = uifactory.addCheckboxesVertical("tcpfrom", "", formLayout, new String[]{"xx"}, new String[]{translate(NLS_CONTACT_SEND_CP_FROM)}, 1);
		ccSender.setVisible(cc);
		
		FormLayoutContainer buttonGroupLayout = FormLayoutContainer.createButtonLayout("buttonGroupLayout", getTranslator());
		formLayout.add(buttonGroupLayout);
		
		if(useSubmit) {
			uifactory.addFormSubmitButton("continue", "mailtemplateform.continue", buttonGroupLayout);
		}
		if (useCancel) {
			uifactory.addFormCancelButton("cancel", buttonGroupLayout, ureq, getWindowControl());
		}
		
		update();
	}
	
	private void update () {
		boolean sm = mandatoryEmail || sendMail.isSelected(0);
		subjectElem.setVisible(sm);
		bodyElem.setVisible(sm);
		ccSender.setVisible(sm && cc);	
	}
	
	@Override
	protected void formInnerEvent (UserRequest ureq, FormItem source, FormEvent event) {
		update();
	}
	
	/**
	 * @return true: mail switch is enabled; false: otherwise
	 */
	public boolean sendMailSwitchEnabled() {
		return mandatoryEmail || sendMail.isSelected(0);
	}
	
	/**
	 * Checks if is ccSender selected.
	 *
	 * @return true, if is ccSender selected
	 */
	public boolean isCCSenderSelected() {
		return ccSender.isSelected(0);
	}
	
	/**
	 * Sets the send-mail element selected.
	 */
	public void setSendMailElementSelected () {
		this.sendMail.select("xx", true);
		update();
	}

	@Override
	protected void doDispose() {
		//
	}
	
}