View on GitHub

AbixApuri - käyttöliittymälaajennus Abittiin™

Avoimen lähdekoodin Abitti™-lisäosa

AbixApuri

AbixApuri (ent. AbittiApuri) on ilmainen ja avoin käyttöliittymälaajennus Ylioppilastutkintolautakunnan oma.abitti.fi-koepalveluun. AbixApuri toimii Firefox- ja Chrome-selaimissa erillisen ladattavalla lisäosalla.

Sitä voi myös käyttää erillisen laajennoksen (TamperMonkey Firefoxille/TamperMonkey Chromelle) avulla.

Asennusohjeet (lisäosana)

Firefoxille

  1. Tallenna Firefox-laajennus (.XPI-tiedosto) koneellesi ja
  2. raahaa se Firefoxin ikkunaan.
  3. Hyväksy asennus.

Chromelle

  1. Mene Chrome-selaimen kauppaan ja etsi AbixApuri
  2. Valitse Lisää Chromeen -nappi ja hyväksy asennus

AbixApuria voi edelleen käyttää TamperMonkeyn avulla, mutta tätä vaihtoehtoa ei suositella. Asennusohjeet tähän alempana.

Lisäosan päivittäminen

Lisäosan päivittämisen voi pakottaa selaimen lisäosavalikosta tai asentamalla lisäosa uudelleen.

Ominaisuudet

  1. Tehtävätekstien muokkaus laajennetulla editorilla (WYSIWYG)
    • Abitti-kokeen liitetiedostojen lisäys ja käyttö helposti omalla työkalulla suoraan koetehtävänantoon.
    • Näyttää liitetiedostojen kuvat ja videot jo suoraan editoinnin aikana sekä mahdollistaa kuvien koon muuttamisen
    • mahdollistaa tekstin muotoilun sekä muotoillun tekstin ja kuvien liittämisen suoraan tehtävänantokenttiin esim. Wordistä.
    • Chromessa kuvien liittäminen suoraan leikepöydältä ei toimi, mutta kuvia ja mediaa voi lisätä Lisää kuva -napilla
  2. Vanhojen tehtävien uudelleenkäyttö kopioimalla tehtävä vanhasta kokeesta. Tehtävän kopiointi huomioi myös liitteet.
  3. Tehtävien järjestely kokeen sisällä intuitiivisesti raahaamalla.
  4. Kopion ottaminen vanhasta kokeesta uudelleenkäytettäväksi. Kopiossa tulee myös liitteet mukana.
  5. Arviontitaulukon voi ladata mm. taulukkolaskentaohjelmaa. Lisäksi arvosanat voi tuoda taulukkolaskennasta takaisin Abittiin.
  6. Koelistauksesta voi hakea helposti suodattavalla haulla esim. kurssikoodilla (Vinkki kurssikoodi kannattaa olla kokeen nimessä, jolloin haku sen löytää)
  7. Arviontimerkintöjen helpottaminen: Ehdotetaan vanhoja merkintöjä automaattisesti merkittäväksi.
  8. Arvosanataulukko sisällytetty Abittiin, jolloin Apuri ehdottaa suoraan arvosanaa.

Asentaminen selaimen lisäosana

Firefoxille

  1. Tallenna Firefox-laajennus (.XPI-tiedosto) koneellesi ja
  2. raahaa se Firefoxin ikkunaan.
  3. Hyväksy asennus.

Chromelle

  1. Mene Chrome-selaimen kauppaan ja etsi AbixApuri
  2. Valitse Lisää Chromeen -nappi ja hyväksy asennus

Huomaa, että AbixApurin toimintaa haittaa, mikäli Bittiniilo on aktiivisena selaimessa. Suosittelemme sen poistamista käytöstä, ohjeet tähän alempana.

Muutokset

v0.6.2 (11.12.2018)

v0.6.1 (30.11.2018)

v0.6.0 (16.10.2018)

v0.5.4 (6.2.2018)

v0.5.3 (30.1.2018)

v0.5.2 (28.1.2018)

v0.5.1 (25.1.2018)

v0.5.0 (18.1.2018)

v0.4.3 (18.1.2018)

v0.4.2 (2.1.2018)

v0.4.1 (30.12.2017)

v0.4.0 (17.12.2017)

v0.3.2 (28.11.2017)

v0.3.1 (27.11.2017)

v0.3.0 (26.11.2017)

v0.2.9 (17.11.2017)

v0.2.6 (22.9.2017)

v0.2.5 (19.9.2017)

v0.2.4 (7.9.2017)

v0.2.3 (4.9.2017)

v0.2.2 (23.8.2017)

v0.2.1 (22.8.2017)

v0.1.2 (8.8.2017)

v0.1.0 (28.5.2017)

v0.0.3 (22.5.2017)

Selainlaajennokset

Miksi haluaisin käyttää erillisiä selainlaajennoksia?

Tietooni on tullut, että AbixAjurin käyttäjien juridisesta asemasta on heitetty epäilyksiä, viitaten siihen, että GreaseMonkey ja TamperMonkey eivät olisi luotettavia. Molemmat lisäosat ovat vakiintuneita ja hyvämaineisia, erityisesti viimeaikoina kun niiden skriptien asetuksia on pystynyt rajaamaan tarkemmin. Lisäksi AbixApuri ei tallenna mitään tietoja kyseisiin lisäosiin.

Erillisen laajennuksen käyttö poistaa kuitenkin nämä epäilyt. Erillinen lisäosa ei myöskään lataa verkosta mitään sisältöä tai skriptejä, vaan kaikki toiminnallisuus on toteuttu paikallisesti.

Miksi selainlaajennos ei ole Firefoxin kaupassa?

Laajennos käyttää CKEditoria, joka on Firefoxin selainkaupan kooditarkistuksen mielestä osin heikkolaatuista. En ole heti parantelemassa sen ongelmia.

Tuki ja ongelmatilanteet

Uusista huomatuista virheistä ja ongelmista kannattaa raportoida ensisijaisesti GitHubin projektin virheseurantaan.

AbixApuri on avointa ohjelmistoa, jossa ei ole varsinaista käyttötukea, mutta toki autan parhaani mukaan, jos tarve on suuri. Apuja voi kysellä minun sähköpostini (ks. sivun alalaita) lisäksi Tietokoneet YO-kirjoituksissa Facebook-ryhmästä.

Ohjeet AbixAburin tai Bittiniilon poisasentamiseksi

AbixApurin toiminnallisuutta haittaa Bittiniilon aktiivisena olo. Mikäli et ole ostanut maksullista Bittiniilon lisenssiä, ei se auta kokeenlaadinnassa, jolloin se kannattaa poistaa käytöstä.

Bittiniilon kytkeminen pois käytöstä

Tunnetut ongelmat

Lisenssi ja vastuuvapaus

Lisäosan kehittäjällä ei ole yhteyksissä Ylioppilastutkintolautakuntaan, eikä lisäosa ole YTL:n kehittämä. Tarkoituksellisesti lisäosa ei tee mitään pahantahtoista YTL:n tai kolmannen osapuolen palvelulle. Käyttö kuitenkin omalla vastuulla.

Lisäosa ei siirrä mitään informaatiota YTL:n oma.abitti.fi-palvelun ulkopuolella, mutta lähettää YTL:n Abitti-palveluun rajapintakutsuja kyseisen sivun “päälle liimattuna osana” sekä lataa skriptitiedostoja internetistä (toiminnallisuuksiin liittyvät laajennuksia). Sinänsä toiminnallisuuksien ei pitäisi rikkoa yhtään mitään YTL:n eikä käyttäjän tiedoista, mutta skripti tekee muutoksia avoinna olevan kokeen tietoihin, mikä onkin sen käyttötarkoitus. Muihin kokeisiin laajennus ei tee muutoksia. Skripti voi myös luoda uuden kokeen, kun sitä nimenomaisesti pyydetään ottamaan kopio. V0.5.0 alkaen skripti voi myös tallentaa YTL:n APIin kokeen arvosanatietoja kokeen pistemäärän perusteella käyttäjän nimenomaisesti niin pyytäessä (Arvosanalaskurin nappi “Toimeenpane” tai Arvosanojen tuonti toiminnon “Tallenna”). Muita muutoksia skripti ei tee tai tallenna mitään tietoja YTL:n Abitti-palvelun (ja selaimen välimuistin) ulkopuolelle toimistaan.

AbixApuri (ent. AbittiApuri) on julkaistu GPLv3-lisenssillä. Lyhyesti, laajennusskripti on ilmainen käyttää, sen lähdekoodi on julkinen ja sitä saa muokata. Muokkauksissa ja käytössä pitää lähde ja alkuperäinen lisenssi mainita sekä julkaista koodi myös GPL:n alaisuudessa. AbixApuri-skriptiä käytetään omalla vastuulla, eivätkä kehittäjät vastaa mistään skriptin aiheuttamasta vahingosta.

AbixApuri - Lisäosa oma.abitti.fi-palveluun
Copyright (C) 2018 Joni Lehtola

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see [http://www.gnu.org/licenses/]

Yhteystiedot

Lisätiedot ja palaute Joni Lehtola, etunimi.sukunimi@kauniaistenlukio.fi