# Zend_Service_Delicious

## Introduction

Zend_Service_Delicious est une API pour accéder aux Web services XML et JSON de del.icio.us. Ce composant vous donne, si vous avez les droits, un accès en lecture-écriture à vos entrées sur del.icio.us. Il permet également un accès en lecture seule aux données de tous les utilisateurs.

Récupérer toutes vos entrées

    $delicious = new Zend_Service_Delicious('identifiant', 'mot_de_passe');
    $posts = $delicious->getAllPosts();

    foreach ($posts as $post) {
        echo "--\n";
        echo "Titre: {$post->getTitle()}\n";
        echo "Url: {$post->getUrl()}\n";
    }

## Récupérer vos entrées

Zend_Service_Delicious fournis trois méthodes pour récupérer vos entrées : getPosts(), getRecentPosts() et getAllPosts(). Elles retournent toutes une instance de la classe Zend_Service_Delicious_PostList, qui contient toutes les entrées récupérées.

    /**
     * Récupère les entrées correspondants aux arguments. Si la date ou
     * l'url n'est pas précisée, la date la plus récente
     * sera prise en compte.
     *
     * @param string $tag Optionnel pour filtrer par tag
     * @param Zend_Date $dt Optionnel pour filtrer par date
     * @param string $url Optionnel pour filtrer par url
     * @return Zend_Service_Delicious_PostList
     */
    public function getPosts($tag = null, $dt = null, $url = null);

    /**
     * Récupère les dernières entrées
     *
     * @param string $tag Optionnel pour filtrer par tag
     * @param string $count Nombre maximum d'entrées à récupérer
     *                     (15 par défaut)
     * @return Zend_Service_Delicious_PostList
     */
    public function getRecentPosts($tag = null, $count = 15);

    /**
     * Récupère toutes les entrées
     *
     * @param string $tag Optionnel pour filtrer par tag
     * @return Zend_Service_Delicious_PostList
     */
    public function getAllPosts($tag = null);

## Zend_Service_Delicious_PostList

Des instances de cette classe sont retournées par les méthodes getPosts(), getAllPosts(),getRecentPosts(), et getUserPosts() de Zend_Service_Delicious.

Pour faciliter l'accès au données cette classe implémente les interfaces `Countable`, `Iterator`, et`ArrayAccess`.

Accéder à la liste des entrées

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');
    $posts = $delicious->getAllPosts();

    // Affiche le nombre d'entrées
    echo count($posts);

    // Itération sur les entrées
    foreach ($posts as $post) {
        echo "--\n";
        echo "Titre: {$post->getTitle()}\n";
        echo "Url: {$post->getUrl()}\n";
    }

    // Affiche une entrée en utilisant un tableau
    echo $posts[0]->getTitle();

Dans cette implémentation les méthodes ArrayAccess::offsetSet() et ArrayAccess::offsetUnset() lèvent des exceptions. Ainsi, du code tel que `unset($posts[0]);` ou `$posts[0] = 'A';` lèvera une exception car ces propriétés sont en lecture seule.

Les objets d'entrées ont deux capacités de filtrage incorporées. Les entrées peuvent être filtrées par étiquette et URL.

Filtrage d'une entrée par une étiquette spécifique

Les entrées peuvent être filtrées par une (des) étiquette(s) spécifique(s) en utilisant withTags(). Par confort, withTag() est aussi fourni quand il est nécessaire 'e ne spécifier qu'une seule étiquette

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');
    $posts = $delicious->getAllPosts();

    // Affiche les entrées ayant les étiquettes "php" et "zend"
    foreach ($posts->withTags(array('php', 'zend')) as $post) {
        echo "Title: {$post->getTitle()}\n";
        echo "Url: {$post->getUrl()}\n";
    }

Filtrage d'une entrée par URL

Les entrées peuvent être filtrées par URL correspondant à une expression régulière spécifiée en utilisant la méthode withUrl() :

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');
    $posts = $delicious->getAllPosts();

    // Affiche les entrées ayant "help" dans l'URL
    foreach ($posts->withUrl('/help/') as $post) {
        echo "Title: {$post->getTitle()}\n";
        echo "Url: {$post->getUrl()}\n";
    }

## Édition des entrées

Édition d'une entrée

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');
    $posts = $delicious->getPosts();

    // change le titre
    $posts[0]->setTitle('Nouveau Titre');
    // sauvegarde le changement
    $posts[0]->save();

Enchaînement des appels de méthode

Toutes les méthodes "setter" renvoient l'objet Zend_Service_Delicious_PostList vous pouvez donc chaîner les appels aux méthodes en utilisant une interface fluide.

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');
    $posts = $delicious->getPosts();

    $posts[0]->setTitle('Nouveau Titre')
             ->setNotes('Nouvelle note')
             ->save();

## Supprimer des entrées

Il y a deux moyens de supprimer une entrée, en spécifiant son URL ou en appelant la méthode delete() sur un objet Zend_Service_Delicious_PostList.

Suppression d'une entrée

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');

    // en spécifiant l' URL
    $delicious->deletePost('http://framework.zend.com');

    // en appelant la méthode de l'objet Zend_Service_Delicious_PostList
    $posts = $delicious->getPosts();
    $posts[0]->delete();

    // une autre façon d'utiliser deletePost()
    $delicious->deletePost($posts[0]->getUrl());

## Ajout d'entrées

Pour ajouter une entrée vous devez appeler la méthode createNewPost(), qui renvoie un objet Zend_Service_Delicious_Post. Quand vous éditez l'entrée, vous devez la sauvegarder dans la base de donnée de del.icio.us en appelant la méthode save().

Ajouter une entrée

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');

    // créé et sauvegarde une nouvelle entrée (en chainant les méthodes)
    $delicious->createNewPost('Zend Framework', 'http://framework.zend.com')
              ->setNotes('Page d\'accueil de Zend Framework')
              ->save();

    // créé et sauvegarde une nouvelle entrée (sans enchaîner les méthodes)
    $newPost = $delicious->createNewPost('Zend Framework',
                                         'http://framework.zend.com');
    $newPost->setNotes('Page d\'accueil de Zend Framework');
    $newPost->save();

## Les étiquettes ("tags")

Récupérer les étiquettes

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');

    // récupère tous les étiquettes
    print_r($delicious->getTags());

    // renomme l'étiquette "ZF" en "zendFramework"
    $delicious->renameTag('ZF', 'zendFramework');

## Les groupes d'étiquettes

Gestion des groupes d'étiquette

    $delicious = new Zend_Service_Delicious('nom_d_utilisateur',
                                            'mot_de_passe');

    // récupère tous les groupes
    print_r($delicious->getBundles());

    // efface le groupe someBundle
    $delicious->deleteBundle('someBundle');

    // ajoute un groupe
    $delicious->addBundle('newBundle', array('tag1', 'tag2'));

## Données publiques

L'API Web del.icio.us autorise l'accès aux données publiques de tous les utilisateurs.

Méthodes pour récupérer les données publiques

Nom | Description | Type de retour
--- | --- | ---
getUserFans() | Récupère les fans d'un utilisateur | Array
getUserNetwork() | Récupère le réseau d'un utilisateur | Array
getUserPosts() | Récupère les entrées d'un utilisateur | Zend_Service_Delicious_PostList
getUserTags() | Récupère les étiquettes d'un utilisateur | Array

Si vous utilisez uniquement ces méthodes, le nom d'utilisateur et le mot de passe ne sont pas obligatoires pour créer un nouvel objet Zend_Service_Delicious.

Récupérer les données publiques

    // nom d'utilisateur et mot de passe optionnels
    $delicious = new Zend_Service_Delicious();

    // récupère les fans de l'utilisateur someUser
    print_r($delicious->getUserFans('someUser'));

    // récupère le réseau de l'utilisateur someUser
    print_r($delicious->getUserNetwork('someUser'));

    // récupère les Tags de l'utilisateur someUser
    print_r($delicious->getUserTags('someUser'));

### Entrées publiques

Quand vous récupérez des entrées publiques, la méthode getUserPosts() retourne un objet Zend_Service_Delicious_PostList qui contient des objets Zend_Service_Delicious_SimplePost. Ces derniers contiennent des informations basiques sur l'entrée : URL, title, notes, and tags.

Méthodes de la classe Zend_Service_Delicious_SimplePost

Nom | Description | Type de retour
--- | --- | ---
getNotes() | Récupère les notes de l'entrée | String
getTags() | Récupère les étiquettes de l'entrée | Array
getTitle() | Récupère le titre de l'entrée | String
getUrl() | Récupère l'URL de l'entrée | String

## Client HTTP

Zend_Service_Delicious utilise Zend_Rest_Client pour effectuer les requêtes HTTP sur le Web service de del.icio.us. Pour modifier le client HTTP utiliser par Zend_Service_Delicious, vous devez modifier le client HTTP de Zend_Rest_Client.

Modifier le client HTTP de Zend_Rest_Client

    $myHttpClient = new My_Http_Client();
    Zend_Rest_Client::setHttpClient($myHttpClient);

Quand vous effectuez plus d'une requête avec Zend_Service_Delicious vous pouvez accélérez vos requêtes en configurant votre client HTTP pour qu'il ne ferme pas les connexions.

Configurer votre client HTTP pour qu'il ne ferme pas les connexions

    Zend_Rest_Client::getHttpClient()->setConfig(array(
            'keepalive' => true
    ));

En raison de quelques problèmes de del.icio.us avec `'ssl2'` (environs 2 secondes pour une requête), quand un objet Zend_Service_Delicious est construit, le transport SSL de Zend_Rest_Client est configuré sur `'ssl'` au lieu de la valeur par défaut `'ssl2'`.