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
    |           `-- Amcmgddpp
    |               |-- Block
    |               |   |-- Form.php
    |               |   `-- Info.php
    |               |-- Helper
    |               |   `-- Data.php
    |               |-- Model
    |               |   |-- Amcmgddpp.php
    |               |   `-- Quote.php
    |               |-- doc
    |               `-- etc
    |                   |-- config.xml
    |                   `-- system.xml
    |-- design
    |   |-- adminhtml
    |   |   `-- default
    |   |       `-- default
    |   |           `-- template
    |   |               `-- amcmgddpp
    |   |                   |-- form.phtml
    |   |                   `-- info.phtml
    |   `-- frontend
    |       `-- default
    |           `-- default
    |               `-- template
    |                   `-- amcmgddpp
    |                       |-- form.phtml
    |                       `-- info.phtml
    |-- etc
    |   `-- modules
    |       `-- XAivomatic_Amcmgddpp.xml
    `-- locale
        |-- en_US
        |   `-- Aivomatic_Amcmgddpp.csv
        `-- fi_FI
            `-- Aivomatic_Amcmgddpp.csv

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/Amcmgddpp/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 AmcMgDdPp-n.n.n.tar.gz

Poista asennushakemiston juureen kopioitu tar.gz-jakelupaketti.

rm AmcMgDdPp-n.n.n.tar.gz

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

rm -r ./app/code/local/Aivomatic/Amcmgddpp/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 Direct Deposit PrePay - AmcMgDdPp. Selaimeen avautuu ao. näkymä:

Asetukset

Aluksi asetusten oletusarvoina on esimerkkiarvot. Ennen tuotantokäyttöön siirtymistä ne pitää korvata kauppiaan omilla tiedoilla ja asetuksilla.

Asetukset voidaan konfiguroida erikseen kullekin rinnakkaiselle kaupalle, mikä mahdollistaa mm. useiden eri kielien sujuvan käytön.

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 asiakkaalle mm. maksutapojen valinnassa.
• Tilinhaltijan nimi
  • Ennakkomaksun vastaanottavan tilinhaltijan nimi. Tavallisesti verkkokaupan toiminnasta vastaavan yrityksen nimi.
• Pankkitilin numero
  • Pankkitilin numero kotimaisille tilisiirroille.
• Pankin nimi
  • Pankkiryhmän nimi. Tämä tieto auttaa asiakas arvioimaan, miten pitkään kestää, ennen kuin maksusuoritus välittyy asiakkaan pankista verkkokauppiaan pankkiin.
• IBAN
  • Kansainvälinen pankkitilin numero (International Bank Account Number).
• BIC
  • Kansainvälinen pankkitunnistekoodi (Bank Identifier Code). Jos IBAN tai BIC tai molemmat jätetään tyhjäksi, ennakkomaksutiedoissa ei näytetä lainkaan kansainvälisiä pankkitietoja.
• Maksuaika (X päivää)
  • Ennakkomaksun määräpäivä lasketaan tilauksen päivämäärän ja maksuajan perusteella. Jos laskettu määräpäivä on lauantai tai sunnutai, määräpäivä on seuraava maanantai.
• Vapaa info-teksti
  • Asiakkaalle tilaustiedoissa, eli tilausvahvistuksen sisältävässä sähköpostissa ja arkistoidussa tilauksessa näytettävä vapaamuotoinen teksti.
• Vapaa lomake-teksti
  • Asiakkaalle maksutavan valintalomakkeessa näytettävä vapaamuotoinen teksti.
• Uuden tilauksen tila
  • Uuden tilauksen tila. Nykyisessä Magentossa käytässä aina Pending.
• Debug-loki
  • Kyllä/Ei (Yes/No). Jos Kyllä, debug-lokiin (.../var/log/system.log) tallentuu tietoa AmcMgDdPp:n toiminnasta (toistaiseksi ei käytössä). 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. Oletuksena ennakkomaksu on sallittu vain listalla valittuna olevista maista.
• 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. Oletuksena listalta on valittuna vain Suomi. Kannattaa huomioida, että suomalaista pankkiviitenumeroa ei voi käyttää muista maista suoritettavissa tilisiirroissa. Toisaalta asiakkaalla joka on toisessa maassa, saattaa silti olla käytettävissään suomalainen pankkiyhteys.
• 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)