SigTools - Sigarra Tools

Sigarra on Steroids: export calendar events (timetables, events, book renewal, payments, ...); infinite scroll; export, filter and sort data-tables; statistical analysis on grades; library book renewal; configurable behaviour and more. SigToCa's heir

Install via:

• Chrome WebStore
• Firefox Addons Thanks a bunch to @afonsobspinto
• Source code in this repo
• From .crx see how here

Features

Most features are customizable and can be turned off in the options page.

Exporting Calendar Events

SigTools exports to iCalendar .ics format which means most applications handle it pretty well, namely

Performance

It was developed to be as non-intrusive as possible, requires minimal permissions, only executes processes when it needs to, and all the scripts are loaded after the pages are ready so as to minimize any interface performance impact!

Contribute to SigTools

You can contribute by:

• Identifying and reporting issues
• Fixing bugs - fork + branch + pull request
• Adding more modules/extractors each module should address a different calendar need
• Sharing this Extension

class NewExtractor extends Extractor{
    constructor() {
        super();
        ...
        this.ready(); // this will trigger init and then attachIfPossible
    }
    //must implement: structure, attachIfPossible
    structure() { return {...} }
    attachIfPossible() {...}
    ...
}
// All the functions that are used by this script but do not
// belong to the class definition should follow the above line
...

{
    extractor: "the name of the extractor", // must be unique among extractors
    description: "a simple description of what it does",
    parameters: [{//a list of the parameters that can be used ny users
            name: "name of the parameter",
            description: "either describe or exemplify"
        }
        //... other parameters
    ],
    storage: { // the variables to save for this extractor (in the local storage)
        text: [ //variables that should be displayed and edited in <input type="text">
            {
                name: "the name of the variable, eg: title",
                default: "The default value, eg: [${acronym}] - ${room.name}"
            }
        ],
        textarea: [ //variables that should be displayed and edited in <textarea></textarea>
            {
                name: "description",
                default: "another description - can have <strong>HTML</strong> inside"
            }
        ],
        boolean: [ //variables that should be displayed and edited in <input type="checkbox">
            {
                name: "isHTML",
                default: true
            }
        ]
    }
}

describe('what the test is about', function() {
    it('should return some results', function(done) {
        updatejQueryContext("new_context.html").then(() => {
            // your tests
            done()
        }).catch(done)
    })
})

describe('what the test is about', function() {
    before(() => {
        return new Promise((resolve)=>{
            updatejQueryContext("new_context.html").then(resolve)
        })
    })
    it('should return some results', function(done) {
        // your tests
    })
})
describe(...

Credits

A thanks to... ics.js | FileSaver.js | Blob.js | mustache | chart.js | math.js for saving us a lot of time!

Credits to Paomedia for the flat calendar icon!

Credits to Icons8 for services icons such as Office 365, Outlook, Google and Yahoo.

Changelog

• V1.0
  • MVP, timetable + exams + mooodle
• V1.1
  • Multiple exam tables on the same page support
• V1.2
  • Fixed exam pages with wrong exam dates. Thanks to @G-Pereira
• V1.3
  • Fixed problem in the encoding of html (both on the download and direct links). Thanks to @G-Pereira
• V1.4
  • Fixed Timetable bug in the first occurrence of a subject that does not start at 8h30. Thanks to @sergioalmeida13
  • Fixed GMT problems in chrome import - by using ZULU time
  • Noticed that moodle extractor only has information on the day (and not time) of the event
• V1.5
  • Adapted to sigarra's (fuzzy) way of using classes in tables for the exam extractor
  • Only display exam tables if they have at least one event
  • Make one-click link (for the timetable extractor) obey recurrence of events specified in the page (previously the event was non-recurring even if it actually was). Thanks to @sergioalmeida13
  • Icons have been properly defined in the manifest
• V1.6
  • Fixed date parsing in text string like "Semanas de X a Y", most likely to appear in POST requests to https://sigarra.up.pt/feup/pt/hor_geral.estudantes_view (when there is no side-table with the time intervals)
• V1.7
  • Detection for overlapping classes in the timetable extractor. Thanks to @Dannyps
• V1.8
  • Minor updates on the overlapping classes
  • One-click Outlook.com integration for all extractors 🎉 (only for non-beta Outlook). All props go to @fabiodrg666
  • .1 - bug fix in overlapping classes
• V2.0
  • SigToCa -> SigTools
  • Complete refactor
  • Each extractor describes itself
  • Options page is dynamic and varies according to extractors
  • Simplified manifest
  • Better organization of scripts into folders
  • Started using mustache templates
  • Options page
  • Changelog page when installed or updated
• V3.0
  • Improved Readme and contribution instructions
  • Started Unit Testing
  • Fixed UI bugs
  • Fixed non-minified JS files for mozilla chrome extension
  • Moodle 2019 is alive
  • Erasmus Datatables are working
  • Every extractor has "exclude pages" for custom pages where you don't want it
  • Every extractor has "apply" setting by default (boolean defaults to true)
  • Improved Contribution guidelines (extractors, tests, ...)
  • Mozilla problem with minified files
• V3.1
  • Minimalist changelog page
  • Fixed exclude_urls_csv bug that disabled all extractors
  • Updates to satisfy Firefox's restrictions
• V3.1.1
  • Closed issues #52, #45
• V3.1.2
  • Fixed Broken Grades #62
  • Fixed Bad Exam Acronym parsing #59
  • Handled Firefox Add-ons problems with 3rd party libraries...
• V3.1.3
  • Fixed UI problem in "Conta corrente" page
• V4.0.0
  • Revamp the way the extension is designed, introducing faster development and deployments with gulp.js
  • Fix issues that led the extension to be blocked on Firefox
• V4.1.0
  • Documentation
  • Handle weird Microsoft encoding problem #83
  • Update the link for Outlook.com events #84
  • Fix URI encoding bug #85
• V4.2.0
  • Improve the development environment
    • Disable the changelog so that the page is not shown everytime the extension is reloaded #87
    • Fix some bugs in gulp.js configuration #76, #87
    • Fix browsers blocking HTTP requests due to CORS in unit tests #93
    • Adding a logging mechanism that only works in development mode #102
    • Better mocking for extensions Storage API in unit tests
    • Add document mocking in unit tests #90
  • Fixes Outlook 'one-click' URLs (again) #111
  • Fixes custom recurring periods not affecting the event's start date #110
  • Enhance the DataTable extractor
    • Fix missing sorting arrows #79
    • Fix duplicated table headers #78
    • Support more tables by fixing their layout conservatively #93
  • New email extractor #99
    • It adds 'one-click' mailto links near all profiles find within current page
    • Supports 'batch email', where you can select multiple recipients
  • New extractor for exam supervisions #104
  • New extractor for pending bills with ATM details #118
  • Improve calendar events generation
    • Recurrence rules now also apply to 'one-click' events
    • Support custom locations (WIP) #51, #48
    • Support calendar status, i.e., show as Free vs Busy, in .ics #113
      • Deadline related extractors create events that show as Free by default (customisable!)
    • Support 'All Day' events on .ics and 'one-click'
      • Also useful for deadline/reminder events with no specific time
  • Revamp options page
    • Human readable extractors names
    • Add icons
    • Fix UI glitches