Import a export CSV

Rozšírenie importéra/exportéra CSV WooCommerce o stĺpce právnych údajov, GPSR, environmentálnych tvrdení a ďalších polí vyžadovaných poľským a európskym právom.

Podporované polia CSV

Polia GPSR (General Product Safety Regulation)

Stĺpec CSV	Meta key	Typ	Popis
`gpsr_manufacturer_name`	`_polski_gpsr_manufacturer_name`	string	Názov výrobcu
`gpsr_manufacturer_address`	`_polski_gpsr_manufacturer_address`	string	Adresa výrobcu
`gpsr_manufacturer_email`	`_polski_gpsr_manufacturer_email`	string	E-mail výrobcu
`gpsr_manufacturer_phone`	`_polski_gpsr_manufacturer_phone`	string	Telefón výrobcu
`gpsr_manufacturer_url`	`_polski_gpsr_manufacturer_url`	string	Web výrobcu
`gpsr_authorized_rep_name`	`_polski_gpsr_auth_rep_name`	string	Názov splnomocneného zástupcu
`gpsr_authorized_rep_address`	`_polski_gpsr_auth_rep_address`	string	Adresa splnomocneného zástupcu
`gpsr_authorized_rep_email`	`_polski_gpsr_auth_rep_email`	string	E-mail splnomocneného zástupcu
`gpsr_safety_info`	`_polski_gpsr_safety_info`	string	Informácie o bezpečnosti
`gpsr_warnings`	`_polski_gpsr_warnings`	string	Upozornenia týkajúce sa produktu
`gpsr_barcode_type`	`_polski_gpsr_barcode_type`	string	Typ kódu: EAN, UPC, GTIN
`gpsr_barcode_value`	`_polski_gpsr_barcode_value`	string	Hodnota čiarového kódu
`gpsr_product_type`	`_polski_gpsr_product_type`	string	Typ produktu podľa GPSR
`gpsr_country_of_origin`	`_polski_gpsr_country_origin`	string	Krajina pôvodu (kód ISO)

Polia greenwashing (anti-greenwashing)

Stĺpec CSV	Meta key	Typ	Popis
`green_claim_text`	`_polski_green_claim`	string	Obsah environmentálneho tvrdenia
`green_claim_evidence`	`_polski_green_evidence`	string	Dôkazy / odôvodnenie
`green_certification_name`	`_polski_green_cert_name`	string	Názov certifikátu
`green_certification_number`	`_polski_green_cert_number`	string	Číslo certifikátu
`green_certification_url`	`_polski_green_cert_url`	string	Odkaz na certifikát
`green_carbon_footprint`	`_polski_green_carbon`	float	Uhlíková stopa (kg CO2)
`green_recyclable`	`_polski_green_recyclable`	bool	Či je produkt recyklovateľný
`green_durability_years`	`_polski_green_durability`	int	Trvanlivosť produktu v rokoch

Polia údajov produktov

Stĺpec CSV	Meta key	Typ	Popis
`unit_price`	`_polski_unit_price`	float	Jednotková cena
`unit_price_unit`	`_polski_unit_price_unit`	string	Jednotka: kg, l, m, ks
`unit_price_base`	`_polski_unit_price_base`	float	Prepočítavacia základňa
`delivery_time_min`	`_polski_delivery_min`	int	Min. čas doručenia (dni)
`delivery_time_max`	`_polski_delivery_max`	int	Max. čas doručenia (dni)
`manufacturer_name`	`_polski_manufacturer`	string	Názov výrobcu
`manufacturer_url`	`_polski_manufacturer_url`	string	URL výrobcu
`gtin`	`_polski_gtin`	string	Kód GTIN/EAN
`withdrawal_excluded`	`_polski_withdrawal_excluded`	bool	Vylúčený z práva na odstúpenie
`withdrawal_reason`	`_polski_withdrawal_reason`	string	Dôvod vylúčenia z odstúpenia

Polia potravinových produktov

Stĺpec CSV	Meta key	Typ	Popis
`energy_kcal`	`_polski_energy_kcal`	float	Energia (kcal/100g)
`energy_kj`	`_polski_energy_kj`	float	Energia (kJ/100g)
`fat`	`_polski_fat`	float	Tuk (g/100g)
`saturated_fat`	`_polski_saturated_fat`	float	Nasýtené mastné kyseliny
`carbohydrates`	`_polski_carbohydrates`	float	Sacharidy (g/100g)
`sugars`	`_polski_sugars`	float	Cukry (g/100g)
`protein`	`_polski_protein`	float	Bielkoviny (g/100g)
`salt`	`_polski_salt`	float	Soľ (g/100g)
`fiber`	`_polski_fiber`	float	Vláknina (g/100g)
`allergens`	`_polski_allergens`	string	Alergény (oddelené čiarkou)
`nutri_score`	`_polski_nutri_score`	string	Nutri-Score: A, B, C, D, E

Príklad súboru CSV

ID,SKU,Name,gpsr_manufacturer_name,gpsr_manufacturer_address,gpsr_manufacturer_email,gpsr_barcode_type,gpsr_barcode_value,gpsr_country_of_origin,unit_price,unit_price_unit,delivery_time_min,delivery_time_max,manufacturer_name
123,SKU-001,"Koszulka bawełniana","Producent XYZ Sp. z o.o.","ul. Fabryczna 1, 00-001 Warszawa","[email protected]","EAN","5901234123457","PL",49.99,"szt",2,5,"XYZ"
456,SKU-002,"Olej rzepakowy 1L","Olejarnia ABC","ul. Polna 5, 60-001 Poznań","[email protected]","EAN","5901234567890","PL",12.99,"l",1,3,"ABC"

Import CSV

Cez admin panel

Prejdite do WooCommerce > Produkty > Import
Vyberte súbor CSV
Vo fáze mapovania stĺpcov - stĺpce Polski for WooCommerce sa zobrazia automaticky v sekcii Polski for WooCommerce
Namapujte stĺpce CSV na príslušné polia
Spustite import

Cez WP-CLI

wp wc product_csv_importer run /sciezka/do/pliku.csv --user=admin

Programovo

// Hook do modyfikacji importowanych danych
add_filter('polski/csv/import_data', function (array $data, array $raw_row): array {
    // Walidacja kodu GTIN
    if (!empty($data['gpsr_barcode_value'])) {
        $gtin = $data['gpsr_barcode_value'];
        if (strlen($gtin) !== 13 && strlen($gtin) !== 8) {
            $data['gpsr_barcode_value'] = ''; // Odrzuć nieprawidłowy kod
        }
    }
    return $data;
}, 10, 2);

Export CSV

Cez admin panel

Prejdite do WooCommerce > Produkty > Export
V sekcii Stĺpce na export zaškrtnite stĺpce zo skupiny Polski for WooCommerce
Voliteľne filtrujte podľa kategórie, stavu alebo typu produktu
Kliknite na Generovať CSV

Cez WP-CLI

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

Filtrovanie stĺpcov exportu

// Dodanie własnych kolumn do eksportu
add_filter('polski/csv/export_columns', function (array $columns): array {
    $columns['custom_field'] = 'Własne pole';
    return $columns;
});

// Wartość własnej kolumny
add_filter('polski/csv/export_column_value', function ($value, string $column, WC_Product $product) {
    if ($column === 'custom_field') {
        return $product->get_meta('_my_custom_field');
    }
    return $value;
}, 10, 3);

Validácia importu

Import automaticky validuje údaje:

GTIN/EAN - kontrola kontrolnej číslice (algoritmus modulo 10)
E-mail - validácia formátu e-mailovej adresy
URL - validácia formátu URL
Krajina - kontrola kódu ISO 3166-1 alpha-2
Alergény - overenie, či hodnoty patria do definovaného zoznamu (14 alergénov EÚ)
Nutri-Score - kontrola, či je hodnota A, B, C, D alebo E

Nesprávne hodnoty sa preskakujú a logujú (neblokujú import). Log je dostupný vo výsledkoch importu.

Hromadný import údajov GPSR

Pre obchody s mnohými produktmi od toho istého výrobcu:

# Przygotuj CSV z minimalnymi danymi
# ID,gpsr_manufacturer_name,gpsr_manufacturer_address,gpsr_manufacturer_email

Nastavte predvolené hodnoty GPSR v WooCommerce > Polski > Právny súlad > GPSR > Predvolené hodnoty. Import doplní iba produkty s prázdnymi poliami GPSR.

Riešenie problémov

Stĺpce Polski sa nezobrazujú v mapovaní - uistite sa, že doplnok Polski for WooCommerce je aktívny. Stĺpce sa registrujú hookom woocommerce_csv_product_import_mapping_options.

Import končí timeoutom - zvýšte max_execution_time PHP alebo použite WP-CLI na import veľkých súborov.

Špeciálne znaky sú poškodené - uistite sa, že súbor CSV je uložený v kódovaní UTF-8 (bez BOM).

Číselné hodnoty sa neimportujú - desatinný oddeľovač v súbore CSV by mal byť bodka (.), nie čiarka.

Nahlasovanie problémov: github.com/wppoland/polski/issues

Táto stránka má výlučne informačný charakter a nepredstavuje právne poradenstvo. Pred nasadením sa poraďte s právnikom. Polski for WooCommerce je open source softvér (GPLv2) poskytovaný bez záruky.