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
Links
Beim Anfragen von Links, werden diese absteigend nach deren Datum - wann es
hinzugefügt wurde - sortiert. Es kann nach Links anhand des Titels, des Spitznamens,
der Tags, der Notizen oder sogar des Inhalts der verknüpften Webseite gesucht werden.
Simpy erlaubt es, jegliche oder alle dieser Felder mit Phrasen, booleschen
Operatoren und Wildcards zu durchsuchen. Siehe in den
» Suchsyntax- und
» Suchfelder-Sektionen
der Simipy FAQ für weitere Informationen.
Example #1 Abfragen von Links
$simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
/* Suche nach den 10 letzten hinzugefügten Links */
$linkQuery = new Zend_Service_Simpy_LinkQuery();
$linkQuery->setLimit(10);
/* Holen und darstellen */
$linkSet = $simpy->getLinks($linkQuery);
foreach ($linkSet as $link) {
}
/* Suche nach den 5 letzten hinzugefügten Links mit 'PHP'
im Titel */
$linkQuery->setQueryString('title:PHP');
$linkQuery->setLimit(5);
/* Suche nach allen Links mit 'French' im Titel und
'lanuage' in den Tags */
$linkQuery->setQueryString('+title:French +tags:language');
/* Suche nach allen Links mit 'French' im Titel und ohne
'travel' in den Tags */
$linkQuery->setQueryString('+title:French -tags:travel');
/* Suche nach allen Links, die am 9.12.2006 hinzugefügt wurden */
$linkQuery->setDate('2006-12-09');
/* Suche nach allen Links, die nach dem 9.12.2006 hinzugefügt wurden (
das Datum ist nicht eingeschlossen) */
$linkQuery->setAfterDate('2006-12-09');
/* Suche nach allen Links, die vom dem 9.12.2006 hinzugefügt wurden (
das angegebene Datum ist ausgeschlossen) */
$linkQuery->setBeforeDate('2006-12-09');
/* Suche nach allen Links, die zwischen dem 1.12.2006 und dem 9.12.2006
hinzugefügt wurden (die beiden Daten sind dabei ausgeschlossen) */
$linkQuery->setBeforeDate('2006-12-01');
$linkQuery->setAfterDate('2006-12-09');
Links werden eindeutig durch ihren URL angezeigt. In anderen Worten,
falls ein Versuch gemacht wird, einen Link zu speichern, der denselben
URL hat wie ein bereits existierender Link, werden die Daten des
alten Links mit den neuen Daten überschrieben.
Example #2 Modifizieren von Links
$simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
/* Speichern eines link */
$simpy->saveLink(
'Zend Framework' // Titel
'http://framework.zend.com', // URL
Zend_Service_Simpy_Link::ACCESSTYPE_PUBLIC, // Zugriffstyp
'zend, framework, php' // Tags
'Zend Framework home page' // Alternativer Titel
'This site rocks!' // Notiz
);
/* Überschreibe den existierenden Link mit neuen Daten */
$simpy->saveLink(
'Zend Framework'
'http://framework.zend.com',
// der Zugriffstyp wurde geändert
Zend_Service_Simpy_Link::ACCESSTYPE_PRIVATE,
// Die Reihenfolge der Tags hat sich geändert
'php, zend, framework'
// Alternativer Titel wurde geändert
'Zend Framework'
// Notiz hat sich geändert
'This site REALLY rocks!'
);
/* Den Link löschen */
$simpy->deleteLink('http://framework.zend.com');
/* Ein wirklich einfacher Weg den Frühjahrsputz
bei deinen Links zu machen ;-) */
$linkSet = $this->_simpy->getLinks();
foreach ($linkSet as $link) {
$this->_simpy->deleteLink($link->getUrl());
}
Notizen
Notizen können gespeichert, geladen und gelöscht werden. Sie sind
eindeutig durch eine numerische ID definiert.
Example #4 Arbeiten mit Notizen
$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 $note-> getDescription();
}
/* 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.
Example #5 Zurückgeben von Watchlisten
$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 $watchlist-> getName();
echo $watchlist-> getDescription();
echo $watchlist-> getAddDate();
echo $watchlist-> getNewLinks();
foreach ($watchlist->getUsers() as $user) {
}
foreach ($watchlist->getFilters() as $filter) {
echo $filter-> getQuery();
}
}
/* Hole eine spezielle Watchlist anhand einer ID */
$watchlist = $simpy->getWatchlist($watchlist->getId());
$watchlist = $simpy->getWatchlist(1);
|
|