SEO Rich Data - installatie en configuratie
Doel van de module
De module Kowal_SeoRichData voegt gestructureerde gegevens schema.org in JSON-LD-formaat toe aan Magento 2. De gegenereerde gegevens kunnen producten, aanbiedingen, prijzen, beschikbaarheid, ratings, reviews, breadcrumbs, organisatiegegevens, sitenaam, search box, socialmediaprofielen, FAQ en video omvatten.
De moduleconfiguratie bevindt zich in het Magento-beheerpaneel:
Stores > Configuration > Kowal > SEO Rich Data
Vereisten
- Magento 2.
- Toegang tot Magento CLI.
- Toegang tot de Composer repository met het pakket
kowal/module-seo-rich-data. - Vereist basispakket:
kowal/base. - Rechten om opdrachten
bin/magento uit te voeren.
Installatie via Composer
- Voeg de pakketrepository toe:
Toegangsgegevens voor de Composer repository, het e-mailadres van de klant en de licentietoken, ontvangt u per e-mail na aankoop. Ze zijn ook beschikbaar in het klantpaneel na inloggen op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van uw account en TWOJ_TOKEN door de ontvangen token. Voer de opdrachten uit in de hoofdmap van Magento.
composer config repositories.kowal composer https://repo.kowal.store
- 2. Configureer de toegangsgegevens voor de Composer repository van Kowal:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
composer require kowal/module-seo-rich-data
php bin/magento module:enable Kowal_SeoRichData
- 5. Voer de Magento-update uit:
php bin/magento setup:upgrade
- 6. Voer in een productieomgeving DI-compilatie uit:
php bin/magento setup:di:compile
- 7. Genereer in een productieomgeving statische bestanden als het project dit vereist:
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
Handmatige installatie
- Kopieer de module naar de map:
app/code/Kowal/SeoRichData
php bin/magento module:enable Kowal_SeoRichData
- 3. Voer de Magento-update uit:
php bin/magento setup:upgrade
php bin/magento cache:flush
Acties na installatie
Na installatie voegt de module een productattribuut toe:
| Attribuut | Betekenis |
|---|
offer_item_condition | Productconditie die wordt gebruikt om itemCondition in offers te genereren. |
Het attribuut ondersteunt de waarden:
| Waarde in Magento | JSON-LD-waarde |
|---|
DamagedCondition | https://schema.org/DamagedCondition |
NewCondition | https://schema.org/NewCondition |
RefurbishedCondition | https://schema.org/RefurbishedCondition |
UsedCondition | https://schema.org/UsedCondition |
Als het product geen attribuutwaarde heeft ingesteld, behandelt de module het als NewCondition.
Configuratiebereik
Alle configuratievelden zijn beschikbaar voor de bereiken Default, Website en Store View, conform de Magento-instellingen.
Velden van het type Enabled, Show ... en vergelijkbare velden gebruiken standaard Magento-waarden:
| Waarde | Betekenis |
|---|
Yes | De functie is ingeschakeld en kan JSON-LD-gegevens genereren. |
No | De functie is uitgeschakeld. |
Breadcrumbs
Deze sectie is verantwoordelijk voor gestructureerde gegevens van het navigatiepad.
| Veld | Betekenis | Waarden |
|---|
Enabled | Schakelt het genereren van BreadcrumbList-gegevens in. | Yes, No |
Fixed Category Path | Gebruikt op de productpagina het meest specifieke categoriepad wanneer Magento geen volledige categoriecontext levert. | Yes, No |
Type | Bepaalt de lengte van het breadcrumbpad dat voor de zoekmachine wordt gegenereerd. | Default (Long), Short |
Waarden van het veld Type:
| Waarde | Betekenis |
|---|
Default (Long) | Volledig pad, bijv. Store > Category > Subcategory > Product. |
Short | Verkort pad, bijv. Store > Subcategory > Product. |
Include Your Site Name in Search Results
Deze sectie is verantwoordelijk voor gegevens van het type WebSite, die Google kunnen helpen de naam van de website te herkennen.
| Veld | Betekenis | Waarden |
|---|
Enabled | Schakelt het genereren van WebSite-gegevens in. | Yes, No |
Website Name | Naam van de site/shop die in gestructureerde gegevens wordt doorgegeven. | Tekst, bijvoorbeeld de shopnaam. |
Organization
Deze sectie is verantwoordelijk voor gegevens van het type Organization.
| Veld | Betekenis | Waarden |
|---|
Enabled | Schakelt het genereren van organisatiegegevens in. | Yes, No |
Organization Name | Naam van het bedrijf of de shop. | Tekst; verplicht veld na inschakeling van de sectie. |
Logo Url | Volledige URL van het organisatielogo. | URL naar een grafisch bestand. |
Description | Beschrijving van de organisatie. | Tekst. |
Description Length | Maximaal aantal tekens van de beschrijving. | Getal; leeg betekent niet inkorten. |
Country | Land van de organisatie. | Landcode uit de Magento-lijst. |
Region/State | Regio of provincie. | Tekst. |
ZIP/Postal Code | Postcode. | Tekst. |
City | Plaats. | Tekst. |
Street Address | Straat en huisnummer. | Tekst. |
Sales | Telefoonnummer van de verkoopafdeling. | Nummer in internationaal formaat, bijv. +48.... |
Technical Support | Telefoonnummer van technische support. | Nummer in internationaal formaat. |
Customer Service | Telefoonnummer van de klantenservice. | Nummer in internationaal formaat. |
Het land uit deze sectie kan worden gebruikt als fallback voor het verzendland en het land van het retourbeleid als de betreffende velden in de productsectie leeg blijven.
Social Profiles
Deze sectie voegt socialmediaprofielen van de organisatie toe. Om de gegevens zinvol te laten zijn, moet de sectie Organization zijn ingeschakeld.
| Veld | Betekenis | Waarden |
|---|
Enabled | Schakelt het genereren van links naar socialmediaprofielen in. | Yes, No |
Facebook | URL van het Facebook-profiel. | Volledige URL. |
Twitter | URL van het Twitter / X-profiel. | Volledige URL. |
Google+ | URL van het Google+-profiel. | Volledige URL; historisch configuratieveld. |
Instagram | URL van het Instagram-profiel. | Volledige URL. |
YouTube | URL van het YouTube-kanaal. | Volledige URL. |
LinkedIn | URL van het LinkedIn-profiel. | Volledige URL. |
Myspace | URL van het Myspace-profiel. | Volledige URL; historisch configuratieveld. |
Pinterest | URL van het Pinterest-profiel. | Volledige URL. |
SoundCloud | URL van het SoundCloud-profiel. | Volledige URL. |
Tumblr | URL van het Tumblr-profiel. | Volledige URL. |
Lege velden worden overgeslagen.
Search Box
Deze sectie is verantwoordelijk voor SearchAction-gegevens, die de weergave van het zoekveld van de shop in Google-resultaten mogelijk kunnen maken.
| Veld | Betekenis | Waarden |
|---|
Enabled | Schakelt het genereren van gegevens voor de sitezoekfunctie in. | Yes, No |
Category Rich Data
Deze sectie is verantwoordelijk voor het genereren van productgegevens op categoriepagina’s.
| Veld | Betekenis | Waarden |
|---|
Show Products Data | Voegt gestructureerde gegevens toe voor producten die zichtbaar zijn op de categoriepagina. | Yes, No |
Het inschakelen van deze optie kan de prestaties van categoriepagina’s verslechteren, omdat de module gegevens voor veel producten moet verzamelen.
Product Rich Data
Deze sectie is verantwoordelijk voor de hoofdproductgegevens van het type Product en voor offers-gegevens.
Basisvelden van het product
| Veld | Betekenis | Waarden |
|---|
Enabled | Schakelt het genereren van product-JSON-LD op de productpagina in. | Yes, No |
Show Availability | Voegt availability toe in offers. | Yes, No |
priceValidUntil Default Value | Standaard geldigheidsdatum van de prijs. | Datum. |
Use “Special Price To” Value for priceValidUntil Snippet | Als het product een actieve speciale prijs en een datum Special Price To heeft, vervangt deze datum de standaardwaarde. | Yes, No |
Show Condition | Voegt itemCondition toe in offers. | Yes, No |
Description | Bepaalt de bron van de productbeschrijving in JSON-LD. | None, Product Short Description, Product Full Description, Page Meta Description |
Waarden van het veld Description:
| Waarde | Betekenis |
|---|
None | Haalt geen beschrijving uit de configuratie; de code kan de productnaam als fallback gebruiken als de beschrijving leeg is. |
Product Short Description | Gebruikt de korte productbeschrijving. |
Product Full Description | Gebruikt de volledige productbeschrijving. |
Page Meta Description | Gebruikt de meta description van de pagina. |
Configureerbare en gegroepeerde producten
| Veld | Betekenis | Waarden |
|---|
Show Configurable Products as | Bepaalt de manier waarop aanbiedingen voor configureerbare producten worden gegenereerd. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Show Grouped Products as | Bepaalt de manier waarop aanbiedingen voor gegroepeerde producten worden gegenereerd. | Main Offer, List of Associated Products Offers, Aggregate Offer |
Waarden:
| Waarde | Betekenis |
|---|
Main Offer | Genereert één aanbieding voor het hoofdproduct. |
List of Associated Products Offers | Genereert een aparte aanbieding voor elk eenvoudig of gekoppeld product. |
Aggregate Offer | Genereert AggregateOffer met de laagste prijs, hoogste prijs en het aantal aanbiedingen. |
Ratings en reviews
| Veld | Betekenis | Waarden |
|---|
Show Rating | Voegt aggregateRating en review toe aan de productgegevens. | Yes, No |
Use Yotpo Reviews instead of Magento Reviews | Haalt reviews op uit Yotpo in plaats van Magento Reviews. | Yes, No |
Rating Format | Bepaalt de beoordelingsschaal. | Percentage Scale, Numeric Scale |
Number of Reviews | Limiet voor het aantal nieuwste reviews dat aan JSON-LD wordt toegevoegd. | Getal; leeg betekent alle reviews. |
Waarden van het veld Rating Format:
| Waarde | Betekenis |
|---|
Percentage Scale | Ratings worden geïnterpreteerd op een procentuele schaal. |
Numeric Scale | Ratings worden geïnterpreteerd op een numerieke schaal. |
Integratie met Yotpo vereist de beschikbaarheid van een module die Yotpo ondersteunt. Als de module niet is geïnstalleerd, mag de Yotpo-configuratie niet worden ingeschakeld.
Brand, manufacturer en productidentificatoren
| Veld | Betekenis | Waarden |
|---|
Brand | Productattribuut dat wordt gebruikt om de eigenschap brand te genereren. | Willekeurig productattribuut uit de lijst. |
EAN / GTIN Attribute | Productattribuut dat wordt gebruikt als globale productidentificator. | Willekeurig productattribuut uit de lijst. |
Manufacturer | Productattribuut dat wordt gebruikt om de eigenschap manufacturer te genereren. | Willekeurig productattribuut uit de lijst. |
Het veld EAN / GTIN Attribute genereert een eigenschap afhankelijk van het aantal cijfers:
| Aantal cijfers | JSON-LD-eigenschap |
|---|
| 8 | gtin8 |
| 12 | gtin12 |
| 13 | gtin13 |
| 14 | gtin14 |
| Ander positief aantal cijfers | gtin |
De module verwijdert andere tekens dan cijfers uit de EAN / GTIN-waarde voordat JSON-LD wordt gegenereerd.
Shipping details
De verzendsectie is verantwoordelijk voor het genereren van shippingDetails in offers. Gegevens worden alleen toegevoegd als de sectie is ingeschakeld en alle vereiste waarden aanwezig zijn.
| Veld | Betekenis | Waarden |
|---|
Show Shipping Details | Schakelt het genereren van shippingDetails in. | Yes, No |
Shipping Country | Land van levering. | Landcode uit de Magento-lijst; als leeg wordt het land uit de sectie Organization gebruikt. |
Shipping Price | Verzendkosten. | Getal gelijk aan of groter dan 0; 0 betekent gratis verzending. |
Handling Time Min Days | Minimale verwerkingstijd van de bestelling. | Geheel getal, dagen. |
Handling Time Max Days | Maximale verwerkingstijd van de bestelling. | Geheel getal, dagen. |
Transit Time Min Days | Minimale transporttijd. | Geheel getal, dagen. |
Transit Time Max Days | Maximale transporttijd. | Geheel getal, dagen. |
De valuta van de verzendkosten wordt gehaald uit de valuta van de productaanbieding.
Voorbeeld van de betekenis van waarden:
| Veld | Voorbeeld | Betekenis |
|---|
Shipping Price | 0 | Gratis verzending. |
Handling Time Min Days | 0 | De bestelling kan dezelfde dag worden verwerkt. |
Handling Time Max Days | 1 | De verwerking van de bestelling duurt maximaal 1 dag. |
Transit Time Min Days | 1 | De levering duurt minimaal 1 dag. |
Transit Time Max Days | 5 | De levering duurt maximaal 5 dagen. |
Merchant return policy
De sectie voor retourbeleid is verantwoordelijk voor het genereren van hasMerchantReturnPolicy in offers. Gegevens worden alleen toegevoegd als de sectie is ingeschakeld en de vereiste waarden aanwezig zijn.
| Veld | Betekenis | Waarden |
|---|
Show Merchant Return Policy | Schakelt het genereren van hasMerchantReturnPolicy in. | Yes, No |
Return Policy Country | Land waar het retourbeleid van toepassing is. | Landcode uit de Magento-lijst; als leeg wordt het land uit de sectie Organization gebruikt. |
Return Policy Category | Type retourbeleid. | Finite Return Window, Returns Not Permitted, Unlimited Return Window |
Merchant Return Days | Aantal dagen voor retour. | Geheel getal; vereist voor Finite Return Window. |
Return Method | Ondersteunde retourmethode. | -- Empty --, Return By Mail, Return In Store, Return At Kiosk |
Return Fees | Informatie over retourkosten. | -- Empty --, Free Return, Customer Responsibility, Return Shipping Fees |
Return Shipping Fee | Bedrag van de kosten voor retourzending. | Getal groter dan 0; alleen vereist voor Return Shipping Fees. |
Waarden van het veld Return Policy Category:
| Waarde | JSON-LD-waarde | Betekenis |
|---|
Finite Return Window | https://schema.org/MerchantReturnFiniteReturnWindow | Retour mogelijk gedurende een bepaald aantal dagen. Vereist Merchant Return Days. |
Returns Not Permitted | https://schema.org/MerchantReturnNotPermitted | Retouren zijn niet toegestaan. |
Unlimited Return Window | https://schema.org/MerchantReturnUnlimitedWindow | Retour zonder vastgestelde daglimiet. |
Waarden van het veld Return Method:
| Waarde | JSON-LD-waarde | Betekenis |
|---|
-- Empty -- | geen waarde | Retourmethode wordt niet aan JSON-LD toegevoegd. |
Return By Mail | https://schema.org/ReturnByMail | Retour per post. |
Return In Store | https://schema.org/ReturnInStore | Retour in een fysieke winkel. |
Return At Kiosk | https://schema.org/ReturnAtKiosk | Retour bij een punt/kiosk. |
Waarden van het veld Return Fees:
| Waarde | JSON-LD-waarde | Betekenis |
|---|
-- Empty -- | geen waarde | Informatie over kosten wordt niet aan JSON-LD toegevoegd. |
Free Return | https://schema.org/FreeReturn | Retour is gratis. |
Customer Responsibility | https://schema.org/ReturnFeesCustomerResponsibility | De klant draagt de retourkosten. |
Return Shipping Fees | https://schema.org/ReturnShippingFees | Retour heeft een specifieke vergoeding voor retourzending. Vereist Return Shipping Fee. |
De valuta van het veld Return Shipping Fee wordt gehaald uit de valuta van de productaanbieding.
Custom Properties
Het veld Custom Properties maakt het mogelijk eigen eigenschappen toe te voegen aan de product-JSON-LD.
Formaat:
wlasciwosc_jsonld,kod_atrybutu
Als slechts één element is opgegeven, behandelt de module dit tegelijk als de naam van de JSON-LD-eigenschap en als attribuutcode.
Standaardwaarde:
skumpn,sku
Betekenis van de standaardwaarde:
| Regel | Effect |
|---|
sku | Voegt sku toe op basis van het attribuut sku. |
mpn,sku | Voegt mpn toe op basis van het attribuut sku. |
Voorbeeld van het toevoegen van een eigen attribuut:
color,colormaterial,material
Aanbevolen minimale configuratie voor producten
Configureer minimaal het volgende om waarschuwingen in Google Search Console voor productgegevens te beperken:
| Veld | Aanbeveling |
|---|
Product Rich Data > Enabled | Yes |
Show Availability | Yes |
Brand | Kies een attribuut met het productmerk. |
EAN / GTIN Attribute | Kies een attribuut met EAN / GTIN als producten een globale identificator hebben. |
Show Shipping Details | Yes, als de shop een uniform verzendbeleid heeft dat in de configuratie kan worden beschreven. |
Show Merchant Return Policy | Yes, als de shop een uniform retourbeleid heeft dat in de configuratie kan worden beschreven. |
Custom Properties | Behoud minimaal sku; voeg optioneel mpn toe als de shop zo’n identificator heeft. |
Cache legen na configuratiewijzigingen
Voer na een configuratiewijziging uit:
php bin/magento cache:flush
Als de shop extra HTTP-cache, Varnish of CDN gebruikt, leeg dan ook deze cachelagen.
Werking controleren
- Open de productpagina op de frontend.
- Controleer de paginabron en zoek naar:
<script type='application/ld+json'>
- 3. Controleer of JSON-LD de verwachte velden bevat, bijvoorbeeld:
{ '@type': 'Product', 'brand': { '@type': 'Brand', 'name': 'Example Brand' }, 'gtin13': '5901234123457', 'offers': [ { '@type': 'Offer', 'shippingDetails': {}, 'hasMerchantReturnPolicy': {} } ]}
- 4. Test de product-URL in de Google Rich Results Test-tool of in Google Search Console.
Implementatie-opmerkingen
- Schakel
shippingDetails of hasMerchantReturnPolicy niet in als de waarden in de configuratie niet overeenkomen met het werkelijke shopbeleid. - Als verzend- of retourbeleid verschilt per product, regio, verzendmethode of winkelwagen, kan één globale configuratie onvoldoende zijn.
- Na wijziging van attributen
Brand, Manufacturer of EAN / GTIN Attribute is het verstandig productgegevens opnieuw te indexeren als de shop cache of indexen gebruikt die invloed hebben op het uitlezen van attributen. - Controleer in meertalige en multivaluta-shops de configuratie afzonderlijk voor elke Store View.
