Compad
Magento koppeling – Installatie instructie
Geldig tot en met: Latest Content: Auteur:
07 oktober 2010
i:\handboek\compad store automatoion\magento.docx Carol Esmeijer, Compad Software
Compad
Magento Koppeling – Installatie instructie Carol Esmeijer
Published : Applied to :
7 oktober 2010 CarianInBusiness, Compad Store Automation, V-Solution
i
Copyright Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, e-mail address, logo, person, place or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Compad may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. © 2004 Compad Software. All rights reserved. Compad, Compad voor Windows, Prodel and Protocol Description Language are either registered trademarks or trademarks of Compad Software in the Netherlands and/or other countries. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.
Acknowledgments Project Editor: Carol Esmeijer Technical Reviewers: Graphic Design: Compad Production: Compad
ii
Inhoudsopgave OVERZICHT ............................................................................................................... 2 WAT IS MAGENTO .................................................................................................... 3 VOORBEREIDING ..................................................................................................... 5 BEHEREN ARTIKELGROEPEN.............................................................................. 12 BEHEREN ARTIKELEN........................................................................................... 13 VERSTUREN NAAR MAGENTO ............................................................................. 14 IMPORTEREN IN MAGENTO .................................................................................. 15 BELANGRIJKE GEGEVENS ................................................................................... 16
iii
I N T R O D U C T I E
Overzicht
Dit document geeft een beschrijving van de installatie Magento ten behoeve van een koppeling met Compad productlijnen:
Compad Store Automation CarianInBusiness V-Solution
Dit document is vooral bestemd voor webbeheerders, webdesigners. Kennis van Magento is niet vereist, maar wordt uit gegaan van enige kennis van webservers en het uploaden van bestanden op een webserver. Naast deze documentatie zijn ook een aantal instructiefilms beschikbaar, waarin de algemene werking van de Magento koppeling wordt uitgelegd en alsmede instructiefilms waarin de installatie procedure wordt gedemonstreerd. Deze documentatie dient vooral als stappenplan bij het inrichten van de Magento website.
Hoe is dit document gestructureerd Dit document is opgedeeld in een de volgende hoofdstukken: Hoofdstuk 1 “Wat is Magento” Magento eCommerce software is een open source software project. In het eerste hoofdstuk geeft een beschrijving waar u Maganto kunt downloaden. Hoofdstuk 2 “Installatie Magento” In het tweede hoofdstuk wordt een korte beschrijving gegeven hoe u een Magento database moet aanmaken en Magento kunt installeren. Appendix A “Belangrijke gegevens” In Appendix A is een handig hulpmiddel opgenomen waarin u alle belangrijke gegevens van uw website kunt noteren. Hierbij moet u denken aan de naam van de database, de naam van de database gebruiker, ftp-login gegevens en dergelijke. Deze gegevens kunnen van pas komen bij de installatie en/of het latere beheer van uw webshop.
2
H O O F D S T U K
1
Wat is Magento
Magento is een open source eCommerce oplossing en stelt u in staat om snel en eenvoudig uw eigen Internet winkel te openen. Open source wil zeggen dat de software wordt ontwikkeld door een groep van verschillende programmeurs (ook wel community genoemd) en stellen de broncode beschikbaar. Open source wordt door veel computergebruikers nog wel eens verward met gratis software. Dat is niet per definitie het geval. Soms wordt er wel een gratis versie beschikbaar gesteld, voor meer informatie over Open source en de gebruikersrechten raadpleeg altijd vooraf de website van de ontwikkelaars.
Voor- en nadelen Open source kan zowel voor als nadelen hebben. Veel open source projecten vragen doorgaans behoorlijk wat programmeer/ict-kennis. Omdat u in tegenstelling tot standaard software doorgaans geen ondersteuning en service krijgt, dient u deze service elders te betrekken. Het vinden van open source deskundige kan soms erg lastig zijn. In de praktijk noemt iedereen zich deskundige, maar echte deskundige schreeuwen doorgaans niet. Daar hebben ze het te druk voor! Vooral wanneer u een kleine maatwerk aanpassing wenst in uw Magento website hebben doorgaans veel mensen toch hulp nodig van een echte Magento expert. Naast de nadelen heeft een open source ook voordelen, zoals de aanschafprijs en het feit dat u de mogelijkheid heeft om de website te laten aanpassen aan uw eigen specifieke wensen. Het gaat te ver om alle voor- en nadelen van Open soucre te beschrijving.
Magento Magento stelt u kort omschreven in staat om snel en eenvoudig een webshop te openen op het Internet. De Magento webshop werkt volgens het principe van het winkelwagentje. De klant plaats één of meerdere artikelen in het winkelmandje en gaat naar de kassa om te betalen. Want naast het registeren van orders, biedt 3
Magento ook verschillende betaalmiddelen waaronder iDeal. Magento biedt u naast de webshop veel extra’s zoals orderbeheer, creditfactuur, etc. En als dat nog niet genoeg is zijn er veel extenties beschikbaar waarmee u de functionaliteit van Magento verder kunt uitbreiden.
Downloaden Meer informatie over Magento treft u aan op http://www.magento.com. Op deze website kunt u ook een versie van Magento downloaden. Magento biedt u een aantal standaard stijlen waarmee u snel en eenvoudig een website kunt starten. Wij kunnen ons heel goed voorstellen dat deze standaard niet aansluit bij uw eigen idee / uitstraling. Uiteraard kunt een webdesigner opdracht geven om Magento qua stijl helemaal te laten aansluiten bij uw eigen stijl. Maar u kunt er ook voor kiezen voor een commerciële template van bijvoorbeeld TemplateMonsters. Een template van Template monsters is een schil voor Magento zodat uw webshop qua stijl beter aansluit bij uw bedrijf. Met een dergelijke template kunt u bijvoorbeeld uw webdesigner opdracht geven om deze te finetunen op uw specifieke wensen. Meer informatie http://www.magento.com http://www.templatemonster.com/magento-themes.php
4
H O O F D S T U K
2
Voorbereiding
In het tweede hoofdstuk wordt een beschrijving gegeven van welke voorbereidingen u moet treffen voordat u Magento kunt installeren op uw webserver. In dit hoofdstuk gaan wij er vanuit dat u Magento heeft gedownload en dat u het zip-bestand op een locale schijf op uw computer heeft uitgepakt. Tevens gaan wij uit van een bepaald controldesk (plesk) van uw server. Deze kan afwijken van de door uw webhosting service provider gehanteerde controldesk. In de toekomstige versie van dit handboek kunnen meerdere plesk systemen worden beschreven.
Subdomein of domein Sommige bedrijven gebruiken hun website uitsluitend voor verkoop van hun producten. In dergelijke situaties maakt de online shop een belangrijk onderdeel uit van de website, zo niet het belangrijkste deel. In deze situaties ligt het voor de hand dat via de domeinnaam direct de webshop wordt aangeroepen. Voorbeeld: een bedrijf heeft een website met de domeinnaam www.mijnbedrijf.nl. Via deze domeinnaam krijgt de bezoeker direct de webshop te zien. Naast de webshop wordt er (bijna) geen andere informatie beschikbaar gesteld. De webshop bevind zich dan op het hoofddomein. Indien een bedrijf de website ook voor andere doeleinden gebruikt zoals product ondersteuning, product informatie en dergelijke en de website minder belangrijk is dan de webshop worden ondergebracht op een subdomein, bijvoorbeeld shop.mijnbedrijf.nl. Bezoekers van de website www.mijnbedrijf.nl krijgen de gewone website te zien. Vanuit deze website kan een link gemaakt worden naar shop.mijnbedrijf.nl In de praktijk zullen vooral bedrijven die zich richten op internet verkoop er voor kiezen om de shop direct beschikbaar te stellen via het hoofddomein. Bedrijven zoals software bedrijven die de website voor veel meer doeleinde gebruiken zullen er eerder voor kiezen om een gebruik te maken van een subdomein. Echter een retailer voor een retailer kan het ook erg handig zijn om naast het hoofddomein ook een tweede online winkel te hebben onder bijvoorbeeld een subdomein. Bijvoorbeeld newshop.mijnbedrijf.nl. Deze tweede winkel kunt u 5
gebruiken om uw nieuwe collectie in te richten. Op het moment dat u klaar bent met de voorbereidende werkzaamheden stuurt u de gegevens naar uw “echte online winkel”. Indien u gebruik wilt maken van een subdomein dient u via Plesk / Controlpanel een subdomein aan te maken. Noteer de (sub)domeinnaam in Appendix A
Database Magento maakt gebruik van een mySQL database. Veel webhosting bedrijven staan toe dat u meerdere Databases kunt draaien op één website. Het aanmaken van de mySQL database dient vanuit het controlpanel van uw webserver te gebeuren. 1. 2. 3. 4. 5.
U logt in op uw control panel van uw website. Ga naar de database beheertool Klik op nieuwe database Geef de naam van de database op Na het aanmaken van de database selecteert u de database en ken daar de gebruiker aan toe. Wanneer er nog geen database gebruiker aanwezig is dient u er eerst een nieuwe gebruiker vast te leggen. 6. Vul in Appendix A tabel 1 database gegevens zoals naam database, gebruikersnaam en wachtwoord. Deze informatie kan u later helpen bij het installeren van de Magento website en het beheer in de toekomst. Maak de database aan in de controlpanel van uw webserver. En noteer de gegevens in Appendix A
Uploaden Magento website Voordat u begint met het uploaden van de Magento website raden wij u aan om de ftp gegevens van uw website bij de hand te houden. Deze informatie heeft uw webhosting service provider aan u aangeboden bij het aanvragen van de webhosting dienst. Wanneer u niet over deze gegevens beschikt en u beschikt wel over de login gegevens van het controlpanel, dan kunt uzelf de naam en het wachtwoord van de ftp gebruiker wijzigen. Wij raden u aan om de ftp gegevens in Appendix A vast te leggen.
6
1. Voor het uploaden van de Magento website kunt u het beste gebruik maken van ftp programma’s zoals FileZilla. 2. Zorg er voor dat u de Magento zip file op uw locale schijf heeft uitgepakte. 3. Ga in FileZilla naar Bestand | Sitebeheer 4. Klik op de opdrachtknop Nieuwe site
5. Geef in het invoervak host de naam van de website. Bijvoorbeeld www.compad.eu. U kunt ook het IP-nummer van de website opgeven 6. Selecteer bij servertype FTP- File Transfer protocol 7. Selecteer bij de keuzelijst Inlogtype de optie Normaal 8. Geef in het invoervak gebruiker de gebruiker 9. Geef in het invoervak wachtwoord het wachtwoord van de ftp gebruiker. 10. Klik op verbinden om de verbinding met uw website op te bouwen.
7
11. Lokaliseer op de webserver (linkerzijde) de folder van uw website. Het hoofddomein bevind zich doorgaans onder www, html of public_html. 12. Ga op uw lokale schijf naar de locatie waar u het ZIP bestand van Magento heeft uitgepakt. 13. Selecteer alle bestanden met bijvoorbeeld CTRL-A 14. Sleep de bestanden van de lokale schijf naar de webserver 15. FileZilla gaat nu de bestanden kopieren. Het kopieren van de Magento bestanden kan een behoorlijke tijd gaan duren.
8
Compad Magento Extentie uploaden Wanneer u optimaal gebruik wilt maken van de Compad/Magento koppeling dan dient u de Compad Magento Extentie te installeren. Dat doet u middels de volgende procedure. 1. Ga in FileZilla naar de locatie waar u de Magento bestanden heeft gekopieerd. 2. Klik op de foldermap var 3. Klik op de rechtermuisknop en kies voor de optie nieuwe map 4. Geef de naam import in en druk op enter 5. Ga terug naar de root van uw webshop 6. Klik vervolgens op de folder app 7. Klik op de folder code 8. Klik op de folder local 9. Klik op de folder Mage 10. Klik op de rechtermuisknop en kies voor de optie nieuwe map/folder 11. Geef de volgende map naam in Catalog/Model/Convert/Adapter en druk op enter 12. Ga terug naar de folder Convert en klik op nieuw op de rechtermuisknop 13. Kies voor de optie nieuwe map/folder en geef de naam Parser in 14. Kopieer de inhoud van de folder app-code-local-Mage-Catalog-ModelConvert-Parser van uw lokale computer naar de folder /app/code/local/Mage/Catalog/Modle/Convert/Parser op uw webserver 15. Kopieer de inhoud van de folder app-code-local-Mage-Catalog-ModelConvert-Adapter van uw lokale computer naar de folder /app/code/local/Mage/Catalog/Modle/Convert/Adapter op uw webserver
Installatie Magento Nu heeft u alle noodzakelijke bestanden op uw webserver geplaatst en wordt het tijd om de installatie procedure uit te voeren. Het installeren van Magento is nu samen met de informatie vanuit Appendix A redelijk eenvoudig 1. Start uw Internet Browser op en geef in de adres balk het adres van uw webshop. Bijvoorbeeld www.mijnbedrijf.nl of shop.mijnbedrijf.nl 2. De Magento installatie procedure wordt nu doorlopen. U dient eerst het de taal, de tijdzone en de valuta te selecteren. 3. Vervolgens dient u de database gegevens zoals naam van de database, de database gebruiker en zijn wachtwoord op te geven. 9
4. Tevens dient u de naam en een wachtwoord op te geven van de beheerder van uw online winkel. Noteer deze gegevens weer in Appendix
Import definitie maken De software maakt gebruik van een geadvanceerde import/export extentie. U heeft deze extentie reeds eerder op uw webserver geplaatst. Maar nu is het tijd om deze ook in Magento aan te maken. Hiervoor volgt u de onderstaande procedure: 1. Ga in Magento naar System | Import/Export | Advanced profile 2. Klik op de opdracht add new profile 3. Geef in het invoervak Profile name de naam Compad Software Import op. 4. In het Actions XML dient u de volgende tekst te plakken.
file var/import
true 1 catalog/convert_adapter_productimport parse
5. Klik op de opdrachtknop Save profile
10
Attribute Size vastleggen Wanneer u de software gebruikt in combinatie met kleuren/maten, dan dient u in Magento het attribute size vast te leggen. Dat doet u door middel van de onderstaande procedure: 1. Ga in Magento naar Catalog | Attributes | Manage Attributes 2. Klik op de opdracht add new attribute 3. Geef in de het invoervak Attribute code size op. 4. Bij de keuzelijst Scope selecteert u de optie Global 5. Bij de keuzelijst Catelog Input Type for store Owner kiest u voor de optie Dropdown. 6. Bij de keuzelijst Use to Create Configurable product selecteert u de optie Yes 7. Klik op de tab Manage Label / Opties 8.
Bij de invoervakken Manage Title geeft u bij het invoervak Admin Size op.
9.
Geef bij de overige invoervakken van Manage Title de naam in de verschillende talen op.
10. Bij Manage Options klikt u op de opdrachtknop Add options. 11. Geef in de invoervakken de maat op bijvoorbeeld 38.
1 2 .
Herhaal de stappen 10 en 11 voor alle maten.
11
H O O F D S T U K
3
Beheren artikelgroepen
Het beheren van artikelgroepen t.b.v. Magento moet nog verder worden beschreven
12
H O O F D S T U K
4
Beheren artikelen
Het beheren van artikelen t.b.v. Magento moet nog verder worden beschreven
13
H O O F D S T U K
5
Versturen naar Magento
Om de gegevens van uit de software van Compad te versturen naar Magento volgt u de onderstaande procedure: 1. Ga naar Extra | Magento koppeling 2. Selecteer in de keuzelijst Magento voor de optie Magento 1.4.x (met extention) 3. Selecteer eventueel het door u gewenste magazijn 4. Geef de ftp server instellingen zoals ftp server, naam en wachtwoord van de ftp gebruiker. 5. Geef de folder van de webshop in. 6. Geef de naam van de webshop in (standaard is dat base). 7. Klik op de opdrachtknop ok
14
H O O F D S T U K
6
Importeren in Magento
Nadat alle gegevens vanuit de software naar de Magento shop zijn verstuurd, logt u in op de Magento website om de gegevens te importeren. Dat doet u middels de onderstaande procedure 1. 2. 3. 4. 5. 6.
7
Ga naar de beheerders login bijvoorbeeld shop.mijnbedrijf.nl/admin/ Geef de naam en het wachtwoord op van de shop beheerder Ga naar System | Import/Export | Advanced profiles Selecteer de Compad Software Import profile Klik op het tabblad Run Profile Klik op de opdrachtknop Run Profile . Magento zal nu het door de software aangeboden artikelbestand importeren. Het importeren kan enige tijd in beslag nemen.
15
A P P E N D I X
A
Belangrijke gegevens
Deze appendix biedt u een belangrijk hulpmiddel om alle noodzakelijke gegevens overzichtelijk te noteren. Dit maakt de installatie en het beheer van de website een stuk eenvoudiger.
1.1 1.2 1.3
Database Naam database Naam gebruiker Wachtwoord gebruiker
Voorbeeld Compad_magento Compad_dbuser dbwachtwoord
2.1 2.2 2.3 2.4
FTP Server Host website FTP gebruikersnaam FTP wachtwoord Folder website
Voorbeeld www.compad.eu compad ftpwachtwoord /www/shop/
3.1 3.2 3.3
Magento beheerder Naam beheerder Wachtwoord Url beheer
Voorbeeld admin adminwachtwoord www.compad.eu/admin/
4.1
Magento shop Naam shop
Voorbeeld base
16