Skip to content
gumho edited this page Mar 27, 2012 · 23 revisions

Welcome to the AntPlanner Help Page!

Back to AntPlanner

What is AntPlanner?

A visual way for you to experiment with course schedules. AntPlanner is created and maintained by a UCI alum.

Features include:

  • Rich calendar interface for eased course addition & removal
  • Overlappable calendar time slots
  • Saving and loading of course schedules
  • Always up-to-date course listings

How do I use it?

Quick Start

  1. Search for a course by selecting the course criteria then clicking 'Display Results'
  2. To add a course, hover over the course name and click
  3. To remove a course, click on the course event in the calendar view
  4. To clear the calendar, click the 'Clear Calendar' link above the calendar

Saving / Loading

You can now save your schedule so you can edit or view later on. Steps:

  1. When you have finished selecting courses, click the 'Save/Load' link above the calendar
  2. Enter a unique username for retrieving your schedule. Make sure the username is something that nobody would guess so that someone can't just guess your username and edit your schedule (This will be changed in the future). For privacy reasons, please refrain from using your UCI Net ID or any personally-identifiable names.

Note: Due to resource constraints, saved schedules are held up to 3 months and then deleted. You may continue to create and save a new course at that time.

Something is wrong with 'X'

Create an 'Issue' on the AntPlanner project issues page. You may or may not need a GitHub account for this. I'll try to address the problem as soon as I can.

Can you add 'X' feature?

Create an 'Issue'. See above section, "Something is Wrong with 'X'". Tag the issue as "feature request".

How can I contribute?

AntPlanner is currently a one-man project. There are a bunch of things to do and features to add but I'm extremely busy these days. Since we're on the GitHub project page already ;), I'd like to encourage users to report issues or to even check out the codebase. Feel free to submit patches or even implement a new feature! There are a ton of issues on the Issues page and the code is open for everyone to inspect on the Source page. There is a Readme on the Source page that describes how to get AntPlanner running on your own computer!˝

What is AntPlanner written in?

The AntPlanner backend is written in Python using Aaron Swartz' web.py framework and parts of the Google App Engine Python Library. And jQuery is driving the front-end bus.

Known Issues

  • Courses with times on different days of the week will not transfer completely to the calendar. For example:

    W 09:00 - 09:50
    F 10:00 - 10:50

  • In Internet Explorer 7, courses with multiple professors listed show "No professors found".

Disclaimer

The author of AntPlanner is not responsible for anything bad that happens as a result of using the AntPlanner application. Course listings are automatically scraped from the WebSoc website and it may be possible for course names/times to be wrong due to a sudden change in WebSoc, a bug in the code, or any other mishap. Though this is unlikely, always check your schedule when you've finished checking your courses!