CSV import and export

Erweiterung des CSV-Importers/-Exporters von WooCommerce um Spalten für rechtliche Daten, GPSR, Umweltaussagen und andere nach polnischem und EU-Recht erforderliche Felder.

Unterstützte CSV-Felder

CSV-Spalte	Meta key	Typ	Beschreibung
polski_unit_price_base	_polski_unit_price_base	float	Basispreis pro Einheit
polski_unit_price_unit	_polski_unit_price_unit	string	Einheitspreiseinheit
polski_unit_price_amount	_polski_unit_price_product_amount	float	Produktmenge
polski_delivery_time	_polski_delivery_time_id	int	Lieferzeit-ID
polski_gpsr_responsible	_polski_gpsr_responsible	string	Verantwortliche Person (GPSR)
polski_power_supply	_polski_power_supply	string	Stromversorgung
polski_defect_description	_polski_defect_description	string	Fehlerbeschreibung
polski_withdrawal_exempt	_polski_withdrawal_exempt	bool	Befreiung vom Widerrufsrecht
polski_ingredients	_polski_ingredients	string	Zutaten
polski_nutrients	_polski_nutrients	string	Nährwerte
polski_nutrient_reference_unit	_polski_nutrient_reference_unit	string	Nährwert-Bezugsmenge
polski_nutri_score	_polski_nutri_score	string	Nutri-Score
polski_alcohol_content	_polski_alcohol_content	float	Alkoholgehalt
polski_place_of_origin	_polski_place_of_origin	string	Herkunftsland
polski_net_filling	_polski_net_filling_quantity	string	Nettoinhalt
polski_gpsr_manufacturer_name	_polski_gpsr_manufacturer_name	string	GPSR - Herstellername
polski_gpsr_manufacturer_address	_polski_gpsr_manufacturer_address	string	GPSR - Herstelleradresse
polski_gpsr_manufacturer_contact	_polski_gpsr_manufacturer_contact	string	GPSR - Manufacturer contact
polski_gpsr_importer_name	_polski_gpsr_importer_name	string	GPSR - Name des Importeurs
polski_gpsr_importer_address	_polski_gpsr_importer_address	string	GPSR - Adresse des Importeurs
polski_gpsr_importer_contact	_polski_gpsr_importer_contact	string	GPSR - Importer contact
polski_gpsr_responsible_person	_polski_gpsr_responsible_person	string	GPSR - Verantwortliche Person
polski_gpsr_responsible_address	_polski_gpsr_responsible_address	string	GPSR - Responsible person address
polski_gpsr_responsible_contact	_polski_gpsr_responsible_contact	string	GPSR - Responsible person contact
polski_gpsr_product_identifier	_polski_gpsr_product_identifier	string	GPSR - Produktkennung
polski_gpsr_safety_warnings	_polski_gpsr_safety_warnings	string	GPSR - Sicherheitswarnungen
polski_gpsr_instructions	_polski_gpsr_instructions	string	GPSR - Sicherheitshinweise
polski_durability_guarantee_months	_polski_durability_guarantee_months	int	Haltbarkeitsgarantie (Monate)
polski_update_period_months	_polski_update_period_months	int	Kostenlose Software-Updates (Monate)
polski_repair_info	_polski_repair_info	string	Reparaturinformationen
polski_gtin	_polski_gtin	string	GTIN / EAN (fallback)
polski_green_claim_basis	_polski_green_claim_basis	string	Grundlage für Umweltansprüche
polski_green_claim_cert_url	_polski_green_claim_cert_url	string	Link zum Umweltzertifikat
polski_green_claim_expiry	_polski_green_claim_expiry	string	Ablauf des Umweltzertifikats

Beispiel-CSV-Datei

ID,SKU,Name,polski_gpsr_manufacturer_name,polski_gpsr_manufacturer_address,polski_gpsr_manufacturer_contact,polski_gtin,polski_place_of_origin,polski_unit_price_base,polski_unit_price_unit,polski_delivery_time
123,SKU-001,"Cotton T-shirt","Producer XYZ Sp. z o.o.","ul. Fabryczna 1, 00-001 Warsaw","[email protected]","5901234123457","PL",1,"szt",12
456,SKU-002,"Rapeseed oil 1L","Olejarnia ABC","ul. Polna 5, 60-001 Poznan","[email protected]","5901234567890","PL",1,"l",8

CSV-Import

Über das Admin-Panel

1. Gehen Sie zu WooCommerce > Produkte > Import
2. Wählen Sie die CSV-Datei aus
3. In der Phase der Spaltenzuordnung erscheinen die Spalten von Polski for WooCommerce automatisch im Abschnitt Polski for WooCommerce
4. Ordnen Sie die CSV-Spalten den entsprechenden Feldern zu
5. Starten Sie den Import

Über WP-CLI

wp wc product_csv_importer run /path/to/file.csv --user=admin

Programmatisch

// Das Plugin bringt keinen eigenen Import-Filter mit. Die Spalten schreibt
// der Hook von WooCommerce, es gewinnt also, was danach läuft.
add_filter('woocommerce_product_import_inserted_product_object', function ($product, $data) {
    if (! empty($data['polski_gtin']) && strlen((string) $data['polski_gtin']) !== 13) {
        $product->update_meta_data('_polski_gtin', '');
    }
    return $product;
}, 20, 2);

CSV-Export

Über das Admin-Panel

1. Gehen Sie zu WooCommerce > Produkte > Export
2. Aktivieren Sie im Abschnitt Zu exportierende Spalten die Spalten aus der Gruppe Polski for WooCommerce
3. Filtern Sie optional nach Kategorie, Status oder Produkttyp
4. Klicken Sie auf CSV generieren

Über WP-CLI

wp wc product_csv_exporter run --filename=products-polski.csv --user=admin

Filtern der Exportspalten

// Die Spalten registrieren die Export-Hooks von WooCommerce selbst, eigene
// fügen Sie also genauso hinzu wie das Plugin es tut.
add_filter('woocommerce_product_export_column_names', function (array $columns): array {
    $columns['custom_field'] = 'Eigenes Feld';
    return $columns;
});

add_filter('woocommerce_product_export_product_column_custom_field', function ($value, $product) {
    return $product->get_meta('_my_custom_field');
}, 10, 2);

Was der Importer prüft

Sehr wenig, und das mit Absicht. Jede zugeordnete Spalte läuft durch sanitize_text_field() von WordPress und wird unverändert am Produkt gespeichert. Die einzige Ausnahme ist die Nährwertspalte, die aus ihrer Liste name=wert zurück in die vom Plugin gespeicherte Struktur gelesen wird.

Nichts prüft die GTIN-Prüfziffer, eine E-Mail-Adresse, einen Ländercode, einen Allergennamen oder einen Nutri-Score-Buchstaben, und es entsteht kein eigenes Importprotokoll. Ein falscher Wert wird als falscher Wert importiert. Prüfen Sie die Datei also vor dem Lauf, nicht danach.

Dieselben GPSR-Daten für viele Produkte

Es gibt keinen Bildschirm für Standardwerte, auf den Sie zurückgreifen könnten: die GPSR-Einstellungen umfassen den Anzeigemodus und den Abschnittstitel, mehr nicht. Um vielen Produkten denselben Hersteller zu geben, wiederholen Sie die Spalte in jeder Zeile der CSV, was eine Tabellenkalkulation mit einem Zug ausfüllt:

ID,polski_gpsr_manufacturer_name,polski_gpsr_manufacturer_address,polski_gpsr_manufacturer_contact
123,"Producer XYZ Sp. z o.o.","ul. Fabryczna 1, 00-001 Warschau","[email protected]"
124,"Producer XYZ Sp. z o.o.","ul. Fabryczna 1, 00-001 Warschau","[email protected]"

Ein Import aktualisiert nur die Spalten, die in der Datei stehen. Eine CSV mit lediglich der ID und den GPSR-Spalten lässt alle übrigen Produktfelder unberührt.

Fehlerbehebung

Polski-Spalten erscheinen nicht in der Zuordnung - stellen Sie sicher, dass das Plugin Polski for WooCommerce aktiv ist. Die Spalten werden über den Hook woocommerce_csv_product_import_mapping_options registriert.

Der Import läuft in einen Timeout - erhöhen Sie die PHP-Einstellung max_execution_time oder verwenden Sie WP-CLI für den Import großer Dateien.

Sonderzeichen sind beschädigt - stellen Sie sicher, dass die CSV-Datei in UTF-8-Kodierung (ohne BOM) gespeichert ist.

Numerische Werte werden nicht importiert - der Dezimaltrennzeichen in der CSV-Datei sollte ein Punkt (.) sein, kein Komma.

Probleme melden: github.com/wppoland/polski/issues

Diese Seite dient ausschließlich zu Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.