Using the Upcoming Events Grid Template

We have created a template in WordPress that will automatically insert onto a page a table (grid) listing all events in a particular category. To see an example of this template in action, view the “Second Friday Coffeehouse Schedule”, which can be found under the “Upcoming Events” link on the left hand menu. Note that in the events grid, the event name is a hyperlink which will take you to the full POST that describes the event.

These instructions explain the steps needed to take advantage of this template.

STEP 1 – Create Event Posts

Events to be listed are assumed to each have a post that fully describes the event. To create the requisite event posts:

  • Add a new post (or modify an existing one according to these specifications)
  • Enter the text that fully describes the event as you would normally do
  • Enter “Excerpt” text (especially if you want the post listed in the “News” section of the home page)
  • First time, go to “Screen Options” at the top of this wordpress post edit page, click and select “Custom Fields” so that a check mark is inserted.  This will allow you to view and edit custom fields.
  • Using the “Category” check boxes on the right side off the Edit Post screen, select the desired category (also select “News” if the event is imminent and should be listed on the home page),  Your post can appear simultaneously in as many of these which apply:  What’s New, Volunteer, Opportunities for Action, the events calendar for your function or committee, and the combined events calendar itself.  Only the calendars will “retire” your post after the event.  You have to come back into Edit mode to “de-select” all other fields after your event occurs.  Each event creator is responsible for retiring their own obsolete posts.
  • Scroll down to the “Custom Fields” area of the Edit Post page (below the “Excerpt”window) and add the following fields to the post (these are what the template will use to fill in the grid). Each field is added by Selecting a “Name” from the drop-down list, entering a value, and clicking on the “Add Custom Field’ button. (YOU DO NOT NEED TO CLICK ON “Enter new” – this is to create a new custom field.)  The “Add Custom Fields” also serves as an “Enter” key for your data though it does not say so.
    • Select “Display Day MM/DD/YYYY” and add the date of the event as you wish it to be displayed on the grid
    • Select “Sort Date YYYYMMDD” and enter the date of event again, but this time in Year Month Day order with no intervening slashes or dashes. For example, July 4, 2010, would be entered as 20100704. This field allows the template to sort the events in chronological sequence
    • Select “Time” and enter the time of the event
    • Select “Location” and enter the location of the event
    • If applicable, select “Admission” and enter the admission charge for your event
    • If applicable, select “Comments” and enter any additional info you want displated in the last column of the grid.
    • You DO NOT need to select a category for the post within the custom fields – only using the category check boxes. The “Category” custom field is used on the PAGE as described in Step 2, not the POST
  • Repeat this process for all of the events that you wish to be displayed

STEP 2 – Create an Events Grid Page

  • Add a new page (or modify an existing one to these specifications)
  • Enter your desired page text as normal – this text will appear at the top of the page.
  • Using the “Template” drop-down list (found on the right side of the Edit Page screen under the “Attributes” section) select the template called “Upcoming Events Grid”
  • In the “Custom Fields” section of the Edit Page screen (just below the text entry box)
    • Using the “Name” drop-down list select the custom field named “Category”
    • In the “Value” box enter the category for which you wish the page to list events. Be sure to spell the category name exactly
  • Publish the page and view it using the “View” button at the top of the “Edit Page” screen. Check that everything is in order.  Adjust your custom fields as necessary to create a clean-looking table.
  • Once you are satisfied, do whatever else you need to make the page accessible from the website.
Posted in Author Info