|
-
Installation -
jMailComposer
is a 100% JAVA/JSP/Servlets sendmail component.
Read
[General]
instructions to install jMailComposer
on your servlet engine.
A
[WAR]
archive is available to make jMailComposer installation
easier (recommended!). It needs a servlet engine SERVLETS
2.2+ API compliant or a J2EE1.2+ compliant applications server.
See installation instructions.
Any problem ? Read the [FAQ]
first. Still a problem ? Post your question to our online
JSP Forum.
General
Installation |
Basically, our download package structure is SERVLETS
2.2+ compliant.
You
will find JAR files under a WEB-INF/lib folder. The
standardized deployment descriptor file (web.xml) under
WEB-INF/ folder and JSP files under / folder (document
root). Most of
servlet engines are compliants with this structure so
jMailComposer installation is as easy as a copy/paste.
Here are basic steps to install jMailComposer on your
servlet engine :
-
Add struts.jar,
uploadbean.jar,
activation.jar,
mail.jar,
smtp.jar and jmailcomposer.jar
the CLASSPATH of your web application.
(e.g. : Put these files under WEB-INF/lib/).
- Copy
JSP samples : blank/, resume/,
contact/
folders into the documentRoot
of your web application.
(e.g. : Put all these under a folder
jmailcomposer/ in your web server).
- Merge
WEB-INF/web.xml to your webapp's deployment descriptor.
This step requires JSP/Servlets/XML skills,
if you don't know how to do this then we strongly
recommend you to use the WAR
installation.
- Edit
blank/compose.jsp, contact/compose.jsp, resume/compose.jsp
to setup SMTP server propery before launching your
servlet engine.
Browse
the configuration
section to learn more about jMailComposer properties.
- Run
jMailComposer :
Documentation
: http://yourserver.com/jmailcomposer/documentation/index.html
Template : http://yourserver.com/jmailcomposer/blank/
Sample
1: http://yourserver.com/jmailcomposer/contact/
Sample
2: http://yourserver.com/jmailcomposer/resume/
|
WAR
Installation |
jMailComposer
is also available as a WAR archive. It's a SERVLETS
2.2 standard archive for Web Applications.
What does it mean ?... It means that WAR installation
is as easy as a copy/paste, regardless to the servlet
engine vendor.
-
To install jMailComposer WAR archive, copy
jmailcomposer.war
under the webapps folder of your servlet engine before
running it. That's all :-)
Note that webapps folder depends on your servlet
engine. It could be webapps/, applications/ ... The
WAR file will be automatically uncompressed under
jmailcomposer/ folder.
- Run
jMailComposer for the first time :
Documentation : http://yourserver.com/jmailcomposer/documentation/index.html
Template : http://yourserver.com/jmailcomposer/blank/
Sample
1: http://yourserver.com/jmailcomposer/contact/
Sample
2: http://yourserver.com/jmailcomposer/resume/
Note
that at this step, jMailComposer is running but
not configured yet.
- Once
launched for the first time, stop the servlet engine
to configure JSP samples as you need. You have to
modify SMTP server properties. Browse the configuration
section to learn more about jMailComposer properties.
The
jMailComposer WAR archive is downloadable at jMailComposer
Homepage.
|
FAQ |
- I
get Javascript errors when running compose.jsp ?
Do not access any JSP files directly, use servlets
URL instead. The main URL is http://myserver.com/jmailcomposer/blank/
- I
get a 404 HTTP error on http://myserver.com/jmailcomposer/blank/
?
- Try http://myserver.com/jmailcomposer/blank/compose
- Check your web deployment descriptor (web.xml).
You should have <servlet-mapping> entries matching
to /blank. You could find more info about lines to
add into web.xml in configuration
section.
- I
still get HTTP 404 error on http://myserver.com/jmailcomposer/blank/
?
Double check how you deployed jmailcomposer web
application. You might have deployed it under "/"
or "/something" so the correct main URL
should be http://yourserver.com/blank/ or http://yourserver.com/something/blank/
- I
get "Access to default session denied error"
when email is sending ?
You might need a login/password to get a JavaMail
session. jMailComposer supports authenticated session.
Add username and password properties in compose.jsp.
See configuration
section to learn more.
- How
to get StackTrace from ExceptionHandler ?
Right-click and view HTML source, full StackTrace
is in HTML comments.
- How
to add a progress bar when file is uploading ?
blank/
template includes a progress bar on uploads. It should
be a good starting point.
|
|
|