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
|   |           |   |   `-- Luottokunta.php
|   |           |   |-- Sender
|   |           |   |   `-- Luottokunta.php
|   |           |   `-- Validator
|   |           |       `-- Luottokunta.php
|   |           `-- Fipnmglk
|   |               |-- Block
|   |               |   `-- Standard
|   |               |       |-- Failure.php
|   |               |       |-- Form.php
|   |               |       `-- Redirect.php
|   |               |-- doc
|   |               |-- Helper
|   |               |   `-- Data.php
|   |               |-- Model
|   |               |   |-- Config.php
|   |               |   |-- Session.php
|   |               |   |-- Source
|   |               |   |   |-- LanguageAction.php
|   |               |   |   `-- TransactiontypeAction.php
|   |               |   `-- Standard.php
|   |               |-- controllers
|   |               |   `-- StandardController.php
|   |               `-- etc
|   |                   |-- config.xml
|   |                   `-- system.xml
|   |-- design
|   |   `-- frontend
|   |       `-- default
|   |           |-- default
|   |           |   |-- layout
|   |           |   |   `-- fipnmglk.xml
|   |           |   `-- template
|   |           |       `-- fipnmglk
|   |           |           `-- standard
|   |           |               |-- failure.phtml
|   |           |               `-- form.phtml
|   |           `-- modern
|   |               |-- layout
|   |               |   `-- fipnmglk.xml
|   |               `-- template
|   |                   `-- fipnmglk
|   |                       `-- standard
|   |                           |-- failure.phtml
|   |                           `-- form.phtml
|   |-- etc
|   |   `-- modules
|   |       `-- XAivomatic_Fipnmglk.xml
|   `-- locale
|       |-- en_US
|       |   `-- Aivomatic_Fipnmglk.csv
|       `-- fi_FI
|           `-- Aivomatic_Fipnmglk.csv
`-- skin
    `-- frontend
        `-- default
            `-- default
                `-- images
                    |-- fipnmglk-visa-electron-mastercard-amex-223x40.png
                    `-- fipnmglk-visa-electron-mastercard-amex-223x40.xcf

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/Fipnmglk/doc-hakemistoa, jossa on ohjelmistojen API-dokumentaatio, sekä tiedostoa fipnmglk-visa-electron-mastercard-amex-223x40.xcf, joka on luottokorttilogojen PNG-kuvatiedoston alkuperäisversio GIMP-kuvankäsittelyohjelmalle, ei ole pakko asentaa palvelimelle, joskaan niistä 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 FipnMgLk-n.n.n.tar.gz

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm FipnMgLk-n.n.n.tar.gz

Myös jakelupaketin /app/code/local/Aivomatic/Fipnmglk/doc-hakemistossa olleen API-dokumentaation sekä fipnmglk-visa-electron-mastercard-amex-223x40.xcf -kuvatiedoston voi halutessaan poistaa palvelimelta.

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

rm ./skin/frontend/default/default/images/fipnmglk-visa-electron-mastercard-amex-223x40.xcf

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 Luottokunta DMP. Selaimeen avautuu ao. näkymä:

Asetukset

Aluksi asetusten oletusarvoina on Luottokunnan rajapintadokumentaation esimerkkiarvot. 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 minkä vain maksutapaa hyvin kuvaavan nimityksen, joka näkyy myös asiakkalle mm. maksutapojen valinnassa.
• Liiketunnus
  • Liikkeen tunnusluku, eli Luottokunnan kauppiaalle antama asiakastunnus. Pelkkiä numeroita.
• Kauppiasvarmenne
  • Luottokunnan kauppiaalle antama salainen koodi. Kirjain- ja numerosarja.
• Tilaustiedot rivi 1 ja rivi 2
  • Luottokunnan hallintapaneliin välittyvän viestin kaksi vapaamuotoista tekstiriviä. Viesti ei näy asiakkaalle.
• Maksutavan tyyppi
  • Varmenna tai Varmenna ja veloita. Lisätietoja Luottokunnan dokumentaatiosta.
• Kieli
  • Kieli jolla Luottokunnan sivusto esitetään asiakkaalle.
• Maksetun tilauksen tila
  • Tilauksen tila kun Luottokunnalta on saatu tieto hyväksytystä ja onnistuneesta maksutapahtumasta.
• Debug-loki
  • Kyllä/Ei (Yes/No). Jos Kyllä, debug-lokiin (.../var/log/system.log) tallentuu tietoa FipnMgLk: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)

Luottokunnan Kauppiaspanelin asetukset

Luottokunnan Kauppiaspanelin asetuksista tulee varmistaa, että valinta Lisää MAC-tarkiste Success_Url:iin on päällä.