Asennus ja konfigurointi

Asennus

Alla esitellään kaksi FipnMgSvm:n asennustapaa.

Uusien laajennusohjelmistojen asennus Magentoon on aina hyvä testata erillisellä testi-palvelimella ennen asennuksen suorittamista/siirtämistä varsinaiselle tuotantopalvelimelle. Ennen asennusta on hyvä ottaa täysi varmuuskopio Magenton tiedostoista ja tietokannasta.

Jakelupaketin hakemistorakenne

Jakelupaketti sisältää hakemistorakenteen, joka täsmää Magenton hakemistorakenteeseen.

|-- app
|   |-- code
|   |   `-- local
|   |       `-- Aivomatic
|   |           |-- Fipn
|   |           |   |-- Receiver
|   |           |   |   `-- SuomenVerkkomaksut.php
|   |           |   |-- Sender
|   |           |   |   `-- SuomenVerkkomaksut.php
|   |           |   |-- Util
|   |           |   |   `-- SuomenVerkkomaksut
|   |           |   |       `-- ButtonGrid.php
|   |           |   `-- Validator
|   |           |       `-- SuomenVerkkomaksut.php
|   |           `-- Svmmg
|   |               |-- Block
|   |               |   `-- Standard
|   |               |       |-- Failure.php
|   |               |       |-- Form.php
|   |               |       `-- Redirect.php
|   |               |-- Helper
|   |               |   `-- Data.php
|   |               |-- Model
|   |               |   |-- Config.php
|   |               |   |-- Session.php
|   |               |   |-- Source
|   |               |   |   |-- ButtongridtypeAction.php
|   |               |   |   |-- CultureAction.php
|   |               |   |   `-- WapiversionAction.php
|   |               |   `-- Standard.php
|   |               |-- controllers
|   |               |   `-- StandardController.php
|   |               |-- doc
|   |               `-- etc
|   |                   |-- config.xml
|   |                   `-- system.xml
|   |-- design
|   |   `-- frontend
|   |       `-- default
|   |           |-- default
|   |           |   |-- layout
|   |           |   |   `-- svmmg.xml
|   |           |   `-- template
|   |           |       `-- svmmg
|   |           |           `-- standard
|   |           |               |-- failure.phtml
|   |           |               `-- form.phtml
|   |           `-- modern
|   |               |-- layout
|   |               |   `-- svmmg.xml
|   |               `-- template
|   |                   `-- svmmg
|   |                       `-- standard
|   |                           |-- failure.phtml
|   |                           `-- form.phtml
|   |-- etc
|   |   `-- modules
|   |       `-- XAivomatic_Svmmg.xml
|   `-- locale
|       |-- en_US
|       |   `-- Aivomatic_Svmmg.csv
|       `-- fi_FI
|           `-- Aivomatic_Svmmg.csv
`-- skin
    `-- frontend
        `-- default
            `-- default
                `-- images
                    `-- fipnmgsvm-logo-192x40.png

Tiedostojen kopiointi manuaalisesti

Pura jakelupaketti työasemallesi johonkin väliaikaiseen hakemistoon.

Kopioi puretun jakelupaketin sisältämät alihakemistot ja tiedostot www-palvelimelle Magento-verkkokaupan asennushakemistoon Magenton oman hakemistorakenteen esimerkin mukaisesti.

Jakelupaketin /app/code/local/Aivomatic/Svmmg/doc-hakemistoa, jossa on ohjelmistojen API-dokumentaatio, ei ole pakko kopioida palvelimelle.

tar.gz-paketin purku asennushakemistoon terminaali-ikkunassa

Tässä asennustavassa tarvitaan ns. terminaali-ikkunaa, joka myös saatetaan tuntea myös termillä komentorivikehote, joko suoran paikallisen yhteyden tai esim. SSH-etäyhteyden kautta.

Kopioi tar.gz-jakelupaketti palvelimelle Magento-verkkokaupan asennushakemiston juureen.

Vaihda terminaalin työhakemistoksi Magenton asennushakemisto. Käytä esim. komentoa

cd /home/user/public_html/magento

Pura tar.gz-paketti suorittamalla terminaali-ikkunassa komento

tar -zxvf FipnMgSvm-0.3.0.tar.gz

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti. Myös jakelupaketin /app/code/local/Aivomatic/Svmmg/doc-hakemistossa olleen API-dokumentaation voi halutessaan poistaa palvelimelta.

Välimuistin tyhjennys

Käytettiinpä mitä tahansa asennustapaa, Magento välimuisti (Cache) pitää tyhjentää asennuksen jälkeen. Avaa välimuistin hallinta (System/Cache Management), valitse All Cache kohdan alasvetovalikosta arvo Refresh ja klikkaa lopuksi Save cache settings.

Konfigurointi

Kirjaudu sisään Magento-ohjauspaneliin. Avaa maksutapojen konfigurointi (System/Configuration/Payment Methods). Valitse listalta Suomen Verkkomaksut eFactoring. Selaimeen avautuu ao. näkymä:

Kauppakohtainen konfigurointi

Yhdellä Magento-ohjelmistolla voidaan toteuttaa useita rinnakkaisia verkkokauppoja, joista jokaisessa voi olla esim. eri oletuskieli. Osa Suomen Verkkomaksut -maksutavan asetuksista voidaan asettaa kullekin kaupalle erikseen.

Asetukset

Aluksi asetusten oletusarvoina on arvot, jotka käyvät Suomen Verkkomaksut Oy:n testitunnuksiksi. Ennen tuotantokäyttöön siirtymistä ne pitää korvata kauppiaan omilla tunnuksilla ja asetuksilla.

Alla käydään läpi kaikki asetukset ja niiden merkitykset.

• Käytössä
  • Kyllä/Ei (Yes/No). Jos Kyllä, maksutapa on käytössä, eli se esitetään asiakkaalle yhtenä maksutapavaihtoehtona tilauksen teon yhteydessä.
• Nimike
  • Periaatteessa tähän voi kirjoittaa minkä vain maksutapaa hyvin kuvaavan nimityksen, joka näkyy myös asiakkalle mm. maksutapojen valinnassa. Suomen Verkkomaksut Oy antaa asiasta omat ohjeensa asiakasmateriaalin dokumentaatiossa.
• Kauppiastunnus
  • Kauppiaan tunnusluku, eli SVM Oy:n kauppiaalle antama asiakastunnus. Pelkkiä numeroita.
• Kauppiasvarmenne
  • Suomen Verkkomaksut Oy:n kauppiaalle antama salainen koodi. Kirjain- ja numerosarja.
• Tilaustiedot rivi 1 ja rivi 2
  • Suomen Verkkomaksut Oy:n hallintapaneliin välittyvän viestin kaksi vapaamuotoista tekstiriviä. Viesti ei näy asiakkaalle.
• Kulttuuri
  • Kieli ja lukujen esitystapa, jolla Suomen Verkkomaksut Oy:n sivusto esitetään asiakkaalle.
• WAPI-versio
  • Suomen Verkkomaksut Oy:n verkkorajapinnan (Web API) versio. Versio S1 on yksinkertaisempi, mutta ei tue lasku-, luotto- tai Netposti-maksutapoja. Versio E1 on monimutkaisempi, sillä sillä välitetään yksityiskohtaisia tilaustietoja verkkokaupasta maksupalveluun.
• Maksetapakuvan tyyppi
  • Maksutapakuvalla esitetään asiakkaalle, mitä eri maksutapoja hän voi valita Suomen Verkkomaksut Oy:n palvelussa. Tässä asetuksella määritetään, onko ko. kuva pysty- vai vaakasuuntainen.
• Maksetapakuvan sarakkeet
  • Maksutapakuvan sarakkeiden lukumäärä määrää, miten monta maksutapalogoa on rinnan tai allekain.
• Debug-loki
  • Kyllä/Ei (Yes/No). Jos Kyllä, debug-lokiin (.../var/log/system.log) tallentuu tietoa FipnMgSvm:n toiminnasta, kuten lähetetystä ja vastaanotetusta datasta. Tarkista myös että Magenton loki-asetusten (System/Configuration/Developer/Log Setting) Enabled-asetus on arvossa Yes (Käytössä/Kyllä).
• Maksu kaikista tai vain tietyistä maista
  Jos All Allowed Countries (Kaikki sallitut maat), maksutapaa voivat käyttää kaikki asiakkaan heidän osoitetietojensa maasta riippumatta. Katso myös System/Configuration/General/Coutries options/Allow Countries
• Maat joille maksutapa on sallittu
  • Jos em. kohdan arvo on Specific coutries (Tietyt maat), maksutapaa voivat käyttää vain ne asiakkaat, joiden osoitetietojen maa on valittuna tällä listalla.
• Tilaussumman minimimäärä
  • Tyhjä = ei käytössä. Jos tilauksen kokonaissumma on tässä asetettua arvoa pienempi, maksutapa ei ole käytettävissä.
• Tilaussumman maksimimäärä
  • Tyhjä = ei käytössä. Jos tilauksen kokonaissumma on tässä asetettua arvoa suurempi, maksutapa ei ole käytettävissä.
• Järjestys
  • Järjestysnumero maksutapalistalla, eli monentenako maksutapana tämä maksutapa esitetään asiakkaalle.