SRP-Info

SpreadshirtRandomProduct

Was ist SRP - SpreadshirtRandomProduct?

SpreadshirtRandomProduct (oder kurz “SRP”) ist ein kleines PHP-Script, welches ich in meiner Freizeit entwickelt habe. Es liest die Daten aus dem Spreadshirt-Shop-RSS aus und gibt daraus ein zufälliges Produkt aus. Das Script ist weitestgehend konfigurierbar, sodass man eigentlich alles einstellen kann.

UPDATE! Spreadshirt hat einige Dinge am RSS-Feed geändert. Deswegen ist jetzt die neue Version 0.5 von Nöten, damit alles wieder korrekt dargestellt wird.

SRP Versions-Info und Changelog

  • Version 0.1 (25.3.2006)
  • Version 0.1b (26.3.2006)
    • Some little bug fixes, new parameter html_linebreaks
  • Version 0.2 (15.4.2006)
    • New external config file
    • New parameter: newest product
    • New parameter: configurable error message
    • New parameter: possibility to show multiple products
    • multiple configurations possible
  • Version 0.3 (6.5.2006)
    • New parameter: currency
    • New parameter: shop from Europe or USA
    • New parameter: image size
    • New parameter: show front or back of product
    • New functions: get information of title, image, price etc.
  • Version 0.3b (17.5.2006)
    • bug fixed in function configchange
    • bug fixed: if libiconv is not installed, the script now stops (and doesn’t crash with a error)
  • Version 0.3c (21.10.2006)
    • bug fixed: no more warnings about undefined constants in the error log
  • Version 0.4 (22.10.2007)
    • bug fixed: now works with the new spreadshirt RSS feed
    • bug fixed: some little bugs inside
    • removed: removed some old functions (and related parameters)
  • Version 0.4b (27.10.2007)
    • new: with rss cache
  • Version 0.4c (9.11.2007)
    • bug fixed: now works with the new RSS feed url
    • removed: some old parameters
  • Version 0.5 (18.3.2008)
    • bug fixed: now works with new rss feed, which has additional product information from spreadshirt
  • ToDo: Umbau von SRP auf die Spreadshirt-SOAP-Schnittstelle anstatt des RSS-Feeds..

SRP Download

SRP gibts hier zum Download als ZIP-File: SRP Version 0.5 (ca. 7kB)

Folgende Dateien sind im ZIP-File enthalten:

  • srp.inc.php: das Haupt-Script
  • srp_config.inc.php: die Konfigurations-Datei
  • lastRSS.php: RSS-Reader, der von SRP benutzt wird (Autor: Vojtech Semecky)
  • index.php: Demo-HTML-Datei

Und so funktionierts

Einfach die im ZIP-File enthaltenen Dateien auf deinen Server kopieren (PHP benötigt!). Dann kann man SRP wie folgt einbinden:

include ("srp.inc.php");

Dann kann man ein neues SRP-Objekt erzeugen:

$product = new SpreadshirtRandomProduct($config);

Dann kann man mit verschiedenen Funktionen auf die Informationen zugreifen:

print ($product->getTitle());
print ($product->getImage());

“$config” ist dabei der Name des Konfigurations-Arrays aus der Konfigurations-Datei. Hier können auch mehrere Arrays mit unterschiedlichen Namen angelegt werden. Somit kann man mehrere SRP-Objekte mit mehreren Konfigurationen erzeugen:

// Zeigt Produkt entsprechend der Konfiguration "config" an
$product = new SpreadshirtRandomProduct($config);
// Zeigt Produkt entsprechend der Konfiguration "differentconfig" an
$product->new SpreadshirtRandomProduct($differentconfig);

Funktions-Übersicht

getTitle() Liefert den Titel des aktuellen Produkts
getDescription() Liefert die Beschreibung des aktuellen Produkts
getImage() Liefert den Image-HTML-Tag des aktuellen Produkts
getPrice() Liefert den Preis des aktuellen Produkts
getLink() Liefert den Link auf das aktuelle Produkt
isAdditionalProduct() Liefert true, wenn Item eine Zusatzprodukt-Info von Spreadshirt und kein “normales” Produkt ist
setItem() Wählt ein neues Zufallsprodukt
getErrorState() liefert true, wenn ein Fehler aufgetreten ist, ansonsten false
getErrorLog() Liefert die Fehlermeldungen, wenn Fehler aufgetreten sind, sonst den leeren String

 

SRP-Parameter

Im Folgenden eine Übersicht über alle Konfigurations-Parameter:

$config[”shop_id”] die ID des Shops, dessen RSS-Feed gelesen werden soll
$config[”language”] NEU: Gibt die Shop- und RSS-Sprache an (de, en, us, fr, pl, …)
$config[”region”] NEU: Gibt die Region an, aus der man kommt. Häufig identisch mit der Sprache…
$config[”charset”] Gibt den Zeichnsatz an, in dem der RSS-Feed ausgeliefert wird (iso-8859-1 für West-Europa, iso-8859-2 z.B. für Polen)
$config[”img_size”] Gibt die Größe des Bildes an (small = 42px, medium = 130px, big = 192px)
$config[”img_side”] Gibt an, ob die Vorderseite oder die Rückseite des Produkts gezeigt wird (1 = Vorderseite, 2 = Rückseite)
$config[”show_additional_products”] Gibt an, ob zusätzliche Produktinfo-Items von Spreadshirt angezeigt werden sollen ode rnicht (true = anzeigen, false = nicht anzeigen)
$config[”show_random”] Gibt an, ob ein Zufalls-Produkt oder das letzte Produkt angezeigt werden soll (true = Zufall, false = letztes)
$config[”error_nofeed”] Fehlermeldung, wenn Feed nicht gelesen werden konnte (inkl. HTML-Tags)
$config[”error_noproduct”] Fehlermeldung, wenn keine Produkte im Feed sind (inkl. HTML-Tags)
$config[”cache_dir”] NEU: Das Cache-Verzeichnis (chmod 777!). Wenn Inhalt der Variable leer, dann ist der Cache abgeschaltet
$config[”cache_time”] NEU: Die Cache-Zeit in Sekunden, am besten zwischen 3600 und 14400 (1-4 Stunden)

 

Autor und Rechtliches

Dieses kleine Script ist kein offizielles Spreadshirt-Angebot, sondern ein Freizeit-Projekt von mir, Marc Nilius. Ich gebe keine Garantie/Gewährleistung auf die korrekte Funktion des Scripts. Das Script wird im Rahmen der GPL bereitgestellt.

Anregungen und Wünsche zum Script bitte per E-Mail an mail@computerservicewissen.de. Weitere Informationen zu mir und meinem Unternehmen findet Ihr auf den anderen Seiten dieser Website. :-)