Documentation

Zend_Service_Simpy - Zend_Service

Zend_Service_Simpy

導入

Zend_Service_Simpy は、ソーシャルブックマークサービスである Simpy 用のフリーな REST API の、軽量なラッパーです。

Zend_Service_Simpy を使用するには Simpy アカウントが必要です。アカウントを取得するには、 » Simpy のウェブサイト にいきます。 Simpy REST API についての詳細な情報は » Simpy REST API ドキュメント を参照ください。

Simpy REST API を使用すると、Simpy のウェブサイトが提供するサービスを利用することができます。 以下の節は、Zend_Service_Simpy で利用できる機能の概要をまとめたものです。

  • リンク: 作成、取得、更新、削除

  • タグ: 取得、削除、名前の変更、統合、分割

  • メモ: 作成、取得、更新、削除

  • ウォッチリスト: 取得、すべてを取得

タグ

取得時に、そのタグを使用しているリンク数の降順 (多いものが先) でタグが並べ替えられます。

Example #3 タグの処理

  1. $simpy = new Zend_Service_Simpy('あなたのユーザ名', 'あなたのパスワード');
  2.  
  3. /* タグつきでリンクを保存します */
  4. $simpy->saveLink(
  5.     'Zend Framework' // タイトル
  6.     'http://framework.zend.com', // URL
  7.     Zend_Service_Simpy_Link::ACCESSTYPE_PUBLIC, // アクセス形式
  8.     'zend, framework, php' // タグ
  9. );
  10.  
  11. /* リンクおよびメモで使用しているすべてのタグの一覧を取得します */
  12. $tagSet = $simpy->getTags();
  13.  
  14. /* 各タグと、それを使用しているリンク数を表示します */
  15. foreach ($tagSet as $tag) {
  16.     echo $tag->getTag();
  17.     echo ' - ';
  18.     echo $tag->getCount();
  19.     echo '<br />';
  20. }
  21.  
  22. /* 'zend' タグを使用しているすべてのリンクから、そのタグを削除します */
  23. $simpy->removeTag('zend');
  24.  
  25. /* 'framework' タグの名前を 'frameworks' に変更します */
  26. $simpy->renameTag('framework', 'frameworks');
  27.  
  28. /* 'frameworks' タグを 'framework' および
  29. 'development' に分割します。つまり、'frameworks' タグを
  30. 使用しているすべてのリンクからこのタグを削除し、'framework'
  31. および 'development' をそれらのリンクに追加します */
  32. $simpy->splitTag('frameworks', 'framework', 'development');
  33.  
  34. /* 'framework' および 'development' のふたつのタグを
  35. 'frameworks' に統合します。これは分割の反対の作業です */
  36. $simpy->mergeTags('framework', 'development', 'frameworks');

メモ

メモの保存、取得および削除が可能です。 メモは、数値 ID によって識別されます。

Example #4 メモの扱い

  1. $simpy = new Zend_Service_Simpy('あなたのユーザ名', 'あなたのパスワード');
  2.  
  3. /* メモを保存します */
  4. $simpy->saveNote(
  5.     'Test Note', // タイトル
  6.     'test,note', // タグ
  7.     'This is a test note.' // 説明
  8. );
  9.  
  10. /* 既存のメモを上書きします */
  11. $simpy->saveNote(
  12.     'Updated Test Note', // タイトル
  13.     'test,note,updated', // タグ
  14.     'This is an updated test note.', // 説明
  15.     $note->getId() // 一意な ID
  16. );
  17.  
  18. /* 直近に追加された 10 件のメモを探します */
  19. $noteSet = $simpy->getNotes(null, 10);
  20.  
  21. /* メモを表示します */
  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. /* タイトルに 'PHP' が含まれるすべてのメモを探します */
  33. $noteSet = $simpy->getNotes('title:PHP');
  34.  
  35. /* タイトルに 'PHP' が含まれ、説明に 'framework' が含まれない
  36.    すべてのメモを探します */
  37. $noteSet = $simpy->getNotes('+title:PHP -description:framework');
  38.  
  39. /* メモを削除します */
  40. $simpy->deleteNote($note->getId());

ウォッチリスト

ウォッチリストは、API を用いて作成したり削除したりすることはできません。 取得のみが可能です。したがって、API を使用してアクセスする前には Simpy のウェブサイトでウォッチリストを作成しておく必要があります。

Example #5 ウォッチリストの取得

  1. $simpy = new Zend_Service_Simpy('あなたのユーザ名', 'あなたのパスワード');
  2.  
  3. /* すべてのウォッチリストの一覧を取得します */
  4. $watchlistSet = $simpy->getWatchlists();
  5.  
  6. /* 各ウォッチリストのデータを表示します */
  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. /* 個々のウォッチリストを、ID を指定して取得します */
  33. $watchlist = $simpy->getWatchlist($watchlist->getId());
  34. $watchlist = $simpy->getWatchlist(1);

Copyright

© 2006-2021 by Zend by Perforce. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.

Contacts