README

Tento balíček umožňuje generovat XML feedy pro různé služby (Google, Heureka, Zbozi, Facebook) s podporou validace a dynamického nastavení parametrů.

Instalace

composer require codefit/ecommerce-xml

Použití

Google Feed

use Feeds\XmlGenerator\Feed\Google;
use Feeds\XmlGenerator\Entities\GoogleItem;
use Feeds\XmlGenerator\Exceptions\ValidationException;

try {
    $feed = new Google([
        'namespace' => 'http://www.w3.org/2005/Atom',
        'root_element' => 'feed'
    ]);

    // Nastavení autora, linku a title
    $feed->setAuthor('Codefit Webdesign');
    $feed->setLink('https://www.codefit.cz/');
    $feed->setTitle('Produkty');

    // Vzorová data produktů
    $products = [
        [
            'id' => '12345',
            'title' => 'iPhone 13 Pro',
            'description' => 'Nejnovější iPhone s výkonným čipem A15 Bionic',
            'link' => 'https://example.com/iphone-13-pro',
            'image_link' => 'https://example.com/images/iphone-13-pro.jpg',
            'price' => 34990.00,
            'brand' => 'Apple',
            'gtin' => '1234567890123',
            'mpn' => 'IP13P256',
            'google_product_category' => 'Electronics > Phones & Accessories > Mobile Phones'
        ]
    ];

    // Přidání produktů do feedu
    foreach ($products as $productData) {
        $item = new GoogleItem();
        $item->setId($productData['id'])
            ->setTitle($productData['title'])
            ->setDescription($productData['description'])
            ->setLink($productData['link'])
            ->setImageLink($productData['image_link'])
            ->setPriceVat($productData['price'])
            ->setBrand($productData['brand'])
            ->setGtin($productData['gtin'])
            ->setMpn($productData['mpn'])
            ->setGoogleProductCategory($productData['google_product_category']);

        $feed->addItem($item);
        $feed->addAvailability('in stock');
        $feed->addCondition('new');
        $feed->addShipping('CZ', 'Standard', 99.00);
        $feed->addShipping('CZ', 'Express', 149.00);
        $feed->addTax('CZ', '21', true);
    }

    // Generování a uložení feedu
    $feed->save('google.xml');
} catch (ValidationException $e) {
    echo "Chyba při generování Google feedu: " . $e->getMessage() . "\n";
}

Heureka Feed

use Feeds\XmlGenerator\Feed\Heureka;
use Feeds\XmlGenerator\Entities\HeurekaItem;
use Feeds\XmlGenerator\Enums\HeurekaDeliveryMethod;
use Feeds\XmlGenerator\Exceptions\ValidationException;

try {
    $feed = new Heureka([
        'namespace' => 'http://www.heureka.cz/ns/offer/1.0',
        'root_element' => 'SHOP',
        'country' => 'cz'
    ]);

    // Vzorová data produktů
    $products = [
        [
            'itemId' => '12345',
            'productName' => 'iPhone 13 Pro',
            'product' => 'Apple iPhone 13 Pro 256GB',
            'description' => 'Nejnovější iPhone s výkonným čipem A15 Bionic',
            'categoryText' => 'Elektronika | Mobilní telefony | Apple',
            'ean' => '1234567890123',
            'productNo' => 'IP13P256',
            'manufacturer' => 'Apple',
            'url' => 'https://example.com/iphone-13-pro',
            'deliveryDate' => 0,
            'imgUrl' => 'https://example.com/images/iphone-13-pro.jpg',
            'priceVat' => 34990.00
        ]
    ];

    // Přidání produktů do feedu
    foreach ($products as $productData) {
        $item = new HeurekaItem();
        $item->setItemId($productData['itemId'])
            ->setProductName($productData['productName'])
            ->setProduct($productData['product'])
            ->setDescription($productData['description'])
            ->setCategoryText($productData['categoryText'])
            ->setEan($productData['ean'])
            ->setProductNo($productData['productNo'])
            ->setManufacturer($productData['manufacturer'])
            ->setUrl($productData['url'])
            ->setDeliveryDate($productData['deliveryDate'])
            ->setImgUrl($productData['imgUrl'])
            ->setPriceVat($productData['priceVat']);

        $feed->addItem($item);
        $feed->addParameter('barva', 'Grafit');
        $feed->addParameter('kapacita', '256 GB');
        $feed->addDelivery(HeurekaDeliveryMethod::DPD, 99.0);
        $feed->addDelivery(HeurekaDeliveryMethod::PPL, 89.0);
        $feed->addGift('Obal zdarma');
        $feed->addWarranty('Rozšířená záruka', 36);
    }

    // Generování a uložení feedu
    $feed->save('heureka.xml');
} catch (ValidationException $e) {
    echo "Chyba při generování Heureka feedu: " . $e->getMessage() . "\n";
}

Zbozi Feed

use Feeds\XmlGenerator\Feed\Zbozi;
use Feeds\XmlGenerator\Entities\ZboziItem;
use Feeds\XmlGenerator\Enums\ZboziDeliveryMethod;
use Feeds\XmlGenerator\Exceptions\ValidationException;

try {
    $feed = new Zbozi([
        'namespace' => 'http://www.zbozi.cz/ns/offer/1.0',
        'root_element' => 'SHOP'
    ]);

    // Vzorová data produktů
    $products = [
        [
            'itemId' => '12345',
            'productName' => 'iPhone 13 Pro',
            'product' => 'Apple iPhone 13 Pro 256GB',
            'description' => 'Nejnovější iPhone s výkonným čipem A15 Bionic',
            'categoryText' => 'Elektronika | Mobilní telefony | Apple',
            'ean' => '1234567890123',
            'productNo' => 'IP13P256',
            'manufacturer' => 'Apple',
            'url' => 'https://example.com/iphone-13-pro',
            'deliveryDate' => 0,
            'imgUrl' => 'https://example.com/images/iphone-13-pro.jpg',
            'priceVat' => 34990.0,
            'maxCpc' => 5.80,
            'maxCpcSearch' => 4.50
        ]
    ];

    // Přidání produktů do feedu
    foreach ($products as $productData) {
        $item = new ZboziItem();
        $item->setItemId($productData['itemId'])
            ->setProductName($productData['productName'])
            ->setProduct($productData['product'])
            ->setDescription($productData['description'])
            ->setCategoryText($productData['categoryText'])
            ->setEan($productData['ean'])
            ->setProductNo($productData['productNo'])
            ->setManufacturer($productData['manufacturer'])
            ->setUrl($productData['url'])
            ->setDeliveryDate($productData['deliveryDate'])
            ->setImgUrl($productData['imgUrl'])
            ->setPriceVat($productData['priceVat'])
            ->setMaxCpc($productData['maxCpc'])
            ->setMaxCpcSearch($productData['maxCpcSearch']);

        $feed->addItem($item);
        $feed->addParameter('barva', 'Grafit');
        $feed->addParameter('kapacita', '256 GB');
        $feed->addDelivery(ZboziDeliveryMethod::DPD, 99.0);
        $feed->addDelivery(ZboziDeliveryMethod::PPL, 89.0);
        $feed->addExtraMessage('free_gift', 'Obal zdarma');
        $feed->addExtraMessage('extended_warranty', 'Rozšířená záruka 3 roky');
    }

    // Generování a uložení feedu
    $feed->save('zbozi.xml');
} catch (ValidationException $e) {
    echo "Chyba při generování Zbozi feedu: " . $e->getMessage() . "\n";
}

Facebook Feed

use Feeds\XmlGenerator\Feed\Facebook;
use Feeds\XmlGenerator\Entities\FacebookItem;
use Feeds\XmlGenerator\Exceptions\ValidationException;

try {
    $feed = new Facebook();

    // Nastavení autora, linku a title
    $feed->setAuthor('Codefit Webdesign');
    $feed->setLink('https://www.codefit.cz/');
    $feed->setTitle('Produkty');

    // Vzorová data produktů
    $products = [
        [
            'id' => '12345',
            'title' => 'iPhone 13 Pro',
            'description' => 'Nejnovější iPhone s výkonným čipem A15 Bionic',
            'link' => 'https://example.com/iphone-13-pro',
            'image_link' => 'https://example.com/images/iphone-13-pro.jpg',
            'price' => 34990.00,
            'brand' => 'Apple',
            'availability' => 'in stock',
            'condition' => 'new'
        ],
        [
            'id' => '12346',
            'title' => 'Samsung Galaxy S21',
            'description' => 'Výkonný Android telefon s kvalitním fotoaparátem',
            'link' => 'https://example.com/samsung-galaxy-s21',
            'image_link' => 'https://example.com/images/samsung-galaxy-s21.jpg',
            'price' => 29990.00,
            'brand' => 'Samsung',
            'availability' => 'in stock',
            'condition' => 'new'
        ]
    ];

    // Přidání produktů do feedu
    foreach ($products as $productData) {
        $item = new FacebookItem();
        $item->setId($productData['id'])
            ->setTitle($productData['title'])
            ->setDescription($productData['description'])
            ->setLink($productData['link'])
            ->setImageLink($productData['image_link'])
            ->setPriceVat($productData['price'])
            ->setBrand($productData['brand'])
            ->setAvailability($productData['availability'])
            ->setCondition($productData['condition']);

        $feed->addItem($item);
    }

    // Generování a uložení feedu
    $feed->save('examples/xml/facebook.xml');
} catch (ValidationException $e) {
    echo "Chyba při generování Facebook feedu: " . $e->getMessage() . "\n";
}

Povinné atributy produktu

• id - Unikátní identifikátor produktu
• title - Název produktu
• description - Popis produktu
• link - URL produktu
• image_link - URL obrázku produktu
• price - Cena produktu s DPH
• brand - Značka produktu
• availability - Dostupnost produktu (in stock, out of stock, preorder)
• condition - Stav produktu (new, used, refurbished)

Entity

GoogleItem

HeurekaItem

ZboziItem

Enums

HeurekaDeliveryMethod

Hodnoty odpovídají DELIVERY_ID ve specifikaci Heureka XML feedu.

• Doručení na adresu: CESKA_POSTA, CESKA_POSTA_DOPORUCENA_ZASILKA, CSAD_LOGISTIK_OSTRAVA, DPD, DHL, DSV, FOFR, GEBRUDER_WEISS, GEIS, GLS, PPL, SEEGMULLER, TOPTRANS, UPS, FEDEX, RABEN_LOGISTICS, ZASILKOVNA_NA_ADRESU, ONE_COURIER, RHENUS_LOGISTICS, MESSENGER, BALIKOVNA_NA_ADRESU, QDL, DB_SCHENKER, EMONS
• Výdejní místa: ZASILKOVNA, DPD_PICKUP, BALIKOVNA_DEPOTAPI, ONE_POINT, PPL_PARCELSHOP, GLS_PARCELSHOP, ALZAPOINT, UPS_ACCESS_POINT
• Výdejní boxy: DPD_BOX, Z_BOX, ONE_BOX, PPL_PARCELBOX, BALIKOVNA_BOX, ALZABOX, GLS_PARCELBOX
• Ostatní: ONLINE, VLASTNI_PREPRAVA

ZboziDeliveryMethod

Hodnoty odpovídají DELIVERY (DELIVERY_ID) ve specifikaci Zboží.cz / Sklik.

• Výdejní místa: ALZABOX, CESKA_POSTA_BALIKOVNA, CESKA_POSTA_NA_POSTU, DPD_PICKUP, GLS_PARCELSHOP, PPL_PARCELSHOP, TOPTRANS_DEPO, ONE_POINT, ZASILKOVNA, VLASTNI_VYDEJNI_MISTA
• Dopravci: KURYR_123 (123_KURYR), CESKA_POSTA, BALIKOVNA_NA_ADRESU, DACHSER, DB_SCHENKER, DPD, DHL, DSV, EMONS, FOFR, GEBRUDER_WEISS, GEIS, GLS, HDS, HELICAR, IN_TIME_KURYR, ONE_COURIER, NAS_KURYR, MESSENGER, LAGERMAX, PPL, TNT, TOPTRANS, UPS, FEDEX, RABEN_LOGISTICS, RHENUS, ZASILKOVNA_NA_ADRESU, VLASTNI_PREPRAVA