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:
Expanding our definition of bereavement
Friday, September 9 2022
Sept. 10 is World Suicide Prevention Day. Dr. Rebecca Sanford's research looks at expanding our view of who can and should access support.
Read more
Blazing a trail for a future with fossils
Thursday, September 8 2022
Fourth-year Bachelor of Tourism Management student Jada Glen led a pilot tour to McAbee Fossil Beds Heritage Site in late August.
Read more
National think tank selects TRU alum
Friday, September 2 2022
Trevor Tessier (RT ’15, MBA ’18) has joined a leadership program that brings outstanding young Canadians together to tackle national issues.
Read more
Law graduate wins essay contest
Friday, September 2 2022
TRU Law 2022 graduate Brett Book is the winner of the 2022 Canadian Bar Association health law section’s Law Student Essay Contest.
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:
TRU Orange Shirt Day Event
Date: September 29, 11:00am - 1:00pm
Location: Campus Commons
The Office of Indigenous Education invites all students, staff, faculty to join us on Thursday, September 29 in front of the CAC
Faculty of Law Research Series – “What it’s like to write a treatise, and why it matters” with Prof. Chambers, Diab, and Hunt
Date: October 25, 1:00pm - 2:30pm
Location: Old Main
Professors Chambers, Diab, and Hunt discuss their recent work on book-length treatments of subjects important to them and why it matters.
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: