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:
Five tips to engaging your online class
Tuesday, April 13 2021
When schools closed across the country last spring and classes abruptly transitioned to virtual learning, the TRU Open Learning team was well positioned to show teachers the ropes with the Graduate Certificate in Online Teaching and Learning.
Read moreBusiness leader shares tips for student entrepreneurs
Wednesday, March 31 2021
Student Ambassador Gaurav Mishra shares key learnings from a business leader and TRU alumni.
Read moreTRU’s 2020 Chair Leadership Award
Monday, March 22 2021
Dr. Andrew Fergus is the recipient of TRU’s 2020 Chair Leadership Award in recognition of his work as department chair of TRU’s School of Business and Economics Human Enterprise and Innovation department, and his role in TRU’s transformation from a college to a university.
Read moreStudents support students with donation to Limitless
Wednesday, March 17 2021
Significant donations from TRUSU and the Society of Law Students will fund student bursaries and initiative.
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 and Community Trash Bash
Date: April 15 - All Day
Location: On and off campus
Join the annual TRU and Community Trash Bash. From April 15—18, help make TRU and Kamloops even more beautiful by picking up trash.
Lunch and Learn—Bio-psycho-social-spiritual approaches to wellness
Date: May 3, 12:00pm - 1:00pm
Location: No location specified
Add some tools to your Mental Health toolkit with the Lunch and Learn presentation Bio-Psycho-Social-Spiritual Approach to Wellness.
Star Wars Trivia Night
Date: May 4, 6:00pm - 8:00pm
Location: No location specified
Dress up in your Star Wars best and challenge your movie prequel, original and sequel knowledge at TRU's Star Wars trivia night.
Go outside and stretch
Date: May 6, 12:00pm - 12:30pm
Location: No location specified
Go Outside and Stretch! Join Campus Wellness Advisor Joy Demsey for a 30-minute guided stretch, prioritize your physical and mental health.
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: