glavin001 / banner-calendar-server

Service that serves iCal files for registered users, of their Student Calendars.

Banner Calendar Server

A free, open-source, service that automatically creates a Course Calendar from your SMU Self-Service Banner, that you can quickly and easily setup on your personal devices.

Using Banner Calendar

Go to http://society.cs.smu.ca:1234/ and sign up with your SMU Self-Service Banner credentials. See security below if you have any concerns.

Updating Your Calendar

We do not store your login data, and so we cannot automatically login again to update your data later on. Whenever you change your course schedule, simply login to Banner Calendar once again and your schedule will be updated. Be sure to refresh on your Calendar clients (iCal, etc) so they pull the updated Calendar data from our server.

Deleting a Calendar

This feature is not yet available. Please see Issue #8.

How It Works

Powered by Self Service Banner API for Node.js.

1. The user is presented with a simple login form, asking for their username (A-number) and password (PIN). The user enters their Self Service Banner credentials.
2. The server signs in as the user.
3. The server reads the user's courses and retrieves their scheduled class times.
4. The server uses Expressjs to serve an iCalendar file generated by node-icalendar.
5. A URL is displayed to the user that they can subscribe to in their Calendar client.

That's it! Now the user has an automated calendar.

---

Security

Only the fetched calendar data and a hash of the user's A-number / Username is stored in the MongoDB on the server. THe URL displayed is using the secretly salted hash, such that another user cannot simply type in an A-number of a friend or other user and see their course calendar.

banner-calendar-server's Issues

Store Courses in another table

Store Courses in another table, and reference to the courses with a CRN number for the User's schedules.

Show usage stats

Show usage stats:

• Number of Calendars generated by students.

Share via Social Networks

Share:

• Facebook
• Twitter
• Google+
• Email

Email Users when calendar created/updated

Email Users when calendar created/updated with iCalendar URL and links to instructions.

Add *Fork Me on GitHub* banner

See https://github.com/blog/273-github-ribbons

Full Calendar View

http://arshaw.com/fullcalendar/

Error checking

Error checking:

• Incorrect username and/or password

Certain class goes for a full day

My monday class at 11:30am - 12:45pm displays as:

11:30 am Jan 27 to 12:45 am Jan 28

REC A: Data Struc & Algorithms - CSCI 2342 - 2RA

Fix issue that causes every event to be included on Mondays.

Fix issue that causes every event to be included on Mondays.

Delete User's Schedule

Option to delete User's Schedule.

HTTP request:
DELETE /api/calendar/:calendarId

Express:
app.del('/api/calendar/:calendarId, ...

Port Not Found

1234 Not Found on Society Server

Provide tutorial / links for how to subscribe to calendar URL

Google: https://support.google.com/calendar/answer/37100?hl=en

Setup server

Setup server:

• Express
• Public HTML code
• REST API
• MongoDB

Course Search with CRN

Course Search with CRN.

Lookup available courses with their CRN number.

API GET request:
/api/course/:crn

Add Configuration file

Add Configuration file.

Academic Calendar

Get the Search By Term page

Request URL:

GET https://ssb-nlive.smu.ca/pls/sNLIVE/bwckschd.p_disp_dyn_sched

Referrer URL:

https://ssb-nlive.smu.ca/pls/sNLIVE/twbkwbis.P_GenMenu?name=homepage

---

Get to next page: Class Schedule Search

Request URL:

GET /pls/sNLIVE/bwckgens.p_proc_term_date

With Form data:

p_calling_proc : bwckschd.p_disp_dyn_sched
p_term : <# example: 201420 #>

Referrer URL:

https://ssb-nlive.smu.ca/pls/sNLIVE/twbkwbis.P_GenMenu?name=homepage

You are now https://ssb-nlive.smu.ca/pls/sNLIVE/bwckgens.p_proc_term_date

Get to next page: Coming soon.

Create Hash to hide A-number of users

Create Hash to hide A-number of users.

Multi-Step Walkthrough

Multi-Step Walkthrough of how to use Banner Calendar.