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
$ss = new Zend_Service_SlideShare('APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD');

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.

class Zend_Service_SlideShare_SlideShow {

    /**
     * Empfängt den Ort der Slideshow
     */
    public function getLocation() {
        return $this->_location;
    }

    /**
     * Erhält das Transcript für die Slideshow
     */
    public function getTranscript() {
        return $this->_transcript;
    }

    /**
     * Fügt ein Tag zu der Slideshow hinzu
     */
    public function addTag($tag) {
        $this->_tags[] = (string)$tag;
        return $this;
    }

    /**
     * Setzt die Tags für die Slideshow
     */
    public function setTags(Array $tags) {
        $this->_tags = $tags;
        return $this;
    }

    /**
     * Erhält alle Tags die mit der Slideshow assoziiert sind
     */
    public function getTags() {
        return $this->_tags;
    }

    /**
     * Setzt den Dateinamen im Lokalen Filesystem der Slideshow
     * (für das Hochladen einer neuen Slideshow)
     */
    public function setFilename($file) {
        $this->_slideShowFilename = (string)$file;
        return $this;
    }

    /**
     * Empfängt den Dateinamen auf dem lokalen Dateisystem der Slideshow
     * die hochgeladen werden soll
     */
    public function getFilename() {
        return $this->_slideShowFilename;
    }

    /**
     * Empfängt die ID für die Slideshow
     */
    public function getId() {
        return $this->_slideShowId;
    }

    /**
     * Empfängt den eingebetteten HTML Code für die Slideshow
     */
    public function getEmbedCode() {
        return $this->_embedCode;
    }

    /**
     * Empfängt die Thumbnail URi für die Slideshow
     */
    public function getThumbnailUrl() {
        return $this->_thumbnailUrl;
    }

    /**
     * Setzt den Titel für die Slideshow
     */
    public function setTitle($title) {
        $this->_title = (string)$title;
        return $this;
    }

    /**
     * Empfängt den Titel der Slideshow
     */
    public function getTitle() {
        return $this->_title;
    }

    /**
     * Setzt die Beschreibung für die Slideshow
     */
    public function setDescription($desc) {
        $this->_description = (string)$desc;
        return $this;
    }

    /**
     * Empfängt die Beschreibung der Slideshow
     */
    public function getDescription() {
        return $this->_description;
    }

    /**
     * Erhält den nummerischen Status der Slideshow auf dem Server
     */
    public function getStatus() {
        return $this->_status;
    }

    /**
     * Erhält die textuelle Beschreibung des Status der Slideshow
     * auf dem Server
     */
    public function getStatusDescription() {
        return $this->_statusDescription;
    }

    /**
     * Erhält den permanenten Link der Slideshow
     */
    public function getPermaLink() {
        return $this->_permalink;
    }

    /**
     * Erhält die Anzahl der Aufrufe der Slideshow
     */
    public function getNumViews() {
        return $this->_numViews;
    }
}

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.

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
$ss = new Zend_Service_SlideShare('APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD');

$slideshow = $ss->getSlideShow(123456);

print "Slide Show Titel: {$slideshow->getTitle()}<br/>\n";
print "Anzahl an Besuchen: {$slideshow->getNumViews()}<br/>\n";

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:

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
$ss = new Zend_Service_SlideShare('APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD');

$starting_offset = 0;
$limit = 10;

// Empfängt die ersten 10 jeden Typs
$ss_user = $ss->getSlideShowsByUser('username', $starting_offset, $limit);
$ss_tags = $ss->getSlideShowsByTag('zend', $starting_offset, $limit);
$ss_group = $ss->getSlideShowsByGroup('mygroup', $starting_offset, $limit);

// Durch die Slideshows iterieren
foreach($ss_user as $slideshow) {
   print "Slide Show Titel: {$slideshow->getTitle}<br/>\n";
}

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:

$frontendOptions = array(
                        'lifetime' => 7200,
                        'automatic_serialization' => true);
$backendOptions  = array(
                        'cache_dir' => '/webtmp/');

$cache = Zend_Cache::factory('Core',
                             'File',
                             $frontendOptions,
                             $backendOptions);

$ss = new Zend_Service_SlideShare('APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD');
$ss->setCacheObject($cache);

$ss_user = $ss->getSlideShowsByUser('username', $starting_offset, $limit);

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:

$client = new Zend_Http_Client();
$client->setConfig(array('timeout' => 5));

$ss = new Zend_Service_SlideShare('APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD');
$ss->setHttpClient($client);
$ss_user = $ss->getSlideShowsByUser('username', $starting_offset, $limit);