Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: enhanced/corrected description of javascript.jQuery.include
  1. Download the most current version using Subversion:
    Code Block
    svn export https://www.ja-sig.org/svn/portlets/AnnouncementsPortlet/trunk announcements-portlet
    
  2. Make sure you have Maven2 installed and that you can run the following command from your command line:
    Code Block
    mvn -version
    
  3. If you're using uPortal 3.0, or if you know that your portal provides jQuery in the global namespace, skip this step; otherwise, you need to set Make sure the javascript.jQuery.include property in src/main/resources/configuration.properties is set to the correct value: true for uPortal 3.1 or later or any portal that does not provide jQuery in the global JavaScript namespace; false for uPortal 3.0.x or any portal that provides jQuery in the global JavaScript namespace. The default is true. This enables the setting allows Ajax features of the Topic Management screenin the portlet to function properly.
  4. If you are only testing the portlet, skip this step; otherwise, edit the datasource.properties file to reflect your database settings and add your JDBC driver to the pom.xml.
  5. In the announcements-portlet directory, run
    Code Block
    mvn package
    
  6. Once the project is built, you'll have a file called Announcements.war in the target directory.
  7. Deploy the portlet by running
    Code Block
    ant deployPortletApp -DportletApp=/path/to/Announcements.war
    
    ...in the uPortal source directory on your target server.
  8. Add the two portlets to your portal:
    • uPortal 2.5.x and 2.6.x format:
      • Announcements.AnnouncementsDisplay
      • Announcements.AnnouncementsAdmin
    • uPortal 3 format:
      • Portlet Web Application Path: /Announcements
        Portlet Name: AnnouncementsDisplay
      • Portlet Web Application Path: /Announcements
        Portlet Name: AnnouncementsAdmin
  9. Restart Tomcat if you get any fussiness from the portlet.  If you have issues, ask us on the portlet-dev mailing list.