Programmer's Reference Guide

Zend_Service_Flickr

Zend_Service_Simpy

Einführung

Zend_Service_Simpy ist ein schlanker Wrapper für das freie REST API des Simpy Lesezeichen-Services.

Um Zend_Service_Simpy zu nutzen, solltest du bereits ein Simpy-Konto besitzen. Falls dies nicht der Fall ist, kannst du dies auf der » Simpy Webseite tun. Für weitere Informationen über das Simpy REST API, kannst du in der » Simpy REST API Dokumentation nachlesen.

Das Simpy REST API erlaubt es dem Entwickler, mit verschiedenen Aspekten des Services, welche die Simpy Webseite bietet, zu interagieren. Diese Sektionen zeigen dir, wie man Zend_Service_Simpy in jedem dieser Bereiche nutzen kann.

  • Links: Erstellen, Laden, Aktualisieren, Löschen

  • Tags: Laden, Löschen, Umbenennen, Zusammenfassen, Splitten

  • Notes: Erstellen, Laden, Aktualisieren, Löschen

  • Watchlists: Holen, Alle holen

Tags

Wenn die Tags zurückgegeben werden, werden sie in absteigender Reihenfolge (d.h. der größte zuerst) nach der Häufigkeit der Benutzung durch die Links sortiert.

Beispiel #3 Arbeiten mit Tags

<?php
require_once 'Zend/Service/Simpy.php';
$simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');

/* Speicher einen Link mit Tags */
$simpy->saveLink(
    'Zend Framework' // Titel
    'http://framework.zend.com', // URL
    Zend_Service_Simpy_Link::ACCESSTYPE_PUBLIC, // Zugriffstyp
    'zend, framework, php' // Tags
);

/* Hole eine Liste mit allen Tags, die von Links und
Notizen genutzt werden */
$tagSet = $simpy->getTags();

/* Stelle jeden Tag mit der Anzahl der Links, die ihn nutzen, dar */
foreach ($tagSet as $tag) {
    echo $tag->getTag();
    echo ' - ';
    echo $tag->getCount();
    echo '<br />';
}

/* Entferne das 'zend'-Tag von allen Links, die es benutzen */
$simpy->removeTag('zend');

/* Nenne das 'framework'-Tag zu 'frameworks' um */
$simpy->renameTag('framework', 'frameworks');

/* Splitte das 'frameworks'-Tag in 'framework' und
'development' auf. D.h. dass alle Links, die 'frameworks'
als Tag besitzen, nunmehr stattdessen 'framework' und 'development'
besitzen */
$simpy->splitTag('frameworks', 'framework', 'development');

/* Fasse 'framework' und 'development' wieder zu 'frameworks'
zusammen; vereinfacht ist es das Gegenteil, ein Tag zu splitten */
$simpy->mergeTags('framework', 'development', 'frameworks');
            

Notizen

Notizen können gespeichert, geladen und gelöscht werden. Sie sind eindeutig durch eine numerische ID definiert.

Beispiel #4 Arbeiten mit Notizen

<?php
require_once 'Zend/Service/Simpy.php';
$simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');

/* Eine Notiz speichern */
$simpy->saveNote(
    'Test Note', // Titel
    'test,note', // Tags
    'This is a test note.' // Beschreibung
);

/* Eine bereits existierende Notiz überschreiben */
$simpy->saveNote(
    'Updated Test Note', // Titel
    'test,note,updated', // Tags
    'This is an updated test note.', // Beschreibung
    $note->getId() // Eindeutige ID
);

/* Suche nach den 10 letzten hinzugefügten Notizen */
$noteSet = $simpy->getNotes(null, 10);

/* Zeige diese Notizen an */
foreach ($noteSet as $note) {
    echo '<p>';
    echo $note->getTitle();
    echo '<br />';
    echo $note->getDescription();
    echo '<br >';
    echo $note->getTags();
    echo '</p>';
}

/* Suche nach allen Notizen mit 'PHP' im Titel */
$noteSet = $simpy->getNotes('title:PHP');

/* Suche nach allen Notizen mit 'PHP' im Titel und ohne
'framework' in der Beschreibung */
$noteSet = $simpy->getNotes('+title:PHP -description:framework');

/* Löschen einer Notiz */
$simpy->deleteNote($note->getId());
            

Watchlists

Watchlisten können durch das API nicht erstellt oder entfernt werden, sondern lediglich zurückgegeben. Folglich musst du eine Watchlist über die Simpy Webseite erstellen, bevor du diese über das API nutzt.

Beispiel #5 Zurückgeben von Watchlisten

<?php
require_once 'Zend/Service/Simpy.php';
$simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');

/* Hole eine Liste von allen Watchlisten */
$watchlistSet = $simpy->getWatchlists();

/* Zeige die Daten jeder Watchlist an */
foreach ($watchlistSet as $watchlist) {
    echo $watchlist->getId();
    echo '<br />';
    echo $watchlist->getName();
    echo '<br />';
    echo $watchlist->getDescription();
    echo '<br />';
    echo $watchlist->getAddDate();
    echo '<br />';
    echo $watchlist->getNewLinks();
    echo '<br />';

    foreach ($watchlist->getUsers() as $user) {
        echo $user;
        echo '<br />';
    }

    foreach ($watchlist->getFilters() as $filter) {
        echo $filter->getName();
        echo '<br />';
        echo $filter->getQuery();
        echo '<br />';
    }
}

/* Hole eine spezielle Watchlist anhand einer ID */
$watchlist = $simpy->getWatchlist($watchlist->getId());
$watchlist = $simpy->getWatchlist(1);
            

Zend_Service_Flickr
blog comments powered by Disqus

Select a Version

Languages Available

Components

Search the Manual