Agriculture Communication


| Share

How Do I Add a Portlet to Display Events?

Portlets are the little boxes you see on Ag CMS pages. They can be used to display a variety of types of information. This lesson focuses on how to create a portlet that displays a text list of upcoming events automatically.

Before You Begin

To display events in this portlet, those events need to have been entered using the "Event" item type. See the lesson on How Do I Enter an Event? if you need help with that.

And you should already have a folder called "Events" created before you begin. This is usually a default folder that is part of every Ag CMS website.


Go To The Events Folder


Make sure that you have some upcoming events. If your events are in the past, they will not appear in the portlet.


Go To The Home Folder


Whatever the appearance of your home page (i.e., Folder, Page, etc.) you'll want to start here. That way your portlet can appear on every page in your website.


Manage Portlets


Click on the "Manage Portlets" link on the left hand side. (Even if you want your portlet to appear on the right.)


Add Events Portlet


On the right-hand side, click on the "Add Portlet" dropdown list and select "Events".


Select What You Want to Appear in The Portlet


Your choice on how many items to display. Five is the default, three to five are recommended.

The default for the Workflow state is Published and unless you've got a good reason to change it, just leave it selected. And of course click the Save button.


Portlet is Now Created


You should now see a portlet placeholder box in the right-hand column.


The Portlet is Now Live


The portlet box should now appear with the information you specified. This is where the more information you added to the event originally, the better it will appear in the box. Location and date should be displayed along with the name of the event.

Events will automatically drop off the displayed list as they move into the past.

Once advantage of the Events portlet over a Calendar portlet is that upcoming events will appear even if they're not in the current month. Events displayed can span several months at a time.

Filed under: Web Development, Tutorial
Add comment

You can add a comment by filling out the form below. Plain text formatting. Web and email addresses are transformed into clickable links. Comments are moderated.

Creative Commons License
Feel free to use and share this content, but please do so under the conditions of our Creative Commons license and our Rules for Use. Thanks.