HUOM! Voit itse lisätä ja muuttaa sisältöä muokkaa-painikkeiden avulla

 Olet itse vastuussa tämän teoksen käytöstä aiheutuvista vahingoista Lue lisää.

Magento

Kohteesta Wikikko - kansan taitopankki
Loikkaa: valikkoon, hakuun

Sisällysluettelo

Yleistä[muokkaa]

Tämä sivusto käsittelee Magento CE versioita 1.8 tai aikaisemmin.
Magento 2.0 katso sivulta Magento 2

Magento on nykyaikainen laaja verkkokauppaohjelmisto, jota käyttävät sekä pienet että suuret verkkokaupat. Magentosta on makstuon CE eli Community Edition versio ja kovaan käyttöön tarkoitettu maksullinen EE eli Enerprise Edition. Tällä sivulla on useita olennaisia vinkkejä verkkokaupan asennukseen ja toimintakuntoon saattamiseen liittyen. Magenton ohjeet, Magento User Guide neuvoo hyvin monissa asetuksissa, joten siihen kannattaa tutustua, sekä syvemmälle menevään Designer's Guide to Magento -ohjeeseen. Kummatkin ovat maksuttomia.

Pikavihjeet[muokkaa]

  • Varmuuskopiointi. Tiedostot tallentuvat var/backups kansioon.
  • PHP:llä voi lisätä sivuille tietoa, kts. kohta "Kuvan alkuperäinen osoite"

Lisätietoa[muokkaa]

  • Magenton kotisivut
  • Magento Suomi foorumi
  • Google, sijoittamalla hakuriville sanan magento ja kirjoittamalla haettavan tekstin englanniksi

Asennus[muokkaa]

Magenton asennusohjeet ovat selkeät ja niiden mukaan etenemällä asennus onnistuu helposti. Asennusohjeet löytyvät myös tältä sivulta.

Virheiden etsintä[muokkaa]

Kannattaa tutustua Commerce Bug 2 -laajennukseen. Katso demo (klikkaa vasemmasta yläkulmasta +Debug http://commercebugdemo.pulsestorm.net ja http://commercebugdemo.pulsestorm.net

  • Firefox selaimen lisäosa Firebug tai Safarin verkkoinspektori ovat näppäriä työkaluja myös Magentossa.
  • Esimerkiksi logokuvakkeen sijainnin haku: Asenna Firebug Firefoxiin. Klikkaa selaimen oikeasta yläkulmasta ötökkää ja ruudun alaosaan aukeaa työkalu. Paina HTML -välilehti. Valitse samalta riviltä vasemmasta reunasta "hiirennuoli ruudun sisällä" ja vie se selainruudulla logokuvan päälle (ja klikkaa). Näet polun josta kuvake noudetaan.
  • Error log record number: joku numero
    • Etsi tiedosto tuolla nimellä kansiosta /var/report ja lisää tiedostopääte .txt
  • Ylläpito > Kehitys > Virheiden haku (debug) -valikosta löytyy myös kohta, josta voi asettaa ilmoituksia näkymään sivustoon. Jos haluat lohkojen nimet näkyviin, sinun on valittava kauppanäkymä, jolloin ylläpitosivulle tulee kyseinen valinta vasta mahdolliseksi.

Valkoinen näyttö (Blank screen, White Screen)[muokkaa]

Mitään ei tapahdu yritettäessä ladata sivua. Kaikkia mahdollisia syitä on mahdotonta kertoa tässä, mutta joitain oleellisia ohessa:

  1. Yritit käyttää kokoamistoimintoa ja se päätyi valkoiseen näyttöön.
    1. Mene /shell -hakemistoon ja anna komento: compiler.php disable
    2. http://stackoverflow.com/questions/8538154/magento-died-after-compilation-how-to-disable-using-compiled-files-without-admi
  2. Tarkista PHP memory limit arvo että se on riittävän suuri
  3. Tarkista että PHP:n kaikki laajennuksen on ladattu.
  4. Tyhjennä välimuisti esim. pääte-ohjelmalla juurihakemistossa: rm -rf var/cache/*
  5. Tyhjennä istunnot var/sessions
  6. Palaa oletus ulkoasuun eli kaikkiin kohtiin arvo default
  7. Asenna ulkoasu uudestaan
  8. Tiedosto-oikeudet eivät ole oikein
  9. xml-tiedostossa sulkematon kommentti aiheuttaa ongelman
  10. Aseta php.ini:ssä short_open_tag = On jolloin <? ?> -tagit hyväksytään.
  11. Onko zip-tiedosto viallinen jos siirsit tiedostoja.
http://stackoverflow.com/questions/4784117/magento-how-to-debug-blank-white-screen

Tärkeitä yleisiä ohjeita[muokkaa]

  • Tutuksi tulee hakemisto /app, joka sisältää teemaan liittyviä tiedostoja kuten myös /skin. Näissä hakemistopolku menee yleensä niin että kaupan puolen hakemisto on /design/frontend/default (joka on paketti)/teemasi nimi/ ja sitten joko layout tai template -hakemisto. Jos käyttämästäsi teemasta ei löydy jotain tiedostoa, Magento hakee tällöin tiedoston todennäköisesti /app/design/frontend/base/default/ ja sitten joko layout tai template -hakemisto.
  • Tutuksi tulee myös Magenton ylläpidon kautta välimuistin tyhjentäminen, jotta osa muutoksista tulee näkyviin. Tarvittaessa muista myös tyhjentää oman selaimen välimuisti!
  • Laajennuksia asentaessa muista ehdottomasti kytkeä kokoamis-toiminto asennuksen ajaksi pois päältä! Muutoin saatat aiheuttaa tilanteen että ohjelmisto ei enää toimi.
  • Tietokannasta ja tiedostojärjestelmästä kannattaa ottaa ajoittain varmuuskopioita ja varskinkin ennen uuden laajennuksen asentamista.
  • On aina suositeltavaa että sinulla on tuotantoversion lisäksi testiversio, johon kokeilet uusien laajennusten ja toimintojen asentamista.

Omat muutokset[muokkaa]

Magento kuuluu ymmärrettävästi myös niihin ohjelmistoihin, jotka saattavat hävittää tekemiäsi muutoksia päivitysten yhteydessä. Yleensä tämä kohdistuu tiedostojärjestelmään. Tämän johdosta /app/code/core -hakemistoon ei tule tehdä muutoksia, koska on todennäköistä että ne menetetään päivityksen yhteydessä. /app/code -hakemisto rakentuu kolmesta hakemistosta: core, community ja local. Magento oletusarvoisesti hakee tiedostoja seuraavassa järjestyksessä sieltä: ensin se katsoo löytyykö tiedostoa local -hakemistosta, sitten community hakemistosta ja lopulta core hakemistosta. Jos tiedosto siis löytyy local -hakemistosta, Magento suorittaa sen. Näin ollen kun muutokset tehdään local -hakemistoon, ne ajavat core -hakemiston ohjelmien yli ja eivät häviä päivityksessä.

  • Hakemisto puut ja tiedostojen nimet täytyy olla identtiset core-hakemiston kanssa myös muissa hakemistoissa, jotta Magento osaa löytää tiedoston local-hakemistosta tai community-hakemistosta jos halutaan korvata core-hakemiston tiedosto.

Verkkokaupan perustaminen yleisesti[muokkaa]

Huomioonotettavia seikkoja:

  • Tarpeet, laajuus
  • Asennuspalveluntarjoajan valinta
  • Ohjelmiston valinta (ulkoasu, toiminnot, verkkomaksut, Itella, laajennusmahdollisuudet, suomenkielisyys, ylläpidon helppous)
  • Ulkoasun tekijä
  • Palvelimen valinta (hitaita, nopeita, palvelimsto-ohjelmien valmius kyseiseen kauppaan)
  • Itella Postin kanssa sopimus
  • Verkkomaksupalveluntarjoajan kanssa sopimus
  • SSL -suojaus. Katso ohje Wikikon sivulta SSL

Pikaohjeet[muokkaa]

Tämän sivun suomenkieliset käännökset ovat tällä sivulla tarjotusta fi_FI suomennoksesta. Perusohjeet löydät sivuilta:

Käsitteitä[muokkaa]

  • CE - Community Edition on ilmainen. Maksuulinen Magenton versio on Enterprise. Magento Go on Magenton tarjoama paketti, mutta siihen ei saa suomalaista verkkomaksupalvelua ja Postin palvelua (talvi 2012)
  • Luokka (Category) - Tuotteiden luokittelu. Tuote voi olla useammassa luokassa. Katso oma otsikko alempana.
    • Luokille voi muodostaa bannereita.
    • Luokille voi muodostaa "laskeutumissivuja"
    • Juuriluokalla tai alaluokilla voi olla oma tuotelista tai etusivu
  • Ominaisuus (Attribute) - Tuotteen ominaisuus, esim. väri. Sen arvo (value) on esim. punainen. Ominaisuuskokoelma (Attribute Set) ominaisuuksien ryhmä, joka muodostuu kyseisenlaista tuotetta koskevista ominaisuuksista. (Attribute Group) looginen ryhmä ominaisuuskokoelman sisällä siitä millätavoin ryhmiteltynä ominaisuudet näkyvät ylläpidon tuotesivulla. Katso oma otsikko alempana.
  • Lasku (Invoice) - Tarvittaessa useita per tuote esimerkiksi tilattaessa samalla kertaa useaan toimitusosoitteeseen
  • Hyvityslasku (Credit memo) - Ostosten maksun hyvitys. Palautus (Return).
  • Tilaus (Order)
    • Tilat: Pidossa (Hold), mitään toimintoja ei voi tehdä ennen kuin vapautetaan pidosta.
    • (Payment Review) -tila kun tilaus odottaa ulkopuolisen palvelun maksunvahvistusta.
    • (Processing) Tilaus on laskutettu tai toimitettu, mutta ei kumpaakin.
    • (Suspected Fraud) Maksupyyntö ei ole läpäissys PayPal suodattimia ja on Fraud Service käsittelyssä.
    • (Complete) laskutettu ja toimitettu.
    • Peruttu (Canceled) kun asiakas peruuttaa tilauksen ennen maksamista.
  • Näkymä (Scope) - Kaupan laajuus: Globaali (Global) sisältää kaikki sivustot, kaupat ja kauppanäkymät. Sivusto (Website) sisältää valitun sivuston ja kaikki kaupat ja kauppanäkymät sen alla. Store sisältää valitun kaupan ja kaikki kauppanäkymät sen alla. Kauppanäkymä (Store View) sisältää valitut kauppanäkymät. Jotkin ylätason asetukset voidaan ohittaa alemmilla tasoilla.
    • Sivusto (Website) - Korkein hierarkiassa. Voi olla useita nettikauppoja omilla domaineilla. Voivat jakaa asiakastietoja.
    • Kauppa (Store) - Sivusto voi käsittää useita kauppoja.
    • Kauppanäkymä (Store View) - Yleensä jaotellaan sijainnin tai kielien mukaan. Jakavat saman luettelon. Asiakas valitsee itse.
  • Search Engine Optimization (SEO) - asetuksia jotka parantavat näkyvyyttä hakukoneissa
  • Toimitus (Shipment) - ostoksen lähetys
  • Luettelo (Catalog) - tuoteluettelo
  • Tuotenumero (SKU) - yksilöi tuotteen varastossa.

Perusasetukset[muokkaa]

  • Määrittele kauppojen hierarkia kohdassa Järjestelmä/Kauppojen hallinta. Esim. käytät samaa Magentoasennusta, mutta toisessa kaupassa myyt roska-astioita ja toisessa muotivaatteita. Tällöin määrittele eri Sivustot. Sivuston alle voit määrittää kaupan eri kauppoja joihin voit yhdistää omia juuriluokkia ja omia domaineja. Kauppanäkymät määrittele esim. suomenkielinen, englanninkielinen
  • Lisää ainakin yksi juuriluokka.
  • Asetusten vasemmassa yläkulmassa määrätään tehtävien asetusten laajuus. Oletusasetukset koskevat kaikki asennuksen sivustoja, kauppoja ja kauppanäkymiä.
  • Ulkoasu (Design)
    • HTML tiedot - Tietoja hakukoneille
      • Oletusotsikko niille sivuille joilla ei omaa otsikkoa
      • Otsikon etu-/loppuliite niille sivuille joilla on oma otsikko
      • Näytä Demokaupan ilmoitus - Pidä päällä ennen kuin avaat kaupan yleisölle.
    • Ylätunniste - nimeä logo muutoin kuin logo.gif että sitä ei ylikirjoiteta myöhemmin. Se ladataan FTP:llä käytettävään skin-hakemistoon.
      • Alatunniste - Muu HTML-sisältö. Esim. skripti joka seuraa asiakkaan toimintoja sivuilla.
  • Yhteydenoton sähköpostiosoitteet
  • Yhteystiedot
  • Myynnin sähköpostiosoitteet ja sähköpostien mallipohjat
  • Toimitusasetukset

Luettelon (Catalog) tekeminen[muokkaa]

Tässä käydään läpi kuinka verkkokauppaan lisätään tuotteet.

Järjestys: perusasetukset --> luokat --> ominaisuudet --> ominaisuuskokoelmat --> tuotteet

Perusasetukset[muokkaa]

Perusasetukset asetetaan järjestelmän asetuksissa ja usein niitä voidaan muuttaa luokka- ja tuotekohtaisesti. Asetussivun yläkulmasta valitaan mihin asetukset vaikuttavat.

  • Järjestelmä > Asetukset > Luettelo > Luettelo
    • Tuoteluettelon järjestys: Paras arvo on kauppiaan siksi asettamia tuotteita.
    • Käytä tasoitettua luetteloa luokista (Flat Catalog Category) - tekee tietokannassa olevista useista luokkatauluista yhden, joka lisää tehoa kaupan puolella. Suositusarvo Kyllä.
    • Käytä tasoitettua luetteloa tuotteista (Flat Catalog Product) - tekee tietokannassa olevista useista tuotetauluista yhden, joka lisää tehoa kaupan puoella. Suositusarvo alle 1000 tuotetta on Ei.
    • Salli dynaamiset median osoitteet tuotteissa ja luokissa (Allow Dynamic Media URLs in Products and Categories)- Ei saattaa parantaa tehokkuutta.
    • Kerroksittainen navigaatio (Layered Navigation): Kuinka kerroksittaisen navigaation (katso alempana mitä tarkoittaa) hinnan porrastus lasketaan.
    • Use Canonical Link Meta Tag For Categories/Products:
    • Hakutyypeissä Lähellä (Like) sanat jotka ovat lähellä haettavaa. Tarkka (Fulltext) sanat jotka ovat tarkasti hakuehto.

Luokat[muokkaa]

Tuotteet ryhmitellään luokkiin. Luokat muodostavat verkkokaupan rakenteen ja muodon. Jokaisella kaupalla on juuriluokka, jonka alapuolelle rakentuvaat alaluokat. Tuote voi kuulua useampaan luokkaan samanaikaisesti. Harmaalla näkyvät luokat on käytöstä poissa olevia luokkia.

  • Luettelo > Luokat
  • Juuriluokan lisäämiseen valitse kauppanäkymäksi oletusasetukset.
  • Alaluokkien lisääminen tapahtuu valisemalla ensin luokka, jonka alle se halutaan lisätä.
  • URL-avain (URL key): tyhjäksi jätettäessä Magento luo sen itse. Jos syötät itse, älä käytä välilyöntejä.
  • Kuva: Ilmestyy luokan nimen ja sisällön väliin.
  • Näkymäasetukset: kuinka luokka näkyy asiakkaalle.
  • Mukailtu ulkoasu: Muutoksia sivun ulkoasuun, jotka vaikuttavat tähän luokkaan ja jos valittu tämän luokan alaluokissa erikseen, myös niihin.
    • Mukailtu sommittelu (Custom Layout Update): staattinen lohko, rakenne XML-muodossa, ilmestyy sivun alaosaan tuotteiden alapuolelle (kun taas muuttumaton sisältölohko tuotteiden yläpuolella).
  • Sijainti (position) kenttään voi määritellä tuotteiden järjestyksen kun järjestetään arvolla Best Value. Esim. 1 tai 2 tai muu kokonaisluku.

Kerroksittainen navigaatio[muokkaa]

Layered Navigation. Kuinka asiakas löytää nopeasti etsimänsä tuotteen lukuisten tuotteiden joukosta? Magentossa on mahdollisuus tarjota Selaa (Shop by)-lohko, jossa asiakas voi suodattaa tuotteita eri ominaisuuksien avulla ja näin päätyä näkemään vain tuotteet, jotka täyttävät hänen asettamansa ehdot. Lohko näkyy luokka-sivuilla, johon tulostuu kyseiset tuotteet. Oletuksena näkyy kaksi arvoa, hinta ja luokka, mutta ominaisuudet -asetuksissa kullekin ominaisuudelle voidaan lisätä näkyvyys lohkoon.

  • Is Anchor: Luokan asetuksissa. Ei-valinta näyttää alaluokat Selaa-lohkossa (Shop-by) sivupalkissa. Kyllä-valinta näyttää kyseisen alaluokat Vaihtoehdot-lohkossa.
  • Ominaisuuksissa:
    • Suodatettava (tuloksellinen) tarkoittaa että linkit näkyvät vain arvoille, joissa tulosten määrä on suurempi kuin nolla. Eli vain ominaisuusarvoja jotka vastaavat olemassaoleviin tuotteisiin luettelossa käytetään kerroksellisessa navigaatiossa.
    • Suodatettava (ei tuloksia) tarkoittaa että linkit näkyvät tulosten määrästä riippumatta. Eli kaikki ominaisuuden arvot jotka on luotu ominaisuuden Nimet ja vaihtoehdot (Manage Label / Options) -välilehdessä listataan.
    • Jotta ominaisuus näkyy kerroksellisessa navigaatiossa, ominaisuudessa syöttömuoto kauppiaalle täytyy olla pudotusvalikko, monivalinta tai hinta.

Ominaisuudet[muokkaa]

Ominaisuus on tuotteen jokin ominaisuus eli esimerkiksi nimi, kuva, tuotenumero, väri, valmistaja jne. Näiden avulla asiakas voi etsiä ja vertailla tuotteita. Järjestelmäominaisuuksia (system attributes) ei voi poistaa. Ominaisuuksien määrää ei ole rajoitettu. Ominaisuudet ryhmitellään ominaisuuskokoelmiksi, joita käytetään samanlaisille tuotteille. Esimerkiksi ominaisuuskokoelmia voivat olla televisiot ja kengät, jotka kumpikin sisältävät erilaisia ominaisuuksia pakollisten lisäksi.

  • Luettelo > Ominaisuudet > Ominaisuudet
  • Ensiksi tulisi määritellä ominaisuudet ja sitten ominaisuuskokoelmat ja yhdistää ominaisuudet ominaisuuskokoelmiin.
  • Syöttömuoto kauppialle: Kaikkia vaihtoehtoja ei voi käyttää kerroksellisessa navigaatiossa.
  • Salli HTML-tagit kaupan puolella: Sallii käyttää ominaisuuden arvoissa html-tageja.
  • Ominaisuudelle on mahdollista antaa eri vaihtoehtoja pudotusvalikko ja monivalinta -syöttömuodoissa.

Ominaisuuskokoelmat[muokkaa]

Katso selitys kohdasta Ominaisuudet. Sisältää pakolliset järjestelmäominaisuudet ja valinnaiset itse lisätyt ominaisuudet tuotteen mukaisesti. Samoja ominaisuuksia voidaan käyttää useissa eri ominaisuuskokoelmissa. Olemassaolevia ominaisuuskokoelmia voidaan käyttää pohjana uudelle ominaisuuskokoelmalle.

  • Vain ominaisuuskokoelmia voidaan liittää tuotteisiin, ei yksittäisiä ominaisuuksia.
  • Luettelo > Ominaisuudet > Ominaisuuskokoelmat
  • Oletus (Default) -ominaisuuskokoelma sisältää pääasiassa järjestelmäominaisuuksia.
  • Pakollinen järjestelmäominaisuus sisältää punaisen merkin pienoiskuvakkeessa.
  • Ominaisuuksia siirrellään hiirellä vetämällä.
  • Ryhmät edustavat jokainen eri välilehteä ylläpidon tuotesivulla. Oletusryhmiä on kuusi. Ryhmän voi poistaa, jos se ei sisällä järjestelmäominaisuuksia. Ryhmien järjestys vaikuttaa välilehtien järjestykseen tuotesivulla.

Tuotteet[muokkaa]

Tuotetyyppi (Product type)[muokkaa]

  • Yksinkertainen tuote (Simple product) - perustuotetyyppi, yleensä sellainen fyysinen tuote, jonka voi lähettää.
  • Ryhmätuote (Grouped) - Samankaltaisten tuotteiden näyttäminen samalla sivulla. Esim. saman tuotteen eri koot näkyville samalla sivulla, joista asiakas valitsee haluamansa ostoskoriin. Tai esim. sohvaryhmä, josta asiakas voi valita montako yksittäin istuttavaa nojatuolia tai muuta sohvaryhmään sisältyy. Ryhmälle ei ole hintaa, vaan se muodostuu yksittäisten tuotteiden hinnasta, mitä asiakas valitsee.
    • Ryhmätuotetta luotaessa, ilmestyy välilehti liitännäistuotteet, jossa valitaan aikaisemmin luodut muut tuotteet ryhmään. Tuotteille voi asettaa oletusmäärän ja järjestyksen sivulla.
  • Muokattava tuote (Configurable product) - Asiakas valitsee tuotetta ostaessaan eri tuotteista sopivan, esimerkiksi vaatteen värin ja koon mukaan. Tällöin muodostetaan kaikista vaihtoehdoista oma tuote, omalla tuotenumerollaan jotta pystytään ylläpitämään varastokirjanpitoa tuotekohtaisesti. Ja sitten nämä eri tuotteet yhdistetään yhdeksi muokattavaksi tuotteeksi jossa asiakas valitsee sopivan tuotteen ja lisää ostoskoriin.
    • Samantyyppisen toiminnon saa aikaiseksi yksinkertaisessa tuotteessa käyttämällä muokattavat vaihtoehdot (Custom Options) -toimintoa, mutta tällöin varastonarvoa ei voida hallita, eikä ole mahdollisuutta suoraan siirtyä tuotteeseen valituilla arvoilla, eikä tämä ole hakukoneystävällinen vaihtoehto. Näkyvyys riippuu ryhmistä joita olet luonut ominaisuuskokoelmat -toiminnolla. Pakolliset arvot on aina täytettävä.
    • Muokattava tuote yhdistetään muihin tuotteisiin ominaisuuksilla joita asiakas voi valita muokattavan tuotteen sivulla. Jokaiselle ominaisuusvaihtoehdolle on oltava oma tuote.
  • Aineeton tuote (Virtual product) - Ei vaadi toimitusta tai varastoa. Esim. palvelu tai takuu
  • Ladattava tuote (Downloadable product) - digitaalisesti ladattava tuote joka sisältää yhden tai useampia tiedostoja ja mallitiedostoja tiedostoista. Voivat sijaita verkkokaupan palvelimella tai toisella palvelimella.
  • Yhdistelmätuote (Bundle product) - Tuote joka myyntitilanteessa rakennetaan asiakkaan tarpeiden mukaiseksi useasta erillisestä tuotteesta. Esim. tietokone voidaan kasata eri komponenteista ostovaiheessa.

Muita käsitteitä[muokkaa]

  • Samankaltainen tuote (Related product) - Katsottavaan tuotteeseen liittyvät muut tuotteet, jotka asiakasta voisivat kiinnostaa. Näkyy esim. laatikossa sivupalkissa.
  • Ehdotettava tuote (Cross-sell) - Samantyyppiset tuotteet ostoskorisivulla.
  • Vaihtoehtoinen tuote (Up-sell) - Tarjotaan asiakkaalle valitsemansa tuotteen vaihtoehtona. Näkyy esim. tuotesittelysivun lopussa.

Ohjeita[muokkaa]

  • Osa tuotesivuilla näkyvistä nimistä tulee suomenkielisestä käännöksestä ja osa ominaisuuksista.
  • Erikoishinta (Special Price): alennus, kampanja.
  • Cost: Käytetään vain ylläpidon puolella esimerkiksi muodostettaessa marginaali ja voitto raportteja.
  • Minimum Advertised Price (MAP)
    • Näytä todellinen hinta (Display Actual Price)
    • Valmistajan ehdottama jälleenmyyntihinta (MSRP)
  • Kuvat: voi ladata useamman kuvan kerralla paikalliselta koneelta. Esimerkiksi 370 x 370 kuvaa voidaan pitää vähimmäisvaatimuksena. Katso myös artikkeli suositelluista verkkokaupan kuvista yleensä.
    • Järjestys: Missä järjestyksessä kuvat ovat kun niitä on useampia
    • Miniatyyrikuva: näytetään ostoskorissa ja samankaltaisissa tuotteissa. Koko 50 x 50 px.
    • Pieni kuva: näytetään luokkaluettelossa, kauppalistassa jne. Koko 370 x 370 px.
    • Peruskuva: suuri tuotekuva jota voidaan zoomata. Koko 370 x 370 px.
      • Lisäksi Magento suosittelee että tuotteen lisäkuvat ovat 470 x 470 px. ja jos ne ovat zoomattavia 1100 x 1100 px.
    • Sulje pois: ei näytä kuvaa slideshow:ssa ja enemmän kuvia galleriassa
  • Ulkoasu: Katso kohdasta Luokat
  • Osamaksu (Recurring Profile): Käytössä vain PayPal Express Checkout maksutavassa. Oletuksena ilmestyy vain yksinkertaiset ja aineettomat tuotteet. Voidaan muuttaa myös muille tuotetyypeillemuuttamalla asetusta Enable Recurring Profile. Asetuksetsivulla??
  • Varasto
    • Ostoskorin vähimmäis/enimmäistuotemäärä: Voidaan rajoittaa esimerkiksi tilantieta joissa toiset kauppiaat yrittävät ostaa edulllista tuotetta ylenmäärin myydäkseen niitä sitten itse.
    • Määrä desimaaleina: Asiakas voi määrittää tarkan määrän, esim. 3.5 metriä mattoa
    • Jälkitoimitukset (Backorders): Voiko asiakas tilata tuotteen jota ei ole varastossa. Toiminnon voi asettaa ilmoittamaan asiakkaalle ostoskorissa että tilaus voidaan tehdä ja toimitetaan jälkitoimituksena vaikka tuotetta ei ole varastossa. Aseta saatavuus kohtaan arvo Varastossa.
    • Erämyynti (Enable Qty Inrements): Myydäänkö tuotetta muutoin kuin yksittäin, esimerkiksi viinipullolaatikoittain jossa on kuusi.
  • Samankaltaiset, vaihtoehtoiset, ehdotettavat tuotteet: Tyhjennä suodattimet ja paina haku jos haluat kaikki tuotteet näkyviin.

Muokattava tuote (configurable product)[muokkaa]

  1. Luo muokattavalle tuotteelle ominaisuus jota tai joita voidaan muokata eli asiakas voi valita haluamansa. Esimerkiksi keltainen S hattu, punainen XL hattu.
    1. Ominaisuuden tiedot > Nimikkeet ja vaihtoehdot > Vaihtoehdot. Vain tällä tavoin saat näkyviin tuotteet pudotusvalikkoon.
  2. Liitännäistuotteita ei tarvitse olla etukäteen tehty, vaan ne voidaan luoda muokattavan tuotteen yhteydessä. Nämä liitännäistuotteet asetetaan etteivät ne näy yksittäin. Niillä on oma varastoarvonsa. Lisäysvaihtoehtoja on useita:
    1. Luodaan tuote ja siitä muodostetaan muokattavat tuotteet kopiona yläreunan painikkeella monista.
    2. Valitse liitännäistuotteet (Associated Products)
      1. Lisää tyhjä: Avaa ponnahdusikkunan, jossa on valmiiksi valittuna yksinkertainen tuote ja sama ominaisuuskokoelma kuin muokattavalla tuotteella.
      2. Kopioi muokattavasta: Avaa ponnahdusikkunan kuten edellä, mutta tuotteen tietoja on kopioitu muokattavasta tuotteesta. Joten täydennä muokattavan tuotteen tiedot ennen.
      3. Nopea yksinkertaisen tuotteen lisäys: Tämä vaihtoehto lisää tuotteita vielä nopeammin kuin edelliset vaihtoehdot.
      4. Tuotteen ominaisuuden lisäyksen asetukset (Super): Mahdollisuus määrittää ominaisuuden nimi joka näkyy asiakkaalle valittavana ja hinnan jokaiselle vaihtoehdolle. Hinnat voidaan esittää kiinteä tai prosenttiosuus. Muokattavan tuotteen hinta on yhdistelmä hinta-välilehden hinta-kentästä ja tässä olevasta arvosta. Vaihtoehtoina käytettävien tuotteiden hinnat eivät siis muutu asiakkaan katsoessa tuotesivua, vaan nämä arvot aiheuttavat automaattisen muutoksen heti asiakkaan nähtäville. Varaston arvo kyllä huomioidaan. Tuotteessa oleva hinta Esimerkiksi jos tuotteen hinta on 20 ja tässä on valittu prosenttiosuus ja 10, on tuotteen hinta 22. Liitettyjen tuotteiden hintoja ei käytetä laskennassa.

Tuote ei ilmesty[muokkaa]

Tuotteen saamiseksi kauppaan näkyviin on joskus työn ja tuskan takana. Yksikin virheellinen asetus voi estää näkymisen. Jos ei onnistu ja epäilet että ohjelmassa on vika, suosittelen taukoa verkkokaupan ääreltä ja palaamista uusin hoksottimin. Seuraava lista kannattaa käydä huolellisesti läpi:

  • Tuote / Yleinen / Tila: Käytössä
  • Tuote / Yleinen / Näkyvyys: Luettelo, haku
  • Tuote / Varasto / Saatavuus: Varastossa TÄMÄ UNOHTUU HELPOSTI
  • Tuote / Sivustot / Tarkista että näkyy kyseisessä kaupassa
  • Tuote / Luokat: Jossain luokassa, jonka sivu tulostaa luettelon
    • Etusivulla esimerkiksi seuraava kun vaihdat siihen vain sopivan luokan jonka haluat esille
 {{block type="catalog/product_list" category_id="4" template=catalog/product/list.phtml}} 
  • Jos käytössä useampi sivusto, tarkista että olet selaimella oikealla sivustolla
  • Tarvittaessa tyhjennä välimuisti ja indeksoi
  • PATCH-6788 jälkeen etusivulta katoaa tuotteet tai ehkä voi muualtakin.
    • Katso CMS > Etusivu > Sisältö > block type -nimi, esim. catalog/product_list
    • Järjestelmä > Oikeudet > Blocks > Lisää uusi sisältölohko catalog/product_list ja Allowed

Tuote ilmestyy, mutta ei ostettavissa[muokkaa]

  • Eristyisesti muokattavissa tuotteissa, joihin on liitetty yksinkertaisia tuotteita, (jotka sisältävät varastoarvon).
  1. Muista valita vaihtoehdoista joku tuote oletus -arvoiseksi.
  2. Todennäköinen syy on indeksointi. Muista että jos indeksoit Luettelon uudelleenohjaukset, menetät manuaaliset, joten jätä se pois indeksoinnista, koska se ei suurella todennäköisyydellä liity tähän ongelmaan.

Muita asetuksia[muokkaa]

  • Kauppahierarkia.
  • Verot
  • toimitukset
  • Maksutavat
  • Ulkoasu ja sisältö
    • (Block)
    • (Content block) vaihtuva sisältö jonka ohjelma tuottaa
    • (CMS) sivuja joita voi käyttää kaupassa
    • Sommitelma (Layout) File that maps content blocks to structural blocks.
    • (Skin file) File that define the visual functional specifications of page elements, such as text, graphics, and the logic behind buttons and other controls.
    • (Structural block) Block created for the sole purpose of assigning visual structure to a store page; for example, header, footer, left column, main column.
    • (Template)
    • (Theme) Skin file ja templale kokoelma.
  • Kampanjat (Promotions)
  • Laskutulosteeseen saat yrityksen tiedot kohdasta Järjestelmä/Asetukset/Myynti/Laskun ja lähetyslistan ulkoasu/Osoite. Ei näy toimitettavassa sähköpostissa.

Evästeet[muokkaa]

  • Järjestelmä > Asetukset > Internet > Istunnon evästeet löytyy kohta, jossa valitaan ilmestyykö evästeistä ilmoitus ruudun ylälaitaan asiakkaan tiedoksi.
  • Vaihtoehtoisesti voi asentaa esimerkiksi EU Cookie Law Compliance - Implied Consent -lisäosan, joka antaa enemmän mahdollisuuksia muokata palkin näkyvyyttä.
  • Huomaa että joudut tyhjentämään selaimen asetuksista evästeen testatessasi evästeen toimintaa. Tämä vaatii myös kirjautumisen uudelleen ylläpitoon. Asia hoituu paremmin kun käytät kahta eri selainta, esimerkiksi Safaria ja Firefoxia ylläpidolle ja kaupalle.
  • Lisätietoa esimerkiksi sivulta http://www.ico.org.uk/for_organisations/privacy_and_electronic_communications/the_guide/cookies

Vinkkejä[muokkaa]

Addon Domain[muokkaa]

  1. Magento sijaitsee www.osoite1.fi/magento -hakemistossa
  2. Addon domain jonka halutaan näkyvän selaimen osoiterivillä on www.osoite2.fi
  3. Lisää asetuksissa salaamaton juuriosoite http://www.osoite2.fi/
  4. cPanel asetuksissa Addon Domains www.osoite2.fi :lle on /public_html/magento

Alatunniste[muokkaa]

Sivun alatunnisteeseen ilmestyviä linkkejä voi poistaa. Seuraavassa ohje:

http://www.magentocommerce.com/magento-connect/call-for-price-hide-price.html

Automaattinen alatunnisteen vuosiluvun muutos[muokkaa]

Jotta ei joka vuosi tarvitse muistaa...

  1. Järjestelmä > Asetukset > Yleinen > Ulkoasu > Alatunniste > Tekijänoikeudet
  2. Lisää seuraava tekijänoikeusmerkin puolipisteen jälkeen
<script type="text/javascript">
var d = new Date();
document.write(d.getFullYear())
</script>
  • Tyhjennä välimuistit

Bannerin lisäys sivupalkkiin[muokkaa]

  • Checkout -sivulle muutos täytyy tehdä ulkoasun koodiin. Katso kohta Muuttumattoman sisältölohkon lisäys.
  • Muutoin luo banneri muuttumattomaksi sisältölohkoksi
  • Lisää leijuke (widget), johon määrittele näytettäväksi edellä tekemäsi sisältölohko ja sitten valitse mille sivulle/sivuille ja mihin kohtaan sivua se tulee näkyviin.

Captcha ei ilmesty suomeksi[muokkaa]

Lisää tiedostoon app/code/core/Mage/Captcha/etc/config.xml seuraavat rivit <frontend> kohtaan ja <adminhtml> kohtaan, kummassakin </layout> tagin jälkeen.

<translate> 
<modules> 
<Mage_Captcha> 
<files> 
<default>Mage_Captcha.csv</default> 
</files> 
</Mage_Captcha> 
</modules> 
</translate>

Etusivu -linkki ei toimi ja Base_url[muokkaa]

  • Jos navigaatiopolun Etusivu-linkki tai logon linkki ei toimi vaan ohjaa palvelimen juureen, pikakorjaus on asettaa Ei kohtaan Järjestelmä / Asetukset / Yleinen / Internet / Hakukoneiden optimointi / "Käytä palvelimen osoitteen uudelleenkirjoittamista" ja tyhjennä välimuisti.
  • MUTTA jos todella haluat korjata ongelman ja pitää siis osoiterivin helposti luettavana, niin katso sivulta .htaccess ohjeet kuinka /magento -kansioon ohjataan. Tämä tilannehan syntyy esimerkiksi että magento ei ole domainisi juuressa vaan juuren alihakemistossa esim. public_html/magento/index.php
  • Asetusksissa ei voi asettaa juuriosoitteeksi /magento/index.php/ vaan sen täytyy loppua /magento/
  • Paljon tietoa aiheesta: http://www.solvingmagento.com/magento-url-rewrites/

Euroopan unioni[muokkaa]

Tilanne 5/2016

Ahvenanmaa (1995)
Alankomaat (1958)
Belgia (1958)
Britannia (1973)
Bulgaria (2007)
Espanja (1986)
Irlanti (1973)
*Islanti (ei jäsenmaa)
Italia (1958)
Itävalta (1995)
Kreikka (1981)
Kroatia (2013)
Kypros (2004)
Latvia (2004)
* Liechtenstein (ei jäsenmaa)
Liettua (2004)
Luxemburg (1958)
Malta (2004)
*Norja (ei jäsenmaa)
Portugali (1986)
Puola (2004)
Ranska (1958)
Romania (2007)
Ruotsi (1995)
Saksa (1958)
Slovakia (2004)
Slovenia (2004)
Suomi (1995)
*Sveitsi (ei jäsenmaa)
Tanska (1973)
Tšekki (2004)
Unkari (2004)
Viro (2004)

Facebook[muokkaa]

Suositeltava AddThis laajennusosa.

  • Eräs esimerkki: muuttumaton sisältölohko, joka leijukkeella (widget) laitetaan näkymään sivupalkkiin.
<p><span style="color: #3e59a1;"><a href="https://www.facebook.com/nimitähän" target="_blank"><span style="color: #3e59a1;"><strong>Otsikkoteksti tähän</strong></span></a></span></p>
<p><iframe style="border: none; overflow: hidden; height: 35px;" src="//www.facebook.com/plugins/like.php?href=http%3A%2F%2Fwww.osoite.fi&width&layout=button&action=like&show_faces=false&share=true&height=35" frameborder="0" scrolling="no" width="320" height="240"></iframe></p>
https://developers.facebook.com/docs/plugins/like-button
https://developers.facebook.com/docs/plugins/checklist
https://developers.facebook.com/docs/plugins/like-button
http://www.customfitonline.com/news/2013/2/27/how-to-use-facebooks-open-graph-tags/

Favicon ikonin vaihtaminen[muokkaa]

  • /skin/install/default/default/favicon.ico
  • /skin/frontend/default/KÄYTTÄMÄSITEEMA/favicon.ico

Google Merchant, Google shopping[muokkaa]

  • Useat laajennokset ovat ilmaisia, mutta niiden käyttäminen vaatii rekisteröitymistä laajennoksen tarjoajan palveluun ja kuukausimaksun maksamista. Ilmainen on esim. Googlemerchants Feed Generator.

Istuntojen ja välimuistin tyhjentäminen[muokkaa]

cPanelin tiedostohallinnan kautta tai pääteohjelmalla. Suositeltavaa on tehdä se Järjestelmä > Välimuisti > Tyhjennä Magenton välimuisti. Pääteohjelmalla seuraavasti, jos esimerkiksi et pääse kirjautumaan ylläpitoon.

cd magento/var/sessions
rm -rf *
cd magento/var/cache
rm -rf *

Kuvan alkuperäinen osoite[muokkaa]

Alkuperäistä kuvan osoitetta, ei siis välimuistihakemistossa olevaa, voi käyttää esim. Google Merchant -palvelussa.

  • Tuotteenmuokkaus -sivun alareunaan peruskuvan osoite
    • Oheisen skriptin sijainti edit.phtml -tiedoston loppuun /magentojuuri/app/design/adminhtml/default/default/template/catalog/product/edit.phtml
<?php 
$productId = $this->getProductId();
$product = Mage::getModel('catalog/product')->load($productId);
$productMediaConfig = Mage::getModel('catalog/product_media_config');
echo "Kuvan osoite: ", $baseImageUrl = $productMediaConfig->getMediaUrl($product->getImage()); ?>
  • Tuotesivulle kuvan osoite:
    • /magentojuuri/app/design/frontend/default/teemannimi/template/catalog/product/view.phtml
<?php $productId = $_product->getId();
$product = Mage::getModel('catalog/product')->load($productId);
$productMediaConfig = Mage::getModel('catalog/product_media_config');
echo "<br><small>Kuvan osoite: ", $baseImageUrl = $productMediaConfig->getMediaUrl($product->getImage()),"</small>"; ?>
  • Tuotesivulle välimuistihakemistossa oleva osoite:
<?php echo $_product->getImageUrl(); ?>
  • Valinnaisesti eri kuvakoot:
echo $smallImageUrl = $productMediaConfig->getMediaUrl($product->getSmallImage());
echo $thumbnailUrl = $productMediaConfig->getMediaUrl($product->getThumbnail());

Kuvan lautauspainikkeet katoavat[muokkaa]

Versio 1.6.2. ja Safari selain. Tuotteen kuvien latauspainikkeet katoavat yhtäkkiä. Lopeta kokonaan Safari (älä vain sulje) ja käynnistä uudelleen. Kokeile toisella selaimella, esimerkiksi Firefoxilla tai Chromella ja kenties toimii.

Lisää ostoskoriin arvo[muokkaa]

Näkyvä arvo on oletuksena nolla, mutta voidaan muuttaa ykköseksi Järjestelmä > Varasto > Tuotteiden varastoasetukset > Ostoskärryn vähimmäistuotemäärä. Vaikka painaakin nolla-arvolla, Magento muuttaa sen yhdeksi.

Logon vaihtaminen[muokkaa]

  • jos Järjestelmä/Asetukset/Ulkoasu/Maksutapahtuman sähköpostit kohdassa asetettu logo ei näy asiakkaalle lähetetyissä sähköposteissa oikein.
  • logot löytyvät hakemistosta /skin/frontend/default/default/images tai /skin/frontend/default/käyttämäsi teeman nimi/images tai /skin/frontend/base/default/images
  • tiedostot ovat logo.gif ja logo_email.gif ja logo_print.gif
  • tyhjennä välimuisti
  • sivun logo määritellään kohdassa Järjestelmä/Asetukset/Ulkoasu/Ylätunniste
  • jos et löydä missä logo sijaitsee, käytä apuna tämän sivun ylälaidassa olevaa neuvoa kohdassa Virheiden etsintä. Voit myös etsiä esimerkiksi sähköpostista katsomalla sähköpostin lähdekoodia, siellä näkyy mistä kuva haetaan html-viestiin.

Huom! Jos käytät Mac OS Mail-ohjelmaa, saattaa olla että kuva eivät jostain syystä välttämättä muutu vaan vanha logo näkyy sähköpostissa. Joogaa vaikka puoli tuntia ja ongelma saattaa ratketa (tosielämästä) tai ehkä roskakoriin ja roskakorin tyhjennys sähköpostien osalta jotka sisältävät logon tai Mailin uudelleenkäynnistys saattaa auttaa nopeammin. Se että tyhjentää välimuistia ja tekee muuten ohessa kerrotut eivät vain tunnu auttavan.

Lokitiedosto[muokkaa]

  • Löytyy /var/log/system.log
  • /var/log/exception.log
  • php koodiin
Mage::Log($destinationFolder) ) {
            //or
            var_dump($destinationFolder); 

Lue lisää (Read more) linkki[muokkaa]

Syntyykö tilanne että luokan kuvaus on niin pitkä että tuotteet eivät näy. Tai haluatko lyhentää minkä tahansa tekstin niin että sen jaa klikkauksesta vasta laajenemaan. Tämän voi toteuttaa näyttämällä sopivan määärän tekstiä kuvauksesta ja lisäämällä sen jälkeen Lue lisää... -linkki. Linkkiä painettaessa sisältö aukeaa samalle sivulle. Katso tästä esimerkki.

  1. Käytetään readmore.js -skriptiä osoitteesta http://jedfoster.com/Readmore.js Sivulta löytyy linkki GitHub -sivulle, jossa oikeassa reunassa Download ZIP
  2. Asenna (esimerkiksi) hakemistoon /js/readmore/readmore.js
  3. Käännä em. tiedoston alussa tekstit suomeksi Lue lisää... ja Sulje
  4. Lisää app/design/frontend/base/default/layout/page.xml tiedostoon mage/cookies.js jälkeen <action method="addJs"><script>readmore/readmore.js</script></action> ja tyhjennä välimuisti ja tarvittaessa JavaSkriptivälimuisti.
  5. Tarkista että käytössä on sopiva jquery. Muutoin homma ei toimi. Ehkä helpoin tapa on katsoa selaimen verkkoinspektorilla tms. skriptit jotka latautuvat sivua haettassa. jquery.min.js ei ilmeisesti ole riittävä vaan tiedoston pitää olla esimerkiksi muotoa jquery-1.11.1.js
    1. Jos sitä ei ole lataa jquery sivustosta jquery.com ja asenna esim. /js/jquery/ -hakemistoon
    2. Tee sinne myös tekstitiedostona jquery-1.11.1.noconflict.js -tiedosto, johon tallenna seuraava: var jq = jQuery.noConflict(); Huomaa että juuri tätä jqueryversiota kutsutaan nyt jq -muuttujalla. Jos et lisää tätä, niin on mahdollista että Magentoon muutoin asennetut jqueryt, esimerkiksi teemaa varten voivat aiheuttaa konflikteja. Esimerkiksi java-ylävalikko ei ilmesty.
    3. Lisää jquery page.xml sivulle mage/cookies.js jälkeen (vaihda tarvittaessa versionumerot): <action method="addJs"><script>jquery/jquery-1.11.1.js</script></action> ja <action method="addJs"><script>jquery/jquery-1.11.1.noconflict.js</script></action>
  6. Älä avaa ylläpidossa Wysiwyg-editoria vaan koodi ja lisää seuraavat:
    1. Lisää sen tekstin ympärille div-tagit jotka haluat piilottaa: <div class="luelisaa"> teksti tulee tähän </div>
  7. Lisää loppuun seuraava koodin pätkä. maxHeight arvoksi voidaan asettaa pixeleitä, joilla säädetään enimmäiskorkeus mitä näytetään tekstistä kun se on piilotettuna. Nolla-arvolla piilotetaan kaikki. Jos muutat readmore.js tiedostoon maxHeight arvoksi 0, ei kutsuttaessa tarvitse asettaa arvoa. Huomaa, että nyt kutsutaan jq:lla, joka asetettiin aiemmin muuttujaksi.
<script type="text/javascript">
         jq('.luelisaa').readmore({maxHeight:0, moreLink: '<a href="#">Lue lisää tai vapaavalintainen teksti tähän...</a>'});  
    </script>
  • Jos haluat kokeilla latautuuko ja toimiiko jquery, lisää jquery-1.11.1.noconflict.js -tiedostoon:
jq(document).ready(function()
                   {
                   alert('Tämä ponnahdusikkuna ilmestyy koska jquery.functions.js -tiedosto toimii');
                   });

Jos ei toimi[muokkaa]

  • Jos ilmenee sellainen vika, jossa vain osa tekstistä avautuu, tarkista maxHeight arvo, mutta jos sekään ei auta, niin seuraava voi tulla kyseeseen:
    • Ohjelmassa on ilmeisesti bugi, mutta sen pystyy korjaamaan lisäämällä /js/readmore/readmore.js -tiedostoon riville 95 seuraavan koodin. Eli lisää $(window).on('resize', function(event) { yläpuolelle. Tyhjennä tämän jälkeen välimuisti ja tarvittaessa myös Java-välimuisti. Tämä ohje löytyi https://github.com/jedfoster/Readmore.js/pull/57
$(window).on('load', function(event) {
   $this.resizeBoxes();
});
http://jedfoster.com/Readmore.js/
http://stackoverflow.com/questions/24876420/how-to-add-jquery-readmore-function-expand-collapse-to-magento-cms-pages
http://www.websitemagazine.com/content/blogs/posts/archive/2013/07/18/expand-amp-collapse-text-blocks-easily-with-readmore-js.aspx
If elements have a max-height CSS property, the Readmore.js plugin will use that value instead of the value of the maxHeight option.

Magento Connect[muokkaa]

  • Paketin päätteen muoto on .tgz
  • Jos saat virheilmoituksen, eikä asennus onnistu, yritä ladata tiedosto Firefox:lla. Esim. Safari saattaa korruptoida tiedo
  • Muistathan aina ottaa kokoamisen asennuksen ajaksi pois ja varmuuskopiot!

Maintenance.flag[muokkaa]

Juurihakemistoon asetettu maintenance.flag tiedosto estää sekä asiakkaita että ylläpitoa käyttämään verkkokauppaa.

  • Jos haluat päästä kuitenkin kirjautumaan ylläpitoon ja nähdä itse ylläpitäjänä etusivun samalla kun asiakkaat eivät voi käyttää verkkokauppaa, lisää seuraava index.php -tiedostoon. Katso esim. Googlella "my ip", mikä on IP-osoitteesi sillä hetkellä ja muuta se oheiseen koodiin numeroina.
# Maintenanceflagin ohittaminen
$ip = $_SERVER['REMOTE_ADDR'];
$allowed = array('minun.oma.ip.tähän');
Korvaa: if (file_exists($maintenanceFile)) {
Rivillä: if (file_exists($maintenanceFile) && !in_array($ip, $allowed)) {
  • Jos haluat korvata tekstin, joka ilmestyy, se löytyy hakemistosta /errors/default/503.phtml ja logo /errors/default/images sisältää logo.gif
  • Katso myös kohta "Service Temporarily Unavailable"

Maksupalvelut[muokkaa]

Verkkokauppaan pystyy kytkemään maksupalvelun ja moduulin myös ilmaiseksi! Maksat vain asiakkaan käyttäessä palvelua hiukan korkeamman hinnan.

  • Checkout Finland Oy tarjoaa ilmaisen verkkopankkimaksut ja luottokortit, mutta veloitus käytöstä on hiukan suurempi. Vaihtoehtona on kuitenkin paketit, joissa on kuukausimaksu, mutta sitä ei laskuteta jos myyntiä ei tule sen verran. Kun palvelun tilaa Aivomatic -yrityksen kautta, saa Magenton lisäosan käyttöön ilmaiseksi. Erittäin suositeltava kokonaisuus, joka kytketään nopeasti ja asiakaspalvelu on ollut nopeaa. (2014).
    • Asiakkaan hyväksyessä tilauksen, on ilmennyt Magento 1.8.0.0 version ja FipnMgChk-1.3.1 ja Fipn-1.13.0 kanssa. Kannattaa kokeilla onko merkitystä, että muuttaa Järjestelmä > Varasto > Tuotteiden varastoasetukset > Ostoskärryn vähimmäistuotemäärä arvoksi 1. Kun tuotteen määrä on 0 ja painetaa ostoskoriin lisääminen, Magento muuttaa kyllä arvon ykköseksi ilman tätäkin.
    • Mahdollisesti yhdistelmä 1.8.0.0 ja FipnMgChk-1.3.1 ja Fipn-1.14.1 ei toimi.
  • Myös muita maksupalveluita tarjoavia yrityksiä on mutta kannattaa tehdä vertailua sekä hinnoittelussa että tarvittavien lisäosien hankintahintojen suhteen.

Maksusivumuutokset[muokkaa]

Katso kohta Muuttumattoman sisältölohkon lisääminen.

Maksusopimuksen ja osamaksusopimuksen poistaminen valikosta[muokkaa]

Kaupan puolella oman tilin valikossa olevat kohdat voi poistaa seuraavasti. Tämä ei poista toimintoja itsessään vaan vain kohdan valikosta.

  • Kopioi osoitteesta /app/design/frontend/base/default/layout/sales/ tiedostot billing_agreement.xml ja recurring_profile.xml kansioon /app/design/frontend/default/käyttämäsiteema/layout/sales/ Perusta tarvittaessa uusi kansio sales
  • Tee seuraavat muutokset billing_agreement.xml -tiedostoon
   <customer_account>
	<reference name="customer_account_navigation" >
		<!--<action method="addLink" translate="label"><name>billing_agreements</name><path>sales/billing_agreement/
 		</path><label>Billing Agreements</label></action>-->
	</reference>
   </customer_account>
  • Tee seuraavat muutokset recurring_profile.xml -tiedostoon
   <customer_account>
	<reference name="customer_account_navigation" >
		<!--<action method="addLink" translate="label"><name>recurring_profiles</name><path>sales/recurring_profile/
		</path><label>Recurring Profiles</label></action>-->
	</reference>
   </customer_account>
  • Tyhjennä välimuisti

Maksutavan lisääminen ylläpitoon[muokkaa]

CE 1.8.0. Maksutavat eivät näy automaattisesti tilausta lisättäessä ylläpidon puolella. Ne täytyy kytkeä erikseen päälle. Huomaa myös että toimitustapa tulee näkyviin vasta sitten kun valitset tuotteen.

  1. Kopioi osoitteesta /app/code/core/Mage/Payment/Model/Method/ haluamasi maksutapa, esimerkiksi Cashondelivery
  2. Jotta Magenton päivityksessä et menettäisi tätä muutosta kannattaa se tallentaa /app/code/local/Mage/Payment/Model/Method/ hakemistoon.
  3. Lisää seuraavat rivit tiedostoon ja tyhjennä välimuisti
    protected $_code  = 'maksutavan nimi vaihtelee tässä kohtaa';

    /* Asetetaan nakyviin vain yllapidon puolelle */
    protected $_canUseInternal = true;
    protected $_canUseCheckout = false;
    protected $_canUseForMultishipping = false;
  • Koodista voidaan nähdä että maksutapa asetettiin näkyviin ylläpidon puolelle, mutta estettiin näkyvyys kaupan puolella.

Mikä tämä on? ei toimi[muokkaa]

Käyttäessäsi jotain muuta ulkoasua kuin Magenton mukana tulevia, saattaa olla että asiakkaiden kirjautumisikkunassa oleva "Mikä tämä on?" ei toimi. Lisää silloin skin/frontend/default/default/css/styles.css tiedostossa oleva seuraava koodi käyttämääsi style.css tiedostoon.

/* Remember Me Popup ===================================================================== */
.window-overlay { background:url(../images/window_overlay.png) repeat; background:rgba(0, 0, 0, 0.35); position:absolute; top:0; left:0; height:100%; width:100%; z-index:990; }

.remember-me label { float:none; margin:0 6px; }
.remember-me-popup { background:#fff; border:1px solid #ccc; left:50%; top:50%; position:absolute; margin:-85px 0 0 -200px; width:400px; text-align:left; -moz-box-shadow:0 0 6px #ccc; -webkit-box-shadow:0 0 6px #ccc; -box-shadow:0 0 6px #ccc; z-index:1000; }
.remember-me-popup h3 { background:#d9e5ee; border-bottom:1px solid #ccc; font-size:14px; padding:5px 10px; }
.remember-me-popup .remember-me-popup-head { position:relative; }
.remember-me-popup .remember-me-popup-head .remember-me-popup-close { background:url(../images/btn_window_close.gif) no-repeat; display:block; position:absolute; top:7px; right:7px; height:15px; width:15px; text-indent:-9999em; }
.remember-me-popup .remember-me-popup-body { padding:10px; }
.remember-me-popup .remember-me-popup-body a { display:inline-block; height:19px; border:1px solid #de5400; background:#f18200; padding:0 8px; font:bold 12px/19px Arial, Helvetica, sans-serif; text-align:center; text-decoration:none; white-space:nowrap; color:#fff; }
/* Remember Me Popup ===================================================================== */

Ponnahdusikkunaan ilmestyvä teksti on englanninkielinen. Se muutetaan suomeksi tiedostossa /app/design/frontend/base/default/template/persistent/remember_me_tooltip.phtml

<h3>Mikä tämä on?</h3>
<p>Valitsemalla "Muista minut" voit kirjautua automaattisesti käyttämälläsi tietokoneella uudestaan omalle tilille kirjauduttuasi verkkokaupasta ulos.</p>

Monikielisyys[muokkaa]

  • Useita asetuksia voi asettaa kauppanäkymäkohtaisesti eli eri kielille.
  • CMS sivut. Kun asetat jokaiselle kielelle saman URL-avaimen kyseiselle sivulle, se vaihtuu kielivalinnan mukaan. 404-sivulla no-route
  • Tuotteen asettaminen näkymään vain tietylle kielelle. Tuotetta ei voi asettaa kauppanäkymässä eli jollekin kielelle pois päältä. Toisin sanoen päällä-arvo koskee kaikkia kieliä. Tämän sijaan yksittäisen tuotteen voi asettaa pois tietystä kielestä valitsemalla ettei se näy luettelossa ja haussa. Tämän negatiivinen seuraus on että asiakkaan tarkastellessa tuotetta ja vaihtaessa kieltä ilmestyy valkoinen sivu. Jos tuote on kummallakin kielellä, tuotteen kieli vaihtuu.


Muokattavan tuotteen lisääminen[muokkaa]

Muokattavan tuotteen kohdalla sekä ominaisuus, ominaisuuskokoelma että tuotteet pitää olla oikein asennettuna!

  • Muokattavan ominaisuuden lisääminen.
    • Luettelo / Ominaisuudet / Lisää uusi ominaisuus
    • Anna koodi, näkymä Globaali, pudotusvalikko, arvot pakollisia ei, Kaikki tuotetyypit, käytä muodostaaksesi muokattava tuote kyllä.
    • Otsikoiden Admin nimi
    • Lisää vaihtoehdot
  • Sijoittaminen ominaisuuskokoelmaan
    • Vedä ominaisuus haluttuun ominaisuuskokoelmaan.
  • Lisää tuote
    • Valitse kyseinen ominaisuuskokoelma ja muokattava tuote
    • Valitse kyseinen ominaisuus
    • Syötä tuotteen perustiedot
    • Varasto Kyllä. Saatavuus Varastossa.
    • Tallenna ja jatka muokkaamista
    • Liitännäistuotteet. Eri vaihtoehtoja syöttää eri ominaisuuksilla olevat tuotteet. Seuraavassa käytety Nopea yksinkertaisen tuotteen lisäys -vaihtoehtoa
      • Jos käytät omia nimiä tai tuotenumeroita, ota raksi pois kohdasta muodosta automaattisesti
      • Näkyvyys: Ei näy yksittäin
      • Valitse ominaisuuden tai useampien poikkava arvo
      • Toista kaikille vaihtoehdoille. Tällä tavoin tuoteluetteloon perustetaan jokaiselle oma tuote, jolla on oma hintansa ja varasto-arvonsa.
    • Tallenna
  • Huom! Valinta näkyy vain kun kyseisen yksilöllisen tuotteen Varasto > Saatavuus on Varastossa ja lukumäärä on vähintään 1. Lisäksi myös muokattavan tuotteen Varasto Kyllä ja Saatavuus Varastossa.

Muokattava tuote ei toimi[muokkaa]

  • Versio 1.6.2 Ohjeiden mukaan lisättäessä muokatava tuote, sitä ei vain yksinkertaisesti saa toimimaan. En tiedä onko kyseessä bugi vai Magento Go -ohje, mutta http://stackoverflow.com/questions/5156021/cannot-associate-simple-products-in-a-configurable -sivulla on nappiin osuva vinkki: "I changed the attribute to be valid for all product types and not mandatory." Eli aseta ominaisuudessa Pakollinen arvo -kohtaan EI ja Ota käyttöön -kohtaan Kaikki tuotetyypit !!

Kuva vaihtumaan tuotevalinnan mukaan[muokkaa]

http://inchoo.net/ecommerce/magento/create-a-color-switcher-in-magento/

Muuttumattoman sisältölohkon lisääminen[muokkaa]

Bannereiden osalta katso kohta Bannerin lisäys sivupalkkiin.

  • Muuttumattoman sisältölohkon lisääminen maksusivuille ei onnistu ylläpidon kautta, vaan se on tehtävä suoraan koodiin. Tee muuttumaton sisältölohko normaalisti ylläpidon puolelle ja käytä tunnistetta koodissa. Jos haluat tekstin laatikkoon, lisää se taulukoon jossa on yksi sarake ja rivi eli yksi solu.
  • Katso onko käyttämässäsi teemassa onepage.phtml tiedostoa osoitteessa: /app/design/frontend/default/teemasinimi/template/checkout ja tee muutos sinne. TAI /app/design/frontend/default/teemasinimi/template/persistent/checkout
  • Jos tiedostoa ei ole siellä tee muutos tiedostoon /app/design/frontend/base/default/template/checkout/onepage.phtml
  • Lisää koodi haluttuun kohtaan esimerkiksi seuraavan alapuolelle, jolloin se ilmestyy heti otsikon jälkeen,
    <h1><?php echo $this->__('Checkout') ?></h1>
Lisää tämä koodi haluttuun kohtaan:
<?php echo $this->getLayout()->createBlock('cms/block')->setBlockId('sisältölohkonnimitähän')->toHtml(); ?>
  • Jos haluat muokata maksusivustoa muuten, esimerkiksi poistaa sisäänkirjautumiseen ja tilin luontiin liittyviä päällekkäisiä tekstejä, muutos tehdään mahdollisesti tiedostoon /app/design/frontend/default/teemasinimi/template/persistent/checkout/onepage/login.phtml
    • poista sopivia echo-rimpsuja jotka tulostavat tekstejä tai lisää niitä. Jos lisäät echo-tekstejä, voit käydä lisäämässä myös mage_checkout.csv tiedostoon fi_FI -hakemistossa kyseisen rimpsun ja tyhjentää välimuistin. Tällöin samaa rimpsua voi käyttää usein ja muuttaa sen vain käännökseen.
  • Maksusivuston maksutavat, niiden ohjetekstit muutetaan Asetukset > Toimitustavat

Rekisteröityminen sivulle osoitekenttä[muokkaa]

Oletuksena rekisteröitymissivulla ei näytetä yritystä ja osoitetta. Ne saa liittämällä seuraavan koodin app/design/frontend/default/käyttämäsiteemannimi/layout/local.xml -tiedostoon. Muista tyhjentää välimuisti että asetus tulee voimaan.

<customer_account_create>
	<reference name="customer_form_register">
		<action method="setShowAddressFields"><param>true</param></action>
	</reference>
</customer_account_create>

Paino -arvon desimaalien muuttaminen[muokkaa]

Magento tallentaa painon neljällä desimaalilla. Tuote-esittelyssä kuitenkin kaksi desimaalia voi riittää ja näyttää ehkä paremmalta. Seuraavalla muutoksella koodiin voit muuttaa näkymän kaksi desimaaliseksi, mutta tämä ei muuta itse tuotteen painoa mitenkään pysyvästi tietokantaan. Kyse on vain tulostukseen liittyvästä kosmetiikasta. Arvon pitää täyttää kaksi ehtoa, olla numeerinen ja Paino (kg) -kohdassa. Jos Suomennos on erilainen, vaihda se samaksi kuin kaupan puolella paino näkyy.

app/design/frontend/base/default/template/catalog/product/view/attributes.phtml
                <th class="label"><?php echo $this->escapeHtml($this->__($_data['label'])) ?></th>
<?php
$_MyValue = $_data['value'];
if (is_numeric($_MyValue) && ($_data['label'] == 'Paino (kg)'))
{
$_MyValue = number_format($_MyValue, 2,'.', ' ');
}
?>
                <td class="data"><?php echo $_helper->productAttribute($_product, $_MyValue, $_data['code']) ?></td>
            </tr>

Patch -tiedoston asennus[muokkaa]

Ajoittain Magentoon tulee nk. patch-tiedostoja, joilla korjataan jotain ohjelmaan liittyvää tai lisätään uusia toimintoja. Nämä voivat olla kriittisiä, esimerkiksi turvallisuusaukkoja, jotka pitää paikata välittömästi, jopa muutamassa tunnissa tai päivässä. Kriittisistä ilmoitus tulee suoraan ylläpidon puolelle ilmoituksiin.

  • Tiedostot ovat versiokohtaisia! Magenton versio näkyy ylläpidon alalaidassa.
  • Tiedostot pitää asentaa mahdollisesti tietyssä järjestyksessä!
  • Näiden pääte on usein .sh, .pathch tai .diff. Patch-tiedosto sisältää tarvittavat ohjeet ja rivit, jotka se suoritettaessa muuttaa Magentoon. Ohjelman ajaminen siis tekee muutoksia Magenton tiedostojärjestelmään ja kenties sen jälkeen muutoksia myös tietokantaan.
  • Tiedostoikeudet ovat todennäköisesti tuotantoversiossa esimerkiksi hakemistoissa 500 ja tiedostoissa 400. Patch-tiedostoa ei voi asentaa, jos ne hakemistot, johon teet muutoksia eivät ole kirjoituskelpoisia.
    • Eräs tapa on ajaa sh-komentoa niin kauan, että se onnistuu, koska skripti tarkistaa aluksi että se pystyy kirjoittamaan. Vaihda hakemistoille esim. 774 oikeus ja palauta se onnistuneen skriptin ajon jälkeen. Eli kaikki pitää avata ja sitten sulkea kaikki vasta kun skripti on onnistuneesti suoritettu.
      • Checking if patch can be applied/reverted successfully... ERROR: Patch can't be applied/reverted successfully.
    • Olemassaolevia tiedostoja ei tarvitse muuttaa kirjoitettavaksi, skripti kirjoittaa uudet ja muuttaa vanhojen nimet.
  • Tämä ohje käsittelee .sh -loppuisten asentamista
  1. Tarkista onko verkkokaupassa asiakkaita: Asiakkaat > Sisäänkirjautuneena olevat asiakkaat
  2. Aseta verkkokauppa huoltotilaan asettamalla juurihakemistoon maintenance.flag -tiedosto
  3. Ota kokoaminen pois päältä
  4. Tyhjennä välimuisti
  5. Varmuuskopioi tiedostojärjestelmä, esm. zip -r varmuuskopionimi.zip kaupanhakemisto
  6. Varmuuskopioi tietokanta, esm. phpMyAdmin-ohjelmalla tai cPanelilla.
  7. Siirrä patch-tiedosto juurihakemistoon
  8. Jos olet ottanut /downloader -hakemiston pois käytöstä turvallisuussyistä esm. muuttamalla sen nimen, palauta sen nyt takaisin nimelle /downloader
  9. Anna Pääteohjelmassa komento: sh patchtiedostonnimi.sh
  10. HUOM! Onnistunut asennus ilmoittaa: Patch was applied/reverted successfully
    1. Jos onnistumisilmoitusta ei tule, ei tiedostoja ole muutettu. Sen näkee esm. päivämääristä. Ei siis tarvitse huolehtia, että muutoksia olisi tehty, jos tulee virheilmoituksia.
    2. Huom! Jos ytimen tiedostoihin on tehty oia muutoksia, silloin patchit eivät välttämättä toimi!
    3. Virheilmoitusten todennäköisin syy on että, tiedostoihin eikä hakemistoihin voi kirjoittaa. Yleensä muutettavaa on paljon, joten kannattaa ehkä avata oikeudet kerralla (vaihtoehto alla) tai lisätä oikeuksia virheilmoitusten perusteella tiedostoon ja sille hakemistolle, jossa tiedosto sijaitsee.
    4. Jos tiedosto puuttuu, saattaa se olla pakko lisätä tiedosto alkuperäisestä tai seuraavan Magento-version paketista. Yleensä, tällöin kannatta googlettaa ohjeita (magento patch error patchnumero)
    5. Jos tiedostoon on tehty muutoksia, esim. .htaccess -niin muuta .htaccess toiselle nimelle, hae alkuperäisestä Magentoasennuksesta korvaava ja aja patch siihen. Tee sitten muutokset muokkaamaasi tiedostoon manuaalisesti. Jos tämä ei toimi, katso ohje alhaalla miten patchista poistetaan pala ja lisätään manuaalisesti.
      1. Eli jos saat virheilmoituksen, esim. /usr/bin/patch: **** Can't create temporary file lib/Varien/Db/Adapter/Pdo/Mysql.php.oMzVDFy : Permission denied muuta tällöin Pdo-hakemisto ja Mysql.php 744 -tiedosto-oikeudelle.
    6. Katso myös virheilmoitus alla
  11. Muuta tiedosto-oikeudet takaisin hakemistoille 500 ja niissä oleville muutetuille tiedostoille 400
  12. Tarkista että tiedostojen omistaja on oikea. Tarvittaessa muutetaan chown -R käyttäjänimi . Tarkistus esm. komennolla ls -l
  13. /app/etc -hakemistosta ehkä löytyy applied.patches.list Siitä tiedostosta näet lokia tapahtuneesta.
  14. Ota verkkokauppa huoltotilasta pois (maintenance.flag -tiedosto)
  15. Kirjaudu ylläpidosta ulos, takaisin sisään, tyhjennä välimuisti
  16. Suorita kokoaminen
  17. Katso että verkkokauppa toimii
  • Komennot joilla oikeudet voi kerralla avata. Omistajalle ja ryhmälle täydet oikeudet, muille ei mitään. Annetaan oltaessa magento-hakemistossa.
cd magento
find app/ -type d -exec chmod 770 {} \;
find app/ -type f -exec chmod 770 {} \;
find lib/ -type d -exec chmod 770 {} \;
find lib/ -type f -exec chmod 770 {} \;
find downloader/ -type d -exec chmod 770 {} \;
find downloader/ -type f -exec chmod 770 {} \;
  • Komennot joilla oikeudet voi kerralla tiukentaa. Katso myös ohjeet muualla tällä sivulla.
find app/ -type d -exec chmod 500 {} \;
find app/ -type f -exec chmod 400 {} \;
find lib/ -type d -exec chmod 500 {} \;
find lib/ -type f -exec chmod 400 {} \;
find downloader/ -type d -exec chmod 500 {} \;
find downloader/ -type f -exec chmod 400 {} \;
  • Jos saat virheilmoituksen, joka näyttää seuraavalta. Katso katkoviivoituksen alla olevaa riviä. Sen alla oleva hakemisto ja tiedosto täytyy saada kirjoitettavaksi!
Skip this patch? [y] 
Skipping patch.
1 out of 1 hunk ignored
can't find file to patch at input line 321
Perhaps you used the wrong -p or --strip option?
The text leading up to this was:
--------------------------
|diff --git downloader/template/messages.phtml downloader/template/messages.phtml
|index 211bc22..c8f8d86 100644
|--- downloader/template/messages.phtml
|+++ downloader/template/messages.phtml
--------------------------
  • Poistetaan pala patchia. Eli rivi joka alkaa diff --git app/ ja seuraavaan asti on jotain tiettyä tiedostoa koskeva.
__PATCHFILE_FOLLOWS__
diff --git app/code/core/Mage/Admin/Model/Block.php app/code/core/Mage/Admin/Model/Block.php
tässä plussat ja minukset
diff --git app/code/core/Mage/Admin/Model/Resource/Block.php app/code/core/Mage/Admin/Model/Resource/Block.php

http://devdocs.magento.com/guides/m1x/other/ht_install-patches.html

Postin taulukkohintojen tuonti ja csv-tiedostot[muokkaa]

Taulukkohinnat (Table rates) tulee Magenton CE:n mukana ja tarkoittaa esimerkiksi Postin hinnoittelua postipaketeissa painon mukaan. Toiminnolla voi siis määritellä eri hintoja, joita Magento käyttää eri tilanteissa. Tiedot viedään Magentoon csv-taulukon avulla. Katso tältä sivulta myös kohta Matrix Rates.

  • Ongelmaksi muodostuu usein se ettei Magento hyväksy .csv-tiedostoa. Neuvoja on kuten csv tallennus Windows muodossa, sitaattien sisään, Excel ei toimi, OpenOffice toimii jne. Omakohtaisesti en myöskään saanut joskus Macin Excelillä toimimaan, mutta seuraava toimi yksinkertaisuudessaan Macissa:
  1. Ota taulukkohinta käyttöön
  2. Vaihda sivustonäkymään vasemmasta yläkulmasta.
  3. Vie CSV jotta saat pohjan (tärkeä vaihe!)
  4. Avaa csv Macin mukana tulevalla TeXturi -editorilla.
    1. syötä maa tunnukseksi FI jokaisen rivin alkuun
    2. erota kohdat toisistaan pilkuilla
    3. ilmoita aina desimaali pisteenä
    4. jos arvo sisältää välilyöntejä tai desimaalipisteen laita se sitaattien " -väliin
    5. käytä * -merkkiä jokerina eli esim. maakunnan ja postinumeron kohdilla, kun et halua määrittää arvoa tarkemmin.
    6. tallenna normaalisti
  5. Tuo tiedosto Magentossa em. kohdassa. Tuonti tapahtuu tallentamalla asetukset.
Maa,Maakunta,Postinumero,"Paino (tai yli)","Toimituksen hinta"
FI,*,*,0,"7.20"
FI,*,*,2,"8.50"
FI,*,*,5,"9.75"
FI,*,*,10,"12.95"
FI,*,*,15,"18.00"

Service Temporarily Unavailable[muokkaa]

The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later.

  • Tämä virheilmoitus voi ilmestyä esimerkiksi kun Magento Connect palvelussa asennat omalta koneelta laajennusta .zip tai .tgz. Laajennus asentuu, mutta Magento jää huoltotilaan, jos tästä asennuspalvelusivun yläosassa on rasti ruudussa. Palvelin ei tällöin ole alhaalla vaan Magenton juurihakemistoon on ilmestynyt tiedosto nimeltä maintenance.flag. Muuta sen nimi tai tuhoa se esimerkiksi komennolla rm ./magento/maintenance.flag Tiedostoa ei välttämättä kannata tuhota, koska sen avulla sivusto on helppo ottaa pois käytöstä.

Sivukartta[muokkaa]

Sivukartta muodostetaan ylläpidon puolella kohdasta Luettelo > Google sivukartta. Huomaa että sinun on lisättävä sivukartta tänne (mikä ei ole siis Järjestelmä > Asetukset-sivu vaan mistä löytyy tuotteet ja luokat), ja vasta sitten ajastettu toiminto alkaa päivittämään sitä, mitä voit säätää kohdasta Järjestelmä > Asetukset > Luettelo > Google sivukartta. Ota siellä sivukartan muodostus käyttöön.

  • Huomaa että Magenton juurihakemistoon on ehkä hyvä luoda /sitemaps -hakemisto etukäteen ja antaa sille oikeudet 755, tämän jälkeen sitemaps.xml tiedostonimi ja hakemistopolku lisätään Luettelo > Google sivukartta -kohdasta. Kun lisäät tätä, saattaa käydä niin että koko domain kaatuu, varsinkin jos sitemaps -hakemistoa ei ole aiemmin luotu. Vaikea sanoa syytä miksi näin kävi. Kaatumisen jälkeen noudatin järjestystä:
  1. Lisäsin hakemiston sftp:llä ja oikeudet siihen
  2. Lisäsin sivukartan ja tallensin sen kohdassa Luettelo > Google sivukartta
  3. Asetin sivukartan muodostamisen asetukset Järjestelmä > Asetukset > Luettelo > Google sivukartta
  4. Tyhjensin välimuistin
  5. Valitsin Muodosta (sivukartta) kohdassa Luettelo > Google sivukartta

Sivukartan lisäys Googleen[muokkaa]

  • Aseta domainosoitteesi juureen robots.txt -tiedosto joka sisältää seuraavan koodin. Tee siitä tekstitiedosto ja käytä robots.txt nimeä. Ensimmäinen rivi antaa kaikkie hakurobottien indeksoida sivu ja toinen rivi määrittelee missä edellä luomasi sivukartta sijaitsee. Katso lisätietoa sivulta Www.
User-agent: *
Sitemap: http://www.osoite.fi/polku/sitemap/sitemap.xml

SSL (https)[muokkaa]

Katso asennusohje sivulta SSL.

Kytkeminen pois päältä tietokannassa[muokkaa]

Joskus voi käydä niin että et pääse kirjautumaan ylläpitoon jos se on ylläpidon puolella asetettu päälle sitä johtuen että sertifikaatti ei ole palvelimella asennettu tms.

  1. Kirjaudu phpMyAdmin:lla tietokantaan
  2. Etsi taulu core_config_data
  3. etsi sarakkeesta path joko web/secure/use_in_frontend” tai “web/secure/use_in_adminhtml” sen mukaan haluatko muuttaa ylläpidon ja/tai kaupan puolen https:n pois. Yksi tapa on järjestää sarake painamalla path -sarakkeen otsikkoa KAKSI kertaa, jolloin ne järjestyvät päinvastaiseen järjestykseen sen sarakkeen mukaan.
  4. muuta arvoksi nolla 0
  5. Tyhjennä välimuisti, katso ohje "Istuntojen ja välimuistin tyhjentäminen"
  6. Tyhjennä käyttämäsi selaimen välimuisti

Taulukon reunuksen väli[muokkaa]

Jos et onnistu styles.css ja div-tagien kanssa etkä wysiwyg-editorin kanssa asettamaan taulukon reunoihin väliä, onnistuu se seuraavasti:

  • Älä käytä wysiwyg editoria vaan, lisää suoraan haluamaasi soluun seuraavasti:
<table style="background-color: #dcddd9;" align="left">
<tbody>
<tr>
<td style="padding:10px;">Solun teksti tässä</td>
</tr>
</tbody>
</table>
  • Jos haluat asettaa muita säätöjä niin:

Solun teksti.

Tiedostopolut[muokkaa]

  • <p><a href="/magentopäähakemisto/media/wysiwyg/hakemistonnimi/tiedostonimi.jpg"></a></p>
  • http://www.osoite.fi/magentotms/cmssivunnimi
  • http://www.osoite.fi/mahdollinenpolkumagentonjuureen/catalog/product/view/id/59
  • Linkki sivulla asetuksista riippuen. Huomaa että alkaa kauttaviivalla. Esim: /magentotms/luokka/luokka.html
  • Staattinen sivu:
    • Kutsutaan muualta staattista sivua: {{block type="cms/block" block_id="muuttumattomansisältölohkontunniste"}}
    • Kutsutaan kuvaa staattisessa sivussa: {{skin url='media/kuvannimi.jpg'}} TOIMIIKO?
    • Linkataan toiselle Magentosivulle: {{store direct_url='sivunnimi.html'}}
    • Kutsutaan staattista sivua XML-tiedostossa:
<reference name="left">
    <block type="cms/block" name="sample_block" before="-">
        <action method="setBlockId"><block_id>sample_block</block_id></action>
    </block>   
</reference>
  • Kutsutaan staattista sivua .phtml -tiedostossa:

<?php echo $this->getLayout()->createBlock('cms/block')->setBlockId('my_static_block_name')->toHtml() ?>

Uudelleenohjaus[muokkaa]

Luokkia ja tuotteita voidaan uudelleenohjata toiseen osoitteeseen Luettelo > Uudelleenohjaukset -kohdasta. Kun muutat tuotteen tai luokan URL-avainta, sen vieressä on mahdollisuus valita luodaanko automaattisesti ohjaus vanhasta osoitteesta uuteen. Kun vedät hiirellä luokkia toisiin kohtiin, muodostuu lisää uudelleenohjauksia. Loppujen lopuksi niitä voi olla surullisen paljon ja mopo karkaa kuvainnollisesti käsistä.

Jos kieliä on esimerkiksi useita, uudelleenohjaukset ovat kullekin kielelle.

  1. Hahmota itselle ”Mistä haluat ohjata mihin?”
  2. Olemassaolevia uudelleenohjauksi ei välttämättä pysty muuttamaan, joten on ensin poistettava vanha ohjaus ja sitten tehtävä uusi.
  3. Lisää osoitealias > Muokattu
    1. Kauppa: Määritä tarvittaessa mitä ohjaus koskee
    2. Tunnisteen polku: Vapaavalintainen nimi, esm. category/3
    3. Pyydettävä polku: Mistä sivulta haluat ohjata, eli se on osoite, jota Magento vertaa URL-riviltä ja jos täsmää, ohjaa sen "Kohteen polku" -osoitteeseen. Kirjoitetaan tässä muodossa: tavarat.html tai astiat/kupit.html
    4. Kohteen polku: Mihin sivulle ohjataan. Kirjoitetaan tässä muodossa: catalog/category/view/id/54
    5. Edellisessä esimerkissä siis tavarat.html sivu ohjautuu sivulle catalog/category/view/id/54
    6. Uudelleenohjaus: Pysyvä (301)

Uudelleenohjausten nollaus[muokkaa]

Jos haluat aloittaa tyhjältä pöydältä, niin tietokannassa voi tyhjentää (truncate) taulun core_url_rewrite. HETI tämän jälkeen tulee ylläpidon puolella indeksoida Luettelon uudelleenohjaukset. HUOM! Jos olet muokannut omia uudelleenohjauksia, ne kaikki menetetään.

https://www.yireo.com/tutorials/magento/magento-administration/664-fixing-url-rewrites-with-magento

Voit myös poistaa tietokannasta yksittäisiä rivejä core_url_rewrite -taulusta, jos et halua itse tekemiesi ohjausten nollaantuvan indeksoinnin johdosta.

Uudelleenohjaus Magentoon juurihakemistosta[muokkaa]

Katso sivu .htaccess

Varasto[muokkaa]

  • Ei varastossa ilmoitus. Ilmoituksen voi poistaa kaupan puolelta seuraavasti:
  1. /skin/frontend/default/teemasinimi/css/style.css
  2. Etsi rivi .availability ja lisää siihen display:none; eli esimerkiksi .availability {margin:0; display:none;}

Varmuuskopiointi[muokkaa]

Magenton asetuksissa voit ottaa käyttöön automaattisen varmuuskopioinnin. Lisäksi voit manuaalisesti ottaa varmuuskopioita kohdassa Järjestelmä > Varmuuskopiointi ja kokoaminen. Tiedostot tallentuvat var/backups kansioon. Huomaa kuitenkin että niitä täytyy manuaalisesti poistaa ettei palvelimen levytila täyty.

Versionumero[muokkaa]

  • Ylläpitosivuan alalaidassa
  • Versionumero /app -hakemistossa: grep -A6 'static function getVersionInfo' Mage.php

Vertailulohko ei näy[muokkaa]

Yleensä ongelma ratkeaa uudelleenindeksoimalla kaikki indeksit. Lisäksi asetusten luettelo-sivulla on vertailuun liittyvä asetus.

WYSIWYG[muokkaa]

Mitä näet, sitä saat :) Magentossa koodia voi syöttää tekstiin poistamalla käytöstä wysiwyg-editorin silloin kun tarve ilmenee. Esimerkiksi tuotetta syötettäessä.

  • Kommentointi <!-- Tämän voi laittaa koodin sekaan selvennykseksi ja se ei näy tai sitä ei suoriteta -->

Ylläpidon luetteloiden oletus[muokkaa]

1.8.0. Magento näyttää oletuksena 20 riviä esimerkiksi tuotteita. Voit muuttaa sen haluamaksi. Ehkä lukemina on paras käyttää niitä arvoja mitä asetuksissa on asettanut?

  • /app/code/core/Mage/Adminhtml/Block/Catalog/Product/Grid.php
  • Etsi rivi parent::__construct();
  • Lisää heti sen jälkeen: $this->setDefaultLimit(100);

Ylläpitoon kirjauduttaessa jatkuvan viesti-ilmoituksen poistaminen[muokkaa]

Ohje koskee vain vanhempia versioita. 1.7.0.2 versiossa ei enää ole kyseistä hakemistoa.

  • Tee kansio nimeltä Resource Model-kansioon: app/code/local/Mage/AdminNotification/Model/Resource
  • Kopioi app/code/core/Mage/AdminNotification/Model/Resource/Inbox.php Resource-kansioon
  • Vaihda Resource-kansiossa olevaan koodiin seuraava. Katso tarkasti että muutat sen juuri oikeaan kohtaan, koska tiedostossa on samanlaisia rivejä muitakin eri kohdassa.

Alkuperäinen koodi

$select = $adapter->select()
                ->from($this->getMainTable())
                ->where('url=?', $item['url']);

Uusi koodi:

$select = $adapter->select()
                ->from($this->getMainTable())
                ->where('url=? OR url IS NULL', $item['url'])
                ->where('title=?', $item['title']);
  • Poista kaikki ilmoitukset. Kirjaudu ulos ja takasin sisälle.

Ylläpitäjän salasana hukkunut tai käyttäjätunnus unohtunut[muokkaa]

  • phpMyAdmin / Magento tietokantasi / admin_user table löytyy käyttäjätunnus ja sähköpostiosoite
  • Salasanan voi tämän jälkeen pyytää ylläpitoon kirjautumisesta sähköpostiin
  • Salasanan voi myös muuttaa tietokantaan: phpMyAdmin / Magento tietokantasi / admin_user table / Muokkaa / password-rivillä Funktio-valikosta MD5 / Kirjoita uusi salasana / Suorita

Ylläpitäjän rooli[muokkaa]

VAROITUS! Varo muuttamasta ylläpitäjän roolia Muokatuksi ja jättämällä oleellisia tai kaikkia valintaruutuja tyhjiksi. Tallennettuasi tällaisessa tilassa asetukset, ylläpito-oikeutesi katoavat.

Ratkaisu phpMyAdmin[muokkaa]

Jos näin kuitenkin pääsi käymään...

  • Kirjaudu ylläpidon puolelta ulos
  • Ota varmuuskopio tietokannasta
  • Siirry tietokantaan phpMyAdmin -avulla. Huomaa että seuraavassa on role ja rule
  • Näet ylläpitäjän roolin ja muut tunnistetiedot mahdollinenetuliite_admin_role -kohdasta
  • Tuhoa kaikki kohdasta mahdollinenetuliite_admin_rule lukuunottamatta resource_id:tä all, joka on ensimmäisenä. Valitse kaikki rivit kerralla, poista valinta all-kohdasta ja paina poista.
  • Muokkaa kyseistä all -riviä seuraavasti: Role ID = 1, Resource ID = all, Assert ID = 0, Role Type = G, permission = allow Jätä kohta Privileges tyhjäksi, siihen tulee automaattisesti NULL
  • Kirjaudu ylläpitoon normaalisti
  • Ohjeen lähde: http://www.magentocommerce.com/answers/discussion/674/How-can-I-reset-Admin-role-and-resources-to-all/p1

Ulkoasu (teema)[muokkaa]

Ulkoasun suhteen, teemoilla on erilaisia niksejä miten ne asennetaan ja toimintoja esitetään sivulla. Hyvässä teemassa ne on yleensä ohjeissa kerrottu. Etenkin maksulliset, mutta myös ilmaiset teemat tarjoavat tukipalveluita esimerkiksi sähköpostin avulla.

  • Ulkoasuun vaikuttaa sekä itse phtml tai xml -tiedostot tai style.css tai skin.css. Lisäksi ylläpidon kautta voi tehdä muutoksia.

Miten poistetaan lohko[muokkaa]

Esimerkiksi samankaltaiset tuotteet -lohko saattaa tulostua samanaikaisesti sekä vasemmalle että oikealle. Miten poistetaan esimerkiksi vasen lohko?

  • Tehdään tämä local.xml tiedostoon.
  1. /app/design/frontend/default/teemannimi/layout/local.xml
  2. etsi poistettava lohko koodin seasta ja poista rivit. Esimerkiksi
        <reference name="left">
            <block type="catalog/product_list_related" name="catalog.product.related.left" before="-" template="catalog/product/list/related.phtml" />
        </reference>
  1. tallenna ja tyhjennä välimuisti


Koodin pätkiä[muokkaa]

 <p>{{block type="catalog/product_list" template="catalog/product/home.phtml" category_id="4"}}</p>

Laajennukset (extension)[muokkaa]

http://gotgroove.com/ecommerce-blog/magento-development/developer-toolbox-a-guide-for-installing-magento-extensions/

Asennuksen valmistelu ja yleiskulku[muokkaa]

  1. Varmista onko moduulli kytkennäinen esimerkiksi johonkin palveluun, josta menee kuukausimaksu. Eli moduulin käyttäminen on maksullista, vaikka moduuli itsessään on ilmainen.
  2. Lue laajennuksen asennusohjeet!
  3. Varmuuskopioi sekä tietokanta että tiedostojärjestelmä. Esimerkiksi Magenton ylläpidon kautta tai cPanelin avulla tai pääteohjelmalla tai Cyberduck, PhpMyAdmin jne.
  4. Kytke tarvittaessa pois Asetukset/Kehitys/ Yhdistä JavaScript-tiedostot ja Yhdistä CSS-tiedostot
  5. Kokoaminen (compilation) tulee ottaa asennuksen ajaksi pois käytöstä (Järjestelmä > Työkalut > Kokoaminen)
  6. Välimuistit tulee ottaa asennuksen ajaksi pois käytöstä (Järjestelmä > Välimuisti)
  7. Siirry ylläpidossa Järjestelmä > Välimuisti -sivulle.
  8. Suorita asennus
  9. Ota ensin käyttöön auki jättämälläsi selaimen sivullla välimuistit ja sitten tyhjennä välimuistit. Jos ei onnistu tuhoa hakemistosta var/cahce kaikke mage-- -alkuiset hakemistot
  10. Kirjaudu ulos ja takaisin sisälle ylläpitoon. Jos et tee tätä saattaa esimerkiksi ilmetä virheilmoitus ettei uuden laajennoksen asetuksia löydy.
  11. Jos käytössä on kokoaminen (compilation) tulee se myös ajaa jotta moduuli toimii oikein. Suorita kokoaminen joka ottaa kokoamisen sen myötä taas käyttöön. Eli suorita -painike, ei pelkästään ota käyttöön. Tarvittaessa /includes ja sen alihakemistot ja tiedoston config.php tiedosto-oikeuksia pitää tarvittaessa höllentää kirjoitusoikeuksiksi.
    1. esimerkiksi virheilmoitus includes/src/Mage_Shipping_Model_Shipping.php on line 424 korjaantuu todennäköisesti:
      1. Katso että moduulisi.xml on hakemistossa: app\design\adminhtml\default\default\layout\jokunimi.xml ja erityisesti sen pitiää olla moduulin hakemistossa, jos sellainen on alkuperäisessäkin moduulin hakemistopuussa eli esim /layout/datafeedwatch/connector.xml
      2. Tai http://gotgroove.com/ecommerce-blog/magento-development/developer-toolbox-a-guide-for-installing-magento-extensions/
  12. Tarvittaessa tyhjennä vielä uudestaan välimuisti, kirjaudu ulos tai kokoa jos tulee esim. virheilmoitus "ei löydy"
  13. Testaa laajennusta ja muita toimintoja. Toimiiko sivusto normaalisti ja odotetusti?

Laajennusten asentaminen Magento Connect ohjelmalla[muokkaa]

  • Ota käyttöön Magento Connect, jos esimerkiksi olet muuttanut /downloader -hakemiston nimen tietoturvasyistä
  • Laajennukset löytyvät osoitteesta /app/code/ ja yleensä community tai local, mutta joskus core
  • Laajennosten xml-tiedostojen sijainti /app/etc/modules ja /app/code/core/Mage
  1. Magento Connect (Järjestelmä > Magento Connect > Magento Connect Manager
  2. Esimerkiksi kopioi Magento Connect sivulta avain joka on tehty Magento Connect 2.0 versioille (esim. Community Edition 1.5 ja myöhemmät)

Laajennosten asentaminen pääteohjelmalla[muokkaa]

Jos sivustosi on tuotannossa ja kovassa käytössä ei tiedosto-oikeuksien höllentäminen ole järkevää ja näin altistaa sivusto hyökkäyksille. Tällöin asentaminen SSH-yhteydellä tulee kyseeseen. Asennuksen voi tehdä mage -ohjelmalla jos tiedosto-oikeudet ovat asetettu riittävän hölliksi niihin hakemistoihin joita asennus tarvitsee (hmm...miten tämän selvittäisi helpolla?). Aiemmissa versioissa mage:n sijaan kyseessä oli pear.

Vaihtoehto 1[muokkaa]

  1. Ota Magento Connect sivulta laajennuksen Magento Connect 1.0 tai 2.0 -latauslinkki, esim. http://connect20.magentocommerce.com/community/IG_FlatShipping5
  2. Syötä Magento Connect 2.0 -latauslinkki seuraavalle sivulle: tälle sivulle. Hidas vaihtoehto jos tiedostoja on paljon.
  3. Lataa tiedosto paikalliselle tietokoneellesi ja pura .tgz
  4. Siirrä tiedostot yksitellen tai zip-pakkauksina tms. hakemistoihin samoin kun ne on laajennoksessa. Vaihtoehtoisesti seuraa tiedostossa package.xml olevia ohjeita ja sijoita tiedostot Magento vastaaviin hakemistoihin sftp-ohjelmalla esimerkiksi vetämällä hiirellä. Jos et tiedä minne asentaa, nyt auttaa esimerkiksi testiverkkokauppa, jossa voit kokeilla ja tehdä asennuksen Magento Connect -ohjelman avulla ja katsoa tiedostojärjestelmästä minne asentuivat.
    1. Joudut tarvittaessa muuntamaan palvelimen hakemistoja kirjoitettavaksi ja takaisin suojaamaan ne kopioinnin jälkeen. Tiedosto-oikeudet saattavat vaihdella hakemistottain ja tiedostottain. Yleisimmät ovat tiedosto 400 ja hakemisto 500, tai tiedosto 644 ja hakemisto 711. Yleensä 700 riittää hakemistolle johon kirjoitetaan. Lisäksi uuden laajennoksen tiedosto-oikeudet pitää tiukentaa. Sen voi tehdä samalla kun tiedostoja asentaa. Isommat muutokset kannattaa tehdä kerralla komennoilla kyseisestä hakemistosta, jolloin se vaikuttaa kaikkiin sen alla oleviin: tiedostoille find . -type f -exec chmod 400 {} \; ja hakemistoille find . -type d -exec chmod 500 {} \;
  5. Katso ohje otsikko Asennuksen valmistelu ja yleiskulku
  • Tiedostojen sijainnista (package.xml):
    • modules - app/etc/modules
    • esm moduulihakemisto TM, jos rooli magecommunity - app/code/community/TM
    • frontend, jos rooli mageskin - /skin/frontend tai /app/design/frontend

Vaihtoehto 2[muokkaa]

Huom! Jos tiedosto-oikeudet ovat liian tiukat, ei asennus onnistu tällä tavalla.

  1. Katso edellinen otsikko laajennusten asentamisesta.
  2. ssh käyttäjä[email protected]
  3. Seuraavaa ei ole testattu. Katso http://www.webshopapps.com/blog/2011/08/installing-community-extensions-via-command-line-ssh/ ja http://www.magentocommerce.com/wiki/groups/227/installing_extensions_via_ssh
    1. käytä tarvittaessa sudo komentoa edessä esim. OSX:ssä
    2. Katso Magento Connect sivulta laajennuksen Magento Connect 2.0 -latauslinkki, esim. http://connect20.magentocommerce.com/community/IG_FlatShipping5 ja poimi siitä loppuosa eli tässä esimerkissä IG_FlatShipping5
  4. Siirry Magenton juurihakemistoon
chmod +ox mage
./mage mage-setup .
./mage config-set preferred_state stable
./mage -V
./mage list-channels
./mage install connect20.magentocommerce.com/community/ laajennuksennimi
rm -rf downloader/pearlib/cache/* downloader/pearlib/download/*
  1. Tyhjennä Magenton välimuisti

Vaihtoehto 3[muokkaa]

  1. Katso Magento Connect sivulta laajennuksen Magento Connect 1.0 tai 2.0 -latauslinkki, esim. http://connect20.magentocommerce.com/community/IG_FlatShipping5 ja poimi siitä loppuosa eli tässä esimerkissä IG_FlatShipping5
  2. Aseta vähintään omistajalle kirjoitusoikeus (chmod +ox) hakemistolle /downloader/.cache
  3. ssh käyttäjä[email protected]
  4. Siirry Magenton juurihakemistoon ja anna seuraavat komennot. Viimeinen komento lataa laajennuksen hakemistoon .cache
chmod +ox mage
./mage mage-setup .
./mage -V
./mage list-channels
./mage download connect20.magentocommerce.com/community/ laajennuksennimi

Vaihtoehto 4[muokkaa]

  • Jos tiedosto-oikeudet ovat liian tiukkoja ja et voi esimerkiksi poistaa vanhoja hakemistoja, seuraavilla päätekomennoilla voit muuttaa tiedosto-oikeuksia hakemistoille ja tiedostoille. d = hakemisto, f = tiedosto. 500 ja 400 ovat tiukat tuotantoasetukset, 744 ja 644 sallivat niiden poistamisen ja muutosten tekemisen hakemistoon
find . -type d -exec chmod 744 {} \;
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 500 {} \;
find . -type f -exec chmod 400 {} \;


  • Fatal error: Call to a member function children() on a non-object in includes/src/__default.php on line
    • Unohtuiko compilation sittenkin päälle?
  1. poista moduuli käytöstä, jonka juuri asensit hakemistossa /app/etc/modules/moduulinnimi.xml Muuta tiedostoon <active>true</active> arvoksi false
  2. tuhoa kaikki var/cache/ hakemistossa olevat hakemistot eli tyhjennät välimuistin
  3. kirjaudu nyt ylläpitoon ja compiloi uudestaan.
  4. epäselvää
    • muita vaihtoehtoja: systems / tools / compilation
    • muita vaihtoehtoja: $ php shell/compiler.php disable
    • muita vaihtoehtoja: includes/config.php
##define('COMPILER_INCLUDE_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'src');
#define('COMPILER_COLLECT_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'stat');

Laajennusten poistaminen Magento Connect ohjelmalla[muokkaa]

  • Jos tarvitset tietää mitä tiedostoja laajennuksen asennuksessa on lisätty, alkuperäinen Magento Connect -ohjelman lataama tiedosto löytyy /downloader/.cache/community

AddThis[muokkaa]

Sosiaalisen median painikkeet. LIsäksi ne voi asettaa ilmestymään "ruudun päälle" ja laajennus myös estittelee suosituksia.

  • Linkki esim. cms-sivulle: {{block type="sharingtool/share" name="addthis_sharetool"}}
  • Huom! Jos lisäät muokattuja tietoja ylläpidon asetuksissa laajennukselle, tuotejako lopettaa toiminnan eli asiakas ei pysty enää jakamaan tuotetta, koska laajennus käyttää ylläpidossa antamaasi yleistä jakotietoa kaikkialla.

Aftership[muokkaa]

https://www.aftership.com

Aftership on maksuton, mutta lisäominaisuuksiltaan maksullinen palvelu jonka voit liittää Magentoon. Se tarjoaa mm. seuraavia ominaisuuksia

  • Lähetyksen seuratasivu. Voit tehdä esimerkisi verkkokaupan alatunnisteeseen sivun, jossa on lokero johon aisakas syöttäessään lähes minkä tahansa lähetystunnuksen saa tiedon lähetyksen kulusta. Näihin kuuluu myös Posti.
  • Asiakas saa omalle tililleen tekemiensä tilausten yhteyteen linkin, josta voi seurata kyseisen tilauksen kulkemista.
  • Ylläpidosta on mahdollisuus suoraan linkistä seurata tilauksen kulkemista
  • Aftershipin verkkopalvelussa voi tarkastella tilausten etenemistä. Palvelulle voi antaa SOAP- yhteyden avulla oikeuden hakea seurantatunnukset verkkokaupasta.
  • Nämä eivät vaadi laajennusosien asennusta, mutta muutoksia Magenton koodeihin. On olemassa myös laajennusosa Aftership, mutta sen tarve on epäselvä.
    • Jos läehtyksen seurantasivua ei saa näkymään omalla koodilla, kannattaa kokeilla ohjeissa annettua koodia.
  • Aftershipin salliminen noutaa automaattisesti tilaukset verkkokaupastasi seuraa seuraavaa ohjetta.
https://aftership.uservoice.com/knowledgebase/articles/258399
  1. Luo Rooli Magentossa
  2. Luo käyttäjä Magentossa
  3. Liitä käyttäjälle edellä tehty rooli
  4. Siirry Aftershipin sivulle ohjeen linkin mukaisesti
    1. Valitse valikosta API ja kopioi API avain
  5. Lisää avain Magentossa käyttäjälle
  6. Siirry Aftershipin sivulle edellisen linkin mukaisesti
    1. Syötä pyydetyt tiedot. Esimerkiksi osoite on http://www.osoite.fi/verkkokauppa
      1. Syötä edelläsi luomasi käyttäjän nimi, sama API avain ja jos verkkokauppoja on useita, niiden tunnusnumerot.

Blog[muokkaa]

AheadWorks Blog lisää mahdollisuuden pitää blogia asiakkaille ja antaa asiakkaiden kommentoida. Erittäin suosittu laajennus.

Call for Price[muokkaa]

Mahdollisuus asettaa hinnan kohdalle haluttu teksti ja poistaa lisää ostoskoriin painike. Tuki vastaa nopeasti (2014).

  • Vaatii aikamoista ulkoasuun vaikuttavien muutosten tekemistä. Mukana tulee kaksi laajennusta, jotka kummatkin asennetaan. Tämän jälkeen laajennuspaketissa on mukana valmiita tiedostoja, jotka voi suoraan kopioida olemassaolevien tilalle käytettävään teemaan tai vain laajennuksen koodinpätkä, jos kyseistä tiedostoa on jostain muusta syystä muutettu. Jos tiedostoja ei ole, ne voi kopioida base -hakemistosta.
  • Jos laajennuksen asennuksissa on ongelmia katso kohta Magento Connect tällä sivulla.
http://www.magentocommerce.com/magento-connect/call-for-price-hide-price.html

Cookie Law Compliance[muokkaa]

Evästeiden käyttöön liittyvät EU-vaatimukset kuntoon. Antaa erinäisiä mahdollisuuksia esittää asia.

Delete Orders[muokkaa]

1.8.0 Magentoon ei sisälly tilausten poistotoimintoa. Lisäosista Raveinfosys_Deleteorder-1.0.5 saattaa jättää tilaukset näkyviin, vaikka ilmeisesti poistaakin ne. Kannattaa ehkä kokeilla suoraan ASPerience DeleteOrders laajennusta, joka vaikuttaa toimivan 1.8.0 CE -versiossa. Tämän sivun käännöspakettiin sisältyy kyseisen laajennuksen suomennos.

Easylife Switcher[muokkaa]

https://github.com/tzyganu/Switcher

Laajennus lisää muokattavaan tuotteen vaihtoehdoista pienet miniatyyrikuvat (esim. eri värivaihtoehdot) ja kun värivaihtoehtoa klikkaa, vaihtuu pääkuva.

  • Jos käytät laajennusta Magic Zoom Plus -laajennuksen kanssa, nämä kyllä toimii yhteen. Se kuva vaihtuu, joka on yksinkertaisessa tuotteessa. Eli muokattava tuote saa sisältää kuvia, mutta kun pienoiskuvaa, esim. eriväristä T-paitaa klikataan, vaihtuu kyseisen värisen T-paidan tuotteen peruskuva
  1. Tärkeää on että kytket liitännäistuotteet käyttöön myös Magic Zoom Plus puolella. Check Miscellaneous "Show associated product's images".
  2. Tärkeää on myös että muokattava tuote sisältää vähintään kaksi kuvaa. Muutoin kuva ei vaihdu. You have to have at least two photos on Configurable Product and one image on simple product.
  3. Tiedostonimillä ei näyttäisi olevan väliä.
  4. Odota myös että sivu latautuu kokonaan. Esimerkiksi jos käytössä on AddThis -lisäosa, niin siitä voi ottaa vihjeen että vaihto toimii vasta kun se on latautunut.
  • Asetukset-sivulla laajennus ilmestyy valikkoon "luettelo".

Googlemerchants Feed Generator[muokkaa]

  • Ilmainen laajennos, joka ei vaadi myöskään mitään kuukausimaksuja.
  • Asennettu Magento 1.8.0
  • Fatal error: Class 'Zend_Log' not found siirtyessäsi luokka-sivulle, niin nosta cPanel:ssa Magento-hakemiston PHP versioksi 5.5.38 tai joksikin muuksi. Tämän virheilmoituksen korjaaminen ei siis vaadi välttämättä laajennokseen muutoksia vaan palvelin PHP-versio ei ole sopiva laajennokselle.
  • The gateway did not receive a timely response from the upstream server or application.
    • Lataa tekstitiedosto ilman id-numeroita ja virheilmoituksen jälkeen paina selaimen edelliselle sivulle painiketta, todennäköisesti kaikki ovat kuitenkin latautuneet.
    • PHP -arvon default_socket_timeout nostaminen 6000 koko Magento hakemistossa ei auttanut
  • 404 error: Page not found kun yritetään muodostaa feediä.

Grayscale teema[muokkaa]

Nykyaikainen ulkoasu, joko koko ruudun täyttävä 2014 versio tai ruudulla palkkina näkyvä. Grayscale 2014 versiossa saa valikoihin näkymään kuvia ja muutoinkin paljon toimintoja.

Magic Zoom Plus[muokkaa]

Kuvien esittämiseen erittäin tehokas ja nykyaikainen laajennus! Maksullinen, mutta rahan arvoinen. Plus-versio lisää mahdollisuuden klikatessa avata kuva ruudulle, kun pelkkä perusversio Magic Zoom antaa mahdollisuuden avata hiiren päälle vietäessä isomman kuvan ja vaihtaa pikkukuvia pelkällä hiiren päälle viemisellä. Paljon säätömahdollisuuksia. Mahdollisuus asentaa ja tsestata, ja maksaminen poistaa vasta alareunasta mainostekstin. Muutoin toiminnot ovat samat maksuttomassa ja maksullisessa versiossa.

  • Muokkaa asetuksia ylläpidon puolella. Yleiset asetukset ja eri kohteisiin vaikuttavat.
  • Kutsutaan class"MagicZoomPlus" ja annetaan samalla tarvittaessa arvoja.
  • Hyvät ohjeet kotisivuilla ja myös ladattavissa ilmaiseksi paljon esimerkkiskriptejä sisältävä tiedostohakemisto, jota voi käyttää selaimen kautta.

Muokattavan tuotteen kuvan vaihtuminen[muokkaa]

Tämä mahdollistaa tuotteen pääkuvan vaihtumisen kun pudotusvalikosta valitaan eri arvo. Esimerkiksi T-paidan kuva vaihtuu siksi väriksi, joka pudotusvalikosta valitaan. Samalla tietysti myös hinta vaihtuu.

  • Huom! Tämä laajennus ei ilmeisesti kuitenkaan muodosta pudotusvalikon sijalle miniatyyrikuvia esimerkiksi erivärisistä T-paidoista. Katso tähän tarkoitukseen laajennusosa Easylife Switcher.
  1. Magic Zoom Plus > Product page > Miscellaneous > Show associated product's images Yes
  2. Lisää muokattava tuote, johon on liitetty liitännäistuotteet kohdasta yksinkertaisia tuotteita niinä eri vaihtoehtoina.
    1. Aseta värivaihtoehtokuvat kuhunkin tuotteeseen, ja valitse kunkin tuotteen kohdalla kuvan Base Image eli peruskuva. Tämä on tärkeä valinta!
  3. Epäselvää on mikä merkitys on kohdalla "Options names associated with images separated by commas (e.g 'Color,Size')" ja sen ohjeella "You should named all product images associated with option values. e.g If option values is 'red', 'blue' and 'white' then you should have 3 images with labels 'red', 'blue' and 'white'".
    1. Muokattavien tuotteiden kenttien nimikkeet kyllä kannattanee varmaan lisätä pilkulla erotettuna, mutta kuvien nimillä ei näytä olevan väliä vai onko joku ominaisuus mikä tällä saadaan käyttöön?
Alkuperäinen ohje

Kuvagalleria[muokkaa]

Pieniä kuvia, joita painaessa aukeaa ruudulle.

<!-- Kuvagalleria -->
<p><a class="MagicZoomPlus" href="kuvan osoite joka avataan klikatessa" rel="disable-zoom: true"><img src="pienoiskuvan osoite" alt="" /></a></p>

MD Quick View Product[muokkaa]

Vietäessä hiiri taulukkonäkymässä kuvan päälle, näkyy QUICK VIEW -sana josta voi avata tuotteen keskelle ruutua ikkunaksi, jossa näkyy lyhyt kuvaus ja kuvat. Oheisesta linkistä voit ladata sanan PIKAKATSELU. Tiedoston nimi on quick_look.gif ja sillä korvataan hakemistossa /skin/frontend/default/default/md/quickview/images oleva samanniminen tiedosto. Lataa täältä

  • The requested content cannot be loaded. Please try again later. -virheilmoitus.

Order tickets[muokkaa]

Asiakas ja asiakaspalvelu voivat pitää yhteyttä lähetetyn tilauksen jälkeen. Asiakkaalle keskustelu näkyy omalta tililtä kyseisen tilauksen kohdalla. Kirjautumattomat asiakkaat eivät voi käyttää tätä palvelua. Asetukset löytyvät ylläpidonsta kohdasta Järjestelmä > Asetukset > Myynti > Myynti > Tilausten tiketit.

  • Teemasta riippuen asiakkaan viestin lähetyspainike kannattaa tarkistaa, se saattaa olla musta.
  • Cron ajona, joka tunnin 12 ja 42 -minuutti asetus on 12,42 * * * *
  • Laajennus on suomennettu tältä sivulta ladattavissa olevassa paketissa
  • Jos haluat sähköpostit suomenkielisinä, tee muutokset tiedostoon /app/code/community/Laurent/Order/Tickets/Model/Observer.php
$subject = 'Verkkokaupan asiakkaiden lähettämät viestit';
$body .= 'Asiakas '. $customerFullname .' lähetti ' . $coreHelper->formatDate($ticket->getCreatedAt(), 'full', ' ') ."\n";
$body .= 'Tilaus ' . $ticket->getChat()->getOrder()->getIncrementId() . "\n";

Zopim Live Chat[muokkaa]

Suora keskusteluyhteys asiakaspalveluun chat-ruudun avulla. Pidä tietokoneella tai tabletissa Zopim-ruutu auki ja kuulet kun joku tulee sivulle tai pyytää neuvoa. Voit myös seurata asiakkaiden liikkeitä sivulla ja reagoida tarpeen mukaan. Paljon säätömahdollisuuksia ja raportteja. 14 päivän testi täysillä, sitten rajoitetaan yhteen yhteyteen kerralla ellei makseta kuukausimaksua. Erittäin hyvä laajennus!

WebShopApps Matrix Rates[muokkaa]

Tuo lisävalikoimaa Magenton asennuksen (1.6.2) mukana tulevaan taulukkohintatoimitustapaan. Lisätoimintoja on tarkan painon määritys, huomaa että käytetään neljää desimaalia.

  • Itellan hintaesimerkki.
Maa,Maakunta,"Postitoimipaikka (isoilla kirjaimilla)",Postinumeroalkaen,Postinumeroloppuen,"Paino From","Paino To","Lahetyksen hinta",Toimitustapa
FI,*,*,*,*,0,2,"7.20","Postipaketti nouto postista"
FI,*,*,*,*,"2.0001",5,"8.50","Postipaketti nouto postista"
FI,*,*,*,*,"5.0001",10,"9.75","Postipaketti nouto postista"
FI,*,*,*,*,"10.0001",15,"12.95","Postipaketti nouto postista"
FI,*,*,*,*,"15.0001",30,"18.00","Postipaketti nouto postista"
  • Suomenkielinen käännös löytyy tämän sivun käännöspaketista. Infotekstiä varten ohessa suomenkielinen teksti. Korvaa teksti tiedostossa /app/code/community/Webshopapps/Matrixrate/etc/system.xml
Tämän moduulin on kehittänyt <a href="http://www.webshopapps.com" target="_blank">www.WebShopApps.com</a> - Magenton toimituslaajennusten spesialistit.

Käyttöohjeet ja esimerkit löytyvät WebShopApps-wikistä <a href="https://sites.google.com/a/webshopapps.com/webshopapps-wiki/extensions/matrix-rates">wiki</a>.
Valikoimastamme löytyy <a href="http://webshopapps.com/shipping-extensions/most-popular/premium-matrixrate-shipping-extension.html" target="_blank">Premium Matrixrate</a> kaupallisille käyttäjille. Se sisältää monia toimintoja, jotka vähentävät ylläpitoon käytettävää aikaa.
Meillä on laajin <a href="http://www.webshopapps.com" target="_blank">toimituslaajennusten</a> valikoima Magentolle.</a>

Kääntäminen[muokkaa]

Magenton nettisivuilla oleva suomenkielinen fi_FI paketti on vajaa ja sitä on liikkeellä myös eriasteisia versioita. Käännöstyön määräksi vajaasta paketista tulee helposti kymmeniä tunteja.

Wikikon käännöspaketti[muokkaa]

Tämä käännöspaketti ei ole virallinen Magenton käännöspaketti vaan vuoden 2012 versiosta alunperin kehitetty käännös, joka elää omaa elämäänsä. Viimeisimpänä siihen on tuotu 1.8.0 version englanninkieliset lauseet 24.12.2013. Se sisältää erityisesti ylläpidon puolen suomennoksen ja tarkastetun kaupan puolen. Mutta se on myös vajaa. Käännöksessä on muutettu lauserakenteita ja myös sanoja, joita alkuperäisessä käännöksessä on käytetty. Erityisesti huomiota on pyritty kiinnittämään ymmärrettävyyteen ja käytettävyyteen - on pyritty "suomentamaan". Paketti sisältää myös mallisähköpostit ja useita laajennusten käännöksiä. Paketin kääntäminen on lopetettu ja siirrytty Magento CE 2.x -version kääntämiseen (4/2016). Ajankohtainen tieto tämän paketin tilanteesta on latauskansiossa olevassta LUE TÄMÄ -tiedostossa. Lisäksi viestissä #40 osoitteessa http://www.magentosuomi.fi/yleinen-keskustelu/magento-suomennos/msg501/#msg501 on tietoa tästä käännöksestä.

Tietoon on tullut että tämä käännöspaketti ei ilmeisesti toimi 1.9 versiossa. Tarkoitukseni ei ole päivittää tätä käännöstä 1.9 versioon. Jos etsit Magento CE 2.x -versioon Wikikon käännöspakettia, katso sivu Magento 2.

Lataa viimeisin versio Tiedosto:Magento123kaannos v140823 klo1605 fi FI.zip
5.8.2014: tehty useita käytettävyyttä parantavia muutoksia kaupan ja ylläpidon puolelle.
24.12.2013: 1.8.0 us_US mukaan tehty käännös joka sisältää aikaisempien us_US -tiedostojen rivit, jotka puuttuvat 1.8.0 us_US -tiedostosta, täydellinen paketin oikoluku toukokuu 2013, käännetty kaikki sähköpostit --> hakemistossa fi_FI/template/email/ josta ne poimitaan magentoon, käännetty cms yms. sivuja (mm. evästeet) --> kopio manuaalisesti CMS sivuihin ylläpidossa, käännetty laajennuksia (muutettava tarvittaessa laajennusten config.xml-tiedostoa). Käännetyt: AW Blog, Fooman SameOrderInvoiceNumber, MD QuickView, Qaz Qsticker, Webshopapps Matrixrate, Zizio Powershare, lauserakenteita muutettu luettavampaan muotoon, kääntämisessä käytetään OmegaT -ohjelmaa (kts. http://wikikko.info/wiki/Magento#K.C3.A4.C3.A4nt.C3.A4minen), mitään ei ole käännetty tietokantaan, käännöstyö ja sopivien sanojen vaihtaminen jatkuu kun mielekkäämpi käännös löytyy, vapaasti jaossa. Em. wikikko -linkissä tiedusteluohjeet - lähetän sähköpostilla zip-pakettina. Käännöstä jaetaan tasaisesti muutamia kuukaudessa.
12.8.2013: tehty useita käytettävyyttä parantavia muutoksia kaupan ja ylläpidon puoelelle, korjattu oletussähköposteja, suositellaan päivitystä tammikuu 2014 versiosta.
ASENTAMINEN: Tiedosto on liitteessä zip-muodossa. Pakkaus on tehty Mac OSX ympäristössä, joten hakemisto sisältää piilotiedoston .DS Store, joka on Mac-hakemiston tiedosto, eikä liity Magentoon.
Esimerkki asennuksesta:
  1. Lisää uusi kansio: magento/app/locale/fi_FI
  2. Pura zip-tiedosto sinne, aseta käyttökieleksi ylläpidon etusivulta Suomi
  3. Tyhjennä välimuisti.
  4. a_Muut_tiedostot -kansiossa on ylläpidon kautta asennettavia copy-paste -CMS-tiedostoja
  5. template -kansiossa on ylläpidon kautta asennettavia sähköpostipohjia.

Huom! jos käännöksen perässä on WK? on kyseinen rivi käännetty, mutta se vaatii vielä tarkistuksen. Jos laajennusten käännökset eivät tule näkyviin, vaatii se itse laajennukseen pienen koodinpätkän lisäämisen. Katso ohje tältä sivulta.

Huom! jos haluat jo Magenton asennuksen olevan suomenkielinen, asenna tämä paketti ennen Magenton asentamista!

Kääntämisen perusteita[muokkaa]

  • Aseta käytettävä kieli suomeksi ylläpitopuolen sivun alalaidasta.
  • Magento hakee magento/app/locale/fi_FI -hakemistosta englanninkielisen " " -merkityn rimpsun mukaan suomenkielistä tekstiä. Esim. Mage_Checkout.csv -tiedostosta haetaan kaupan puolen maksamiseen liittyviä tekstejä "Sentence in english","Lause suomeksi"
  • Rimpsun pitää sijaita oikeassa csv-tiedostossa ja tämän voi selvittää esimerkiksi kytkemällä indeksoinnin pois käännös-kohdasta ja kytkemällä asetuksista viimeisestä kohdasta kehitys, "kääntämisen tietokantaan" päälle. Tällöin tekstien ympärille ilmestyy punainen laatikko ja tekstin päälle mentäessä pieni aukiolevan kirjan kuva. Tätä kuvaketta painettaessa avautuu ruutu, johon voi tehdä käännöksen suoraan tietokantaan. Saattaa olla että esim. Safari ei avaa, mutta Firefox avaa. Mutta tästä ruudusta saa myös vinkin mistä csv-tiedostosta käännöstä haetaan ja mikä on alkuperäinen englanninkielinen lauseke. Näin muutoksen voi tehdä esimerkiksi suoraan palvelimella tekstieditorilla selaimessa kyseiseen csv-tiedostoon, tallentaa ja päivittää selaimen. Muutos näkyy välittömästi. Tekstin koodaus on utf-8. Jos kyseisestä tiedostosta puuttuu, kokonaan rimpsu, kannattaa se kopioida copy-paste -tavalla että varmasti englanninkielinen versio tulee heittomerkkien väliin juuri oikein. Erottele suomenkielinen käännös heittomerkkien välissä pilkulla. Mutta voit tehdä myös käännöksen suoraan tietokantaan edellä kuvatulla tavalla. Tämä siis ei muuta näitä .csv -tiedostoja.
  • Lisää app/locale/fi_FI -hakemisto, ei siis tarvitse korvata esimerkiksi us_US -hakemistoa suomenkielisellä käännöstiedostoilla.
  • Osa teksteistä ei kuitenkaan reagoi käännöksiin. Näitä saattavat olla esimerkiksi tuotetietojen rivien nimet. Nämä ovat ominaisuuksia, jotka asetetaan tietokantaan Luettelo/Ominaisuuksien hallinta -kohdasta.
  • fi_FI hakemistossa on myös sähköpostipohjat omassa /template/email -kansiossa. Nämä pitää kääntää suoraan html-koodin sekaan. Tarvittavia muuttujia on helppo lisätä kopioimalla niitä ylläpidon sähköpostieditorin kautta eli ei kannata kirjoittaa suoraan esimerkiksi puhelinnumeroa, koska se saadaan automaattisesti haettua viestiin sivun asetuksista. Yhteystietojen muuttuessa ei silloin tarvitse plärätä kaikkea läpi vaan yksi muutos ylläpidossa riittää.
  • fi_FI hakemistossa on myös CMS -käännöksiä kuten evästeet ja 404. Nämä kopioi käsin wysiwyg-editoriin kohtaan CMS/Sivut.
  • Tietokantaan kääntäminen ei tallenna käännöksiä CSV-tiedostoihin.

Kääntäminen tietokantaan[muokkaa]

Käännökset voi tehdä myös suoraan kaupan ja ylläpidon puolelta tietokantaan. Tällöin tekstien ympärille ilmestyy punainen laatikko ja tekstin päälle mentäessä pieni aukiolevan kirjan kuva. Tätä kuvaketta painettaessa avautuu ruutu, johon voi tehdä käännöksen suoraan tietokantaan. Saattaa olla että esim. Safari ei aina avaa, mutta Firefox avaa. Jos käännät suoraan tietokantaan, ei saman sanan käännös toimi CSV tiedostojen kautta, joten tapa ei ole suositeltava.

  • Ylläpidon puolella > Järjestelmä > Asetukset > Kehitys > Kääntäminen suoraan tietokantaan > Käytössä kaupan puoella Kyllä > Tallenna asetukset.

Kääntäminen[muokkaa]

Magenton versiossa 1.6.2.0 version mukana tulevassa en_US versiossa käännettäviä kohteita oli noin 8000 kpl. Osa niistä on suunnattu maksupalveluihin, Amerikan markkinoille jne. joten kaikkea ei liene tarvetta kääntää. Hyvin toteutettu kääntäminen vaatii perehtymistä kaupan toimintoihin ja vakiintuneiden termien käyttämistä yhtenevästi. Tällaisen käännösmäärän käsittely on aikaa vievää etenkin tekstieditorilla.

Yksittäisiä muutoksia ja korjauksia toki voi tehdä tietokantaan tai tekstieditorilla suoraan esimerkiksi palvelimella csv-tiedostoihin kuten edellä on kerrottu, mutta lähdettäessä kääntämään koko tiedostoa, kannattaa käyttää apuna ohjelmaa nimeltä OmegaT. Tähän ohjelmaan ladataan en_US hakemisto ja esimerkiksi osittain käännetty fi_FI hakemisto. Ohjelma pitää csv-tiedostot erillään, mutta itse ohjelmassa voidaan hakea haluttu teksti kaikista lausekkeista yli tiedostorajojen. Käännettäessä ohjelma kääntää automaattisesti ne lauseet jotka ovat täysin samoja entuudestaan ja ehdottaa käännöksiä niihin joita ei ole käännetty. Ohjelmaan on helppo luoda esimerkiksi Wordin avulla oma sanasto, joista ilmestyy näyttöön aina ne sanat joita esiintyy käännöksen alla olevassa lauseessa. Ohjelmassa on myös muita kääntämistä helpottavia ja nopeuttavia toimintoja. Suosittelen ehdottomasti tätä ohjelmaa. Teen käännökset aina sillä omalla tietokoneella ja ajoittain siirrän ne palvelimelle fi_FI -hakemistoon. Näin pystyn pitämään yhtenäisyyttä, koska OmegaT hakutoiminto ja ehdotukset helpottavat tässä. En ole kääntänyt yhtään tietokantaan.

  • Huom! Osassa lauseita on virhe jossa \ viiva on esimerkiksi heittomerkin edessä. Tällöin käännös ei välttämättä ilmesty suomeksi. Kokeile tällöin poistaa kyseiset viivat.
  • Vinkki! csv-tiedostoihin tehdyt muutokset saat näkymään heti tallennuksen jälkeen kun tyhjennät Magenton välimuistin.

OmegaT asennus ja kielipakettien asennus[muokkaa]

OmegaT asennus[muokkaa]

Tämä versio osaa huomioida Magenton. Aikaisempien versioiden kanssa saattaa ilmetä ongelmia csv-tiedostojen tuontien kanssa.

    • Pura zip-paketti ja vedä OmegaT Macin ohjelmat-hakemistoon.
  • Lataa omegat_csv.zip -paketti osoitteesta http://www.piotrkaminski.com/public/omegat_csv.zip
    • Pura zip-paketti ja siirrä tiedostot sieltä oikeisiin OmegaT -hakemistoihin.
    • Macissa paina hiiren oikeaa painiketta Finderissa ohjelmat-kansiossa OmegaT ohjelman päällä ja valitse Näytä pakkauksen sisältö. Tiedostot sijoitetaan hakemistoihin Contents/Resources/Java/lib ja /plugins
  • Käynnistä OmegaT hakemistosta Contents/MacOS/JavaApplicationStub
  • Valitse Project/New... ja anna projektille nimi
    • Aseta Source Files Language en-US ja Translated Files Language fi-FI. Poista väkänen kohdasta Enable Sentence-level Segmenting ja katso että File Filters... -kohdassa on väkänen Magento CE Locale CSV Files -kohdassa.

Käännettävän kielipaketin asennus[muokkaa]

  • Hae Magenton app/locale/ hakemistosta en_US -hakemisto. Tarvittaessa joudut pakkaamaan sen ensin esim. zip-tiedostoksi (Compress) ja vasta sitten saat sen ladattua.
  • Pura paketti
  • Valitse toisesta ikkunasta Import Source files ja tuo sillä kerralla kaikki halutut käännös tiedostot en_US -hakemistosta. Tämä on nyt siis SE tiedosto jota aletaan kääntämään. Ei haittaa vaikka tuot sellaisiakin joita et aio kääntää. Tiedostot löytyvät projektikansion hakemistosta source.

Aikaisemmin käännetyn kielipaketin asennus[muokkaa]

Huom! Alkuperäinen ohje mainitsee että kaikki kääntämättömät lausekkeet täytyy poistaa, ettei niitä merkitä "käännökset ovat yhtäläiset alkuperäisen tekstin kanssa" OmegaT:n niitä yhdistellessä automaattisesti. Mutta ei esim. "HTML","HTML". Tätä en tehnyt...täytyy selvittää...

  • Voit tuoda myös osittain käännetyn fi_FI kielipaketin avuksi, jolloin valmiiksi käännetyt ovat käytössäsi automaattisesti tai pienellä korjaamisella. Kielipaketista täytyy muodstaa tmx-tiedosto. Tämä tapahtuu palvelimella.
    • Yksi vaihtoehto on tuoda kielipaketti Magenton sivuilta osoitteesta http://www.magentocommerce.com/langs Valitse kohta Download Package.
    • Toinen vaihtoehto on tuoda kielipaketti asennetusta Magento verkkokaupasta, jonka csv-tiedostoihin olet tehnyt jo omia muutoksia.
  • Tee palvelimella File Managerin tai SSH:n avulla seuraavat temput:
    • Tee app/locale/ -hakemistoon uusi tiedosto jollain nimellä, mutta .php -päätteellä. Tiedoston oikeudet voivat olla esim. 0755. Sijoita tiedostoon seuraavasta osoitteesta löytyvä koodi http://www.piotrkaminski.com/public/csv_to_tmx.phps
    • Muuta tiedostoon seuraavat rivit $dest_lang = 'FI'; ja $src = 'fi_FI';
  • Aja skripti päätteessä komennolla php tiedostonimi.php
  • Kopioi muodostunut all.tmx -tiedosto OmegaT projektisi hakemistoon tm/auto/
  • Valitse OmegaT ohjlemassa Project/Reload

OmegaT asetuksia[muokkaa]

  • Säädä tarpeen mukaan kohdasta Options/Editing Behaviour esimerkiksi millä tarkkuudella käännösehdotuksia tehdään.
  • Kääntäminen voi alkaa. Voit edetä enteriä painamalla lausekkeesta toiseen kääntämällä suoraan vasempaan ruutuun, käyttää pikavalintoja hiirellä tai näppäimistöltä tekstien valinnan nopeuttamiseen jne. Esimerkiksi shift-cmd-i kopioi en_US tekstin, nuoli ylös ja alas siirtää rivin alkuun tai loppuun, Cmd-1 jne. valitsee ehdotuksen suoraan. Kääntämisen alla oleva csv-tiedosto näkyy yläkulmassa ja toisesta ikkunasta voit valita halutun csv-tiedoston. Cmd-f -hakutoiminto on tehokas! Käännökset jotka siirretään automaattisesti fi_FI käännöksestä en_US käännökseen ovat ??täysin samoja?? eli en_US ja fi_FI käännöksen englanninkielinen lauseke täsmää. Tai jos ne ovat ehdotuksia niin niiden eteen ilmestyy [fuzzy]-sana. Tätä asetusta voi säätää kohdassa Options/Editing Behaviour. Voit myös hypätä suoraan seuraavaan kääntämättömään Cmd-u -näppäinyhdistelällä.
  • Huom! Ole tarkkana erityisesti sitaattien kanssa. Niitä pitää yleensä olla tuplat eli "" . Käännöksessä olevat html-koodit ja erityisesti %s on oltava juuri samoin, mutta niiden sijainti voi lauseessa vaihdella. # -merkki ilmoittaa yleensä esim. tilausnumeroa, eli sen voi myös jättää pois, mutta kannattaa korvata tällöin välilyönnillä.
  • Glossary otetaan käyttöön avaamalla esimerkiksi Word ja tekemällä .txt -tiedosto joka sijoitetaan projektin glossary -hakemistoon. Valitse txt-tiedoston koodaukseksi varmuuden vuoksi utf-8.

CSV-tiedostojen vienti Magentoon[muokkaa]

  • Tallenna normaalisti projekti jolloin käännökset tallentuvat. Kun haluat muodostaa csv-tiedostoja valitse Project/Create translated documents, jolloin projektin /target-kansioon muodostuu csv-tiedostot. Ei haittaa vaikka Target kansiossa säilyttää esimerkiksi sähköpostimallipohjat ja CMS-tiedostot.
  • Vienti Magentoon tapahtuu yksittäin tai valitsemalla Omegan targen-kansiossa kaikki tiedostot (Cmd-A), hiiren oikea näppäin, pakkaa x kohdetta. Kopioi palvelimella varmuuden vuoksi vanha magento/app/locale/fi_FI -hakemisto toiselle nimelle ja lisää tällöin uusi fi_FI -kansio. Kopioi zip-tiedosto palvelimelle ja pura se fi_FI -kansioon. Tyhjennä välimuisti ja uusi käännös on käytettävissä.

Päivitys[muokkaa]

  • Magenton julkaistessa uuden päivityksen, lisätään ja muutetaan us_US -csv-tiedostoista rivejä. Nämä uudet tiedostot voi kopioida OmegaT:n source -hakemistoon csc-tiedostoihin, jolloin ne pääsee kääntämään ja viemään käännettynä OmegaT:n target-kansiosta päivitettyyn Magentoon. Ikävää on se että nämä us_US -csv-tiedostot eivät välttämättä sisällä kaikkia rimpsuja, eli suomenkielisiäkäännöksiä menetetään jos otetaan ainoastaan käyttöön uuden version tiedostot. OmegaT muistaa kyllä vanhoja käännöksiä jos uusia tuo ja merkitsee ne [f] tai automaattisesti tekee käännöksen.
  • Netissä olevalla http://www.diffnow.com -palvelulla voi verrata csv-tiedostoja manuaalisesti ja liittää puuttuvat uuteen käännökseen vanhasta, mutta homma on aikaa vievää hiirellä napsuttelua.
    • http://www.diffnow.com
    • Tee kaksi kansiota joissa toisessa on OmegaT:n viimeisin käännös ja toisessa Magenton viimeisin käännös. Siirrä kansiot hakemistopuussa tarvittaessa pikalinkeillä samaan kansioon tms.
    • Avaa esim. vasempaan ikkunaan (First file) alkuperäinen ja oikeaan (Second File) uusi.
    • Muutokset näkyvät Added, Changed, Changed in changed. Huomaa myös keltaiset eli changed koska käännös ei hyväksy \ -merkkiä saattaa rivillä olla kuitenkin joku muutos.
    • Kopioi rivit alkuperäiseen csv -tiedostoon ja tallenna.
    • Paina OmegaT:ssä F5 ja tee käännös ja tallenna cmd-s
    • Ja seuraava tiedosto... Kannattaa ehkä aina painaa DiffNow -logoa jotta sivu latautuu uudestaan, muutoin ehkä jumittaa useammin.

Ohjeen lähteet[muokkaa]

Laajennusten kääntäminen[muokkaa]

Magenton käännökset kannattaa keskittää fi_FI -kansioon, jolloin ne ovat helposti hallittavissa. Laajennusten mukana tulee lisää käännettävää, jonka joku on jo kääntänyt. Jos lähdet tekemään käännöstä itse, tässä yksi esimerkki:

  • Laajennus asentuu kansioon /app/code/community/laajennoksen nimi/etc tai /app/code/local/etc
  • Tiedoston config.xml tulee sisältää seuraavat rivit, jotta laajennus osaa etsiä tiedostoa esimerkiksi fi_FI -hakemistosta. Tiedoston csv-nimi näkyy config.xml tiedoston yläosassa <modules> tagin jälkeen. Esimerkissä MatrixRate -ohjelma, jonka valmistaja on Webshopapps eli paketinnimi_laajennuksennimi. Tämä koodin pätkä on jo kenties valmiina koodissa. Huomaa että Magenton pakettiin sisältyvät ovat Mage_ -alkuisia eli esim. Mage_Captcha.csv
  • Aseta rivt <adminhtml> ja </adminhtml> tagien väliin niin se vaikuttaa ylläpidon puolelle ja <frontend> ja </frontend> välille, jolloin se vaikuttaa kaupan puolelle. Kummassakin tapauksessa </layout> tagin jälkeen jos sellaiset löytyy. Jos adminhtml tageja ei ole, niin lisää ne translate-tagien ulkopuolelle eli ennen ja jälkeen. Yleensä adminhtml tagit sijaitsevat global ja default tagien välissä.
        <translate>
            <modules>
                <Webshopapps_Matrixrate>
                    <files>
                        <default>Webshopapps_Matrixrate.csv</default>
                    </files>
                </Webshopapps_Matrixrate>
            </modules>
        </translate>
  • Jos käytät OmegaT -ohjelmaa, lue seuraava kappale.
  • Monista joku fi_FI kansiossa oleva tiedosto ja nimeä se uudelleen Webshopapps_Matrixrate.csv tai mikä nyt on kyseessä.
  • Tee käännös normaalisti lausekkeilla. Käännettävät lauseet täytyy kopioida sivustosta tai koodista. Koodissa se näkyy esimerkiksi näin: < ?php echo $this->__('Why every Finn likes to do his own translation') ?> Järkevintä lienee kuitenkin kytkeä tietokantakäännös asetuksista päälle, jolloin saa näkyviin alkuperäisen käännettävän lauseen.
  • Tyhjää välimuisti jos kokeilet ja haluat muutoksien näkyvän heti.

Siirto OmegaT ohjelmaan[muokkaa]

  • Avaa jokin aikaisempi csv käännöstiedosto sourcekansiosta, tallenna siitä kopio uuden moduulin .csv -päätteellä ja tyhjennä sen sisältö (UTF-8 koodi pysyy samana..). Kopioi tiedostoon alkuperäiset englanninkieliset lauseet kahteen kertaan peräkkäin kummatkin sitaateissa pilkulla erotettuna.
    • HUOM! OS X -käyttäjät. Jos käytät TeXturia, niin Mavericks-käyttiksessä ainakin näyttää olevan automaattisesti Muokkaa > Korvaukset > Näytä korvaukset -kohdassa päällä Älykkäät lainausmerkit eli " ja ' merkit pitää olla oikein. Poista tämä valinta, koska älykkäät lainausmerkit eivät ole Omega T:n eikä ehkä Magentonkaan hyväksymiä ja homma ei toimi. Asetuksen saa kokonaan pois päältä Järjestelmäasetukset > Näppäimistö > Teksti > Käytä älykkäitä lainausmerkkejä ja väliviivoja.
  • Tallenna tämä OmegaT source kansioon.
  • Avaa normaalisti OmegaT käännös ja uudet lausekkeet ovat käännettävissä. Tällätavoin voit myös hyödyntää jo aiempia käännöksiä yhtäläisyyden säilyttämiseksi.

Asennus 14.10.2013: Magento ver 1.8.0.0[muokkaa]

Selvitä palvelimesi toimivuus Magentolle[muokkaa]

Mac OSX asennus[muokkaa]

  • Oman tietokoneen käyttäjähakemistosi Sivustot -hakemistoon.
  • Omassa tietokoneessa kytke järjestelmänhallinnasta Jako/Web-jako päälle ja klikkaa siitä vierestä oman hakemistosi linkkiä.
  • Selain aukeaa, lisää osoiterivin loppuun magento-check.php ja paina enter

Tietokannan perustaminen[muokkaa]

  • Yksinkertaista on jos käytössäsi on esimerkiksi cPanel, jossa voit käyttää MySQL Database Wizard -ohjelmaa. Tietokannan voi myös perustaa phpMyAdmin -ohjelmalla.
  • MySQL Database Wizard
    • database: anna sopiva nimi tietokannalle. Älä käytä ääkkösiä.
    • username: anna käyttäjätunnus ja salasana. Salasana sopii olla monimutkainen.
    • all priviledges -oikeudet

Magenton lataus palvelimelle suoraan[muokkaa]

  • Siirry SSH-palvelimelle, jos sinulla on siihen käyttöoikeus. SSH täytyy asentaa ennen kuin sitä voidaan käyttää. Lisätietoa Wikikon sivulta SSH. Kirjautuminen asennuksen jälkeen voi tapahtua esimerkiksi antamalla Pääte-ohjelmassa komento: ssh käyttäjä[email protected]
  • Siirry esimerkiksi /html tai /www -kansioon. Tar-komento luo itse magento-hakemiston.
  • katso Magenton web-sivulta download -kohdasta mikä on viimeisin versio ohjelmistosta ja sen tiedostonimi
  • wget http://www.magentocommerce.com/downloads/assets/1.7.0.2/magento-1.7.0.2.tar.gz
  • VARO! Jos sinulla on jo hakemisto /magento ja se sisältää esimerkiksi vanhan version, seuraava purkutoiminto ajaa uuden sen päälle !
  • tar -zxvf magento-1.7.0.2.tar.gz # puretaan tiedosto
  • rm magento-1.7.0.2.tar.gz (poistetaan ladattu tiedosto, magento-niminen kansio jää)

Magenton lataus oman tietokoneen kautta palvelimelle[muokkaa]

  • Lataa ohjelmisto Magenton sivulta. Sen voi ladata myös ilman rekisteröitymistä. Tämä vaihtoehto on todennäköisesti hitaampi kuin suoraan palvelimelle lataaminen.
  • Lataa magento-hakemisto palvelimellesi, esimerkiksi /html -hakemistoon ftp-ohjelmalla
  • Pura tiedosto (Extract)

Suomi-kielipaketti[muokkaa]

Asentamalla kielipaketin nyt, varsinainen asennus on myös suomenkielinen. Asennuskieli vaihdetaan heti toisella asennussivulla määritettäessä Alueeksi Suomi(Suomi) / suomi (Suomi)

  • Wikikon tältä Magento -sivulta löydät Magenton "Wikikon käännöspaketin" hakuohjeet. Voit myös hakea Magenton kotisivuilta laajennuksen (extension) Finnish language pack.
  • cPanelilla app/locale -hakemistoon fi_FI -hakemiston perustaminen ja tiedostojen siirto (Upload) zip-pakettina ja pakettien purku Extract -toiminnolla
  • Päätteessä cd app/locale ja mkdir fi_FI ja tiedoston siirto ja purku

TAI suomenkielinen paketti voidaan asentaa myös myöhemmin ylläpidon kautta Magento Connect. Aseta tällöin Settings kohtaan Beta

Asennusohjelman ajaminen[muokkaa]

  • Anna selaimessa osoite http://www.esimerkki.fi/magento (tarvittaessa jos sivustolla on uudellenohjauksia www.esimerkki.fi/magento/index.php)
  • Hyväksy lisenssiehdot rastittamalla
  • Suomi (kieli vaihtuu nyt jos Suomi-kielipaketti asennettu), E. Europe Standard Time (Europe/Minsk), euro
  • tietokannan tyyppi: MySQL
  • Isäntäpalvelin: localhost
  • Tietokannan nimi: Nimi jonka tietokannalle annoit
  • Tietokannan käyttäjätunnus ja salasana
  • Taulujen etuliite: jos haluat erottaa kyseisessä tietokannassa tämän magentoasennuksen taulut muista tauluista. Sana kirjoitetaan yhteen joten on selvempää antaa se alaviivalla eli muodossa etuliite_
  • Juuriosoite: hyväksy mikä on
  • Ylläpidon osoite: vaihtoehtoisesti joku oma osoite admin -oletuksen tilalle
  • Ota käyttöön kaaviot
  • Älä ohita juuriosoitteen varmentamista
  • Käytä palvelimen (Apache) uudelleenkirjoitusta
  • Käytä salattua URL-osoitetta (SSL) jos sellainen on käytettävissä. Vaatii yleensä niiden erikseen ostamista.
  • Tallenna istunnon tiedot tiedostojärjestelmään (tai tietokantaan)
  • Henkilökohtaiset tiedot
  • Salausavaimen voi antaa Magenton itse generoida, kirjaa se ylös suraavalta sivulta
  • Vastaa vapaaehtoiseen kyselyyn

Cron ajastus[muokkaa]

Magento tarvitsee myös taustalle ajoja, jotka tekevät toimenpiteitä kuten Google sivukartta, uutiskirjeiden lähetys, historiatietojen poisto jne. Katso tarkemmat ohjeet seuraavalta sivulta kohdasta Magento

Cron

Tiedostojärjestelmän oikeuksien asetus[muokkaa]

Tiedostojärjestelmän oikeudet kannattaa asettaa päätteen kautta seuraavilla komennoilla, koska asetettavaa on paljon. Mutta pienet säädöt voi tehdä myös esimerkiksi cPanelin tai FTP-ohjelman avulla. Jos . -alkuisia piilotiedostoja ei näy, aseta ohjelman asetuksista niiden näkyminen päälle tai cPanelissa valitse Show Hidden Files (dotfiles). cPanelissa valikon kohta Change Permissions tai Ftp-ohjelmassa mene kyseisen hakemiston päälle ja valitse hiiren oikean näppäimen takaa "tietoja" "oikeudet" tms.

Huomaa että muutosten jälkeen sivut eivät välttämättä toimi!
OTA VARMUUSKOPIO TIETOKANNASTA JA KOKO /MAGENTO -HAKEMISTOSTA!

Varmuuskopio kannattaa sijoittaa varsinaisen rinnalle, joten tarvittaessa on helppo vain muuttaa magentohakemiston nimeä, jolloin sivuston voi välittömästi saada toimintaan vanhoilla oikeuksilla. HUOMAA että jos paketoit tiedoston ja purat sen, purku todennäköisesti ylikirjoittaa koska purettava hakemisto on saman niminen. Helpointa on siis kopioida toiselle nimelle pääte-ohjelmalla paketoimatta tai vain olla huolellinen pakettia purkaessa.

Huomaa myös sellainen seikka, että tiedosto-oikeuksia asetettaessa oma internetselaimesi saattaa temppuilla välimuistin takia, joten sivusto voi näkyä oikein tai väärin, vaikka kaikki olisi päinvastoin. Tyhjennä siis selaimen välimuisti ja lataa sivu uudelleen joka kerran kun teet oikeuksien muutoksia, nähdäksesi todellisen tilanteen.
http://www.magentocommerce.com/knowledge-base/entry/install-privs-after

Edellä mainitulla sivulla ohjeistetaan asettamaan tiukimmat mahdolliset oikeudet eli 400 ja 500 sekä media ja var -hakemistoille myös kirjoitusoikeudet. Magenton tarvitsee kirjoittaa vain media- ja var -hakemistoihin, muista se vain lukee normaalisti. Lisäosien asennuksen ajaksi tiedosto-oikeuksia tarvitsee kuitenkin muuttaa! Includes-hakemisto ja sen alihakemistot tarvitaan kokoamis-toiminnon ajamiseen laajennusten asentamisen jälkeen.

Saattaa kuitenkin olla että asiakas ei pysty lataamaan kuvia, javaskriptejä ja tyylitiedostoja. Seuraavissa komennoissa tämä on otettu huomioon. Eli jos tarve ei vaadi muuttamaan skin- ja js -hakemistojen oikeuksia, älä turhaan muuta niitä. Jotkin kolmannen osapuolen teemat vaativat kuitenkin tämän. Huomaat sen esimerkiksi siitä että osa ulkoasun kuvista jää latautumatta tai sivusto ei lataudu oikein, joten todennäköisesti skin-hakemisto tarvitsee lukuoikeuksia ja jos esimerkiksi javaskriptillä toimiva menu ei ilmesty tai asiakkaan sisäänkirjautumisen "mikä tämä on" ei toimi tms., aseta js -hakemistolle laajemmat oikeudet.

Lähtökohtaisesti voit ajaa uudestaan niin monta kertaa oikeuksia, että saat ne toimimaan. Piste vaikuttaa KAIKKIIN hakemistoihin, myös itse magento-hakemistoon. Määrittelemällä hakemiston nimen se vaikuttaa vain siihen ja KAIKKIIN sen alahakemistoihin. f-kirjain tarkoittaa tiedostot ja d -tarkoittaa hakemistot. Esimerkin komennoissa siis ensin asetetetaan KAIKKI tiedostot 400 ja 500 ja sitten var- ja media-hakemistot toisiin arvoihin. Niissäkin hakemistot ja tiedostot eri arvoihin.

Lisätietoa komennoista ja oikeuksista löytyy sivuilta Unix ja Tiedosto-oikeudet.

400 Omistaja voi vain lukea
500 Omistaja voi vain lukea ja suorittaa
600 Omistaja voi vain lukea ja kirjoittaa
700 Omistaja voi vain lukea, kirjoittaa ja suorittaa
644 Kaikki saavat lukea, mutta omistaja voi vain kirjoittaa
711 Omistaja voi lukea, kirjoittaa, suorittaa ja ryhmä suorittaa ja muut suorittaa
404 Omistaja ja muut voi lukea
755 Kaikki voi lukea ja suorittaa, mutta omistaja myös kirjoittaa
JOS TIEDÄT VIELÄ TIUKEMPIA, MUTTA TOIMIVIA OIKEUKSIA, OLE HYVÄ JA KIRJOITA TÄLLE SIVULLE NIISTÄ
  1. Varmuuskopioi tiedostojärjestelmä
  2. Huomaa että sivusto ei toimi asiakkaille komentojen antamisen aikana ennen kuin viimeinen komento on annettu
  3. Siirry Magenton juurihakemistoon, siis siihen jossa on app, media jne.
  4. Anna komennot yksitellen ja ODOTA että ne valmistuvat. Osa voi kestää minuutin, pari riippuen verkkokauppasi koosta ja laajennusten määrästä
  5. Tyhjennä selaimen välimuisti ja lataa sivu uudelleen. Kokeile myös toisessa selaimessa, mobiililaitteessa tms.
find . -type f -exec chmod 400 {} \;
find . -type d -exec chmod 500 {} \;
find var/ -type f -exec chmod 600 {} \; 
find var/ -type d -exec chmod 700 {} \; 
find media/ -type f -exec chmod 644 {} \;
find media/ -type d -exec chmod 711 {} \; 
chmod 404 .htaccess
chmod  755 ../magentonjuurihakemistonnimitähän

find skin/ -type f -exec chmod 644 {} \; 
find skin/ -type d -exec chmod 711 {} \;
find js/ -type f -exec chmod 644 {} \;
find js/ -type d -exec chmod 711 {} \;
find includes/ -type f -exec chmod 644 {} \;
find includes/ -type d -exec chmod 700 {} \;
/errors/default/images/logo.gif hakemistot 755 ja logo 644 ehkä?


  • Nollaus alkuperäisiin:
find . -type d -exec chmod 775 {} \;
find . -type f -exec chmod 664 {} \;
chmod 777 -R downloader var media

Päivitys[muokkaa]

Koska tiedosto-oikeudet ovat edellisten asetusten myötä tiukat, et pysty välttämättä kirjoittamaan hakemistoihin. Jos olet yhteydessä SFTP (SSH) -yhteydellä voit ainakin tällöin muuttaa sen hakemiston ja sen sisällä olevien tiedostojen oikeudeksi johon haluat tallentaa 700. Tällainen voisi olla esimerkiksi fi_FI jos päivität kielitiedostoa. Ei siis tarvitse muuttaa koko hakemistopolkua juurihakemistosta asti.

Virhetilanteet[muokkaa]

  • 404-virhe. Tarkista ensimmäisenä .htaccess tiedosto magenton juurihakemistossa ja itse magentohakemisto.

Aiheeseen liittyvää[muokkaa]

Turvallisuus[muokkaa]

http://addoa.com/blog/ten-tips-keeping-your-magento-store-secure

Uudelleenasennus velholla[muokkaa]

  • Tuhoa app/etc/local.xml ja var/ -hakemiston tiedostot.

Päivitys 1.6 --> 1.7[muokkaa]

Ohje sivulta: http://turnkeye.com/blog/magento-upgrade-guide/#.UW-aZZUdeYQ

  • Siirry päätteellä Magenton juurihakemistoon
  • chmod 550 mage (tämä vapauttaa virheilmoituksesta Permission denied)
  • ./ mage list-upgrades
  • ./mage config-set preferred_state stable (päivittää stable- versioihin eli "toimiviin")
  • ./mage upgrade-all --force (voi kestää aika kauan, mutta lopputuloksena ilmestyy lista päivitetyistä osista)
  • php -f ./index.php

Aiheeseen liittyvä sivu: http://www.magentocommerce.com/wiki/1_-_installation_and_configuration/upgrading_magento

Magenton kopiointi[muokkaa]

Kun verkkokauppa on tuotannossa eli myyntiä tapahtuu, ei ole koskaan järkevää tehdä laajennusten asennuksia ja testauksia tällaiseen verkkokauppaan. Tätä varten tarvitaan testiversio verkkokaupasta. Tämä on joko kertakopio sen hetkisestä tilanteesta tai peilaava, joka automaattisesti pysyy ajantasalla tuotannossa olevan kanssa. Kopio voi olla joko samalla palvelimella tai omalla tietokoneella. Jos kuitenkin teet tuotannossa olevaan versioon asennuksia ilman testausta tai aina kun asennat laajennuksen, ota vähintään täysi varmuuskopio tietokannasta ja tiedostojärjestelmästä. Tällöin on helppo palauttaa tilanne ennalleen, jos asennuksessa joku menee pieleen.

Yleistä[muokkaa]

  • Älä asenna kopiota samaan tietokantaan, vaan perusta testiversiolle oma tietokanta

Kopiointi OSX -järjestelmään[muokkaa]

  1. Wikikosta löytyy muilta sivuilta ohjeet OSX-käyttöjärjestelmän palvelinkäyttöönottoon.
  2. Aseta Magento huoltotilaan maintenance-lipulla juurihakemistossa ettei tietokanta ja tiedostojärjestelmä poikkea toisistaan.
  3. Varmuuskopioi Magento tietokanta
    1. PhpMyAdmin -ohjelmalla vienti (export) ehdotetuilla asetuksilla.
  4. Varmuuskopioi Magento tiedostojärjestelmä joka ei poikkea tietokannasta.
    1. Esimerkiksi pääteyhteydell: zip -r varmuuskopionimi.zip kaupanhakemisto tai Cyberduck -ohjelmalla muodosta zip-paketti ja lataa paikalliselle koneelle.
  5. Palauta tuotantoversio huoltotilasta.
  6. Luo uusi paikallinen tietokanta ja anna (kaikki) oikeudet tarvittaessa toiselle käyttäjälle.
    1. http://localhost/~käyttäjänimesi/phpmyadmin/
  7. Tuo Magenton tietokanta
    1. PhpMyAdmin -ohjelmalla valitse juuri luomasi tietokanta ja tuo siihen varmuuskopimasi Magento tietokanta.
    2. Jos saat virheilmoituksen "Yritit ehkä lähettää palvelimelle liian suurta tiedostoa.", php.ini tiedostossasi on rajoite. Katso PHP asennus.
    3. Myös muita tuontivirheitä voi ilmetä. Kirjaa ylös!
  8. Pura tiedostojärjestelmä hakemistoon Macintosh HD/Käyttäjät/käyttäjänimesi/Sites/verkkokauppahakemistonimitähän
    1. Poista seuraavat hakemistot:
      1. /downloader
      2. /var hakemiston sisällä olevien hakemistojen tiedostot mutta ei .htacces tiedostoja
      3. /media/tmp
    2. Muuta /app/etc/local.xml -tiedostoon uuden tietokannan tiedot. Jos tiedosto-oikeudet Magentossa on tiukat, et pääse muokkaamaan tiedostoa höllentämättä niitä. Muutoksen voi tehdä esim. Finder:lla
    3. Jos käytössäsi on php välimuisti, esimerkiksi apc, poista samasta tiedostosta rivit jotka käyttävät sitä. Testiympäristössä välimuistin käyttäminen on turhaa, koska on helpompaa kun kaikki muutokset tulevat näkyviin heti.
  9. Muuta sivuston osoite suoraan tietokantaan muokkamalla taulua core_config_data kahdesta kohtaan web/unsecure/base_url ja web/secure/base_url Jos et käytä SSL-suojausta paikallisella tietokoneella, arvo on kumpaankin sama.
    1. Aseta PhpMyAdmin ohjelmalla arvoksi (value) käyttämäsi osoite. Huomaa että osoite loppuu kauttaviivaan. http://localhost/~käyttäjänimesi/verkkokauppahakemistonimitähän/
    2. Osoite on todennäköisesti käytössä myös muualla ja näitä voi esimerkiksi etsiä PhpMyAdmin -ohjelmalla etsi-toiminnon avulla (valitse kaikki taulut) tai toimivan sivuston kautta.
  10. Kokeile kopiota. HUOM Varmista osoiteriviltä ettet ole joutunut tuotannossa olevaan alkuperäiseen kauppaan! Saattaa olla myös että selaimesi välimuisti ohjaa sinut alkuperäiseen kauppaan. Tyhjennä selaimen välimuisti ja mahdollisesti jopa kaikki selaimen tiedot jos pelkkä välimuistin tyhjentäminen ei auta. Tai kokeile toisella selaimella, esim. Firefox:lla Safarin sijaan.
    1. Jos saat esim. ilmoituksen The requested URL /Users/käyttäjänimesi/Sites/verkkokauppahakemistonimitähän/index.php was not found on this server. on toimiva muoto sivun nimi index.php/ jälkeen. Tämä todennäköisesti korjautuu Järjestelmä > Yleinen > Internet > Hakukoneiden optimointi > Käytä palvelimen osoitteen uudelleenohausta > Ei > Tallenna asetukset > Tyhjennä Magenton välimuisti. Jos ei auta, katso mitä .htaccess tiedostosta on sanottu ohjeissa tuonnempana.
    2. Osoite ylläpitoon on http://localhost/~käyttäjänimesi/verkkokauppahakemistonimitähän/index.php/admintaimahdollinenkäyttämäsikorvike
      1. Kytke pois GoogleAPI. Järjestelmä > Myynti > Google API > Google Analytics -verkkoanalyysi > Ei
      2. Aseta Järjestelmä > Ulkoasu HTML Head > Näytä Demokaupan ilmoitus > Kyllä
      3. Säädä sähköpostiosoitteet jos haluat testisähköpostit eri osoitteeseen kuin tuotannosta tulevat. Järjestelmä > Yleinen > Kaupan sähköpostiosoitteet ja Järjestelmä > Myynti > Myynnin sähköpostit
      4. Kytke pois maksutavat joita et halua testikäytössä käytettävän
      5. Kytke pois SSL. Järjestelmä > Yleinen > Internet > Salattu (SLL) > Käytä salattuja URL-osoitteita kaupan puolella > Ei ja ylläpidossa Ei
      6. Kytke pois JavaScript-tiedostojen ja CSS-tiedostojen yhdistäminen. Järjestelmä > Erityisasetukset > Kehittäjä > JavaScript > Yhdistä JavaScript-tiedostot > Ei ja Yhdistä CSS-tiedostot > Ei
      7. Poista välimuistit käytöstä. Järjestelmä > Välimuisti > Valitse kaikki > Poista käytöstä > Lähetä
      8. Tyhjennä JavaScript/CSS välimuisti.
      9. Uudelleenindeksoi. Järjestelmä > Indeksit > Valitse kaikki > Uudelleenindeksoi tiedot > Lähetä
      10. Vaihda ylläpitoonkirjautumis tunnukset halutessasi
  11. Palauta alkuperäinen Magenton .htaccess -tiedosto tai muokkaa sopivaksi. Tämä saattaa aiheuttaa kirjautumisongelmia.
  12. Aseta robots.txt juurihakemistoon seuraaville asetuksille jos ei paikallisella palvelimella User-agent: * Disallow: /
  13. Magento Connect katso varoitus ja ohje http://alexander.holbreich.org/2009/01/how-to-duplicate-magento-installation/
    1. Ilmeisesti /Downloader hakemiston tuhoaminen jo estää tämän.
    2. Laajennusten asennus onnistuu ainakin seuraavasti kun hakemisto/Downloader joka on tuotu alkuperäisestä tuotantoversiosta on tuhottu. Siirrä samanversioisesta alkuperäisestä Magenton paketista /Downloader hakemisto kopioon ja aja komento pääte-ohjelmassa komento sudo ./mage mage-setup Tällöin ei kuitenkaan näy asennetut laajennukset Magento Connect -asennusohjelmassa, mutta sillä voi normaalisti tehdä asennuksia. Muista mitä laajennusten asennuksesta on sanottu :)


http://wrightcreativelabs.com/create-a-test-instance-of-a-magento-store/
http://alexander.holbreich.org/2009/01/how-to-duplicate-magento-installation/

Tuotteiden tuonti[muokkaa]

Ylläpidon tietokannan varmuuskopiosta[muokkaa]

VARO! Tämä kyllä todennäköisesti tuo tuotteet, mutta jostain syystä saattaa olla mahdoton enää uusien asiakkaiden tilin lisääminen.

Tämä ohje on yksi tapa tuoda vanhasta tietokannasta tuotteet uuteen tietokantaan. Tässä ohjeessa Magenton versiot ovat samat.

  • Ota varmuuskopio tietokannasta Magenton ylläpidossa. Ja vie myös tietokanta phpMyAdmin -ohjelmassa.
  • Luo tyhjä tietokanta väliaikaiseen käyttöön. Sieltä on myös näppärää käsin tai muutoin poimia muitakin tietoja uusille sivuille kuten CMS -sivujen sisältö, asiakasryhmät jne.
  • Lisää tekstieditorissa Magenton ylläpidossa otettuun tietokannan varmuuskopioon rivit oheisesta linkistä: http://www.magentocommerce.com/wiki/1_-_installation_and_configuration/restoring_a_backup_of_a_magento_database
  • Tuo tietokanta tyhjään tietokantaan
  • Vie kaikki catalog_ ja eav_ taulut uuteen tiedostoon. Varmista että viet utf-8 merkistöllä.
  • En osaa sanoa onko tämä tarpeellinen: Kirjaudu ssh:lla tietokantaan komennolla mysql --host=localhost --user=cpanelkäyttäjätunnus --password=cpanelsalasana ja anna komento SET foreign_key_checks = 0; ja kun seuraavien kohtien tuonti on valmis SET foreign_key_checks = 1;
  • Tuhoa varsinaisesta Magento tietokannasta catalog_ ja eav_ alkuiset taulut. Loput taulut tuhoa SQL -komennolla (phpMyAdminvälilehti) kirjoittamalla riville 1. SET foreign_key_checks = 0; ja 2.riville DROP TABLE `catalog_product_entity`; Alkuperäinen ohje http://www.magentocommerce.com/wiki/recover/restore_a_broken_magento_database
  • Tuo Magenton tietokantaan em. taulut sisältävä tiedosto

Media-kansion tuonti[muokkaa]

Luokkien ja tuotteiden kuvat sijoitetaan Media -kansioon. Jos olet lisännyt kuvat Wysiwyg -editorilla, niin ne sijaitsevat wysiwyg -kansiossa, joka siis ainoastaan tarvitsee siirtää. Kuvia on myös /media/catalog -kansiossa. Kuvat voi olla myös valinnasta riippuen sijoitettu aiemmin tietokantaan. Katso että hakemistopuusta tulee samanlainen. Ettei esimerkiksi tuplasti /product/product.

  • HUOM! Jos saat virheilmoituksen Wysiwyg editorissa: "Palvelimella sijaitsevaan hakemistoon ei ole kirjoitusoikeuksia", saattaa olla että hakemistoa nimeltä /media/wysiwyg ei ole. Lisää kansio.

Vienti / Tuonti[muokkaa]

  • Vie tuotteet csv-tiedostoon kohdasta Järjestelmä / Vienti / Kokonaisuuden tyyppi Products / Magento tekee listan ominaisuuksista, kaikki viedään ellet jotain poista / Jatka
  • Muokkaa tuotteita taulukkolaskentaohjelmassa esimerkiksi Word tai OpenOffice. Pilkulla erotettu, koodaus on UTF-8. Vie muodossa CSV, MS Windows
  • Tuo tuotteet kohdasta Järjestelmä / Tuonti / Kokonaisuuden tyyppi Products / Import Behavior Append Complex Data tai muu tarpeen mukaan

Ongelmia[muokkaa]

500 Internal Server Error[muokkaa]

  • Valkoinen ruutu, jossa ilmoitus tietokantavirheestä, 500 Internal Server Error. Anna komento chmod 644 index.php Voi ilmetä esimerkiksi Varmuuskopioinnin yhteydessä tai päivitettäessä Magentoa.
  • Ehkä tämä voi tulla kyseeseen jos ei em. toimi http://www.magentocommerce.com/wiki/_media/groups/227/magento-cleanup2.zip Aja komennolla php magento-celanup.php tai osoitekentän kautta magento/magento-cleanup.php

Vain ylläpidon (admin) puolella[muokkaa]

Jos vika ilmenee vain ylläpidon puolella, mutta kaupan puoli toimii normaalisti.

Magento Connect[muokkaa]

  • Magento Connect Manager antaa 500 Internal Server Error -ilmoituksen. Vaihda Magento/Downloader/index.php tiedoston oikeudeksi 755

Palvelimella sijaitsevaan hakemistoon ei ole kirjoitusoikeuksia[muokkaa]

Katso kohta Media-kansion tuonti

Fatal error virheet[muokkaa]

  • Fatal error: Class 'AddThis_SmartLayers_Helper_Data' not found in /magento/app/Mage.php on line 546
    • Erittäin yleinen virhe! Taisit unohtaa laittaa kokoamisen uuden laajennuksen asennuksen ajaksi pois. Kokeile suorittaa kokoaminen uudestaan. Tyhjennä myös välimuistit.
    • Jos et pääse ylläpitoon mene selaimella osoitteeseen verkkokauppasi/Downloader jolloin pääset Magento Connect Manageriin. Poista asentamasi lisäosa.
  • Fatal error: Call to a member function getStoreLabel() in price.phtml
  • Fatal error: Class 'Mage_Cookienotice_Helper_Data' not found in /magento/app/Mage.php on line 546
    • voi ilmestyä esimerkiksi kun kytketään päälle lokin tyhjennys. Sinänsä erikoinen virhe, että ylläpitoon pääsy on mahdollista mutta ainoastaan Järjestelmä > Asetukset valikkoa avatessa syntyy virheilmoitus. Virheilmoituksesta nähdään että se liittyy Cookienotice lisäosaan.
    • kokeile seuraavia ylläpidon puolelta: kaikkien Magentoon liittyvien välimuistien tyhjentäminen, kaiken indeksointi. Jos nämä eivät auta, siirry Magento Connect Manageriin ja reinstall kyseinen virheilmoituksessa ilmoitettu lisäosa. Nämä tehtyäni virheilmoitus poistui. Seuraavaksi olisin yrittänyt Connect Managerin kautta poistaa lisäosan asennuksen.
  • Fatal error: Call to a member function getUsername() on a non-object in /magento/app/design/adminhtml/default/default/template/page/header.phtml on line 33
    • Lisää seuraava magento/app/design/adminhtml/default/default/layout/main.xml -tiedoston <layout> kohdan jälkeen:
<adminhtml_dashboard_customersmost>
           <block type="core/text_list" name="root" output="toHtml">
               <block type="adminhtml/dashboard_tab_customers_most" name="adminhtml.dashboard.tab.customers.most" />
           </block>
       </adminhtml_dashboard_customersmost>

       <adminhtml_dashboard_customersnewest>
           <block type="core/text_list" name="root" output="toHtml">
               <block type="adminhtml/dashboard_tab_customers_newest" name="adminhtml.dashboard.tab.customers.newest" />
           </block>
       </adminhtml_dashboard_customersnewest>

       <adminhtml_dashboard_productsviewed>
           <block type="core/text_list" name="root" output="toHtml">
               <block type="adminhtml/dashboard_tab_products_viewed" name="adminhtml.dashboard.tab.products.viewed" />
           </block>
       </adminhtml_dashboard_productsviewed>

       <adminhtml_index_login>
           <block type="core/text_list" name="root" output="toHtml">
               <block type="adminhtml/template" name="content" template="login.phtml">
                   <block type="core/text_list" name="form.additional.info" />
               </block>
           </block>
       </adminhtml_index_login>

       <adminhtml_index_forgotpassword>
           <block type="core/text_list" name="root" output="toHtml">
               <block type="adminhtml/template" name="content" template="forgotpassword.phtml">
                   <block type="core/text_list" name="form.additional.info" />
               </block>
           </block>
       </adminhtml_index_forgotpassword>