Everyday-verkkomaksun asennus ja konfigurointi Magento-verkkokaupassa

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

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

Fipn

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

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
│   │           │   │   └── Everyday.php
│   │           │   ├── Sender
│   │           │   │   └── Everyday.php
│   │           │   └── Validator
│   │           │       └── Everyday.php
│   │           └── Fipnmged
│   │               ├── Block
│   │               │   └── Standard
│   │               │       ├── Failure.php
│   │               │       ├── Form.php
│   │               │       └── Redirect.php
│   │               ├── CHANGELOG
│   │               ├── controllers
│   │               │   └── StandardController.php
│   │               ├── doc
│   │               ├── etc
│   │               │   ├── config.xml
│   │               │   └── system.xml
│   │               ├── Helper
│   │               │   └── Data.php
│   │               └── Model
│   │                   ├── Config.php
│   │                   ├── Session.php
│   │                   ├── Source
│   │                   │   ├── CharsetAction.php
│   │                   │   └── LanguageAction.php
│   │                   └── Standard.php
│   ├── design
│   │   └── frontend
│   │       └── default
│   │           └── default
│   │               ├── layout
│   │               │   └── fipnmged.xml
│   │               └── template
│   │                   └── fipnmged
│   │                       └── standard
│   │                           ├── failure.phtml
│   │                           └── form.phtml
│   ├── etc
│   │   └── modules
│   │       └── XAivomatic_Fipnmged.xml
│   └── locale
│       ├── en_US
│       │   └── Aivomatic_Fipnmged.csv
│       └── fi_FI
│           └── Aivomatic_Fipnmged.csv
└── skin
    └── frontend
        └── default
            └── default
                └── images
                    └── everyday-85x35.gif

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/Fipnmged/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 FipnMgEd-n.n.n.tar.gz

(komennossa annettavan tiedostonimen pitää täsmätä jakelupaketin nimeen).

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm FipnMgEd-n.n.n.tar.gz

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

rm -r ./app/code/local/Aivomatic/Fipnmged/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 Everyday. Selaimeen avautuu ao. ruutukaappauksen näkymä. Kunkin asetuksen merkitys on kuvattu asetuskentän kommenttirivillä.

Oletusasetukset

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

Räätälöinti

Ulkonäöllisesti FipnMgEd 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.