OREGON STATE UNIVERSITY

Create an OSU Event Feed

To create an OSU Event feed, just do the following:

First you will need an available OSU Event Calendar - this calendar can be your organization's, or you can pull in another organization's calendar as well, as long as it's a publicly accessible calendar. 

sample osu event calendar

The mini-calendar is a great tool that lets you see upcoming events.  In the mini-calendar, if a date has an underline, this means there is at least one event occuring on that day.  Sometimes, the calendar that you want to use may not have any events on it.  The default feed only extends out one week from "today".  If the calendar of your choice shows no events in the mini-calendar, click on the navigation arrow in the upper right corner of the mini-calendar to scroll ahead by a month.

no events show in min-calendar so use navigation arrows to scroll ahead

day with event in following month is underlined in mini-calendar

In our example, the next event is over a month out.  If the default feed were to be used for this calendar, the calendar block would not display any events.  There is an easy way to address this, though, which we'll cover as soon as we get the basic information entered.

The first piece of basic information we need is the short name of the calendar.

All OSU calendars have the same prefix: calendar.oregonstate.edu.  Directly after that pattern is the short name of the calendar.  Copy just the short name by highlighting it and pressing Ctrl + C (PC) or Command + C (Mac).

calendar short name highlighted in browser address bar

In your Drupal site, go to Admin menu > Content management > Create content > Feed.  This will open up the Feed content submission form.

From The type of feed field, select OSU Events.  This will automatically populate the other fields with some default settings that you can change to customize the feed.

feed content submission form with osu events option selected

Change the Block Title, if desired.

In the URL of your feed field, directly after the calendar.oregonstate.edu piece of the address, enter a forward slash followed by today+some number (put an actual numerical value there..in the example we use 120).  This tells the query to look out 120 days from today.  Type another forward slash and then paste in the short name of your calendar.  An example is provided below.

In the Number of items to display field, adjust how many feed items you want to show.

Click the Save button.

calendar short name and query settings added to feed url

Your completed content won't look like much.  This is normal.

completed event feed node displays with no fields

Once the content has saved, you will need to go into the Blocks manager at Admin menu > Site building > Blocks.  The Feeds Display module has created and pre-configured a new block for you...now all you need to do is put it in a region.  If you're using OSU Standard, as shown in the example, you can put it in the Events or News region, which is set up to display two or more blocks in a split column display.  If you're using OSU Confident, you may, instead, choose to put your block in a sidebar.

new block moved to events feed region in block manager

Once your block has been placed in a region, don't forget to click the Save blocks button at the bottom of the page.  (For more detailed information about working with blocks, please visit the Blocks section in this manual.)

A quick visit to your front page will now show your new Event Feed block, which also displays some nice, fresh styling for the month, day, and year.

completed event feed block on front page