README

生成XML (RSS 2.0, ATOM 1.0) 格式Pinterest目录的非官方PHP库

这可以用于生成Pinterest每天产品导入的数据源。您必须已经有一个商业账户和符合他们商家指南的已声明网站。

您可以使用此库将产品数据转换为XML，但您需要自行提供输出服务。

安装

通过Composer将库添加到您的项目中

composer require softwarepunt/pinterest-xml-catalog

要求

• PHP 7.4+
• ext-dom

用法

创建XML目录

收集您的产品数据，然后将其输入到XmlCatalog实例。

<?php

use SoftwarePunt\PinterestXmlCatalog\XmlCatalog;
use SoftwarePunt\PinterestXmlCatalog\Models\ProductData;

// Create a new, blank catalog
$xmlCatalog = new XmlCatalog();

// Gather product data
$product = new ProductData();
$product->id = "4000086";
$product->title = "Illuminating Makeup Mirror";
$product->description = "A ring light mirror with 23 LED strip lights.";
$product->link = "https://www.example.com/cat/illuminating-makeup-mirror";
$product->imageLink = "https://www.example.com/media/catalog/product/image.jpg";
$product->additionalImageLink = "https://www.example.com/media/catalog/product/image_side.jpg";
$product->price = "14,99 EUR";

// Add products to catalog (can be ProductData, other object, or data array)
$xmlCatalog->addProduct($product);

// Convert to XML and serve as response
echo $xmlCatalog->toXmlString();

产品数据

Pinterest使用Google Merchant Data RSS 2.0的规范，您可以参考该规范以了解使用的特定字段。

👉此库目前仅针对Pinterest样本或文档中存在的字段，而不是Google支持的完整字段集。

建议使用ProductData类，因为它包含相关的phpdocs，可以简化您的工作。如果您更喜欢，也可以将关联数组或对象传递给每个产品的addProduct()。

如果您正在从自己的对象或数组添加产品，请确保属性名/数组键可以被库理解。例如，如果您想设置Google Product Category，设置它的有效键是googleProductCategory、g:google_product_category和google_product_category。

必需字段

填充产品时，以下字段始终是必需的

可选字段

这些字段是可选的，可用于向产品添加更多信息。