MLInvoicen asennus

Ladattavat tiedostot

Viimeisin julkaistu MLInvoice-versio: MLInvoice 1.19.0 (7.9.2018)

Huom! Versiosta 1.14 lähtien tietokannan käyttäjällä pitää olla myös LOCK TABLES -käyttöoikeus.

MLInvoice 1.11.1 on viimeinen PHP 5.3:a tukeva versio ja vielä ladattavissa: MLInvoice 1.11.1 (14.3.2015)

MLInvoice 1.16.1 on viimeinen PHP 5.4:a tukeva versio ja vielä ladattavissa: MLInvoice 1.16.1 (22.12.2017)

Viimeisin kehitysversio (Huom! Saattaa sisältää keskeneräistä tai loppuun asti testaamatonta toiminnallisuutta, vaikka pyritäänkin pitämään toimintakuntoisena): MLInvoice git master. Commit-historiasta löytyvät tiedot viimeisimmistä muutoksista. Tätä versiota ei suositella tuotantokäyttöön.
Huom! kehitysversio ei sisällä kaikkia riippuvuuksia. Niiden asentamiseksi tarvitaan Composer. Suorita "composer install" MLInvoicen hakemistossa.

Uusi asennus

MLInvoice tarvitsee toimiakseen www-palvelimen, joka tukee PHP-kieltä (versio 5.6 tai uudempi), ja MySQL- tai MariaDB-tietokannan. Nämä kaikki voi asentaa erillisen palvelimen lisäksi myös esim. kannettavalle tietokoneelle. Tähän löytyy ohjeita muualta:

Windows-ympäristössä voit käyttää kuvitettua ohjetta MLInvoicen ja XAMPP:n asentamiseksi.

Toki myös erilaiset web-hotellit, jotka tarjoavat PHP- ja MySQL-tuen, ovat toimivia vaihtoehtoja, mutta näissä on syytä pitää mielessä, että jos ei käytetä suojattua HTTPS-yhteyttä, on verkkoliikennettä mahdollista urkkia. Monissa palveluissa on käytettävissä phpMyAdmin-niminen MySQL-tietokantojen ylläpitotyökalu, jolla tietokannan luominen sujuu helposti.

PHP:ltä edellytetään MySQL-tukea ja mbstring-moduulia. Finvoice-tuki tarvitsee myös DOM/XML- ja XSL-moduulit. Vaadittava PHP-versio on vähintään 5.6.

Kun yllämainitut edellytykset on täytetty, varsinainen MLInvoicen asennus tapahtuu näin:

  1. Luo MySQL-tietokanta mlinvoice (tietokannan nimen voi tarvittaessa vaihtaa esim. lyhyemmäksi, mutta näissä ohjeissa oletetaan sen olevan mlinvoice). Aseta collationiksi utf8_swedish_ci.
  2. Luo MySQL-käyttäjä, jolla on riittävät oikeudet (ainakin SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, EXECUTE, CREATE VIEW, EVENT, TRIGGER, LOCK TABLES) mlinvoice-tietokannan käyttöön.
  3. Pura MLInvoicen asennuspaketti www-palvelimelle sopivaan paikkaan (tyypillisesti esim. htdocs-hakemistoon). Varmista, että tiedostojen käyttöoikeudet riittävät. Varmista myös, että PHP:stä pystyy kirjoittamaan hakemistoon tcpdf/cache.
  4. Avaa MLInvoice selaimella menemällä osoitteeseen, johon se on asennettu (ts. ylläoleva paketti on purettu).
  5. Anna avautuvaan asennuslomakkeeseen tarvittavat perustiedot.
  6. Avaa MLInvoice selaimeen ja kirjaudu sisään antamillasi tunnuksilla.
  7. Muokkaa asetukset sopiviksi kohdasta Asetukset -> Yleiset asetukset.
  8. Muokkaa tulostusmallit kohdasta Järjestelmä -> Tulostusmallit poista käytöstä / ota käyttöön tarpeen mukaan.
  9. PHP:n oletusmuistirajat eivät välttämättä riitä PDF:n luontiin. Jos se keskeytyy virheeseen, kasvata PHP:n memory_limit -asetus esim. arvoon 32M (ks. http://php.net/manual/en/configuration.changes.php ja http://php.net/manual/en/ini.core.php#ini.memory-limit).
  10. Jos aiot käyttää Finvoice-laskutusta, varmista, että PHP:ssa on käytössä DOM/XML- ja XSL-moduulit.
  11. Sähköpostin lähettämiseksi voi olla tarpeen muokata lähetysasetuksia config.php-tiedostossa.

Huom! MLInvoice ei välttämättä toimi oikein, jos PHP:n magic quotes -toiminto on päällä, vaikka mahdolliset ongelmat onkin pyritty kiertämään. Katso ohjeet toiminnon poistamiseksi.

Muista huolehtia MLInvoicen tietokannan varmuuskopioinnista. MLInvoice sisältää varmuuskopiointitoiminnon, joka luo tietokannan sisällöstä SQL-skriptin (skripti on samankaltainen kuin phpMyAdmin-ohjelman tietokannan vientitoiminnon tuottama). Skriptin suorittamalla sisältö voidaan palauttaa tyhjään tietokantaan. Kannattaa varmistua aika ajoin siitä, että varmuuskopio toimii, eli kokeilla, miltä tilanne näyttää, jos varmuuskopiosta luo uuden tietokannan.

Ongelmien selvitys

Jos jostain syystä käy niin, että MLInvoice ei toimi, vaan valittelee jostain tai näyttää tyhjää ruutua, niin web-palvelimen ja PHP:n lokeista voi löytyä osviittaa siihen, mikä on pielessä.

Päivitys versiosta 1.17.0 ja sitä uudemmista mihin tahansa uudempaan versioon

Versiosta 1.17.0 MLInvoice tukee automaattista päivitystä. Ks. Järjestelmä-valikko. Jos automaattista päivitystä ei voida käyttää, allaolevat ohjeet toimivat edelleen.

Päivitys versioista 1.5 eteenpäin mihin tahansa uudempaan versioon

  1. Korvaa vanhan version tiedostot uusilla (paketin voi purkaa suoraan vanhan version päälle).
    Tietokanta päivitetään tarvittaessa automaattisesti, ja siitä tulee ilmoitus kirjautumisruudulle. Jos tietokannan päivitys epäonnistuu esim. riittämättömien käyttöoikeuksien takia, kirjoitetaan tarvittavat päivitystoimenpiteet PHP:n virhelokiin. Huomaa, että kirjautumisruutua voi joutua odottamaan hetken aikaa ensimmäisellä kerralla päivityksen jälkeen riippuen siitä, miten paljon tietokantapäivityksiä on tehtävänä.
  2. Varmista, että MySQL-käyttäjällä on LOCK TABLES -käyttöoikeus.
  3. Jos käyttöliittymä toimii oudosti päivityksen jälkeen, tyhjennä selaimen välimuisti.

Päivitys versiosta 1.4.x versioon 1.5.x

  1. Aja tietokantaan päivitysskripti update_database_1.4_to_1.5.sql
  2. Korvaa vanhan version tiedostot uusilla (paketin voi purkaa suoraan vanhan version päälle).

Päivitys versiosta 1.4.2 versioon 1.4.3

  1. Korvaa uudella versiolla tiedostot json.php ja invoice_printer_base.php. Vaihtoehtoisesti voit myös kopioida uuden paketin sisällön kokonaan vanhan päälle.

Päivitys versiosta 1.4.1 versioon 1.4.2

  1. Korvaa uudella versiolla tiedosto json.php. Vaihtoehtoisesti voit myös kopioida uuden paketin sisällön kokonaan vanhan päälle.

Päivitys versiosta 1.3.x versioon 1.4.x

  1. Aja tietokantaan päivitysskripti update_database_1.3_to_1.4.sql
  2. Korvaa vanhan version tiedostot uusilla (paketin voi purkaa suoraan vanhan version päälle).

Päivitys versiosta 1.3.2 versioon 1.3.3

  1. Korvaa vanhan version tiedostot uusilla (paketin voi purkaa suoraan vanhan version päälle).

Päivitys versiosta 1.3.1 versioon 1.3.2

  1. Korvaa uusilla versioilla tiedostot form_switch.php ja sqlfuncs.php sekä koko tcpdf-hakemiston sisältö. Muuta ei tarvita.

Päivitys versiosta 1.3 versioon 1.3.1

  1. Korvaa uusilla versioilla tiedostot invoice_printer_base.php, invoice_printer_email.php ja sessionfuncs.php. Muuta ei tarvita.

Päivitys versiosta 1.2 versioon 1.3

  1. Aja tietokantaan päivitysskripti update_database_1.2_to_1.3.sql
  2. Korvaa kaikki vanhan version tiedostot config.php:ta lukuunottamatta uusilla. Vanhat tiedostot kannattaa ensin poistaa tai siirtää talteen.
  3. Kirjaudu sisään ja käy säätämässä muut asetukset kohdalleen kohdasta Asetukset -> Yleiset asetukset.

Päivitys versiosta 1.2 versioon 1.2.1

  1. Pura paketti vanhan asennuksen päälle. Muuta ei tarvita.

Päivitys versiosta 1.1 versioon 1.2

  1. Aja tietokantaan päivitysskripti update_database_1.1_to_1.2.sql
  2. Kopioi vanhasta versiosta settings.php:sta tietokanta-asetukset talteen.
  3. Korvaa kaikki vanhan version tiedostot. Vanhat tiedostot kannattaa ensin poistaa tai siirtää talteen.
  4. Kopioi config.php.sample nimelle config.php.
  5. Muuta config.php:sta tietokanta-asetukset talteen otetun settings.php:n mukaisiksi.
  6. Kirjaudu sisään ja käy säätämässä muut asetukset kohdalleen kohdasta Asetukset -> Yleiset asetukset.

Päivitys versiosta 1.0 versioon 1.1

  1. Aja tietokantaan päivitysskripti update_database_1.0_to_1.1.sql
  2. Kopioi vanhasta versiosta settings.php:sta tietokanta-asetukset talteen.
  3. Korvaa kaikki vanhan version tiedostot. Vanhat tiedostot kannattaa ensin poistaa tai siirtää talteen.
  4. Muuta uudesta settings.php:sta tietokanta-asetukset talteen otettujen mukaisiksi.
  5. Tyhjennä selaimen välimuisti tai huolehdi muuten, ettei esim. vanhan tyylitiedoston haamu sotke uuden version ulkoasua.
  6. Kirjaudu sisään ja käy säätämässä muut asetukset kohdalleen kohdasta Asetukset -> Yleiset asetukset.