Inhoudsopgave Handleiding Xib Shipping Matrix 1.4.1 1: Installatie Xib Shipping Matrix. 2: Configuratie Shipping Matrix. 2.1 Algemeen. 2.2 Bereiken. 2.3 Bestemming. 2.4 Andere opties. 3: Configuratie artikelen. 4: Overreding verzendmethoden. 5: Gratis verzending aanbieden met voorwaarden. 6: Voorbeelden van reguliere expressies. 7: De extensie uitschakelen. 8: De extensie geheel verwijderen Deze handleiding is in concept fase, en onderhevig aan wijzigingen in configuratie mogelijkheden, interne processen en functionaliteiten binnen Magento. Vragen, opmerkingen en suggesties kunt u richten aan willem-jan@xib.nl
1: Installatie Xib Shipping Matrix De installatie van de extensie is vrij eenvoudig. 1: Zorg dat u uitgelogd ben uit het beheergedeelte van uw Magento webshop. 2: Kopieer de inhoud van de app en js mappen naar de app en js mappen die u vindt in de document-root van uw website. 3: Login in het beheergedeelte van uw website 4: Ga naar het cachebeheer en leeg alle cachetypes, inclusief Magento cache en het cachegeheugen ( de 2 rode knoppen rechtsboven ). Hierna vind u in de menubalk de optie Xib Shippingmatrix, met daaronder de optie Manage Matrix Daarnaast vindt u bij de producten ook een aantal attributen waarmee u de eigenschappen en opties kunt configureren. Deze vindt u onder de tabknop XIB Verzending.
2: Configuratie Verzendmethodes. Voordat we overgaan naar de uitleg van de configuratie mogelijkheden, eerst een stukje uitleg over de interne werking. De Shipping Matrix kan m.b.v. Verzendgroepen meerdere verzendmethodes aanbieden, echter wordt per ingevoerde verzendgroep alleen die optie met de hoogste prioriteit, die voldoet aan alle criterea, weergegeven. Als u dus werkelijk meerdere opties aan wilt bieden, bijvoorbeeld a: Gewone verzending, b: Spoedlevering c: Verzekerd verzenden d: Afhalen op locatie dan dient u meerdere groepen in te voeren. De code van de groep vult u in bij Code van groep onder de tabknop Algemeen. Houd er rekening mee dat de configuraties allemaal op basis van het en-en principe werken. Indien u dus verschillende criteria wenst om een verzendmethode te calculeren, bijvoorbeeld op basis van volume OF gewicht, kan het voorkomen dat u meerder regels met verschillende bereiken in moet voeren om ervoor te zorgen dat tenminste 1 ervan, altijd aan alle criteria voldoet. Indien meerdere verzendmethodes goed worden bevonden, wordt alleen de methode met de hoogste prioriteit in zijn groep weergegeven. Om het invoeren van meerdere regels voor u wat eenvoudiger te maken, is er een duplicatie optie toegevoegd zodat u snel op basis van de geselecteerde regel een nieuwe regel toe kunt voegen met daarin de geringe aanpassingen. Groepcodes en asterisk Indien de groepcode begint en eindigt met een * ( asterisk ), is deze groep in staat om op basis van hoogste prioriteit verzendmethodes in andere groepen te overreden. M.a.w: indien een regel, uit de speciale groep, een hogere prioriteit heeft dan de regels in de andere groepen met dezelfde criteria, dan zullen de verzendmethodes uit de andere groepen niet beschikbaar komen in de afrekenprocedure. In de regel wordt deze mogelijkheid gebruikt om ervoor te zorgen dat als er een product in de winkelwagen is, met een speciale pakketcode ( bijvoorbeeld DHL ), dat dit ervoor zorgt dat andere verzendmethodes niet beschikbaar komen, en de bezoeker uiteindelijk alleen kan kiezen voor verzending met DHL. Let wel dat deze overreding niet wordt toegepast op verzendmethodes uit andere groepen die ook beginnen en eindigen met een asterisk. Dus alleen groepcodes die niet beginnen en eindigen met een asterisk kunnen overreden worden.
Hieronder volgt een uitleg welke configuratie mogelijkheden er zijn, en welke waarden in welke velden in kunnen worden gevuld. 2.1 Algemeen: Artikel Pakket code: De shippingmatrix biedt u de mogelijkheid om aan de hand van een pakketcode pakketspecifieke verzend methodes te bieden. In combinatie met de ingevoerde prioriteit, en de groepcode kunt u er zelfs voor zorgen dat alleen deze verzendmethod beschikbaar komt. Door op de link eronder te klikken gaat u naar het attribuut beheer waar u meer opties toe kunt voegen. Code van groep: Maak hier echt gebruik van een code, dus geen lange teksten met speciale karakters of spaties, behalve de asterisk. Door de code te beginnen en te eindigen met een asterisk, zorgt u ervoor dat de methodes in de groep de methodes van de andere groep(en) kunnen overreden. Prioriteit: De verzendmethode met de hoogste prioriteit, die voldoet aan alle criteria, is de enigste optie die wordt geboden van alle opties in dezelfde groep. Indien u niet wenst dat de optie overreden kan worden door methodes uit de speciale groepen, moet u deze optie een hogere prioriteit. Titel verzendoptie: Dit is de titel die men ziet in de checkout procedure. U kunt deze m.b.v. Inline vertaling de titel aanpassen indien dit nodig is. Prijs: Hier voert u de kosten van de verzending in. Gebruik een punt als decimaal teken. Prijstype: Hier kunt u aangeven of de ingevoerde waarde bij prijs een vaste prijs is, of een percentage van de totale prijs van de winkelwagen. Gratis verzending wijgeren: Indien u gebruik maakt van couponcodes om gratis verzending te bieden, maar u niet wenst dat dat op de specifieke verzendmethode van toepassing kan zijn, moet u hier Nee invullen. Status: Niet actieve verzendmethodes worden niet geselecteerd uit de database, en worden dus ook niet meegenomen in de calculaties en ook niet aangeboden in de afrekenprocedure.
2.2 Bereiken: Gewicht vanaf: Gewicht tot: Hierin kunt u het minimale en maximale gewicht van de verzending ingeven. Shipping Matrix rekent de waarden niet om, dus indien u bij de producten de gewichten in gram of kilogram in heeft gevoerd, dient u hier dezelfde hoeveelheden aan te houden. Eventuele niet numerieke karakters achter de waarde ( bv 45 kg ) worden gefilterd, zodat alleen het getal 45 overblijft om het totale gewicht te bereken. Volume vanaf: Volume tot: Hierin kunt u het minimale en maximale volume van de verzending ingeven. De volume wordt berekent op basis van de gegevens die u invoert bij het artikel in de velden Volume Breedte, Volume Hoogte en Volume Diepte / Lengte. Ook hier geld dat de waarden niet omgerekend worden, en u dient dezelfde maatvoering te hanteren als bij de producten ( dus cm of mtr ). Let erop dat als 1 van de 3 dimensies niet ingevuld is, dat het totale volume dan automisch 0 wordt. Prijs vanaf: Prijs tot: Hierin kunt u de minimale en maximale totale waarde van de winkelwagen exclusief BTW invoeren. Aantal artikelen vanaf: Aantal artikelen tot: Hierin kunt u het minimale en maximale totaal aantal verzendbare producten invoeren. Downloadbare of virtuele producten worden niet meegenomen in de berekening. Maximale Breedte van product: Maximale Hoogte van product: Maximale Diepte/Lengte van product: Naast volume berekening kunt u hier een maximale breedte, hoogte en/of lengte van het artikel invoeren. Indien 1 van de producten in de winkelwagen breder is dan een van deze grenzen, wordt de bijhorende verzendmethode niet geboden.
2.3 Bestemming: Land van bestemming: Hierin kunt u meerdere landen selecteren welke overeen moeten komen met het land van het verzendadres van de bezoeker. Indien u de bovenste optie * Alle landen * selecteerd, wordt de regel toegepast voor alle landen. Regio van bestemming: Hierin dient u de exacte regio in te voeren zoals de bezoeker de kan selecteren of invoeren. Plaats van bestemming: Hierin dient u de exactie plaats van bestemmingzoals de bezoeker deze kan invoeren. Postcode van bestemming: Hierin dient u expressies in te voeren die door MySql als een reguliere expressie kan worden geinterpreteerd. Ondanks dat dit voor de eindgebruiker een complexe methode is, biedt het veel mogelijkheden om uiterst nauwkeurig of juist heel ruim de mogelijke postcode gebieden in te voeren. Meer informatie over Reguliere Expressies in MySQL vindt u op http://dev.mysql.com/doc/refman/5.1/en/regexp.html#operator_regexp 2.4 Andere opties: Klantengroepen: Hierin kunt u aangeven voor welke klantengroepen de verzend methode beschikbaar moet komen. Indien u dit veld leeg laat, geldt de verzend methode voor alle klantengroepen. Betaalmethodes toestaan: Hier kunt u aangeven welke betaalmethodes toegestaan worden indien de bezoeker voor de geselecteerde verzendmethode heeft gekozen. De extensie respecteert echter wel de instellingen van de betaalmethode, dus als een betaalmethode niet geactiveerd is in het betaalmethodesbeheer van Magento, dan zal de betaalmethode niet beschikbaar komen. Ditzelfde geldt uiteraad ook voor eventuele andere criteria die bepalen of een betaalmethode wel of niet beschikbaar komt. U kunt deze instelling dus beschouwen als een laatste selectie filter.
3: Configuratie Artikelen Zoals al eerder vermeld heeft u na de installatie een aantal nieuwe product attributen waarmee u uw artikelen eigenschappen kunt meegeven waar de shipping matrix gebruik van maakt om verzendopties te selecteren uit de database en kosten te berekenen. Hieronder treft u een overzicht en hun doel. Xib Package Group: Hier kunt u aangeven of een product met een bepaalde verzender moet worden verzonden. De beschikbare opties kunt u desgewenst uitbreiden in het attributenbeheer van Magento onder Catalogus Attributen Beheer attributen en daar het veld attribute_code filteren op xib_package_code. Volume Breedte: Volume Hoogte: Volume Diepte / Lengte: Hier kunt u aangeven hoe breed, hoog en diep / lang uw artikel is. U bent zelf vrij om te bepalen of u dit in cm, meter of bv inches invoert. Let wel dat u de eenheid die u hanteerd overal hetzelfde moet zijn. Dus niet alleen bij alle producten, maar ook bij de configuratie van de verzendmethodes Verzendmethodes uitschakelen: U kunt indien gewenst op product nivo bepalen of er bepaalde verzendmethodes niet beschikbaar mogen komen. Let wel dat als u in een later stadium verzendmethodes toevoegd die op dezelfde manier niet beschikbaar mogen komen, dat u deze dan ook nogmaals toe moet voegen aan de selectie bij het artikel.
4: Overreding Verzendmethoden Stel dat u een aantal artikelen heeft in uw catalogus die speciaal transport vereisen, zoals bijvoorbeeld vervoer met UPS, DHL, of een transportbedrijf. Indien de bezoeker van uw webshop 1 van deze artikelen in zijn winkelwagentje heeft, wilt u ervoor zorgen dat alleen de verzendmethodes met UPS, DHL of het transportbedrijf beschikbaar komt afrekenprocedure. In zo'n geval kunt u het artikel een speciale pakketcode geven in het artikelbeheer, en tevens kunt u in de configuratie van de verzendmethodes ervoor zorgen dat de andere opties komen te vervallen. Dit kunt u bereiken door de verzendgroep een speciale code te geven in combinatie met een hogere prioriteit dan de verzendmethodes die u wilt overreden. Indien de code van de verzendgroep begint en eindigt met een * ( asterisk ), dan krijgen de methodes in deze groep een speciale overreding functie, en zullen zij de methoden uit de groepen die niet met een asterisk beginnen en eindigen overreden. Hieronder een voorbeeld ( alle bereiken zijn ingesteld op 0 t/m 9999999999 ): Hier hebben de speciale groepen *standard_dhl* en *standard_insured_dhl* de hoogste prioriteit, maar worden alleen geactiveerd zodra er zich een artikel in het winkelmandje bevindt met die pakket-code. De pakket-code kunt u instellen bij het artikel bij het attribuut Xib Pakket Code. Op de volgende pagina ziet u een praktijk voorbeeld met afbeeldingen.
Hieronder ziet u de opties indien het verzend adres in Nederland is, en er geen artikelen worden besteld met een speciale verzend-code. En hieronder de opties die beschikbaar komen als er tenminste 1 artikel is met een speciale verzendcode, ongeacht het land van verzending ( tenzij dit wel geconfigureerd zou zijn ). Ter informatie: Indien de speciale methodes niet de prioriteit 100 zouden hebben, maar bijvoorbeeld 15, dan zou de verzendmethode Spoed Verzending Benelux beschikbaar komen omdat die de prioriteit 20 heeft, wat dus hoger is dan 15. Voorwaarde is dan wel dat het verzend-adres in de Benelux zou moeten liggen.
5: Gratis verzending aanbieden met voorwaarden. Het kan natuurlijk voorkomen dat u uw klanten gratis verzending aan wilt bieden indien hun bestelling aan een aantal voorwaarden voldoen. Dit kan zijn vanaf een bepaalde totaalwaarde van de bestelling: In dat geval moet u alle bereiken instellen op 0 t/m 999999999, met uitzondering van de prijzen: Bij Prijs: vanaf voert u de minimale totaalwaarde van de inhoud in, bv 200 Euro, bij Prijs: tot voert u de maximale totaalwaarde van de inhoud in, in de regel is dat 9999999999. Of wat ook mogelijk, bij een bepaalde hoeveelheid artikelen. In zo'n geval moet u alle bereiken instellen op 0 t/m 9999999999, met uitzondering van het aantal artikelen. Bij Aantal artikelen: vanaf voert u het minimale aantal artikelen in, bv 20 Bij Aantal artikelen: tot voert u het maximale haalbare in, in de regel 9999999999.
6: Voorbeelden van reguliere expressies voor postcode bereiken. Postcode bereiken goedkeuren: Postcodes die beginnen met 40 t/m 49, 50 t/m 59 en 60 t/m 65 kunnen op de volgende manier ingevoerd worden: ^(4 5 60 61 62 63 64 65) Postcodes die beginnen met 23, 24,25,32,33,34 of 41 kunnen op de volgende manier ingevoerd worden: ^(23 24 25 32 33 34 41) Postcodes in het bereik van 4500 t/m 5799 kunnen als volgt ingevoerd worden ^(4[5-9]{1} 5[0-7]{1}) of meer leesbaar: ^(45 46 47 48 49 50 51 52 53 54 55 56 57) Postcode bereiken verbieden: Het verbieden van postcodes werkt opdezelfde manier, echter moet er een uitroepteken voor plaatsen. Hieronder een aantal voorbeelden: Postcodes verbieden die beginnen met 40 t/m 49, 50 t/m 59 en 60 t/m 65 kunnen op de volgende manier ingevoerd worden: ^!(4 5 60 61 62 63 64 65) Postcodes verbieden die beginnen met 23, 24,25,32,33,34 of 41 kunnen op de volgende manier ingevoerd worden: ^!(23 24 25 32 33 34 41)
7: De extensie uitschakelen. Indien u om bepaalde redenen de extensie in zijn geheel wil uitschakelen, kun u dit doen in bestand app/etc/modules/xib_shippingmatrix.xml. In dat bestand moet u de regel <active>true</active> veranderen naar <active>false</active> en deze weer opslaan. Daarnaast moet u ook het attribuut xib_disable_shipping verwijderen uit uw attributen sets, omdat deze gebruik maakt van een extensie model om de mogelijke optie op te halen. 8: De extensie geheel verwijderen Om de extensie in zijn geheel te verwijderen dient u als volgt te werk te gaan: Verwijder eerst de attributen xib_package_code, xib_shipping_width, xib_shipping_height, xib_shipping_depth, xib_disable_shipping. Daarna verwijdert u bestand app/etc/modules/xib_shippingmatrix.xml zodat magento de extensie niet meer activeert. Hierna kunt u de gegevens uit de database verwijderen met de volgende SQL-instructies: DROP TABLE `xib_shippingmatrix`, `xib_shippingmatrix_countries`, `xib_shippingmatrix_paymentmethods`, `xib_shippingmatrix_store`; DELETE FROM `core_config_data` WHERE path LIKE '%xibshippingmatrix%'; DELETE FROM `core_resource` WHERE code = 'shippingmatrix_setup'; De bestanden vinden zich op de volgende locaties: app/code/community/xib/shippingmatrix ( complete map ) app/design/adminhtml/default/default/layout/shippingmatrix.xml ( enkel bestand ) app/locale/nl_nl/xib_shippingmatrix.csv ( enkel bestand ) js/xib/shippingmatrix.js ( enkel bestand )