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
|   |           |   |   `-- SampoPankki.php
|   |           |   |-- Sender
|   |           |   |   `-- SampoPankki.php
|   |           |   `-- Validator
|   |           |       `-- SampoPankki.php
|   |           `-- Fipnmgsa
|   |               |-- Block
|   |               |   `-- Standard
|   |               |       |-- Failure.php
|   |               |       |-- Form.php
|   |               |       `-- Redirect.php
|   |               |-- Helper
|   |               |   `-- Data.php
|   |               |-- Model
|   |               |   |-- Config.php
|   |               |   |-- Session.php
|   |               |   |-- Source
|   |               |   |   `-- LanguageAction.php
|   |               |   `-- Standard.php
|   |               |-- controllers
|   |               |   `-- StandardController.php
|   |               `-- etc
|   |                   |-- config.xml
|   |                   `-- system.xml
|   |-- design
|   |   `-- frontend
|   |       `-- default
|   |           |-- default
|   |           |   |-- layout
|   |           |   |   `-- fipnmgsa.xml
|   |           |   `-- template
|   |           |       `-- fipnmgsa
|   |           |           `-- standard
|   |           |               |-- failure.phtml
|   |           |               `-- form.phtml
|   |           `-- modern
|   |               |-- layout
|   |               |   `-- fipnmgsa.xml
|   |               `-- template
|   |                   `-- fipnmgsa
|   |                       `-- standard
|   |                           |-- failure.phtml
|   |                           `-- form.phtml
|   |-- etc
|   |   `-- modules
|   |       `-- XAivomatic_Fipnmgsa.xml
|   `-- locale
|       |-- en_US
|       |   `-- Aivomatic_Fipnmgsa.csv
|       `-- fi_FI
|           `-- Aivomatic_Fipnmgsa.csv
`-- skin
    `-- frontend
        `-- default
            `-- default
                `-- images
                    `-- fipnmgsa-sampo-79x30.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/Fipnmgsa/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 FipnMgSa-n.n.n.tar.gz

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm FipnMgSa-n.n.n.tar.gz

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

rm -r ./app/code/local/Aivomatic/Fipnmgsa/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 Sampo Pankin verkkomaksu. Selaimeen avautuu ao. näkymä:

Asetukset

Aluksi asetusten oletusarvoina on Sampo 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.
• Myyjän tunnus
  • Myyjän tunnus, eli Sampo Pankin kauppiaalle antama myyjän tunnuskoodi.
• MAC-avain
  • Sampo Pankin kauppiaalle antama salainen koodi eli MAC-avain. Kirjain- ja numerosarja.
• Kieli
  • Kieli jolla Sampo Pankin verkkomaksusivusto esitetään asiakkaalle.
• Maksetun tilauksen tila
  • Tilauksen tila kun Sampo Pankin verkkomaksupalvelusta on saatu tieto hyväksytystä ja onnistuneesta maksutapahtumasta.
• Debug-loki
  • Kyllä/Ei (Yes/No). Jos Kyllä, debug-lokiin (.../var/log/system.log) tallentuu tietoa FipnMgSa: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)