oeg-upm/SendEmailWebApp

Name: SendEmailWebApp

Owner: Ontology Engineering Group (UPM)

Description: Webapp with formulary to send email a specified destinatary.

Created: 2016-02-11 12:27:56.0

Updated: 2016-07-20 11:43:01.0

Pushed: 2016-07-28 18:09:07.0

Homepage: null

Size: 72

Language: Java

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

SendEmailWebApp

SendEmailWebApp is a web application with a formulary to send emails to a specified destinatary.
This page is designed to be added at other page and the people can send emails at specified email adress.

Pre-requisites

• Maven 3.0 or later.
• Java 1.7 or later.
• Tomcat 1.7 or later.

Compile

Type in a cmd or console:

clean install

Usage

1) Configure webapp.
2) (Optional) add your own language pack.
3) (Optional) add banned ips.
4) Deploy the webapp in a tomcat server.

1) Configure Webapp.

Go to target/SendEmailWebApp/WEB-INF folder.
Edit configuration.properties and change the properties.
Example of configuration.properties:

mail.destinatary=TO_CHANGE
mail.host.url=TO_CHANGE
mail.host.port=TO_CHANGE
mail.host.user=TO_CHANGE
mail.host.password=TO_CHANGE
mail.ttls.enable=false
mail.message.header=%FULLNAME% sent you, from Web=TO_CHANGE and IP=%IP%, the next message: %MESSAGE%
server.mail.limit=5
server.mail.limit.interval.hours=24
server.mail.trys.limit=5
server.mail.trys.interval.hours=1

Properties description:

• mail.destinatary: Is the destinatary of email formulary.
  
• mail.host.url: Is the URL of smtp server.
  
• mail.host.port: Is the port of smtp server.
  
• mail.host.user: Is the user of smtp server.
  
• mail.host.password: Is the user of smtp server.
  
• mail.ttls.enable: If smtp server have TTLs then this parameter is “true”. Values “false”, “true”.
  
• mail.message.header: Is the header added to message for more info to destinatary. This param have reserved words (Replaced by webapp data):
  – %FULLNAME%: Fullname specified in formulary.
  – %IP%: The client ip that send the email.
  – %MESSAGE%: The specified message in formulary.
  
• server.mail.limit: Limit of messages sent by same ip in a interval.
  
• server.mail.limit.interval.hours: Time interval that clear count of emails sent.
  
• server.mail.trys.limit: Limit of captcha trys by same ip in a interval.
  
• server.mail.trys.interval.hours: Time interval that clear count of captcha trys.
  

2) (Optional) add your own language pack.

Go to target/SendEmailWebApp/WEB-INF/classes/resources/messages folder.
Copy ui.properties and rename it to ui_LANGUAGE-CODE_COUNTRY-CODE.properties
–Language-code is your language code, see the next list for search your code (ISO_639-1): https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
–Country-code is your country code, see the next list for search your code: https://es.wikipedia.org/wiki/ISO_3166-1
Edit your new file and translate it (Not translate the keys).
Example lines of languaje file:

key=value to translate
not.change=This is a example

3) (Optional) add banned ips.

Go to target/SendEmailWebApp/WEB-INF/bannedIPs.txt
Each line is a banned ip. If you want to add comments put “#” character and line start.
Example file:

#This is a comment.
#Each line is a banned IP.
#Ip hacker attacks:
1.12.123.123

4) Deploy the webapp in a tomcat server.

Copy the target/SendEmailWebApp folder to a tomcat webapps folder.
Or compress it on a war file and deploy it by tomcat manager.

Version

0.0.1