Zend_Service_SlideShare
Die Zend_Service_SlideShare wird verwendet um mit dem
» slideshare.net Web Service für das
Online-Hosten von Slideshows zu interagieren. Mit dieser Komponente kann eine Slideshow
die in dieser Website gehostet wird in einer Website eingebettet und sogar neue
Slideshows zum eigenen Account hochgeladen werden.
Mit Zend_Service_SlideShare beginnen
Um die Zend_Service_SlideShare Komponente zu verwenden muß zuerst
ein Account auf den slideshare.net Servern erstellt werden (mehr Informationen können
» hier gefunden werden) um
einen API Schlüssel, Benutzername, Passwort und einen geteilten
geheimen Wert zu erhalten -- diese werden alle benötigt um die
Zend_Service_SlideShare Komponente zu verwenden.
Sobald ein Account erstellt wurde, kann die
Zend_Service_SlideShare Komponente verwendet werden durch die
Erstellung eines Zend_Service_SlideShare Objektes und dem
anbieten dieser Werte wie anbei gezeigt:
// Erstellt eine neue Instanz der Komponente
'APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD');
Das SlideShow Objekt
Alle Slideshows in der Zend_Service_SlideShare werden
repräsentiert durch die Verwendung des
Zend_Service_SlideShare_SlideShow Objektes (sowohl beim Empfangen
als auch beim Hochladen neuer Slideshows). Zur Referenz ist eine Pseudo-Code Version
dieser Klasse anbei zu sehen.
span style="color: #808080; font-style: italic;">/**
* Empfängt den Ort der Slideshow
*//**
* Erhält das Transcript für die Slideshow
*//**
* Fügt ein Tag zu der Slideshow hinzu
*//**
* Setzt die Tags für die Slideshow
*//**
* Erhält alle Tags die mit der Slideshow assoziiert sind
*//**
* Setzt den Dateinamen im Lokalen Filesystem der Slideshow
* (für das Hochladen einer neuen Slideshow)
*//**
* Empfängt den Dateinamen auf dem lokalen Dateisystem der Slideshow
* die hochgeladen werden soll
*//**
* Empfängt die ID für die Slideshow
*//**
* Empfängt den eingebetteten HTML Code für die Slideshow
*//**
* Empfängt die Thumbnail URi für die Slideshow
*//**
* Setzt den Titel für die Slideshow
*//**
* Empfängt den Titel der Slideshow
*//**
* Setzt die Beschreibung für die Slideshow
*//**
* Empfängt die Beschreibung der Slideshow
*//**
* Erhält den nummerischen Status der Slideshow auf dem Server
*//**
* Erhält die textuelle Beschreibung des Status der Slideshow
* auf dem Server
*//**
* Erhält den permanenten Link der Slideshow
*//**
* Erhält die Anzahl der Aufrufe der Slideshow
*/
Note:
Die obige Pseudo-Klasse zeigt nur die Methoden welche von End-Benutzer
Entwicklern verwendet werden sollten. Andere vorhandene Methoden sind
intern für die Komponente.
Wenn die Zend_Service_SlideShare Komponente verwendet wird, wird
diese Daten Klasse sehr oft verwendet um nachzusehen oder neue Slideshows zu oder
von einem Webservice hinzuzufügen.
Empfangen einer einzelnen Slideshow
Die einfachste Verwendung der Zend_Service_SlideShare Komponente
ist der Empfang einer einzelnen Slideshow durch die Slideshow ID die von der
slideshare.net Anwendung angeboten wird und kann durch den Aufruf der
getSlideShow() auf einem
Zend_Service_SlideShare Objekt und der Verwendung des
resultierenden Zend_Service_SlideShare_SlideShow Objektes wie
gezeigt durchgeführt werden.
// Erstellt eine neue Instanz der Komponente
'APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD'"Slide Show Titel: {$slideshow->getTitle()}<br/>\n""Anzahl an Besuchen: {$slideshow->getNumViews()}<br/>\n";
Empfangen von Gruppen von Slideshows
Wenn die spezielle ID einer Slideshow die einen interessiert und die man empfangen will
nicht kennt, kann man auch Gruppen von Slideshows empfangen durch Verwendung einer der
drei Methoden:
-
Slideshows von einem speziellen Account
Slideshows können von einem speziellen Account empfangen werden durch
Verwendung der getSlideShowsByUsername() Methode und
der Angabe des Benutzernamens von dem die Slideshow empfangen werden soll
-
Slideshows mit einem speziellen Tag
Slideshows können empfangen werden wenn Sie ein oder mehrere spezielle Tags
enthalten durch die Verwendung der getSlideShowsByTag()
Methode und der Angabe von ein oder mehreren Tags welche der Slideshow
zugeordnet sein müssen um Sie zu empfangen
-
Slideshows durch Gruppen
Man kann Slideshows empfangen welche Mitglied einer speziellen Gruppe sind
durch Verwendung der getSlideShowsByGroup() Methode und
der Angabe des Namens der Gruppe welcher die Slideshow angehören muß um Sie zu
Empfangen
Jede der obigen Methoden des Empfangens mehrerer Slideshows zeigt das ein ähnlicher
Ansatz verwendet wird. Ein Beispiel der Verwendung jeder Methode wird anbei gezeigt:
// Erstellt eine neue Instanz der Komponente
'APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD'// Empfängt die ersten 10 jeden Typs
'username''zend''mygroup'// Durch die Slideshows iterieren
"Slide Show Titel: {$slideshow->getTitle}<br/>\n";
}
Zend_Service_SlideShare Caching Policy
Standardmäßig cached Zend_Service_SlideShare jede Anfrage an den
Webservice automatisch in das Dateisystem (Standardpfad /tmp) für
12 Stunden. Wenn man das Verhalten ändern will, muß eine eigenes Zend_Cache Objekt durch Verwendung der
setCacheObject() Methode angegeben werden wie anbei gezeigt:
span style="color: #ff0000;">'lifetime' => 7200,
'automatic_serialization''cache_dir' => '/webtmp/''Core',
'File''APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD''username'
Das Verhalten des HTTP Clients ändern
Wenn das Verhalten des HTTP Clients, aus welchen Gründen auch immer,
geändert werden soll wenn eine Anfrage an den Webservice durchgeführt wird, kann das
durch die Erstellung einer eigenen Instanz eines Zend_Http_Client
Objektes durchgeführt werden (siehe Zend_Http). Das ist
zum Beispiel nützlich wenn es gewünscht ist das Timeout für die Verbindung auf etwas
anderes als den Standardwert zu setzen wie anbei gezeigt:
span style="color: #ff0000;">'timeout''APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD''username'
|
|