Zend_Service_ShortUrl

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.

Example #3 Arbeiten mit Tags

  1. $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
  2.  
  3. /* Speicher einen Link mit Tags */
  4. $simpy->saveLink(
  5.     'Zend Framework' // Titel
  6.     'http://framework.zend.com', // URL
  7.     Zend_Service_Simpy_Link::ACCESSTYPE_PUBLIC, // Zugriffstyp
  8.     'zend, framework, php' // Tags
  9. );
  10.  
  11. /* Hole eine Liste mit allen Tags, die von Links und
  12. Notizen genutzt werden */
  13. $tagSet = $simpy->getTags();
  14.  
  15. /* Stelle jeden Tag mit der Anzahl der Links, die ihn nutzen, dar */
  16. foreach ($tagSet as $tag) {
  17.     echo $tag->getTag();
  18.     echo ' - ';
  19.     echo $tag->getCount();
  20.     echo '<br />';
  21. }
  22.  
  23. /* Entferne das 'zend'-Tag von allen Links, die es benutzen */
  24. $simpy->removeTag('zend');
  25.  
  26. /* Nenne das 'framework'-Tag zu 'frameworks' um */
  27. $simpy->renameTag('framework', 'frameworks');
  28.  
  29. /* Splitte das 'frameworks'-Tag in 'framework' und
  30. 'development' auf. D.h. dass alle Links, die 'frameworks'
  31. als Tag besitzen, nunmehr stattdessen 'framework' und 'development'
  32. besitzen */
  33. $simpy->splitTag('frameworks', 'framework', 'development');
  34.  
  35. /* Fasse 'framework' und 'development' wieder zu 'frameworks'
  36. zusammen; vereinfacht ist es das Gegenteil, ein Tag zu splitten */
  37. $simpy->mergeTags('framework', 'development', 'frameworks');

Notizen

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

Example #4 Arbeiten mit Notizen

  1. $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
  2.  
  3. /* Eine Notiz speichern */
  4. $simpy->saveNote(
  5.     'Test Note', // Titel
  6.     'test,note', // Tags
  7.     'This is a test note.' // Beschreibung
  8. );
  9.  
  10. /* Eine bereits existierende Notiz überschreiben */
  11. $simpy->saveNote(
  12.     'Updated Test Note', // Titel
  13.     'test,note,updated', // Tags
  14.     'This is an updated test note.', // Beschreibung
  15.     $note->getId() // Eindeutige ID
  16. );
  17.  
  18. /* Suche nach den 10 letzten hinzugefügten Notizen */
  19. $noteSet = $simpy->getNotes(null, 10);
  20.  
  21. /* Zeige diese Notizen an */
  22. foreach ($noteSet as $note) {
  23.     echo '<p>';
  24.     echo $note->getTitle();
  25.     echo '<br />';
  26.     echo $note->getDescription();
  27.     echo '<br >';
  28.     echo $note->getTags();
  29.     echo '</p>';
  30. }
  31.  
  32. /* Suche nach allen Notizen mit 'PHP' im Titel */
  33. $noteSet = $simpy->getNotes('title:PHP');
  34.  
  35. /* Suche nach allen Notizen mit 'PHP' im Titel und ohne
  36. 'framework' in der Beschreibung */
  37. $noteSet = $simpy->getNotes('+title:PHP -description:framework');
  38.  
  39. /* Löschen einer Notiz */
  40. $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

  1. $simpy = new Zend_Service_Simpy('yourusername', 'yourpassword');
  2.  
  3. /* Hole eine Liste von allen Watchlisten */
  4. $watchlistSet = $simpy->getWatchlists();
  5.  
  6. /* Zeige die Daten jeder Watchlist an */
  7. foreach ($watchlistSet as $watchlist) {
  8.     echo $watchlist->getId();
  9.     echo '<br />';
  10.     echo $watchlist->getName();
  11.     echo '<br />';
  12.     echo $watchlist->getDescription();
  13.     echo '<br />';
  14.     echo $watchlist->getAddDate();
  15.     echo '<br />';
  16.     echo $watchlist->getNewLinks();
  17.     echo '<br />';
  18.  
  19.     foreach ($watchlist->getUsers() as $user) {
  20.         echo $user;
  21.         echo '<br />';
  22.     }
  23.  
  24.     foreach ($watchlist->getFilters() as $filter) {
  25.         echo $filter->getName();
  26.         echo '<br />';
  27.         echo $filter->getQuery();
  28.         echo '<br />';
  29.     }
  30. }
  31.  
  32. /* Hole eine spezielle Watchlist anhand einer ID */
  33. $watchlist = $simpy->getWatchlist($watchlist->getId());
  34. $watchlist = $simpy->getWatchlist(1);

Zend_Service_ShortUrl