Feeds - RSS, Events, Date
RSS Feeds
In order to insert an RSS feed on a page, you must include the script. The following variables can be used to customize it to your liking.
Important
- The first variable must be prefaced with a '?'. The remaining variables all use an '&' as a preface.
- The last variable must be '&url'. If other variables follow it, the script may not work correctly or at all.
- The URL must be 'https://'. This will prevent a mixed content blocking/warning error that might prevent the images from showing up as expected.
- The order of the variables before the &url is irrelevant.
- You may omit variables you do not want to use; this will set them to 0 by default.
- Except where otherwise indicated, accepted options are 0 or 1.
- num - This specifies the number of items to load. Typically, this will be between 3-10. Accepted options are 1-10.
- size - This specifies the size of an image to display, to be displayed with the specified column width out of 12. For example, if the number specified is 3, the image will be 1/4 (3/12) of the available space. To display a full-width image in a sidebar, specify a size of 12. For any number less than 12, the description will be aligned to the right of the image. If a 0 is specified, the image will be hidden. Feed items that do not have a featured image attached will be formatted correctly regardless of this setting. Accepted options are 0-12.
- title - This will show or hide the title.
- date - This will show or hide the date.
- desc - This will show or hide the description.
- button - This will make the 'Read more' link a button or text.
- inbody - This will enlarge the headings for better legibility in the body of a page.
- forhome - This will change the entire layout for use on the homepage. This should ONLY be used on the homepage; most other variables will be ignored when this variable is enabled.
- titlelink - This will link the title, making it teal.
- nopad - This will reduce the padding around each feed item.
- linkhide - This will show or hide the link. This will override the button setting. If this is set to 1, the title will be linked automatically.
- althead - This will underline the headings.
- url - This specifies the feed URL. It must be an RSS XML feed.
<!--#include virtual="/utilities/feed/rssparsefeed.php?num=4&size=4&title=1&date=0&desc=1&button=1&inbody=1&forhome=0&titlelink=0&nopad=0&linkhide=0&althead=1&url=https://inside.tru.ca/category/featured/feed" -->
The above code will display the below feed:
TRU Foundation Gala: A Community Affair goes virtual
Monday, January 25 2021
TRU has partnered with six local eateries to deliver an at-home gala and virtual evening of food, entertainment and camaraderie in support of education for all on Feb. 6.
Read moreShow us your research photos
Monday, January 18 2021
Submit your research photos to the Worth 1000 Words contest, and possibly win the $500 top prize.
Read moreFellowships support students studying snakes, bacteria
Tuesday, January 12 2021
Graduate students Breanne McAmmond and Chloe Howarth received prestigious $7,500 Environmental Science and Natural Resource Science Fellowship Awards.
Read moreMeet TRU Law’s new dean
Tuesday, January 5 2021
Get to know TRU Law's new dean: Daleen Millard, LLD, shares her vision for the faculty.
Read more<!--#include virtual="/utilities/feed/rssparsefeed.php?num=3&size=12&title=0&date=0&desc=0&nopad=1&linkhide=1&url=https://inside.tru.ca/category/featured/feed" -->
The above code will display the below feed:
Event Feeds
Event feeds work almost identically to RSS feeds. However, the only options are: num and inbody. The 'inbody' element will enlarge the font size of the feed.
To create the URL for an events feed, go to events.tru.ca and view the category or tag of the feed you want to display, then add 'eo-events?event_start_after=now' to the end of the URL. The include statement should look like the following:
<!--#include virtual="/utilities/ics-parser/parseEvents.php?num=4&inbody=1&url=https://inside.tru.ca/events/category/faculty-and-staff/eo-events?event_start_after=now" -->
The above code will display the below feed:
Lunch and Learn—Will and Estate Planning Information Session for TRU Employees
Date: February 24, 12:00pm - 1:00pm
Location: No location specified
Join your colleagues for a virtual Lunch and Learn focusing on Will and Estate Planning.
Dates & Deadlines Feeds
To display a feed of upcoming Dates & Deadlines, it is configured much like the other feeds.
The defaults are:
- Number of items: 5 (num=5)
- Link the title with the URL (url=1)
- Use smaller text (h4 for titles, p for dates)
- Show all dates (audience=all)
- Display as a list (blockgrid=0)
- If blockgrid is enabled, display a grid of dates 3 wide on medium screens (grid=3)
The possibilities for the size variable are: 12,14,16,20,24,28,32. This will change the date size; the title will be 4px larger. For instance, if &size=20, the dates will be 20px and the titles will be 24px. Enlarging the fonts will allow the text to be visible on CCTV screens.
The options to display in a block grid are: &blockgrid=1 to enable, &grid=2 (typically 2-4 is appropriate, default is 3).
The options to for the audience variable are: &audience=staff or &audience=student. The default (left blank) will display all dates.
<!--#include virtual="/utilities/dates/dates-list.php?num=8&url=0&size=14&blockgrid=1&grid=4" -->
The above code will display the below feed: