Contents

Event List

This documentation will show you how to use the Events List plugin.  An Event List on your website can be used to maximize member experience through interest based matching of users to events they will find interesting. 

Events lists can be placed on the home page, and can be set to match a logged-in user's location and interests. Event Lists can be used for displaying chapter events on chapter pages on the website. Event Lists can

also be used to generate RSS feeds so users can track events with RSS readers. These are only a few applications for the Events list's capabilities.

Follow Along with these Video Tutorials

Overview

Use Cases

Creating an Event List

An Events List is a WYSIWYG Plugin, and can be accessed using the "PluginInsert" button (near the cursor below):



From there, you'll be taken to the Plugin option page, where you'll select "Insert SocietyNet Events List".  Once you select that, you'll be taken to a window to set the parameters for your Event List.

 

The Plugin Editor allows you to set parameters for your Event List, determining how it will appear on the page, what events will appear in the list, and how specific or general the list will be.

Popular Events

Popular Events lists events based on number of page views; this is a way to showcase events that are already popular.  This setting can filter the Event List by audience, showing events commonly viewed by the public, by non-members, by members, by CMS users or by all site viewers.  If "Enable Popular Events Listing" is selected, the display settings will be a secondary sort for the list; events will be listed by popularity, then if two events have the same popularity, they will be sorted by the display settings

Event Filters

The Event Filters section can filter by course type, making a list of only conferences, only seminars, or all events.  Checking the "List Types Equally" box will divide the total number of events by the number of course types, meaning that each selected course type has an equal number of events listed.  "New Events Only" can be selected to display only the events marked as “New”.  Course Code displays only events matching a course code, for example "XYZ".  "Designed For" is a filter for the “Designed for” field in AM4. "Keyword" matches events with the specific keywords, using a free-text search.

The remainder of the Events Filter section is different fields available for the creation of highly specific Events lists. These fields can be used to create Event Lists for a specific division, to create Event Lists by a user's interests, to create an Event List that caters to users at a particular skill level, such as beginning, intermediate or advanced, etc.  A user can hold down the CTRL button to select multiple filters for each section.  The Division, Company, Curriculum, Instructor, Vendor, Level and Field of Interest filters all have options imported from the Association's CRM database, so the content of these fields is specialized to your Association.

Location Filters

The Location Filters section contains multiple filters, including by Location, which includes options such as Webinar, Webcast and Audio as well as physical locations. Filters also include by Chapter, which could be used to create an Events List for a chapter's page in an Association's website, by City and Zip Code.  These filters can be set for specific Chapters, Cities or Zip Codes, but can also be set for the User's Chapter, City or Zip. If the user is logged in, the Events List can be set to cater to their specific chapter or physical location. The Zip Code feature can also be expanded to a “miles radius” from the zip code, to encompass surrounding events if desired.

Display

The Display section determines how the list will be shown on the page.

The “Order” sets what order the events in the list are displayed. It can be by date, by course title, by course level, by location, by the member fee or by how much the course will cost for members, or by the organization the course falls under. 

The Period feature lists events in the order of:

  • Future Events are starting tomorrow or later
  • Current Events are starting today or later
  • Past Events are ended yesterday or before

The Course Code can be shown or hidden in the display, and a message to users can be displayed if no events are found matching the criteria; this would be a good location to put something like “No events found, check back later for future events”


The Display settings now support custom "title" HTML that appears when there are contents displayed for the list - this can be used to add a title to a list, while not displaying a title when the list is empty, in order to effectively hide the list when there is no content to display.

Initial Layout

The Initial Layout section is where you determine the look of your list.  You can set the number of items in your list, the length of your event titles and the length of any summary that shows up after the event title. This is also where the list style can be determined; do you want to show a summary of each event after the event title? Would you prefer a headline list, where only the title is shown? A mixed list will show the summary of some events, then headlines for the remainder. A box list will show up as a box with an even number of items that are separated by a border. Checking “show numbers” will number the events. Mixed Rows is for the Mixed list; it determines how many rows will show up as summary rows in a mixed list, before the rows start showing up as headline lists.

Archive Layout

The Archive Layout section functions similarly to the Initial Layout section.  This section sets  how the list will appear as a user pages through to look at more events. The Outer Div ID for CSS and the Inner Div ID for CSS are CSS identifiers for styling on the website; these can be left blank unless a specific style is desired for the list.

Navigation Settings

The Navigation section sets how a user will navigate through the events list from the initial page to the archives.  If “Show navigation” is selected, the user will be able to page through the events list to see more events; the text for the link the user will click for “more”, “next page”, “previous page” and “return to list” can be set in this setting.

RSS Settings

The Events List plugin can also tie into the RSS portion of your Association's site, or you make the Events List its own RSS feed for your users to tap in to on their own. Clicking the Enable RSS Feed box will make the list its own RSS feed. You can name and describe your RSS feed, and determine where the RSS icon will be displayed, above or below your list. The RSS category drop-down allows you to tie your Events List into a pre-existing RSS category. An Administrator will have to enable the Events List in the RSS channel using the CMS, and once that is enabled it will show up in the specified RSS channel.

Preview and Save

Once your list is created, you can hit "Preview" and see how the list will appear in your site:

From there you can hit "Save" and your list will become part of the page.  It will appear as a placeholder bar that will be invisible in the published page; the list will appear as it did in the Plugin preview once the page is saved and published.

To edit the Event List, you can click on the Event List header then click on the PluginInsert button you used to place the Event List.  You will then be able to change settings and adjust your list to your needs.

LAST UPDATED 9/14/2011

Comments