Samenvatting
Met de productfeed van Mach3Cart toon je je producten in je eigen opmaak op je website. De gegevens komen uit een lijst die Mach3Cart levert, en afrekenen gaat alsnog naar de checkout. De feed vraagt bij Mach3Cart het pakket .
Er zijn drie handelingen, in drie omgevingen. Je zet de feed klaar in Mach3Cart, koppelt het adres aan een collectie in Mach3Blocks, en koppelt de velden in de editor aan je elementen.
Het veld Externe data zelf is beschreven in het artikel Externe data. Hier staat alleen wat aan Mach3Cart eigen is.
Wanneer gebruik je dit?
Je gebruikt dit als je zelf wilt bepalen hoe een product op je pagina eruitziet. De lijst levert de gegevens, en jij bouwt het overzicht met je eigen blokken en opmaak.
Dat is het verschil met de andere route. De productfeed is een gegevenslijst, en de Basket Widget is een schermonderdeel dat er al uitziet zoals het eruitziet.
Verkoop je maar één aanbod, dan is dit te veel werk. Een knop naar een verkooplink is dan genoeg; lees Mach3Cart.
Hoe werkt dit in Mach3Blocks?
Je collectie haalt haar inhoud uit een adres van Mach3Cart. Vanaf dat moment is die inhoud alleen-lezen, en neem je de velden van de bron op in je collectie.
Hoe dat mechanisme werkt, staat volledig in Externe data. Dit artikel zegt alleen welke waarde uit Mach3Cart waar hoort.
Het is dezelfde lijst die ook de widget voedt. Er is dus één adres voor beide routes, en je vindt het op het widgetscherm en niet op het feedscherm.
Wat je in Mach3Cart klaarzet
Drie schermen aan die kant, elk met één ding dat deze route nodig heeft.
| Waar | Wat je er doet | Bijzonderheden |
|---|---|---|
| Widgets, onder Weergave | De Collection URL kopiëren uit het vlak Implementatie | Het veld is alleen-lezen en heeft een kopieerknop |
| Feed, onder Instellingen | De schakelaar Nieuw tabblad zetten | Aan betekent dat de link uit de lijst de checkout in een nieuw tabblad opent |
| Producten, per product | Het vinkje Tonen in feed aanzetten | Zonder dat vinkje komt het product niet in de lijst |
Per product levert de lijst onder meer het artikelnummer, de naam, de omschrijving, de foto, de prijs en de voorraad. De gegevens voor zoekmachines komen mee, en ordergegevens zijn optioneel.
De velden die de feed levert
Na het opslaan van het adres staat op het tabblad Velden een tweede lijst, onderaan. Die lijst heet Externe velden en toont wat de feed levert.
Je neemt een veld over met de tekstactie Veld toevoegen op zijn rij. De knop Velden toevoegen neemt alles in één keer over.
Een veld dat je hebt overgenomen verdwijnt uit die tweede lijst. In de bovenste lijst krijgt het een vinkje in de kolom In externe data.
| Veld uit de feed | Waarvoor je het gebruikt |
|---|---|
| productname | De naam van het product |
| description | De omschrijving |
| image | De foto |
| price_inc | De prijs inclusief btw |
| checkout_button | De knop waarmee je klant afrekent |
Mach3Blocks leest die velden uit de eerste twintig items van de feed. Het type volgt uit de waarde die daarin staat.
Een sleutel met het woord button erin krijgt vanzelf het type Button. Daarom kun je checkout_button meteen aan een knop in je blok koppelen.
De twee velden die de afrekenknop laten werken
Dit is het punt dat je makkelijk mist. Zonder deze twee keuzes wijst je knop naar een pagina op je eigen website in plaats van naar de checkout.
Beide velden staan op het tabblad Algemeen van de collectie-instellingen; lees Standaard item link.
Dit gaat over de link van het item zelf. De afrekenknop uit de feed koppel je apart, met het veld checkout_button.
| Veld | Wat je kiest | Bijzonderheden |
|---|---|---|
| Standaard item link | Uit externe data | Het item krijgt de link die de bron zelf meegeeft |
| Standaard item link doel | Uit externe data | Hier werkt de schakelaar Nieuw tabblad uit Mach3Cart door |
Stappenplan
Drie delen, in drie omgevingen. Je begint in Mach3Cart, want zonder adres valt er bij ons niets te koppelen.
De lijst klaarzetten in Mach3Cart
- Open de checkout waar je klanten bestellen.
- Zet per product het vinkje Tonen in feed aan.
- Kies onder Instellingen het scherm Feed.
- Zet de schakelaar naar keuze en sla op.
- Kies onder Weergave het scherm Widgets.
- Kopieer de Collection URL uit het vlak Implementatie.
De collectie koppelen in Mach3Blocks
- Open het collectieoverzicht van je website.
- Kies de actie Instellingen op de rij van je collectie.
- Ga naar het tabblad Data.
- Plak het adres in het veld Externe data.
- Klik op Opslaan.
- Open die collectie.
- Ga naar het tabblad Velden.
- Klik op Velden toevoegen voor alle velden tegelijk.
- Kies Veld toevoegen op een rij als je één veld wilt.
Zet daarna op het tabblad Algemeen de twee velden voor de afrekenknop op Uit externe data.
De producten op je pagina zetten
- Open je pagina in de editor.
- Plaats een blok voor je producten.
- Koppel dat blok aan je collectie.
- Selecteer een element in dat blok.
- Kies het gewenste collectieveld bij de instellingen van dat element.
- Koppel op dezelfde manier een knop aan het veld checkout_button.
- Publiceer je website.
Welke blokken hiervoor bedoeld zijn, staat in Prijs- en productblokken. Het koppelen van een element staat in Element koppelen.
Voorwaarden en rechten
Aan de kant van Mach3Cart heb je het pakket PRO nodig. Staat je checkout op een ander pakket, dan zie je daar een melding over upgraden.
Aan onze kant heb je twee rechten nodig.
| Recht | Waarvoor |
|---|---|
| Collecties toevoegen | De collectie-instellingen openen en het tabblad Velden gebruiken |
| Publiceren | Je website live zetten, zodat je bezoeker de producten ziet |
De acht rechten die op een collectie werken, staan bij elkaar in Rechtenoverzicht.
Voor Mach3Cart zelf is er geen recht in Mach3Blocks, want er is niets om te toetsen.
Gevolgen en beperkingen
De collectie verandert van eigen inhoud naar inhoud van een bron. Dat raakt meer dan alleen de items.
| Wat | Wat je merkt |
|---|---|
| Een product zonder het vinkje Tonen in feed | Komt niet in de lijst, en dus niet op je website |
| De items in je collectie | Zijn alleen-lezen; je beheert ze voortaan in Mach3Cart |
| Items in menu | Werkt niet bij een collectie met een externe bron |
| Het tabblad Imports | Verdwijnt zodra er een adres in het veld staat |
| Publieke data | Aanzetten haalt het veld Externe data uit beeld |
| Je gepubliceerde pagina | Haalt de lijst bij elke weergave opnieuw op bij Mach3Cart |
Die laatste regel betekent dat je niet hoeft te publiceren voor een prijswijziging. Publiceren is nodig voor de pagina's zelf, niet voor de inhoud van de lijst.
Het betekent ook dat je website op die lijst leunt. Ligt de checkout eruit, dan heeft je pagina op dat moment geen producten om te tonen.
Wil je terug naar eigen beheer, maak het veld dan leeg en sla op. De collectie is daarna weer gewoon te bewerken.
Als het niet lukt
Zie je in Mach3Cart een melding over upgraden, dan past de feed niet bij het pakket van die checkout. Open Pakket binnen de checkout en controleer het actieve pakket.
Verschijnt er geen enkel veld onder het tabblad Velden, open het adres dan zelf in een venster. Komt daar geen JSON uit, dan levert de bron niet wat je collectie verwacht.
Mist er één product, dan staat bij dat product het vinkje Tonen in feed uit.
Zie je producten van de verkeerde winkel, dan komt het adres uit een andere checkout. Elke checkout heeft een eigen lijst.
Zie je in je blok geen afrekenknop, dan is checkout_button nog niet toegevoegd of nog niet gekoppeld.
Wijst je afrekenknop naar een pagina op je eigen website, dan staat Standaard item link niet op Uit externe data.
Toont je pagina geen enkel product, dan levert de bron op dat moment niets bruikbaars. Open het adres dan zelf en controleer wat eruit komt.
Kun je een item niet wijzigen, dan klopt dat. De inhoud blijft alleen-lezen zolang er een adres in het veld staat.