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. Abfragen von Links setLimit(10); /* Holen und darstellen */ $linkSet = $simpy->getLinks($linkQuery); foreach ($linkSet as $link) { echo ''; echo $link->getTitle(); echo '
'; } /* 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. Modifizieren von Links 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()); } ]]> 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. Arbeiten mit Tags 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 '
'; } /* 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. Arbeiten mit Notizen 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 '

'; echo $note->getTitle(); echo '
'; echo $note->getDescription(); echo '
'; echo $note->getTags(); echo '

'; } /* 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. Zurückgeben von Watchlisten getWatchlists(); /* Zeige die Daten jeder Watchlist an */ foreach ($watchlistSet as $watchlist) { echo $watchlist->getId(); echo '
'; echo $watchlist->getName(); echo '
'; echo $watchlist->getDescription(); echo '
'; echo $watchlist->getAddDate(); echo '
'; echo $watchlist->getNewLinks(); echo '
'; foreach ($watchlist->getUsers() as $user) { echo $user; echo '
'; } foreach ($watchlist->getFilters() as $filter) { echo $filter->getName(); echo '
'; echo $filter->getQuery(); echo '
'; } } /* Hole eine spezielle Watchlist anhand einer ID */ $watchlist = $simpy->getWatchlist($watchlist->getId()); $watchlist = $simpy->getWatchlist(1); ]]>