donmbelembe/laravel-facebook-catalog

Laravel Facebook Catalog Package that exports formatted XML data feed

2.0.1 2023-04-12 01:34 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0
• spatie/array-to-xml: ^3.1
• spatie/laravel-package-tools: ^1.14.0

Requires (Dev)

• laravel/pint: ^1.0
• nunomaduro/collision: ^7.9
• nunomaduro/larastan: ^2.0.1
• orchestra/testbench: ^8.0
• pestphp/pest: ^2.0
• pestphp/pest-plugin-arch: ^2.0
• pestphp/pest-plugin-laravel: ^2.0
• phpstan/extension-installer: ^1.1
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-phpunit: ^1.0
• spatie/laravel-ray: ^1.26
• spatie/pest-plugin-snapshots: ^2.0

MIT

• don mbelembe

• laravel
• facebook-catalog

README

Laravel Facebook Catalog Package that exports formatted XML data feed.

Installation

You can install the package via composer:

composer require donmbelembe/laravel-facebook-catalog

Usage

use Donmbelembe\LaravelFacebookCatalog\LaravelFacebookCatalog;

LaravelFacebookCatalog::setTitle('Example feed');
LaravelFacebookCatalog::setDescription('Example feed of the Example shop');
LaravelFacebookCatalog::setLink('https://example.shop');

LaravelFacebookCatalog::addItem([
    'link' => 'https://example.shop/p/foo-bar',
    'id' => 'SKU123',
    'title' => 'Foo bar',
    'image_link' => 'https://example.shop/images/foo-bar.png',
    'description' => 'Foo bar best product',
    'availability' => 'new',
    "price" => 99.99,
    'brand' => 'Foo brand',
    'condition' => 'new',
]);

return LaravelFacebookCatalog::display();

An example of the expected array

[
    "id" 	            		    => "", // Unique Example SKU
    "title" 	            		    => "", // Max 150 Characters
    "description"            	    => "",
    "availability"           	    => "in stock", // values: in stock, available for order, out of stock
    "condition" 	            	    => "new", // values: new, refurbished, used
    "price" 		            	    => 0.00,
    "link"		                    => "",
    "image_link"		                => "",
    "brand" 		            	    => "",
    // required fileds for payments in USA only and optional everywhere else
    "quantity_to_sell_on_facebook"   => 10, // previously name "inventory"
    "google_product_category"        => "",
    "fb_product_category"            => null,
    "size"                           => null,
    // required in india and optional everywhere else
    "origin_country"                 => null, // Ex: US
    "importer_name"                  => null, // if the origin country is not INDIA
    "importer_address"               => null,
    "manufacturer_info"              => null,
    "wa_compliance_category"         => null,
    // Optional fields
    "sale_price"                     => null,
    "sale_price_effective_date"      => null,
    "item_group_id"                  => null,
    "status"                         => null, // Values: active, archived (or staging)
    "additional_image_link"          => null,
    "gender"                         => null,
    "color"                          => null,
    "age_group"                      => null, // Values: adult, all ages, teen, kids, todler, infant, newborn.
    "material" 	                    => null,
    "patern"	                        => null,
    "shipping"                       => null,
    "shipping_weight"                => null,
]

For more details => https://web.facebook.com/business/help/120325381656392?id=725943027795860

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• don mbelembe
• All Contributors

License

The MIT License (MIT). Please see License File for more information.