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
|   |           |   |   `-- Checkoutfi.php
|   |           |   |-- Sender
|   |           |   |   `-- Checkoutfi.php
|   |           |   `-- Validator
|   |           |       `-- Checkoutfi.php
|   |           `-- Fipnmgchk
|   |               |-- Block
|   |               |   `-- Standard
|   |               |       |-- Failure.php
|   |               |       |-- Form.php
|   |               |       `-- Redirect.php
|   |               |-- Helper
|   |               |   `-- Data.php
|   |               |-- Model
|   |               |   |-- Config.php
|   |               |   |-- Session.php
|   |               |   |-- Source
|   |               |   |   |-- LanguageAction.php
|   |               |   |   `-- OrdercontenttypeAction.php
|   |               |   `-- Standard.php
|   |               |-- controllers
|   |               |   `-- StandardController.php
|   |               |-- doc
|   |               `-- etc
|   |                   |-- config.xml
|   |                   `-- system.xml
|   |-- design
|   |   `-- frontend
|   |       `-- default
|   |           |-- default
|   |           |   |-- layout
|   |           |   |   `-- fipnmgchk.xml
|   |           |   `-- template
|   |           |       `-- fipnmgchk
|   |           |           `-- standard
|   |           |               |-- failure.phtml
|   |           |               `-- form.phtml
|   |           `-- modern
|   |               |-- layout
|   |               |   `-- fipnmgchk.xml
|   |               `-- template
|   |                   `-- fipnmgchk
|   |                       `-- standard
|   |                           |-- failure.phtml
|   |                           `-- form.phtml
|   |-- etc
|   |   `-- modules
|   |       `-- XAivomatic_Fipnmgchk.xml
|   `-- locale
|       |-- en_US
|       |   `-- Aivomatic_Fipnmgchk.csv
|       `-- fi_FI
|           `-- Aivomatic_Fipnmgchk.csv
`-- skin
    `-- frontend
        `-- default
            `-- default
                `-- images
                    `-- fipnmgchk-logo-148x35.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/Fipnmgchk/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 FipnMgChk-n.n.n.tar.gz

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm FipnMgChk-n.n.n.tar.gz

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

rm -r ./app/code/local/Aivomatic/Fipnmgchk/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 Checkout. Selaimeen avautuu ao. näkymä:

Oletusasetukset

Aluksi asetusten oletusarvoina on Checkout Finland Oy:n 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 asiakkaalle mm. maksutapojen valinnassa.
• Myyjän tunnus
  • Myyjän tunnusluku, eli Checkout Finland Oy:n kauppiaalle antama Checkout-maksupalvelun asiakastunnus. Pelkkiä numeroita.
• Tarkiste
  • Checkout Finland Oy:n kauppiaalle antama salainen koodi. Kirjain- ja numerosarja.
• Toimitusaika, varasto OK
  • Checkout Finland Oy lähettää luotolliset veloitukset ostajalle toimituspäivän mukaan. Toimitusaika, varasto OK on arvio siitä, monenko päivän päästä tilaus toimitetaan asiakkaalle, jos kaikkia tilauksen tuotteita on varastossa tilaushetkellä.
• Toimitusaika, ei varastossa
  • Toimitusaika, ei varastossa on arvio siitä, monenko päivän päästä tilaus toimitetaan asiakkaalle, jos kaikkia tilauksen tuotteita ei ole varastossa tilaushetkellä.
• Toimituksen tyyppi
  • Tilausten sisällön tyyppi. Normaali tai aikuisviihde.
• Kieli
  • Kieli jolla Checkout-sivusto esitetään asiakkaalle.
• Debug-loki
  • Kyllä/Ei (Yes/No). Jos Kyllä, debug-lokiin (.../var/log/system.log) tallentuu tietoa maksumodulin 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)

Kauppakohtaiset asetukset

Yhdellä Magento-ohjelmistolla voidaan toteuttaa useita rinnakkaisia verkkokauppoja, joista jokaisessa voi olla esim. eri oletuskieli. Seuraavat asetukset voidaan asettaa kullekin rinnakkaiselle kaupalle erikseen.

• Nimike
  • Maksutapaa kuvaava nimitys, joka näkyy myös asiakkaalle mm. maksutapojen valinnassa.
• Kieli
  • Kieli jolla Checkout-sivusto esitetään asiakkaalle. Checkout tukee suomea, ruotsia ja englantia.