Zend_Service_SlideShare
Le composant Zend_Service_SlideShare est utilisé dans
l'interaction avec les services Web de » slideshare.net, plate-forme servant d'hébergement
de diaporamas. Grâce à ce composant, vous pouvez intégrer des diaporamas de Slideshare, dans
votre propre site Web, ou même uploader des nouveaux diaporamas sur votre compte Slideshare,
depuis votre site Web.
Démarrage avec Zend_Service_SlideShare
Pour utiliser Zend_Service_SlideShare, vous devez créer au
préalable un compte sur slideshare.net (plus d'informations à ce sujet » ici), afin de recevoir votre clé
d'API et votre login / mot de passe, indispensables pour utiliser le service Web.
Une fois votre compte créé, vous pouvez utiliser
Zend_Service_SlideShare en créant une instance de
Zend_Service_SlideShare en lui passant vos identifiants :
// Crée une instance du composant
'APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD');
L'objet SlideShow
Chaque diaporama issu de Zend_Service_SlideShare est
matérialisé par un objet Zend_Service_SlideShare_SlideShow (que
ce soit pour uploader ou récupérer des diaporamas). Pour information, voici un pseudo
code de cette classe :
span style="color: #808080; font-style: italic;">/**
* Récupère l'emplacement du diaporama
*//**
* Récupère la transcription du diaporama
*//**
* Associe un mot-clé au diaporama
*//**
* Associe des mots-clés au diaporama
*//**
* Récupère tous les mots-clés associés au diaporama
*//**
* Règle le nom de fichier du diaporama dans le système
* de fichiers local (pour l'upload d'un nouveau diaporama)
*//**
* Rècupère le nom de fichier du diaporama dans le système
* de fichiers local qui sera uploadé
*//**
* Récupère l'ID du diaporama
*//**
* Récupère le code HTML utilisé pour la projection du diaporama
*//**
* Récupère l'URI de la vignette du diaporama
*//**
* Règle le titre du diaporama
*//**
* Récupère le titre du diaporama
*//**
* Régle la description du diaporama
*//**
* Récupère la description du diaporama
*//**
* Récupère le statut (numérique) du diaporama sur le serveur
*//**
* Récupère la description textuelle du statut du diaporama
* sur le serveur
*//**
* Récupère le lien permanent du diaporama
*//**
* Récupère le nombre de diapositives que le diaporama comprend
*/
Note:
La classe présentée ci dessus ne montre que les méthodes qui sont sensées être
utilisées par les développeurs. D'autres méthodes internes au composant
existent.
Lors de l'utilisation de Zend_Service_SlideShare, la classe
de données Slideshow sera souvent utilisée pour parcourir, ajouter, ou modifier des
diaporamas.
Récupérer un diaporama simplement
La manière la plus simple d'utiliser
Zend_Service_SlideShare est la récupération d'un diaporama depuis
son ID, fournit par le service slideshare.net, ceci est effectué via la méthode
getSlideShow() de l'objet Zend_Service_SlideShare.
Le résultat de cette méthode est un objet de type
Zend_Service_SlideShare_SlideShow.
// Création d'une instance du composant
'APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD'"Titre du diaporama : {$slideshow->getTitle()}<br/>\n""Nombre de diapositives : {$slideshow->getNumViews()}<br/>\n";
Récupérer des groupes de diaporamas
Si vous ne connaissez pas l'ID spécifique d'un diaporama vous intéressant, il est
possible de récupérer des groupes de diaporamas, en utilisant une de ces trois méthodes
:
-
Diaporamas depuis un compte spécifique
La méthode getSlideShowsByUsername() va retourner tous les
diaporamas depuis un compte utilisateur.
-
Diaporamas contenant des tags spécifiques
La méthode getSlideShowsByTag va retourner un ensemble de
diaporamas comportant certains tags (mots-clés).
-
Diaporamas depuis un groupe
La méthode getSlideShowsByGroup récupère tous les diaporamas
d'un groupe donné.
Voici un exemple utilisant les méthodes décrites ci-dessus :
// Crée une nouvelle instance du composant
'APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD'// Récupère les 10 premiers de chaque type
'username''zend''mygroup'// Itère sur les diaporamas
"Titre du diaporama : {$slideshow->getTitle}<br/>\n";
}
Politique de cache de Zend_Service_SlideShare
Par défaut, Zend_Service_SlideShare va mettre en cache
toute requête concernant le service Web, dans le système de fichier (par défaut :
/tmp ), ceci pour une durée de 12 heures. Si vous voulez changer ce
comportement, vous devez passer votre propre objet Zend_Cache en
utilisant la méthode setCacheObject :
span style="color: #ff0000;">'lifetime' => 7200,
'automatic_serialization''cache_dir' => '/webtmp/''Core',
'File''APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD''username'
Changer le comportement du client HTTP
Si pour une raison quelconque vous souhaitez changer le comportement de l'objet
client HTTP utilisé pour interroger le service Web, vous pouvez créer votre propre
instance de Zend_Http_Client (voyez Zend_Http). Ceci peut être utile par exemple pour spécifier un timeout ou
toute autre chose :
span style="color: #ff0000;">'timeout''APIKEY',
'SHAREDSECRET',
'USERNAME',
'PASSWORD''username'
|
|