Icecat XML verwerken deel 2, de array weergeven

Roy Duineveld — Tue, 22 Jan 2013 16:53:43 +0000

Hierbij het vervolg op mijn eerste bericht hoe een Icecat XML verwerkt kan worden. Het uitlezen is het “moeilijkste” stuk, het weergeven is gewoon een mooie layout maken en daar de uitgelezen waardes in zetten.

Foutafhandeling

Om te beginnen, eerst maar even kijken of er geen fouten zijn.

Product informatie

Zoals je hier al ziet wordt er elke keer gerefereerd naar $data, om dit niet steeds te hoeven doen is het meest makkelijke extract te gebruiken voor het weergeven van de product informatie. Wanneer er geen fouten zijn kunnen we verder:

SKU
EAN
URL

Zo kan ik nog wel even doorgaan, dit spreekt voor zich natuurlijk. Hierna komen we de product afbeeldingen tegen, dit is uiteraard door een simpele foreach te gebruiken, weer te geven. Nog wel een opmerking hierbij. Op het moment van schrijven geeft Icecat niet altijd alle formaten afbeeldingen mee aan producten. De thumbnail en de grote afbeeldingen worden altijd meegegeven, de kleine en middelmatige missen soms wel eens.

Product specificaties

Het gebruik van een “foreach” geldt ook voor de product specificaties maar laat ik daar wel een voorbeeldje voor maken gezien dit meestal het belangrijkste is:

Product Specifications
$s): ?>
	$f): ?>

Alles kan natuurlijk uitgebreid en veel mooier gemaakt worden. Zo ook mijn kleine demo voor bij dit artikel:

Klik hier voor een online demo

Als laatste nog even wat “sluikreclame” om een idee te geven wat er mogelijk is met de gegevens van Icecat. Bijvoorbeeld een computer en toebehoren webshop of website waar je ~~tablets kan vergelijken~~ (inmiddels offline maar de code staat op Github).

Het bericht Icecat XML verwerken deel 2, de array weergeven verscheen eerst op Roy Duineveld.

Icecat XML verwerken

Roy Duineveld — Sat, 19 Jan 2013 16:58:48 +0000

Icecat is een fantastisch systeem om gratis product informatie te verkrijgen (en betaald nog veel meer). Helaas zijn er maar weinig goede/betaalbare kant en klare oplossingen te vinden om de gegevens te integreren. De URL integratie is dan wel super makkelijk zelf te doen maar als het om XML gaat wordt het vaak een ander verhaal. Inmiddels heb ik meerdere Icecat integraties gedaan, dit was allemaal op maat en niet voor standaard e-commerce systemen als Magento, Prestashop, etc. Bij deze een stukje code om een XML “datasheet” uit te lezen. De gewenste waardes opgeven en je krijgt een array terug met alle informatie. Dit kan uitgebreid worden om de gegevens op te slaan in een database natuurlijk. Vervolgens kunnen met die gegevens eventuele product vergelijkingen of filters gemaakt worden.

Icecat XML functie

 array('ignore_errors' => true))));
	if(!$xml){ $errors[2] = 'Unable to download the product feed! Maybe Icecat isn\'t reachable!'; goto the_end; }

	// Load into Simple XML Element
	$xml = new SimpleXMLElement($xml);

	// Set xpaths
	$product 			= $xml->xpath("/ICECAT-interface/Product");
	$product_attr 		= $product[0]->attributes();

		// Does Icecat give errors?
		if($product_attr['ErrorMessage']){ $errors[3] = (string)$product_attr['ErrorMessage']; goto the_end; }

	$category 			= $xml->xpath("/ICECAT-interface/Product/Category");

	$description 		= $xml->xpath("/ICECAT-interface/Product/ProductDescription");
	$description_attr 	= $description[0]->attributes();

	$supplier			= $xml->xpath("/ICECAT-interface/Product/Supplier");
	$supplier_attr		= $supplier[0]->attributes();

	$images 			= $xml->xpath("/ICECAT-interface/Product/ProductGallery");

	$eans				= $xml->xpath("/ICECAT-interface/Product/EANCode");

	$featurelogo		= $xml->xpath("/ICECAT-interface/Product/FeatureLogo");

	$spec_group			= $xml->xpath("/ICECAT-interface/Product/CategoryFeatureGroup");
	$spec_item			= $xml->xpath("/ICECAT-interface/Product/ProductFeature");

	$related 			= $xml->xpath("/ICECAT-interface/Product/ProductRelated");

	// Set product information
	$p['id'] 			= (int)$product_attr['ID'];
	$p['name']			= (string)$product_attr['Name'];
	$p['title']			= (string)$product_attr['Title'];
	$p['sku']			= (string)$product_attr['Prod_id'];
	$p['release']		= (string)$product_attr['ReleaseDate'];
	$p['img_thumb']		= (string)$product_attr['ThumbPic'];
	$p['img_small']		= (string)$product_attr['LowPic'];
	$p['img_mid']		= (string)$product_attr['Pic500x500'];
	$p['img_high']		= (string)$product_attr['HighPic'];
	$p['pdf_spec']		= (string)$description_attr['PDFURL'];
	$p['pdf_manual']	= (string)$description_attr['ManualPDFURL'];
	$p['descr_long']	= str_replace('\n','
',(string)$description_attr['LongDesc']);
	$p['descr_short']	= (string)$description_attr['ShortDesc'];
	$p['url']			= (string)$description_attr['URL'];
	$p['warrenty']		= (string)$description_attr['WarrantyInfo'];
	$p['category'] 		= (string)$category[0]->Name[0]['Value'];
	$p['category_id']	= (int)$category[0]['ID'];

	// Set brand
	$p['brand_id'] 		= (int)$supplier_attr['ID'];
	$p['brand_name']	= (string)$supplier_attr['Name'];

	// Set images
	foreach($images[0] as $image)
	{
		$image_attr	= $image->attributes();
		$p['image'][(int)$image_attr['ProductPicture_ID']]['thumb']	= (string)$image_attr['ThumbPic'];
		$p['image'][(int)$image_attr['ProductPicture_ID']]['small']	= (string)$image_attr['LowPic'];
		$p['image'][(int)$image_attr['ProductPicture_ID']]['mid']	= (string)$image_attr['Pic500x500'];
		$p['image'][(int)$image_attr['ProductPicture_ID']]['high']	= (string)$image_attr['Pic'];
	}

	// Set EAN numbers
	foreach($eans as $ean)
	{
		$p['ean'][] = (string)$ean[0]['EAN'];
	}

	// Set featurelogos
	foreach($featurelogo as $logo)
	{
		$logo_attr = $logo->attributes();
		$p['featurelogo'][(int)$logo_attr['Feature_ID']]['image'] = (string)$logo_attr['LogoPic'];
		$p['featurelogo'][(int)$logo_attr['Feature_ID']]['descr'] = trim((string)$logo->Descriptions->Description);
	}

	// Set specification groups
	foreach($spec_group as $group)
	{
		$p['spec'][(int)$group[0]['ID']]['name'] = (string)$group->FeatureGroup->Name[0]['Value'];
	}

	// Set specifications
	foreach($spec_item as $item)
	{
		if($item[0]['Value'] != 'Icecat.biz')
		{
			$p['spec'][(int)$item[0]['CategoryFeatureGroup_ID']]['features'][(int)$item->Feature->Name[0]['ID']]['name'] = (string)$item->Feature->Name[0]['Value'];
			$p['spec'][(int)$item[0]['CategoryFeatureGroup_ID']]['features'][(int)$item->Feature->Name[0]['ID']]['value'] = (string)$item[0]['Value'];
			$p['spec'][(int)$item[0]['CategoryFeatureGroup_ID']]['features'][(int)$item->Feature->Name[0]['ID']]['sign'] = (string)$item->Feature->Measure->Signs->Sign;
			$p['spec'][(int)$item[0]['CategoryFeatureGroup_ID']]['features'][(int)$item->Feature->Name[0]['ID']]['pres_value'] = (string)$item[0]['Presentation_Value'];
		}
	}

	// Remove empty specification groups
	foreach($p['spec'] as $key=>$value)
	{
		if(!isset($value['features'])){
			unset($p['spec'][$key]);
		}
	}

	// Related products
	foreach($related as $test)
	{
		$p['related'][(int)$test->Product[0]['ID']]['name'] 	= (string)$test->Product[0]['Name'];
		$p['related'][(int)$test->Product[0]['ID']]['category'] = (int)$test[0]['Category_ID'];
		$p['related'][(int)$test->Product[0]['ID']]['sku'] 		= (string)$test->Product[0]['Prod_id'];
		$p['related'][(int)$test->Product[0]['ID']]['img'] 		= (string)$test->Product[0]['ThumbPic'];
		$p['related'][(int)$test->Product[0]['ID']]['brand']	= (string)$test->Product->Supplier[0]['Name'];
		$p['related'][(int)$test->Product[0]['ID']]['brand_id']	= (string)$test->Product->Supplier[0]['ID'];
	}

	the_end:

	// Return errors if set, else product information
	if(isset($errors)){
		return $errors;
	} else {
		return $p;
	}
}
?>

Gebruik

Zoals in de code staat aangegeven zijn er meerdere waardes welke ingevuld kunnen worden. Taal, gebruikersnaam en wachtwoord zijn verplicht op te geven. Daarnaast zijn er nog 4 verschillende manieren om product informatie op te vragen. Via een EAN, SKU of Icecat nummer (waarbij onderscheid wordt gemaakt tussen Open-Icecat en Full-Icecat). Daarbij een aantal voorbeelden:

Via een EAN nummer

 '4026203907966',
	'language'	=> 'NL',
	'username'	=> 'openIcecat-xml',
	'password'	=> 'freeaccess'
);
$data = icecat_to_array($data);
echo ''.print_r($data,TRUE).'';
?>

Via een SKU nummer

 'PDA01E-00101KDU',
	'brand'		=> 'Toshiba',
	'language'	=> 'NL',
	'username'	=> 'openIcecat-xml',
	'password'	=> 'freeaccess'
);
$data = icecat_to_array($data);
echo ''.print_r($data,TRUE).'';
?>

Via een Icecat nummer (Open-Icecat)

 '10433706',
	'language'	=> 'NL',
	'username'	=> 'openIcecat-xml',
	'password'	=> 'freeaccess'
);
$data = icecat_to_array($data);
echo ''.print_r($data,TRUE).'';
?>

Via een Icecat nummer (Full-Icecat)

 '10433706',
	'language'	=> 'NL',
	'username'	=> 'openIcecat-xml',
	'password'	=> 'freeaccess'
);
$data = icecat_to_array($data);
echo ''.print_r($data,TRUE).'';
?>

Foutmeldingen

Deze functie geeft wanneer er fouten zijn, deze terug in een array. Daarbij zijn er drie verschillende “keys”:

1 = Er is iets niet opgegeven
2 = XML kan niet gedownload worden (Waarschijnlijk is Icecat in dat geval niet bereikbaar)
3 = Door Icecat opgegeven foutmeldingen

Resultaat

Wat doet het nu eigenlijk? Het haalt de gegevens op van een product zoals hier te vinden: http://icecat.nl/p/toshiba/pda01e-00101kdu/tablets-4026203907966-at100-100-10433706.html. Die gegevens staan in een XML welke hier te vinden is: http://openIcecat-xml:freeaccess@data.icecat.biz/export/freexml.int/NL/10433706.xml en welke vervolgens omgezet wordt naar een array met als resultaat:

Dit resultaat kan je vervolgens verwerken in je website door deze gegevens op te slaan in een database of gewoon direct weer te geven.

Array verwerken

Er komt in de toekomst nog een artikel hoe deze array verwerkt kan worden! ~Update: Deel 2, de array weergeven

Het bericht Icecat XML verwerken verscheen eerst op Roy Duineveld.

Icecat – Roy Duineveld