Asennus ja konfigurointi

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
|   |           |   |   `-- NordeaPankki.php
|   |           |   |-- Sender
|   |           |   |   `-- NordeaPankki.php
|   |           |   `-- Validator
|   |           |       `-- NordeaPankki.php
|   |           `-- Fipnmgnp
|   |               |-- Block
|   |               |   `-- Standard
|   |               |       |-- Failure.php
|   |               |       |-- Form.php
|   |               |       `-- Redirect.php
|   |               |-- Helper
|   |               |   `-- Data.php
|   |               |-- Model
|   |               |   |-- Config.php
|   |               |   |-- Session.php
|   |               |   |-- Source
|   |               |   |   `-- LanguageAction.php
|   |               |   `-- Standard.php
|   |               |-- controllers
|   |               |   `-- StandardController.php
|   |               |-- doc
|   |               `-- etc
|   |                   |-- config.xml
|   |                   `-- system.xml
|   |-- design
|   |   `-- frontend
|   |       `-- default
|   |           |-- default
|   |           |   |-- layout
|   |           |   |   `-- fipnmgnp.xml
|   |           |   `-- template
|   |           |       `-- fipnmgnp
|   |           |           `-- standard
|   |           |               |-- failure.phtml
|   |           |               `-- form.phtml
|   |           `-- modern
|   |               |-- layout
|   |               |   `-- fipnmgnp.xml
|   |               `-- template
|   |                   `-- fipnmgnp
|   |                       `-- standard
|   |                           |-- failure.phtml
|   |                           `-- form.phtml
|   |-- etc
|   |   `-- modules
|   |       `-- XAivomatic_Fipnmgnp.xml
|   `-- locale
|       |-- en_US
|       |   `-- Aivomatic_Fipnmgnp.csv
|       `-- fi_FI
|           `-- Aivomatic_Fipnmgnp.csv
|-- skin
    `-- frontend
        `-- default
            `-- default
                `-- images
                    `-- fipnmgnp-nordea-50x50.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/Fipnmgnp/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 FipnMgNp-n.n.n.tar.gz

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm FipnMgNp-n.n.n.tar.gz

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

rm -r ./app/code/local/Aivomatic/Fipnmgnp/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 Nordea E-maksu. Selaimeen avautuu ao. näkymä:

Asetukset

Aluksi asetusten oletusarvoina on Nordea Pankin rajapintadokumentaation esimerkkiarvot, jotka samalla ovat verkkopankkimaksun testitunnukset. 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
  • Tähän voi kirjoittaa periaatteessa minkä vain maksutapaa hyvin kuvaavan nimityksen, joka näkyy myös asiakkalle mm. maksutapojen valinnassa. Huomioi että Nordea Pankki vaatii käyttämään muotoa Nordea E-maksu.
• Myyjän tunnus
  • Myyjän tunnus, eli Nordea Pankin kauppiaalle antama myyjätunnus.
• MAC-avain
  • Nordea Pankin kauppiaalle antama salainen koodi. Kirjain- ja numerosarja.
• Avainversio
  • MAC-avaimen nelinumeroinen versionumero, joka kerrotaan Nordean kauppiaalle toimittamassa aineistossa. Esim. 0001.
• Vaihtoehtoinen pankkitili
  • Kauppiaan vaihtoehtoinen pankkitilin numero. Käytetään jos maksut halutaan ohjata toiselle tilille, kuin mikä on määritelty verkkomaksusopimuksessa.
• Vaihtoehtoinen nimi
  • Kauppiaan vaihtoehtoinen nimi. Käytetään jos asiakkaalle halutaan esittää eri maksun saajan nimi, kuin mikä on määritelty verkkomaksusopimuksessa.
• Tilaustiedot rivi 1 ja rivi 2
  • Tilauksen vapaamuotoinen lisätietoa. Viesti näkyy asiakkaan tiliotteella. Max. 35 merkkiä per rivi.
• Kieli
  • Kieli jolla Nordea Pankin verkkomaksusivusto esitetään asiakkaalle.
• Maksetun tilauksen tila
  • Tilauksen tila kun Nordea E-maksusta on saatu tieto hyväksytystä ja onnistuneesta maksutapahtumasta.
• Debug-loki
  • Kyllä/Ei (Yes/No). Jos Kyllä, debug-lokiin (.../var/log/system.log) tallentuu tietoa FipnMgNp: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.

Klikkaa lopuksi Save Config (Tallenna asetukset)