A custom implementation of a Pippo RouteGroup to handle email sending of a contact form. It uses Simple Java Mail internally.
To be able to create websites with Pippo consistently and effectively this route was created.
As it uses only the concept of RouteGroups in Pippo it is compatible with all versions from version 1.2.0. As it doesn't use any templates and Pippos internationalization system it is compatible with all template engines and multi-language capable.
-
Add the dependency to your pom.xml.
<dependency> <groupId>io.andromeda.pippo</groupId> <artifactId>pippo-contact-route</artifactId> <version>2.0.1</version> </dependency>
-
Configure the route and add it to the application
public class PippoApplication extends Application {
@Override
protected void onInit() {
/* Here the contact route is configured. */
ContactRouteConfiguration contactConfiguration = new ContactRouteConfiguration("/contact", "contact",
"Contact", "Example Contact Form",
"[email protected]", "Example Name",
"[email protected]");
/* Get the contect for this route. Use an empty map if there is no context. */
Map<String, Object> context = getDefaultContext();
/* Create a list of fields you want to have on the contact form. */
List<Field> fields = new ArrayList<>();
fields.add(new FullNameField(false)); // Full name of the user
fields.add(new EmailField(true)); // Email of the user, will be validated
fields.add(new SubjectField(false)); // The subject as entered
fields.add(new MessageField(false)); // The message content
fields.add(new GDPRCheckBox(true)); // The GDPR checkbox, will be validated
/* Here the route is added to the Pippo application. */
addRouteGroup(new ContactRoute(contactConfiguration, fields, context));
}
}- Add a
simplejavamail.propertiesfile undersrc/main/resourceswith the configuration of your email server. Please refer to the Simple Java Mail Website for details.
This is an example configuration file. Please be careful and don't check this file into a public git reporitory.
simplejavamail.transportstrategy=SMTP_TLS
simplejavamail.smtp.host=<host_url>
simplejavamail.smtp.port=<smtp_port>
simplejavamail.smtp.username=<username>
simplejavamail.smtp.password=<password>
- Add the internationalized error messages to your project. You can find them in
src/test/resources/conf. They need to add them to the correspondingsrc/main/resources/conf/messages.propertiesfiles. Currently there are error messages in English and German.
English
andromeda.pippo.contactroute.email.empty = Please enter your email address!
andromeda.pippo.contactroute.email.invalid = Please enter a valid email address!
andromeda.pippo.contactroute.name.empty = Please enter your name!
andromeda.pippo.contactroute.subject.empty = Please enter your subject!
andromeda.pippo.contactroute.message.empty = Please enter your message!
andromeda.pippo.contactroute.phone.empty = Please enter your phone number!
andromeda.pippo.contactroute.phone.invalid = Please enter a valid phone number!
andromeda.pippo.contactroute.gdpr.false = Please allow us to use your data internally!
German
andromeda.pippo.contactroute.email.empty = Bitte geben Sie Ihre Emailadresse ein!
andromeda.pippo.contactroute.email.invalid = Bitte geben Sie eine gültige Emailadresse ein!
andromeda.pippo.contactroute.name.empty = Bitte geben Sie Ihren Namen ein!
andromeda.pippo.contactroute.subject.empty = Bitte geben Sie Ihren Betreff ein!
andromeda.pippo.contactroute.message.empty = Bitte geben Sie Ihre Nachricht ein!
andromeda.pippo.contactroute.phone.empty = Bitte geben Sie Ihre Telefonnummer ein!
andromeda.pippo.contactroute.phone.invalid = Bitte geben Sie eine gültige Telefonnummer ein!
andromeda.pippo.contactroute.gdpr.false = Bitte geben Sie uns Ihre Erlaubnis Ihre Daten zu verarbeiten
public ContactRouteConfiguration(String url, String template, String formTitle, String recipientName,
String recipientAddress, String fromName, String fromAddress) {
ContactRouteConfiguration contactConfiguration = new ContactRouteConfiguration("/contact", "contact",
"Contact", "Example Contact Form",
"[email protected]", "Example Name",
"[email protected]");To provide good error handling Pippo Contact Route uses the internationalization mechanism in Pippo. Below you find the names of the properties and their defaults.
andromeda.pippo.contactroute.email.empty = Please enter your email address!
andromeda.pippo.contactroute.email.invalid = Please enter a valid email address!
andromeda.pippo.contactroute.name.empty = Please enter your name!
andromeda.pippo.contactroute.subject.empty = Please enter your subject!
andromeda.pippo.contactroute.message.empty = Please enter your message!
andromeda.pippo.contactroute.phone.empty = Please enter your phone number!
andromeda.pippo.contactroute.phone.invalid = Please enter a valid phone number!
andromeda.pippo.contactroute.gdpr.false = Please allow us to use your data internally!