MAGENTO 2 · CATEGORIEËN · CSV · STORE VIEW

Kowal Export Import Categories

Exporteer categorie-attributen naar CSV, bereid wijzigingen voor in een spreadsheet en importeer ze naar de juiste store view. Beheer lege waarden, URL-adressen, afbeeldingen en het rapport van elke uitvoering.

Update en Insert · Dry Run · Vertalingen en eigen attributen

HOE HET IN DE PRAKTIJK WERKT

Kowal_ExportImportCategories is een Magento 2-module waarmee u categorie-attributen in CSV-formaat kunt exporteren en importeren, met ondersteuning voor de gekozen store view. De extensie is ontwikkeld voor winkels die met meerdere taalversies of meerdere store views werken, of die categoriegegevens massaal willen bijwerken zonder elke categorie handmatig in het beheerpaneel te bewerken.

Met de module kunt u categorieën naar een CSV-bestand exporteren, geselecteerde attributen buiten Magento wijzigen en de gegevens vervolgens opnieuw importeren in de modus voor het bijwerken van bestaande categorieën of het aanmaken van nieuwe categorieën. De import werkt binnen de opgegeven store view, waardoor u eenvoudig vertalingen van namen, beschrijvingen, metatags, URL’s en andere categorie-attributen kunt voorbereiden.

De module is bedoeld voor:

• Magento 2-winkels met meerdere taalversies,
• contentteams die met CSV-spreadsheets werken,
• bureaus die categoriecatalogi tussen omgevingen implementeren,
• beheerders die categorienamen, beschrijvingen, metadata en URL’s massaal moeten bijwerken,
• winkels die eigen categorie-attributen hebben en deze bulkgewijs willen beheren,
• projecten waarin categoriegegevens buiten Magento worden voorbereid, bijvoorbeeld door vertalers, de SEO-afdeling of een PIM-systeem.

• Export van categorieën naar CSV voor de gekozen store view.
• Import van categorieën uit CSV voor de gekozen store view.
• Modus voor het bijwerken van bestaande categorieën: update.
• Modus voor het aanmaken van nieuwe categorieën: insert.
• Selectie van attributen die naar CSV worden geëxporteerd.
• Selectie van attributen die uit CSV worden geïmporteerd.
• Automatische systeemkolommen die nodig zijn voor categorie-identificatie.
• Validatie van CSV-koppen vóór import.
• Validatie van kolomnamen ten opzichte van de daadwerkelijke Magento categorie-attributen.
• Ondersteuning voor eigen categorie-attributen die in Magento zijn toegevoegd.
• Ondersteuning voor tekstwaarden voor alle attributen.
• Ondersteuning voor select- en multiselect-attributen op basis van optielabels.
• Mogelijkheid om te werken met waarden die zichtbaar zijn in de store view of alleen met store view-overschrijvingen.
• dry-run-modus, oftewel volledige importvalidatie zonder gegevens op te slaan.
• Beleid voor lege waarden.
• Strategieën voor het verwerken van url_key.
• Optioneel aanmaken van permanent redirect bij wijziging van de categorie-URL.
• Ondersteuning voor paden naar categorieafbeeldingen.
• Batch processing voor grotere bestanden.
• Foutafhandelingsbeleid.
• Importrapport in CSV.
• Importgeschiedenis in het beheerpaneel.

Met export kunt u een CSV-bestand met categorieën genereren voor de gekozen store view. De beheerder kiest de store view en de categorie-attributen die in het bestand moeten worden opgenomen. De module voegt automatisch systeemkolommen toe die nodig zijn om categorieën te identificeren en de boomstructuur te behouden.

Export kan worden gebruikt voor:

• het voorbereiden van categorievertalingen,
• audit van categoriegegevens,
• massale correctie van SEO-metadata,
• vergelijking van waarden tussen store views,
• het voorbereiden van een bestand voor import in dezelfde of een andere omgeving,
• archivering van actuele categoriegegevens vóór wijzigingen.

De export omvat categorie-attributen. De module exporteert geen producten die aan categorieën zijn toegewezen. Ook voert de module geen bewerkingen uit om categorieën te verwijderen.

De beheerder kan kiezen:

• Store View,
• startcategorie,
• attributen voor export,
• CSV-scheidingsteken,
• store view-waardemodus.

De module ondersteunt twee modi voor het exporteren van waarden:

• resolved_value - de waarde die zichtbaar is in de betreffende store view wordt geëxporteerd, dus met inachtneming van de Magento fallback naar de standaardwaarde.
• store_override_only - alleen de waarde die rechtstreeks voor de betreffende store view is overschreven wordt geëxporteerd; als de waarde wordt overgenomen, blijft de CSV-cel leeg.

De modus resolved_value is handig voor redactioneel werk, omdat deze de werkelijke waarde toont die in de winkel zichtbaar is. De modus store_override_only is nuttig wanneer u uitsluitend vertalingen of overschrijvingen wilt beheren die specifiek zijn voor een bepaalde store view.

Met import kunt u een CSV-bestand inlezen en geselecteerde categorie-attributen opslaan voor de opgegeven store view. De store view die in het importformulier wordt gekozen is leidend, terwijl de kolom store_view_code uit de CSV wordt gebruikt om te valideren of het bestand overeenkomt met de gekozen store view.

Import kan worden gebruikt voor:

• het vertalen van categorieën,
• het bijwerken van categorienamen,
• het bijwerken van categoriebeschrijvingen,
• het bijwerken van metatags,
• het bijwerken van url_key,
• het aanmaken van nieuwe categorieën,
• het importeren van eigen categorie-attributen,
• het bijwerken van menu- en zichtbaarheidsattributen,
• het importeren van paden naar categorieafbeeldingen.

De modus update werkt bestaande categorieën bij. De module maakt in deze modus geen nieuwe categorieën aan.

Een categorie wordt voornamelijk gezocht op entity_id. Als entity_id niet beschikbaar is, kan de module category_path gebruiken, mits het pad eenduidig naar één categorie verwijst.

De modus update wordt aanbevolen voor:

• categorievertalingen tussen store views,
• SEO-correcties,
• het bijwerken van beschrijvingen,
• het bijwerken van namen,
• het wijzigen van waarden van eigen categorie-attributen.

Voorbeeldscenario voor vertaling:

1. Exporteer categorieën uit de basis-store view.
2. Wijzig store_view_code in de CSV naar de code van de doel-store view.
3. Behoud dezelfde entity_id.
4. Vul vertalingen aan in de kolommen name, description, meta_title, meta_description.
5. Importeer in de modus update voor de doel-store view.

In deze variant slaat de module de geselecteerde attributen op in de context van de numerieke store_id die in het importformulier is gekozen.

De modus insert maakt nieuwe categorieën aan. In deze modus is entity_id niet vereist, omdat Magento dit automatisch toekent.

Een nieuwe categorie moet een oudercategorie hebben die wordt aangegeven via:

• parent_entity_id,
• of parent_path.

De modus insert wordt aanbevolen voor:

• het aanmaken van nieuwe categoriestructuren,
• het verplaatsen van een categorieboom tussen omgevingen,
• het voorbereiden van categorieën in een CSV-spreadsheet,
• het aanmaken van categorieën op basis van externe gegevens.

Als de import zowel een oudercategorie als een onderliggende categorie bevat, moeten de gegevens worden geordend van categorieën op hoger niveau naar categorieën op lager niveau.

De eerste rij van het CSV-bestand moet kolomkoppen bevatten. Kolommen zijn onderverdeeld in:

• systeemkolommen,
• kolommen met categorie-attributen.

Attribuutkolommen moeten overeenkomen met Magento-attribuutcodes, bijvoorbeeld:

• name,
• url_key,
• description,
• meta_title,
• meta_description,
• is_active,
• include_in_menu.

De module gebruikt de volgende systeemkolommen:

• store_view_code,
• entity_id,
• parent_entity_id,
• category_path,
• parent_path,
• level,
• position,
• attribute_set_id.

Systeemkolommen worden niet behandeld als EAV-attributen. Ze dienen voor categorie-identificatie, store view-validatie en het opnieuw opbouwen van de boomstructuur.

store_view_code,entity_id,category_path,name,url_key,is_active,include_in_menu,meta_titlepl,13,Default Category/Gear/Bags,Torby,torby,1,1,Torbypl,14,Default Category/Gear/Fitness Equipment,Sprzet fitness,sprzet-fitness,1,1,Sprzet fitness

store_view_code,parent_entity_id,parent_path,category_path,name,url_key,is_active,include_in_menudefault,12,Default Category/Gear,Default Category/Gear/Helmets,Helmets,helmets,1,1default,12,Default Category/Gear,Default Category/Gear/Gloves,Gloves,gloves,1,1

De module slaat waarden in CSV op als tekst. Daardoor kan het bestand worden bewerkt in een spreadsheet, aan een vertaler worden doorgegeven of automatisch in een extern systeem worden voorbereid.

Voor attributen van het type select en multiselect werkt de module op basis van optielabels en niet op technische optie-ID’s. Dit betekent dat in de CSV leesbare waarden zichtbaar zijn, zoals Products only, Position of Price.

Voor multiselect worden meerdere waarden gescheiden met het scheidingsteken |.

Voorbeeld:

store_view_code,entity_id,category_path,display_mode,available_sort_by,default_sort_bydefault,13,Default Category/Gear/Bags,Products only,Position|Product Name|Price,Position

Als het optielabel niet bestaat of niet eenduidig is, meldt de import een validatiefout.

Tijdens import kiest de beheerder hoe lege CSV-cellen moeten worden geïnterpreteerd:

• skip_empty - een lege cel wijzigt de bestaande waarde niet.
• clear_value - een lege cel wist de attribuutwaarde voor de gekozen store view.
• use_default - een lege cel verwijdert de store view-overschrijving en laat Magento de standaardwaarde gebruiken.

Standaard wordt voor updates de variant skip_empty aanbevolen, omdat deze het risico op per ongeluk wissen van gegevens beperkt.

Met de module kunt u een strategie configureren voor het verwerken van url_key:

• use_csv_value - gebruikt de waarde uit CSV.
• generate_from_name - genereert url_key op basis van het attribuut name.
• keep_existing - behoudt in de modus update de huidige url_key.
• magento_default - laat URL-afhandeling over aan het standaardmechanisme van Magento.

De beheerder kan ook bepalen of er bij wijziging van url_key permanent redirects moeten worden aangemaakt.

Deze configuratie is vooral belangrijk bij vertalingen, omdat verschillende winkels verschillende strategieën kunnen gebruiken:

• vertaalde URL’s voor elke taal,
• gedeelde URL’s tussen taalversies,
• URL’s die automatisch uit categorienamen worden gegenereerd,
• handmatig beheerde SEO-URL’s.

De module kan attributen van categorieafbeeldingen importeren als de juiste kolommen voor import worden geselecteerd.

Standaard bronmap:

pub/media/import/categories

In CSV wordt het tekstpad ten opzichte van deze map opgegeven, bijvoorbeeld:

gear/bags.jpg

De module valideert of het bestand bestaat en controleert de extensie. Veilige afbeeldingsformaten worden ondersteund, zoals:

• jpg,
• jpeg,
• png,
• webp,
• gif.

Met de modus dry-run kunt u importvalidatie uitvoeren zonder gegevens in Magento op te slaan.

In deze modus doet de module het volgende:

• leest de CSV,
• valideert koppen,
• valideert store view,
• controleert of categorieën of oudercategorieën bestaan,
• controleert attributen,
• mapped waarden voor select en multiselect,
• controleert afbeeldingen,
• genereert een rapport met fouten en waarschuwingen,
• slaat geen categorieën op.

Dit is de aanbevolen eerste stap vóór elke grotere import.

De import werkt in batches. De batchgrootte kan in het importformulier worden geconfigureerd.

Standaardwaarde:

100 wierszy

Batch processing beperkt het risico op time-outs en overmatig geheugengebruik bij grotere bestanden.

De module ondersteunt drie varianten voor gedrag bij fouten:

• skip_invalid_rows - foutieve rijen worden overgeslagen, correcte rijen worden verder geïmporteerd.
• stop_on_first_error - de import stopt na de eerste fout.
• all_or_nothing - als validatie van een rij vóór het opslaan een fout detecteert, begint de import niet met opslaan.

Voor grote imports wordt skip_invalid_rows aanbevolen, omdat hiermee correcte gegevens kunnen worden verwerkt en een probleemrapport voor de overige rijen kan worden ontvangen.

Na import genereert de module een CSV-rapport met:

• rijnummer,
• categorie-ID,
• status,
• bericht,
• lijst met gewijzigde attributen.

De importgeschiedenis is beschikbaar in het beheerpaneel. De beheerder kan controleren:

• importdatum,
• admin-gebruiker,
• store view,
• importmodus,
• bestandsnaam,
• aantal rijen,
• aantal successen,
• aantal fouten,
• informatie of de import als dry-run is uitgevoerd,
• het importrapport downloaden.

De module gebruikt Magento ACL en voegt afzonderlijke rechten toe voor export, import en importgeschiedenis.

Import is beveiligd door:

• validatie van koppen,
• validatie van attribuutcodes,
• validatie van store view,
• validatie van vereiste kolommen,
• validatie van waardetypen,
• validatie van optielabels,
• validatie van afbeeldingsbestanden,
• foutrapportage per rij.

De module verwijdert geen categorieën en importeert geen producten die aan categorieën zijn toegewezen.

U exporteert categorieën uit de basis-store view, vult vertalingen aan in CSV, wijzigt store_view_code naar de code van de doel-store view en importeert de gegevens in de modus update.

U exporteert de attributen meta_title, meta_description, url_key, bewerkt ze in CSV en importeert alleen de geselecteerde kolommen.

U bereidt een CSV-bestand voor met category_path, parent_path, name en andere vereiste attributen en importeert dit vervolgens in de modus insert.

Als de winkel eigen categorie-attributen heeft, haalt de module deze dynamisch op uit EAV en kunt u ze selecteren bij export en import.

Na installatie is de module beschikbaar in:

System > Data Transfer > Export/Import Categories

Beschikbare weergaven:

• Export Categories,
• Import Categories,
• Import History.

System → Data Transfer → Export/Import Categories biedt export, import en geschiedenis. De in het formulier gekozen store view bepaalt de opslagcontext; store_view_code in het bestand dient om de overeenstemming te controleren.

Controleer bij het overzetten van gegevens tussen instanties de ouder-ID’s en categoriepaden. Alleen het exporteren van attributen zet geen producten of hun categorietoewijzingen over.

De modus all_or_nothing valideert alle rijen voordat het opslaan begint. Een fout in deze validatie stopt de import.

Het huidige proces slaat categorieën vervolgens één voor één op en omvat niet het hele bestand in één transactie. Een opslagfout betekent niet automatisch dat eerder opgeslagen categorieën worden teruggedraaid; analyseer het rapport en bewaar een export vóór wijzigingen.

Pakket kowal/module-export-import-categories, module Kowal_ExportImportCategories. Configureer toegang tot de Kowal-repository, installeer het pakket, schakel de module in, werk Magento bij en leeg de cache. Houd in productie rekening met compilatie en deployment van statische content volgens het proces van de winkel.

1. U exporteert de geselecteerde gegevens
U kiest de store view, het categoriebereik en de attributen.

2. U bereidt de CSV voor en controleert deze
U bewerkt waarden en voert validatie uit zonder op te slaan.

3. U importeert met controle over het resultaat
U kiest opslagbeleid en analyseert het rijrapport.

U exporteert namen, beschrijvingen en metadata. U behoudt categorie-ID’s, wijzigt de view-code in CSV en bereidt vertalingen voor.

Na dry-run importeert u geselecteerde kolommen in de update-modus naar de doel-store view. Lege cellen worden geïnterpreteerd volgens het gekozen importbeleid.