Top Confirmers Widget

Purpose

This provides the answers to the query for “Count how many bugs each person has confirmed, listing the top 20 people in descending order” from http://www.bugzilla.org/docs/queries.html.

This demonstrates the following:

1. How to leverage the internal ConnectionPool to execute a Statement
2. How to include a css file to style the portlet
3. How to use log4j to write out any error message (assumes you’ve set the log4j.properties to “debug”)

Note that this uses the same package name as the application (com.wmpnj.bugz) in order to leverage the ConnectionPool.

Screenshots

Those users who confirm bugs and the number they have confirmed are listed. This is a great way to give recognition.

When no one has been found to have confirmed bugs, a polite message is displayed.

Installation

Note: This version will only work with Bugs Dashboard v3.0 and up due to the use of the parameter to restrict this portlet to a specific product if desired.

To use the TopConfirmers Portlet, do the following:

• Copy the TopConfirmers.class file at com/wmpnj/bugz/portlets into the deployed web application directory; i.e. /webapps/bugs/WEB-INF/classes/com/wmpnj/bugz/portlets. This may require that you also copy the directory “portlets” if this is the first portlet you’re deploying.
• Copy the TopConfirmers.css file to the deployed web application css directory; i.e. /webapps/bugs/css.
• Update the dwr.xml file in the deployed web application WEB-INF directory; i.e. /webapps/bugs/WEB-INF. Edit the file with a text editor and add the following after the last </create> statement:
  

  <create creator="new" javascript="TopConfirmer">
    <param name="class" value="com.wmpnj.bugz.portlets.TopConfirmers" />
  </create>
  

• Update the portlets.properties file in the deployed web application classes directory; i.e. /webapps/bugs/WEB-INF/classes:
  • Update the first line by incrementing the count of portlets by 1
  • Add the following in the position that you want the portlet to appear within your desired column. For example, if you want the Top Confirmers to appear at the top of the right-most column, you must insert this ahead of any other portlet whose column is “2″. After adding the following block, you MUST then renumber the portlets appropriately, beginning with 0, i.e. “portlet0″, “portlet1″.
    

    portlet0.title=Top Confirmers
    portlet0.column=2
    portlet0.package=com.wmpnj.bugz.portlets.TopConfirmers
    portlet0.className=TopConfirmer
    portlet0.method=getText portlet0.stylesheet=TopConfirmers.css
    portlet0.javascript=
    portlet0.desc=
    portlet0.call=
    portlet0.restrictTo=
    

You may change the title and column, but do NOT change the package, className, or method!

Download

TopConfirmers.zip