Purpose
This portlet provides an easily extendable system for user submitted feedback
forms.
Design
1. Display a form with typical feedback fields (name, phone, email, comments, etc).
2. Upon submission, email the data to a specified address (or system)
CVS
...
| Wiki Markup |
|---|
h3. Purpose This portlet provides an easily extendable system for user submitted feedback forms. h3. Design 1. Display a form with typical feedback fields (name, phone, email, comments, etc). 2. Upon submission, email the data to a specified address (or system) h3. CVS {nocc}ViewCVS{nocc} link: http://www.uportal.org/cgi-bin/viewcvs.cgi/portal_portlets/FeedbackPortlet/ |
...
See http://www.uportal.org/cvs.html for CVS access. |
...
Implementation
Required Libraries:
...
h3. Implementation Required Libraries: - JAF 1.0.2, activation.jar (Included) |
...
- JavaMail 1.3.2, mail.jar (Included) |
...
- JSTL, jstl.jar (Included) |
...
- Jakarta standard tag libs, standard.jar (Included) |
...
- Spring Framework 1.2.5, spring_1.2.5.jar (Included) |
...
- Spring Portlet MVC build 20050928, spring-portlet_20050928.jar (Included) |
...
-- (see http://opensource2.atlassian.com/confluence/spring/display/JSR168/Home) |
...
This portlet is ready for deployment, no additional libraries are needed. |
...
All development and testing was run with uPortal 2.5.1 quickstart, and |
...
Jakarta Tomcat 5.0.28. |
...
The Spring Portlet MVC is an add on for the spring framework that provides the |
...
servlet/web MVC functionality (in the spring framework) for portlets. |
...
Model: The Feedback is stored in a java bean class, named |
...
edu.wisc.my.portlets.feedback.beans.Feedback. Feedback objects get passed |
...
into an edu.wisc.my.portlets.feedback.dao.IFeedbackMessageFormatter, which |
...
returns a org.springframework.mail.SimpleMailMessage. |
...
View: The display pages are made with JSP. You will likely want to modify these |
...
to display information relevant to your computer help organization. |
...
Please - NO SCRIPTLETS!!! If you want scriptlets, please do not submit them |
...
back to CVS. |
...
Controller: classname - edu.wisc.my.portlets.feedback.web.FeedbackFormController. |
...
Extends org.springframework.web.portlet.mvc.SimpleFormController. |
...
There are two fields that need to be set, an IFeedbackFormatter implementation |
...
and an org.springframework.mail.MailSender (a JavaMailSender is listed in |
...
the spring configuration). |
...
Configuration
...
h3. Configuration Within web/WEB-INF/applicationContext.xml, there are two beans, a JavaMailSenderImpl and an IFeedbackMessageFormatter. |
...
For the mailSender, supply any properties you need for your SMTP smart host. This |
...
may be localhost, or a remote server. See http://www.springframework.org/docs/api/org/springframework/mail/javamail/JavaMailSenderImpl.html for the list of availble options. |
...
For the IFeedbackMessageFormatter, choose your desired implementation, and supply fields (those listed are the recipient and from addresses). h3. |
...
Installation |
...
1. checkout the package from the jasig CVS repository, module name portal_portlets/FeedbackPortlet |
...
2. 'ant dist' will create the war file in the dist folder. |
...
Deploy the war file to your portlet container, and you are set. |