Handelsbankenin verkkomaksun asennus ja konfigurointi Magento-verkkokaupassa

Alla esitellään FipnMgHb-ohjelmiston asennus ja konfigurointi.

Magento-verkkokaupan järjestelmävaatimuksien lisäksi FipnMgHb vaatii PHP:n mbstring-laajennuksen.

Fipn

FipnMgHb hyödyntää erillistä verkkokauppaympäristöstä riippumatonta Fipn-ohjelmakomponenttia, joka toimitetaan FipnMgHb:n yhteydessä omana erillisenä jakelupakettinaan. Fipn-komponentin jakelupaketti puretaan ja asennetaan samalla tavalla kuin FipnMgHb.

Asennus

Alla esitellään kaksi 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
|   |           |   |   `-- Handelsbanken.php
|   |           |   |-- Sender
|   |           |   |   `-- Handelsbanken.php
|   |           |   `-- Validator
|   |           |       `-- Handelsbanken.php
|   |           `-- Fipnmghb
|   |               |-- Block
|   |               |   `-- Standard
|   |               |       |-- Failure.php
|   |               |       |-- Form.php
|   |               |       `-- Redirect.php
|   |               |-- CHANGELOG
|   |               |-- Helper
|   |               |   `-- Data.php
|   |               |-- Model
|   |               |   |-- Config.php
|   |               |   |-- Session.php
|   |               |   |-- Source
|   |               |   |   `-- CharsetAction.php
|   |               |   `-- Standard.php
|   |               |-- controllers
|   |               |   `-- StandardController.php
|   |               |-- doc
|   |               `-- etc
|   |                   |-- config.xml
|   |                   `-- system.xml
|   |-- design
|   |   `-- frontend
|   |       `-- default
|   |           |-- default
|   |           |   |-- layout
|   |           |   |   `-- fipnmghb.xml
|   |           |   `-- template
|   |           |       `-- fipnmghb
|   |           |           `-- standard
|   |           |               |-- failure.phtml
|   |           |               `-- form.phtml
|   |           `-- modern
|   |               |-- layout
|   |               |   `-- fipnmghb.xml
|   |               `-- template
|   |                   `-- fipnmghb
|   |                       `-- standard
|   |                           |-- failure.phtml
|   |                           `-- form.phtml
|   |-- etc
|   |   `-- modules
|   |       `-- XAivomatic_Fipnmghb.xml
|   `-- locale
|       |-- en_US
|       |   `-- Aivomatic_Fipnmghb.csv
|       `-- fi_FI
|           `-- Aivomatic_Fipnmghb.csv
`-- skin
    `-- frontend
        `-- default
            `-- default
                `-- images
                    `-- handelsbanken-121x18.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/Fipnmghb/doc-hakemistoa, jossa on ohjelmistojen API-dokumentaatio, ei ole pakko asentaa palvelimelle, joskaan siitä ei ole mitään haittaakaan.

tar.gz-paketin purku asennushakemistoon terminaali-ikkunassa

Tässä asennustavassa tarvitaan ns. terminaali-ikkunaa, joka tunnetaan 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 FipnMgHb-n.n.n.tar.gz
(komennossa annettavan tiedostonimen pitää täsmätä jakelupaketin nimeen).

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm FipnMgHb-n.n.n.tar.gz

Myös jakelupaketin /app/code/local/Aivomatic/Fipnmghb/doc-hakemistossa olleen API-dokumentaation voi halutessaan poistaa palvelimelta. 

rm -r ./app/code/local/Aivomatic/Fipnmghb/doc

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 Handelsbanken. Selaimeen avautuu ao. ruutukaappauksen näkymä. Kunkin asetuksen merkitys on kuvattu asetuskentän kommenttirivillä.

Asetusten hallinnointi

Oletusasetukset

Aluksi asetusten kauppiastunnuksen ja MAC-avaimen oletusarvoina on Handelbankenin rajapintadokumentaation esimerkkiarvot, joilla maksumodulin toimintaa voidaan testata jo ennen ennakkoon. Ennen tuotantokäyttöön siirtymistä ne pitää korvata kauppiaan omilla tunnuksilla ja asetuksilla.

Räätälöinti

Ulkonäöllisesti FipnMgHb istuu helposti olemassa olevaan kauppaan, sillä se käyttää esim. samoja CSS-luokkia, kuin Magento itsekin. Ulkonäköä ja sanamuotoja on helppo muuttaa erillisiä template- ja kielitiedostoja muokkaamalla.