Als uw producten extra gegevens bevatten in ACF of andere aangepaste velden, kunt u deze rechtstreeks in uw productfeeds opnemen. Deze handleiding laat zien hoe u die aangepaste velden in de toewijsbare veldenlijst kunt weergeven en hoe u ze in uw feed kunt toewijzen, inclusief het gebruik ervan in regels en filters. AdTribes heeft geen officiële ACF-integratie, maar een kleine workaround zorgt ervoor dat het werkt met zowel Advanced Custom Fields (ACF) als andere aangepaste productmeta.
Het meest voorkomende probleem waar winkel eigenaren tegenaan lopen, is dat ACF-velden niet verschijnen onder de sectie Toewijsbare velden bij het bouwen van een feed. Dit komt doordat de plugin uw productattributen cacht, en nieuw aangemaakte aangepaste velden worden niet automatisch gedetecteerd. Het wissen van die cache dwingt de plugin om uw producten opnieuw te scannen en de nieuwe velden op te pikken.
Zodra uw ACF-velden zichtbaar zijn in de lijst met toewijsbare velden, kunt u ze precies gebruiken zoals elk ander productattribuut – wijs ze toe aan feedvelden, neem ze op in regels en pas ze toe als filters.
Vereisten
- AdTribes Product Feed Pro of Product Feed Elite geïnstalleerd en actief
- Advanced Custom Fields (ACF) plugin geïnstalleerd en actief – de gratis versie uit de WordPress.org repository is voldoende
- Minstens één ACF-veldgroep geconfigureerd om weer te geven op WooCommerce-producten
- Minstens één product met ACF-veldwaarden ingevuld
Stap 1: Maak uw ACF-veldgroep
Begin met het maken van een nieuwe ACF-veldgroep. Navigeer naar Aangepaste velden > Nieuw toevoegen in uw WordPress-admin. Geef de groep een naam en configureer vervolgens de Locatieregels zodat de velden verschijnen onder Post Type > is gelijk aan > Product. Dit zorgt ervoor dat uw aangepaste velden worden gekoppeld aan WooCommerce-producten.
Voeg de velden toe die u nodig heeft aan de groep – bijvoorbeeld een tekstveld voor een aangepast label of een numeriek veld voor een aangepaste gewichtswaarde. Sla de veldgroep op als u klaar bent.
Stap 2: Vul de velden op uw producten in
Nadat de veldgroep is opgeslagen, gaat u naar een product onder Producten > Alle producten en opent u het om te bewerken. Scroll naar beneden om uw aangepaste ACF-velden onder de standaard productgegevens te vinden. Voer waarden in voor elk veld dat u wilt opnemen in uw feed.
Zorg ervoor dat u het product bijwerkt nadat u uw waarden hebt ingevoerd. Herhaal dit voor alle producten waarop u het aangepaste veld wilt laten verschijnen.
Stap 3: Wis de cache van aangepaste attributen
Standaard verschijnen ACF-velden niet in de lijst Toewijsbare velden wanneer u een productfeed configureert. Dit komt doordat AdTribes uw aangepaste attributen cacht voor prestatieredenen en nieuwe velden die door plug-ins van derden zijn toegevoegd, niet automatisch detecteert.
Om uw ACF-velden te laten verschijnen, navigeert u naar Product Feed Pro/Elite > Instellingen en klikt u op de knop Wis cache voor aangepaste attributen.
Stap 4: Wijs uw ACF-velden toe in de feed
Na het wissen van de cache, keert u terug naar uw feedconfiguratie en opent u de sectie Mappable Fields. Uw ACF-velden zouden nu in de lijst moeten verschijnen – ze kunnen als twee afzonderlijke vermeldingen verschijnen (met licht verschillende sleutelnamen).
Selecteer de eerste vermelding voor uw ACF-veld en wijs deze toe aan het juiste feedattribuut. Sla de feed op en vernieuw deze om te verifiëren dat de aangepaste veldwaarde correct wordt ingevuld in de feeduitvoer.
Als de waarde na het vernieuwen niet verschijnt, ga dan terug naar de toewijsbare velden en probeer de tweede vermelding voor hetzelfde ACF-veld. De juiste sleutel is afhankelijk van hoe ACF het veld intern opslaat.
ACF-velden gebruiken in regels en filters
Zodra uw ACF-velden zichtbaar zijn in de lijst met toewijsbare velden, zijn ze ook beschikbaar om te gebruiken in Regels en Filters. Hiermee kunt u producten opnemen of uitsluiten op basis van aangepaste veldwaarden, of de velduitvoer manipuleren voordat deze in uw feed verschijnt.
Veelgestelde vragen
Ik heb de cache gewist, maar mijn ACF-velden verschijnen nog steeds niet in Mappable Fields. Wat moet ik proberen?
Bevestig eerst dat ten minste één product het ACF-veld heeft ingevuld met een waarde – de plugin detecteert alleen velden waarvoor gegevens zijn opgeslagen bij een product. Als het veld op alle producten leeg is, wordt het niet geïndexeerd. Nadat u een waarde op ten minste één product hebt ingevuld, gaat u naar Product Feed Pro/Elite > Instellingen en klikt u opnieuw op Wis cache voor aangepaste attributen, ga dan terug naar uw feedconfiguratie en controleer de lijst met Mappable Fields.
Waarom verschijnt mijn ACF-veld twee keer in de lijst met Mappable Fields?
ACF slaat veldgegevens op twee manieren op: eenmaal onder de naam-sleutel van het veld en eenmaal onder een interne referentie-sleutel met een underscore als voorvoegsel. Beide sleutels kunnen in de lijst met toewijsbare velden verschijnen. De eerste vermelding is doorgaans de juiste om te gebruiken, maar als waarden niet worden ingevuld in uw feed, schakel dan over naar de tweede vermelding en vernieuw de feed.
Moet ik de cache elke keer wissen als ik een nieuw ACF-veld toevoeg?
Ja. Elke keer dat u een nieuw aangepast veld toevoegt – of het nu van ACF of een andere plugin is – moet u de aangepaste attributencache wissen, zodat AdTribes het nieuwe veld kan detecteren. Bestaande velden die al in de cache zijn opgenomen, worden niet beïnvloed.
Mijn ACF-veld wordt correct toegewezen, maar de waarde is leeg in de feeduitvoer. Waarom?
Dit betekent meestal dat het product dat u test geen waarde heeft opgeslagen voor dat ACF-veld, of dat u de verkeerde sleutel hebt geselecteerd uit de twee beschikbare vermeldingen. Controleer het product in de editor om te bevestigen dat er een waarde is opgeslagen, schakel vervolgens over naar de alternatieve sleutel in de lijst met toewijsbare velden en vernieuw de feed.
Kan ik ACF-velden gebruiken die arrays of repeater-veldgegevens bevatten?
AdTribes wijst eenvoudige tekst-, nummer- en selectietype ACF-velden betrouwbaar toe. Complexe ACF-veldtypen zoals Repeaters, Flexible Content en Relationship-velden slaan gegevens op als geserialiseerde arrays, die niet eenvoudig toe te wijzen zijn aan één feedattribuut. Voor deze veldtypen heeft u mogelijk een ontwikkelaar nodig om een aangepast codefragment te maken dat de gegevens platmaakt tot een eenvoudige waarde voordat deze in een feed kan worden gebruikt.
Werkt dit met ACF Pro of alleen de gratis versie?
De oplossing werkt met zowel de gratis ACF-plugin als ACF Pro. Het belangrijkste verschil is dat ACF Pro extra veldtypen bevat (zoals Repeater en Gallery) die mogelijk niet goed worden toegewezen, zoals hierboven vermeld. Standaard veldtypen van beide versies werken op dezelfde manier.
Kan ik dezelfde aanpak gebruiken voor aangepaste metavelden die door andere plugins zijn toegevoegd?
Ja. Het proces voor het wissen van de aangepaste attributencache werkt voor alle aangepaste productmeta, niet alleen voor ACF-velden. Als een andere plugin aangepaste gegevens aan uw producten toevoegt en deze niet verschijnt in de lijst met toewijsbare velden, is het wissen van de cache de juiste eerste stap. Het veld moet een waarde hebben die op ten minste één product is opgeslagen om te worden gedetecteerd.
Worden mijn ACF-veldwaarden automatisch bijgewerkt in de feed wanneer ik een product bewerk?
Feedbestanden worden gegenereerd op basis van een schema of op aanvraag. Het bijwerken van de ACF-veldwaarden van een product werkt niet onmiddellijk bij in het live feedbestand – u moet de feed handmatig vernieuwen vanuit AdTribes > Feeds door op Vernieuwen te klikken, of wachten op de volgende geplande generatiecyclus.
Ik zie het ACF-veld in Toewijsbare velden, maar het is niet beschikbaar in Regels of Filters. Is dat normaal?
Nee – als het veld na het wissen van de cache in Toewijsbare velden verschijnt, zou het ook beschikbaar moeten zijn in Regels en Filters. Als het ontbreekt, probeer dan de cache opnieuw te wissen en open vervolgens de feedconfiguratie opnieuw. Als het probleem aanhoudt, zorg er dan voor dat het veld een waarde heeft die op ten minste één product is opgeslagen en neem contact op met de ondersteuning.
Is er een officiële ACF-integratie gepland voor AdTribes?
Er is momenteel geen officiële ACF-integratie. De workaround die in dit artikel wordt beschreven, is de ondersteunde methode voor het gebruik van ACF-velden in productfeeds. Als er een officiële integratie beschikbaar komt, zal dit worden aangekondigd in de releaseopmerkingen van de plugin.
Hulp nodig?
Als u verdere hulp nodig heeft bij het mappen van ACF-velden of aangepaste productmeta in uw productfeeds, kunt u gerust een ondersteuningsticket openen om contact op te nemen met ons ondersteuningsteam.
Houd er rekening mee dat het ticketondersteuningssysteem exclusief is voor Product Feed Elite-gebruikers.
Als je alleen de Product Feed Pro plugin gebruikt, kun je gerust een nieuw onderwerp openen op het WordPress.org forum.
