Product Features - installatie, configuratie en beheer van attributen

Dit document beschrijft de configuratie van de module kowal/module-product-features, de betekenis van alle administratieve velden en het werken met attributen aan de productzijde.

Installatie

De module is bedoeld voor installatie via Composer.

De toegangsgegevens voor de Composer-repository, het e-mailadres van de klant en de licentietoken, ontvangt u na aankoop per e-mail. Ze zijn ook beschikbaar in het klantenpaneel 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.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-product-featuresbin/magento module:enable Kowal_ProductFeaturesbin/magento setup:upgradebin/magento cache:flush

Na een productie-implementatie moeten de standaardopdrachten worden uitgevoerd die voor het project gelden, bijvoorbeeld DI-compilatie en deployment van statische assets, volgens de werkwijze van Magento.

Locatie van de configuratie

De configuratie van de module bevindt zich in het Magento-beheerpaneel:

Stores > Configuration > Catalog > Product Features

De vormgevingsinstellingen bevinden zich in een aparte groep:

Stores > Configuration > Catalog > Product Features Appearance

Configuratievelden zijn beschikbaar op het niveau Default, Website en Store View. Daardoor kunnen verschillende winkelweergaven andere kenmerksecties of een andere vormgeving hebben.

Product Features

Enabled

Schakelt de module in of uit voor het betreffende configuratiebereik.

Waarden:

• Yes - productkenmerksecties worden op de productpagina gerenderd,
• No - de module retourneert geen secties en het blok verschijnt niet op de frontend.

Toepassing: snel uitschakelen van de module voor de hele webshop, een geselecteerde Website of Store View zonder de sectieconfiguratie te verwijderen.

Feature Sections

Lijst met secties die op de productpagina worden gerenderd. Elke rij definieert één frontendsectie of een groep secties, als het type cms_blocks wordt gebruikt.

Enabled

Schakelt een afzonderlijke sectie in of uit.

Waarden:

• Yes - de sectie wordt meegenomen in de rendering,
• No - de sectie wordt overgeslagen.

Toepassing: tijdelijk verbergen van één sectie zonder de instellingen te verwijderen.

Section Title

Titel van de sectie die zichtbaar is op de productpagina.

Voorbeelden:

• Cechy produktu,
• Zastosowanie Sportowe,
• Specyfikacja,
• Technologie,
• Dostawa.

Toepassing: de naam moet begrijpelijk zijn voor de klant en hoeft niet overeen te komen met de technische naam van het attribuut.

Opmerking: voor het type cms_blocks wordt de titel van de onderliggende sectie opgehaald uit de titel van het CMS-blok.

Attribute Code

Eén productattribuut dat door de sectie wordt gebruikt. Het veld heeft de vorm van een dropdown met een lijst van productattributen.

Toepassing: gebruik dit veld wanneer de sectie op één attribuut is gebaseerd, bijvoorbeeld sport_usage, blocks_id, material, technology_icon.

Attribute Codes

Lijst met meerdere productattributen die door één sectie worden gebruikt. Het veld heeft de vorm van een multiselect.

Toepassing: gebruik dit veld wanneer één sectie meerdere kenmerken moet samenvoegen, bijvoorbeeld meerdere schalen in de sectie Cechy produktu of meerdere parameters in de sectie Specyfikacja.

Voorbeeld: de sectie Cechy produktu kan de attributen fit, resistance, stretch en breathability bevatten, allemaal gerenderd als schalen.

Display Type

Bepaalt hoe de attribuutwaarde wordt gepresenteerd.

Een lege waarde Auto betekent automatische selectie van de renderer:

• blocks_id wordt gerenderd als cms_blocks,
• swatch multiselect als swatch_list,
• select met 2 of 3 opties als scale,
• select met meer opties als selected_label,
• multiselect als text_list,
• boolean als checkmark,
• date als date,
• price als price,
• textarea als text_block,
• image/media_image als image,
• overige typen als text_inline.

Beschikbare typen:

In het beheerpaneel is een deel van de items gemarkeerd als available in future release. Dit geldt voor typen die al zichtbaar zijn in de configuratielijst, maar nog geen eigen definitieve frontendpresentatie hebben:

• table,
• badge,
• badge_list,
• icon_value,
• icon_list,
• swatch_grid.

Sort Order

Volgorde van secties op de productpagina. Een lager getal betekent eerdere weergave.

Toepassing: plaats de belangrijkste secties aan het begin, bijvoorbeeld 10 voor hoofdkenmerken, 20 voor toepassingen, 30 voor specificatie.

Default State

Beginstatus van de sectie op de productpagina.

Waarden:

• Expanded - de sectie is standaard uitgeklapt,
• Collapsed - de sectie is standaard ingeklapt.

Toepassing: de belangrijkste content kan direct worden getoond, terwijl langere ondersteunende informatie ingeklapt blijft.

Hide Empty

Bepaalt of de sectie moet worden verborgen wanneer er geen gegevens zijn om te tonen.

Waarden:

• Yes - de sectie wordt verborgen als het product geen attribuutwaarde heeft of de renderer geen elementen retourneert,
• No - de sectie kan zichtbaar blijven, ook zonder elementen.

Toepassing: meestal wordt Yes aanbevolen, zodat klanten geen lege secties zien.

Appearance Profile

Selectie van het weergaveprofiel dat is gedefinieerd in het veld Appearance Profiles.

Het veld heeft de vorm van een dropdown. De beheerder voert de code niet meer handmatig in, maar kiest een bestaand profiel uit de lijst, meestal in het formaat code - label.

Toepassing: hiermee kan een specifieke sectie een andere vormgeving krijgen dan de globale, bijvoorbeeld het profiel compact, highlight of plain.

Als het veld leeg is en de optie Use global appearance is geselecteerd, gebruikt de sectie de globale vormgeving.

Aanbevolen werkwijze:

1. definieer het profiel in Appearance Profiles,
2. sla de configuratie op,
3. ga terug naar Feature Sections,
4. selecteer het profiel in de kolom Appearance Profile voor de betreffende sectie.

CSS Class

Extra CSS-klasse die aan de sectie wordt toegevoegd.

Toepassing: individuele aanpassing van de vormgeving in het frontendthema, bijvoorbeeld product-features-section--technical.

Renderer Options JSON

Optionele instellingen die in JSON-formaat aan de renderer worden doorgegeven.

De toepassing hangt af van het presentatietype. Voorbeelden:

{'unit':'cm','precision':1}

Voor number_with_unit:

• unit - eenheid, bijvoorbeeld cm, %, g/m2,
• precision - aantal decimalen.

Voor range_bar:

• min - minimale waarde van het bereik,
• max - maximale waarde van het bereik,
• low_label - label voor het begin van het bereik,
• high_label - label voor het einde van het bereik.

Voor rating_dots:

• steps - aantal punten of niveaus.

Het type radial_chart vereist geen extra opties. De renderer leest de attribuutwaarde of het optielabel in het formaat x/y, bijvoorbeeld 1/6, 4/6, 7/10.

Voorbeeld voor een bereikbalk:

{'min':0,'max':100,'low_label':'Niska','high_label':'Wysoka'}

Voorbeeld voor punten:

{'steps':5}

Opmerking: het veld moet geldige JSON bevatten. Een ongeldige waarde wordt door de renderer genegeerd.

Appearance Profiles

Lijst met optionele weergaveprofielen die via het veld Appearance Profile aan secties kunnen worden toegewezen.

Code

Technische code van het profiel.

Voorbeelden:

• compact,
• highlight,
• plain.

Toepassing: de code identificeert het profiel intern en wordt gebruikt als optiewaarde in de dropdown Appearance Profile bij de sectie.

Label

Beschrijvende profielnaam die zichtbaar is voor de beheerder.

Toepassing: helpt het profiel in de configuratie te herkennen, bijvoorbeeld Kompaktowy, Wyróżniony, Neutralny. In combinatie met de code vormt dit een duidelijk label in de profielkeuzelijst in Feature Sections.

Background

Achtergrondkleur van de sectie voor het profiel.

Toepassing: geselecteerde secties benadrukken of aanpassen aan het thema.

Text

Kleur van de basistekst in de sectie.

Heading

Kleur van de sectietitel.

Accent

Accentkleur, bijvoorbeeld van actieve elementen, schaalpunten of markeringen.

Accent Background

Achtergrondkleur van accentelementen.

Border

Kleur van lijnen, scheidingen, schaalassen en randen.

Icon

Kleur van het pictogram voor het uitklappen en inklappen van secties.

Radius, e.g. 18px

Afronding van de sectiehoeken.

Voorbeelden: 0, 8px, 18px.

Padding, e.g. 28px

Binnenruimte van de sectie.

Voorbeelden: 16px, 24px, 28px.

Label Font Size, e.g. 21px

Tekstgrootte van kenmerklabels in de sectie.

Voorbeelden: 16px, 18px, 21px, 1.25rem.

Product Features Appearance

Deze groep bevat de globale vormgeving van secties. De instellingen worden omgezet in CSS-variabelen en toegepast op de wrapper van de module.

Section Background Color

Achtergrondkleur van de sectie.

Standaard: #f4f4f4.

Section Text Color

Basiskleur van de tekst in de sectie.

Standaard: #000000.

Section Heading Color

Kleur van de sectiekop.

Standaard: #000000.

Muted Text Color

Kleur van ondersteunende en minder belangrijke teksten.

Standaard: #555555.

Accent Color

Kleur van actieve elementen en markeringen.

Standaard: #000000.

Accent Background Color

Achtergrondkleur van actieve elementen, bijvoorbeeld selecties.

Standaard: #ffffff.

Border Color

Kleur van randen, scheidingen en schaalassen.

Standaard: #9b9b9b.

Icon Color

Kleur van het pictogram + / - in de sectiekop.

Standaard: #000000.

Selected Text Color

Tekstkleur van de geselecteerde waarde.

Standaard: #000000.

Selected Font Weight

Fontgewicht van de geselecteerde waarde.

Standaard: 700.

Voorbeelden: 400, 500, 600, 700, bold.

Section Border Radius

Afronding van de sectiecontainer.

Standaard: 18px.

Section Padding

Binnenruimte van de sectie.

Standaard: 28px.

Section Gap

Afstand tussen secties.

Standaard: 16px.

Heading Font Size

Fontgrootte van de sectiekop.

Standaard: 20px.

Voorbeelden: 18px, 20px, 1.25rem, clamp(18px, 2vw, 22px).

Label Font Size

Fontgrootte van kenmerklabels en waardelabels.

Standaard: 21px.

Body Font Size

Fontgrootte van de basistekst in de sectie.

Standaard: 16px.

Beheer van attributen aan de productzijde

De module maakt geen apart systeem voor productgegevens aan. Hij gebruikt Magento-productattributen, waardoor contentbeheer vooral plaatsvindt bij het bewerken van het product.

Eén product bewerken

1. Ga naar Catalog > Products.
2. Open het product om te bewerken.
3. Vul de attributen in die door de modulesecties worden gebruikt.
4. Als het product CMS-blokken moet gebruiken, ga dan naar de groep Product Features en stel het veld CMS Blocks in.
5. Sla het product op.
6. Leeg de cache als het project dit vereist.

De sectie verschijnt alleen op de frontend als:

• de module is ingeschakeld,
• de sectie in de configuratie is ingeschakeld,
• het attribuut bestaat,
• het product een attribuutwaarde heeft,
• de renderer de geselecteerde waarde kan verwerken,
• de sectie niet is verborgen door Hide Empty.

Attribuut blocks_id / CMS Blocks

Tijdens setup:upgrade voegt de module een productattribuut toe:

• code: blocks_id,
• label: CMS Blocks,
• type: text,
• input: multiselect,
• source model: actieve CMS-blokken,
• backend: standaard Magento-backend voor multiselect,
• scope: Store View,
• groep: Product Features,
• zichtbaar bij productbewerking,
• beschikbaar in het productgrid en gridfiltering.

Het veld CMS Blocks maakt het mogelijk actieve CMS-blokken aan een product toe te wijzen. Elk geselecteerd blok wordt als afzonderlijke sectie gerenderd als er in de moduleconfiguratie een sectie bestaat met:

• Attribute Code: blocks_id,
• Display Type: cms_blocks.

De sectietitel op de frontend komt uit de titel van het CMS-blok en de inhoud uit de blokinhoud. Inactieve blokken of blokken die niet beschikbaar zijn voor de Store View worden niet gerenderd.

CMS-blokken beheren

Blokken die door blocks_id worden gebruikt, maakt u standaard in Magento:

Content > Elements > Blocks

Aanbevelingen:

• gebruik duidelijke bloktitels, omdat deze zichtbaar kunnen zijn als sectietitels,
• wijs blokken toe aan de juiste Store Views,
• stel het blok in als actief,
• bewaar in blokken beschrijvende content die door meerdere producten kan worden gedeeld, bijvoorbeeld levering, retouren, instructies, technologieën.

Producten massaal bewerken

Het attribuut blocks_id is voorbereid voor gebruik met massale productbewerking.

1. Ga naar Catalog > Products.
2. Selecteer producten in het grid.
3. Kies de actie Update Attributes.
4. Stel de waarde van het veld CMS Blocks in.
5. Sla de wijzigingen op.

Toepassing: snel dezelfde CMS-sectie, bijvoorbeeld Dostawa, Zwroty of Instrukcja pielęgnacji, aan meerdere producten tegelijk toewijzen.

Attributen voor schaal

Gebruik voor het type scale attributen select met 2 of 3 actieve opties.

Voorbeeld:

• attribuut fit,
• opties: Luźny, Regularny, Dopasowany.

Het product moet één van de opties geselecteerd hebben. De module toont alle opties van de schaal en markeert de optie die aan het product is toegewezen.

Als het attribuut minder dan 2 of meer dan 3 opties heeft, slaat de renderer scale dit attribuut over.

Multiselect-attributen

Gebruik voor lijsten met kenmerken, toepassingen, technologieën of certificaten attributen multiselect.

Mogelijke presentatietypen:

• text_list,
• badge_list,
• swatch_list,
• swatch_grid,
• multiselect_icon,
• icon_list.

Het product kan meerdere waarden geselecteerd hebben. De module rendert alleen waarden die aan het product zijn toegewezen.

Magento-swatches

Als het multiselect-attribuut Magento-swatches gebruikt, kunt u het type swatch_list of swatch_grid gebruiken.

Toepassing:

• technologiepictogrammen,
• kleuren,
• toepassingspictogrammen,
• materiaalaanduidingen.

Als een optie een afbeeldingsswatch heeft, toont de module de afbeelding. Als er een kleur- of tekstswatch is, gebruikt de module de juiste variant.

Amasty-pictogrammen

Voor het type multiselect_icon probeert de module het optiepictogram uit Amasty ShopbyBrand / ShopbyBase op te halen.

Bron van het pictogram:

Shop by Brand > Option Edit > Other > Small Image

De alternatieve tekst komt uit Small Image Alt, en als deze ontbreekt, uit het optielabel.

Als Amasty niet is geïnstalleerd of de optie geen pictogram heeft, toont de module alleen het label.

Tekst- en HTML-attributen

Gebruik voor korte informatie text_inline, key_value of badge.

Gebruik voor langere beschrijvingen text_block, accordion_text of html_block.

Opmerking: html_block en accordion_text renderen HTML en mogen daarom alleen worden gebruikt voor vertrouwde administratieve content.

Numerieke attributen

Voor numerieke waarden kunt u gebruiken:

• number_with_unit - wanneer het getal een eenheid vereist,
• range_bar - wanneer de waarde als voortgang binnen een bereik moet worden weergegeven,
• rating_dots - wanneer de waarde een niveau of beoordeling beschrijft.

Voorbeeld van Renderer Options JSON voor een getal met eenheid:

{'unit':'%','precision':0}

Boolean-attributen

Gebruik voor ja/nee-attributen:

• yes_no, wanneer de klant zowel Yes als No moet zien,
• checkmark, wanneer het kenmerk alleen zichtbaar moet zijn als het product het bezit.

Afbeeldingsattributen

Voor attributen van het type afbeelding kunt u gebruiken:

• image,
• image_with_label,
• image_grid.

De module bouwt het afbeeldingsadres op basis van de productmediamap van Magento en gebruikt het attribuutlabel als alternatieve tekst.

Voorbeeldconfiguratie

Sectie met meerdere schalen:

Sectie met toepassingen en pictogrammen:

CMS-secties:

Diagnose

Als een sectie niet op de frontend verschijnt, controleer dan:

• of Enabled van de module de waarde Yes heeft,
• of de betreffende sectie Enabled = Yes heeft,
• of het product het attribuut ingevuld heeft,
• of de juiste Attribute Code of Attribute Codes is geselecteerd,
• of Display Type past bij het attribuuttype,
• of Hide Empty geen lege sectie verbergt,
• of het attribuut beschikbaar is voor de betreffende Store View,
• of het CMS-blok actief is en aan de juiste Store View is toegewezen,
• of de Magento-cache is vernieuwd.