lib/flickrlib.php

   1 <?php
   2 /**
   3  * phpFlickr Class 2.2.0
   4  * Written by Dan Coulter (dan@dancoulter.com)
   5  * Sourceforge Project Page: {@link http://www.sourceforge.net/projects/phpflickr/}
   6  * Released under GNU Lesser General Public License ({@link http://www.gnu.org/copyleft/lgpl.html})
   7  * For more information about the class and upcoming tools and toys using it,
   8  * visit {@link http://www.phpflickr.com/} or {@link http://phpflickr.sourceforge.net}
   9  *
  10  *   For installation instructions, open the README.txt file packaged with this
  11  *   class. If you don't have a copy, you can see it at:
  12  *    {@link http://www.phpflickr.com/README.txt}
  13  *
  14  *   Please submit all problems or questions to the Help Forum on my project page:
  15  *     {@link http://sourceforge.net/forum/forum.php?forum_id=469652}
  16  *
  17  * Modified by Dongsheng Cai <dongsheng@moodle.com>
  18  * ChangeLog:
  19  *   1. Remove PEAR HTTP LIB, use curl.class.php (created by myself)
  20  *   2. Remove PEAR DB LIB
  21  *   3. Remove all cache code, it will implement in curl class.
  22  *   4. Clean up session code
  23  *
  24  * Modified by David Mudrak <david@moodle.com>
  25  * ChangeLog:
  26  *   1. upload() method uses Moodle stored_file
  27  *   2. upload() method supports all params provided by http://www.flickr.com/services/api/upload.api.html
  28  *   3. auth() method shows debugging warning as this library cannot be used any
  29  *      more for calling Flickr API that requires authentication.
  30  *
  31  * @package moodlecore
  32  * @subpackage 3rd-party
  33  */
  34
  35 defined('MOODLE_INTERNAL') || die();
  36
  37 global $CFG;
  38 require_once("{$CFG->libdir}/flickrclient.php");
  39
  40 /**
  41  * Flickr Class
  42  * @package moodlecore
  43  * @subpackage 3rd-party
  44  */
  45 class phpFlickr {
  46     var $api_key;
  47     var $secret;
  48     var $REST = 'https://api.flickr.com/services/rest/';
  49     var $Upload = 'https://api.flickr.com/services/upload/';
  50     var $Replace = 'https://api.flickr.com/services/replace/';
  51     var $req;
  52     var $response;
  53     var $parsed_response;
  54     var $die_on_error;
  55     var $error_code;
  56     var $error_msg;
  57     var $token;
  58     var $php_version;
  59
  60     /** @var curl cURL class. */
  61     private $curl;
  62
  63     /**
  64      * When your database cache table hits this many rows, a cleanup
  65      * will occur to get rid of all of the old rows and cleanup the
  66      * garbage in the table.  For most personal apps, 1000 rows should
  67      * be more than enough.  If your site gets hit by a lot of traffic
  68      * or you have a lot of disk space to spare, bump this number up.
  69      * You should try to set it high enough that the cleanup only
  70      * happens every once in a while, so this will depend on the growth
  71      * of your table.
  72      *
  73      * @global object
  74      */
  75
  76     function __construct ($api_key, $secret = NULL, $token = '')
  77     {
  78         global $CFG;
  79         //The API Key must be set before any calls can be made.  You can
  80         //get your own at http://www.flickr.com/services/api/misc.api_keys.html
  81         $this->api_key = $api_key;
  82         $this->secret = $secret;
  83         $this->die_on_error = false;
  84         $this->token = $token;
  85         //Find the PHP version and store it for future reference
  86         $this->php_version = explode("-", phpversion());
  87         $this->php_version = explode(".", $this->php_version[0]);
  88
  89         // Initialize curl helper, set custom user agent as Flickr blocks our "MoodleBot" agent string.
  90         $this->curl = new curl(array('cache'=>true, 'module_cache'=>'repository'));
  91         $this->curl->setopt([
  92             'CURLOPT_USERAGENT' => flickr_client::user_agent(),
  93         ]);
  94     }
  95
  96     function request ($command, $args = array())
  97     {
  98         //Sends a request to Flickr's REST endpoint via POST.
  99         if (substr($command,0,7) != "flickr.") {
 100             $command = "flickr." . $command;
 101         }
 102
 103         //Process arguments, including method and login data.
 104         if ($command == 'flickr.upload') {
 105             $photo = $args['photo'];
 106             if (empty($args['is_public'])) {
 107                 $args['is_public'] = 0;
 108             }
 109             if (empty($args['is_friend'])) {
 110                 $args['is_friend'] = 0;
 111             }
 112             if (empty($args['is_family'])) {
 113                 $args['is_family'] = 0;
 114             }
 115             if (empty($args['hidden'])) {
 116                 $args['hidden'] = 1;
 117             }
 118             $args = array("api_key" => $this->api_key,
 119                           "title" => $args['title'],
 120                           "description" => $args['description'],
 121                           "tags" => $args['tags'],
 122                           "is_public" => $args['is_public'],
 123                           "is_friend" => $args['is_friend'],
 124                           "is_family" => $args['is_family'],
 125                           "safety_level" => $args['safety_level'],
 126                           "content_type" => $args['content_type'],
 127                           "hidden" => $args['hidden']);
 128         } else {
 129             $args = array_merge(array("method" => $command, "format" => "php_serial", "api_key" => $this->api_key), $args);
 130         }
 131
 132         if (!empty($this->token)) {
 133             $args = array_merge($args, array("auth_token" => $this->token));
 134         }
 135
 136         ksort($args);
 137         $auth_sig = "";
 138         foreach ($args as $key => $data) {
 139             $auth_sig .= $key . $data;
 140         }
 141
 142         if (!empty($this->secret)) {
 143             $api_sig = md5($this->secret . $auth_sig);
 144             $args['api_sig'] = $api_sig;
 145         }
 146
 147         //$this->req->addHeader("Connection", "Keep-Alive");
 148         if ($command != 'flickr.upload') {
 149             $ret = $this->curl->post($this->REST, $args);
 150             $this->parsed_response = $this->clean_text_nodes(unserialize($ret));
 151         } else {
 152             $args['photo'] = $photo;
 153             $xml = simplexml_load_string($this->curl->post($this->Upload, $args));
 154
 155             if ($xml['stat'] == 'fail') {
 156                 $this->parsed_response = array('stat' => (string) $xml['stat'], 'code' => (int) $xml->err['code'], 'message' => (string) $xml->err['msg']);
 157             } elseif ($xml['stat'] == 'ok') {
 158                 $this->parsed_response = array('stat' => (string) $xml['stat'], 'photoid' => (int) $xml->photoid);
 159                 $this->response = true;
 160             }
 161         }
 162
 163         if ($this->parsed_response['stat'] == 'fail') {
 164             if ($this->die_on_error) die("The Flickr API returned the following error: #{$this->parsed_response['code']} - {$this->parsed_response['message']}");
 165             else {
 166                 $this->error_code = $this->parsed_response['code'];
 167                 $this->error_msg = $this->parsed_response['message'];
 168                 $this->parsed_response = false;
 169             }
 170         } else {
 171             $this->error_code = false;
 172             $this->error_msg = false;
 173         }
 174         return $this->response;
 175     }
 176
 177     function clean_text_nodes($arr) {
 178         if (!is_array($arr)) {
 179             return $arr;
 180         } elseif (count($arr) == 0) {
 181             return $arr;
 182         } elseif (count($arr) == 1 && array_key_exists('_content', $arr)) {
 183             return $arr['_content'];
 184         } else {
 185             foreach ($arr as $key => $element) {
 186                 $arr[$key] = $this->clean_text_nodes($element);
 187             }
 188             return($arr);
 189         }
 190     }
 191
 192     function setToken($token)
 193     {
 194         // Sets an authentication token to use instead of the session variable
 195         $this->token = $token;
 196     }
 197
 198     function setProxy($server, $port)
 199     {
 200         // Sets the proxy for all phpFlickr calls.
 201         //$this->req->setProxy($server, $port);
 202     }
 203
 204     function getErrorCode()
 205     {
 206         // Returns the error code of the last call.  If the last call did not
 207         // return an error. This will return a false boolean.
 208         return $this->error_code;
 209     }
 210
 211     function getErrorMsg()
 212     {
 213         // Returns the error message of the last call.  If the last call did not
 214         // return an error. This will return a false boolean.
 215         return $this->error_msg;
 216     }
 217
 218     /** These functions are front ends for the flickr calls */
 219
 220     function buildPhotoURL ($photo, $size = "Medium")
 221     {
 222         //receives an array (can use the individual photo data returned
 223         //from an API call) and returns a URL (doesn't mean that the
 224         //file size exists)
 225         $sizes = array(
 226                 "square" => "_s",
 227                 "thumbnail" => "_t",
 228                 "small" => "_m",
 229                 "medium" => "",
 230                 "large" => "_b",
 231                 "original" => "_o"
 232                 );
 233
 234         $size = strtolower($size);
 235         if (!array_key_exists($size, $sizes)) {
 236             $size = "medium";
 237         }
 238
 239         if ($size == "original") {
 240             $url = "http://farm" . $photo['farm'] . ".static.flickr.com/" . $photo['server'] . "/" . $photo['id'] . "_" . $photo['originalsecret'] . "_o" . "." . $photo['originalformat'];
 241         } else {
 242             $url = "http://farm" . $photo['farm'] . ".static.flickr.com/" . $photo['server'] . "/" . $photo['id'] . "_" . $photo['secret'] . $sizes[$size] . ".jpg";
 243         }
 244         return $url;
 245     }
 246
 247     function getFriendlyGeodata($lat, $lon) {
 248         /** I've added this method to get the friendly geodata (i.e. 'in New York, NY') that the
 249          * website provides, but isn't available in the API. I'm providing this service as long
 250          * as it doesn't flood my server with requests and crash it all the time.
 251          */
 252         return unserialize(file_get_contents('http://phpflickr.com/geodata/?format=php&lat=' . $lat . '&lon=' . $lon));
 253     }
 254
 255     function auth ($perms = "write", $remember_uri = true)
 256     {
 257
 258         debugging('The flickrlib.php cannot be used for authenticated Flickr API calls.
 259             Flickr does not support their legacy auth API any more. Use the new flickrclient.php instead.');
 260
 261         // Redirects to Flickr's authentication piece if there is no valid token.
 262         // If remember_uri is set to false, the callback script (included) will
 263         // redirect to its default page.
 264         if ($remember_uri) {
 265             $redirect = qualified_me(); // TODO: this is not used, why?
 266         }
 267         $api_sig = md5($this->secret . "api_key" . $this->api_key . "perms" . $perms);
 268         $url = 'http://www.flickr.com/services/auth/?api_key=' . $this->api_key . "&perms=" .  $perms . '&api_sig='. $api_sig;
 269         return $url;
 270     }
 271
 272     /**
 273      * To use the phpFlickr::call method, pass a string containing the API method you want
 274      * to use and an associative array of arguments.  For example:
 275      * $result = $f->call("flickr.photos.comments.getList", array("photo_id"=>'34952612'));
 276      * This method will allow you to make calls to arbitrary methods that haven't been
 277      * implemented in phpFlickr yet.
 278      */
 279
 280     function call($method, $arguments)
 281     {
 282         $this->request($method, $arguments);
 283         return $this->parsed_response ? $this->parsed_response : false;
 284     }
 285
 286     /**
 287      * These functions are the direct implementations of flickr calls.
 288      * For method documentation, including arguments, visit the address
 289      * included in a comment in the function.
 290      */
 291
 292     /** Activity methods */
 293     function activity_userComments ($per_page = NULL, $page = NULL)
 294     {
 295         /** http://www.flickr.com/services/api/flickr.activity.userComments.html */
 296         $this->request('flickr.activity.userComments', array("per_page" => $per_page, "page" => $page));
 297         return $this->parsed_response ? $this->parsed_response['items']['item'] : false;
 298     }
 299
 300     function activity_userPhotos ($timeframe = NULL, $per_page = NULL, $page = NULL)
 301     {
 302         /** http://www.flickr.com/services/api/flickr.activity.userPhotos.html */
 303         $this->request('flickr.activity.userPhotos', array("timeframe" => $timeframe, "per_page" => $per_page, "page" => $page));
 304         return $this->parsed_response ? $this->parsed_response['items']['item'] : false;
 305     }
 306
 307     /** Authentication methods */
 308     function auth_checkToken ()
 309     {
 310         /** http://www.flickr.com/services/api/flickr.auth.checkToken.html */
 311         $this->request('flickr.auth.checkToken');
 312         return $this->parsed_response ? $this->parsed_response['auth'] : false;
 313     }
 314
 315     function auth_getFrob ()
 316     {
 317         /** http://www.flickr.com/services/api/flickr.auth.getFrob.html */
 318         $this->request('flickr.auth.getFrob');
 319         return $this->parsed_response ? $this->parsed_response['frob'] : false;
 320     }
 321
 322     function auth_getFullToken ($mini_token)
 323     {
 324         /** http://www.flickr.com/services/api/flickr.auth.getFullToken.html */
 325         $this->request('flickr.auth.getFullToken', array('mini_token'=>$mini_token));
 326         return $this->parsed_response ? $this->parsed_response['auth'] : false;
 327     }
 328
 329     function auth_getToken ($frob)
 330     {
 331         /** http://www.flickr.com/services/api/flickr.auth.getToken.html */
 332         $this->request('flickr.auth.getToken', array('frob'=>$frob));
 333         $this->token = $this->parsed_response['auth']['token'];
 334         return $this->parsed_response ? $this->parsed_response['auth'] : false;
 335     }
 336
 337     /** Blogs methods */
 338     function blogs_getList ()
 339     {
 340         /** http://www.flickr.com/services/api/flickr.blogs.getList.html */
 341         $this->request('flickr.blogs.getList');
 342         return $this->parsed_response ? $this->parsed_response['blogs']['blog'] : false;
 343     }
 344
 345     function blogs_postPhoto($blog_id, $photo_id, $title, $description, $blog_password = NULL)
 346     {
 347         /** http://www.flickr.com/services/api/flickr.blogs.postPhoto.html */
 348         $this->request('flickr.blogs.postPhoto', array('blog_id'=>$blog_id, 'photo_id'=>$photo_id, 'title'=>$title, 'description'=>$description, 'blog_password'=>$blog_password), TRUE);
 349         return $this->parsed_response ? true : false;
 350     }
 351
 352     /** Contacts Methods */
 353     function contacts_getList ($filter = NULL, $page = NULL, $per_page = NULL)
 354     {
 355         /** http://www.flickr.com/services/api/flickr.contacts.getList.html */
 356         $this->request('flickr.contacts.getList', array('filter'=>$filter, 'page'=>$page, 'per_page'=>$per_page));
 357         return $this->parsed_response ? $this->parsed_response['contacts'] : false;
 358     }
 359
 360     function contacts_getPublicList($user_id, $page = NULL, $per_page = NULL)
 361     {
 362         /** http://www.flickr.com/services/api/flickr.contacts.getPublicList.html */
 363         $this->request('flickr.contacts.getPublicList', array('user_id'=>$user_id, 'page'=>$page, 'per_page'=>$per_page));
 364         return $this->parsed_response ? $this->parsed_response['contacts'] : false;
 365     }
 366
 367     /** Favorites Methods */
 368     function favorites_add ($photo_id)
 369     {
 370         /** http://www.flickr.com/services/api/flickr.favorites.add.html */
 371         $this->request('flickr.favorites.add', array('photo_id'=>$photo_id), TRUE);
 372         return $this->parsed_response ? true : false;
 373     }
 374
 375     function favorites_getList($user_id = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 376     {
 377         /** http://www.flickr.com/services/api/flickr.favorites.getList.html */
 378         if (is_array($extras)) { $extras = implode(",", $extras); }
 379         $this->request("flickr.favorites.getList", array("user_id"=>$user_id, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 380         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 381     }
 382
 383     function favorites_getPublicList($user_id = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 384     {
 385         /** http://www.flickr.com/services/api/flickr.favorites.getPublicList.html */
 386         if (is_array($extras)) {
 387             $extras = implode(",", $extras);
 388         }
 389         $this->request("flickr.favorites.getPublicList", array("user_id"=>$user_id, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 390         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 391     }
 392
 393     function favorites_remove($photo_id)
 394     {
 395         /** http://www.flickr.com/services/api/flickr.favorites.remove.html */
 396         $this->request("flickr.favorites.remove", array("photo_id"=>$photo_id), TRUE);
 397         return $this->parsed_response ? true : false;
 398     }
 399
 400     /** Groups Methods */
 401     function groups_browse ($cat_id = NULL)
 402     {
 403         /** http://www.flickr.com/services/api/flickr.groups.browse.html */
 404         $this->request("flickr.groups.browse", array("cat_id"=>$cat_id));
 405         return $this->parsed_response ? $this->parsed_response['category'] : false;
 406     }
 407
 408     function groups_getInfo ($group_id)
 409     {
 410         /** http://www.flickr.com/services/api/flickr.groups.getInfo.html */
 411         $this->request("flickr.groups.getInfo", array("group_id"=>$group_id));
 412         return $this->parsed_response ? $this->parsed_response['group'] : false;
 413     }
 414
 415     function groups_search ($text, $per_page=NULL, $page=NULL)
 416     {
 417         /** http://www.flickr.com/services/api/flickr.groups.search.html */
 418         $this->request("flickr.groups.search", array("text"=>$text,"per_page"=>$per_page,"page"=>$page));
 419         return $this->parsed_response ? $this->parsed_response['groups'] : false;
 420     }
 421
 422     /** Groups Pools Methods */
 423     function groups_pools_add ($photo_id, $group_id)
 424     {
 425         /** http://www.flickr.com/services/api/flickr.groups.pools.add.html */
 426         $this->request("flickr.groups.pools.add", array("photo_id"=>$photo_id, "group_id"=>$group_id), TRUE);
 427         return $this->parsed_response ? true : false;
 428     }
 429
 430     function groups_pools_getContext ($photo_id, $group_id)
 431     {
 432         /** http://www.flickr.com/services/api/flickr.groups.pools.getContext.html */
 433         $this->request("flickr.groups.pools.getContext", array("photo_id"=>$photo_id, "group_id"=>$group_id));
 434         return $this->parsed_response ? $this->parsed_response : false;
 435     }
 436
 437     function groups_pools_getGroups ($page = NULL, $per_page = NULL)
 438     {
 439         /** http://www.flickr.com/services/api/flickr.groups.pools.getGroups.html */
 440         $this->request("flickr.groups.pools.getGroups", array('page'=>$page, 'per_page'=>$per_page));
 441         return $this->parsed_response ? $this->parsed_response['groups'] : false;
 442     }
 443
 444     function groups_pools_getPhotos ($group_id, $tags = NULL, $user_id = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 445     {
 446         /** http://www.flickr.com/services/api/flickr.groups.pools.getPhotos.html */
 447         if (is_array($extras)) {
 448             $extras = implode(",", $extras);
 449         }
 450         $this->request("flickr.groups.pools.getPhotos", array("group_id"=>$group_id, "tags"=>$tags, "user_id"=>$user_id, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 451         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 452     }
 453
 454     function groups_pools_remove ($photo_id, $group_id)
 455     {
 456         /** http://www.flickr.com/services/api/flickr.groups.pools.remove.html */
 457         $this->request("flickr.groups.pools.remove", array("photo_id"=>$photo_id, "group_id"=>$group_id), TRUE);
 458         return $this->parsed_response ? true : false;
 459     }
 460
 461     /** Interestingness methods */
 462     function interestingness_getList($date = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 463     {
 464         /** http://www.flickr.com/services/api/flickr.interestingness.getList.html */
 465         if (is_array($extras)) {
 466             $extras = implode(",", $extras);
 467         }
 468
 469         $this->request("flickr.interestingness.getList", array("date"=>$date, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 470         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 471     }
 472
 473     /** People methods */
 474     function people_findByEmail ($find_email)
 475     {
 476         /** http://www.flickr.com/services/api/flickr.people.findByEmail.html */
 477         $this->request("flickr.people.findByEmail", array("find_email"=>$find_email));
 478         return $this->parsed_response ? $this->parsed_response['user'] : false;
 479     }
 480
 481     function people_findByUsername ($username)
 482     {
 483         /** http://www.flickr.com/services/api/flickr.people.findByUsername.html */
 484         $this->request("flickr.people.findByUsername", array("username"=>$username));
 485         return $this->parsed_response ? $this->parsed_response['user'] : false;
 486     }
 487
 488     function people_getInfo($user_id)
 489     {
 490         /** http://www.flickr.com/services/api/flickr.people.getInfo.html */
 491         $this->request("flickr.people.getInfo", array("user_id"=>$user_id));
 492         return $this->parsed_response ? $this->parsed_response['person'] : false;
 493     }
 494
 495     function people_getPublicGroups($user_id)
 496     {
 497         /** http://www.flickr.com/services/api/flickr.people.getPublicGroups.html */
 498         $this->request("flickr.people.getPublicGroups", array("user_id"=>$user_id));
 499         return $this->parsed_response ? $this->parsed_response['groups']['group'] : false;
 500     }
 501
 502     function people_getPublicPhotos($user_id, $extras = NULL, $per_page = NULL, $page = NULL) {
 503         /** http://www.flickr.com/services/api/flickr.people.getPublicPhotos.html */
 504         if (is_array($extras)) {
 505             $extras = implode(",", $extras);
 506         }
 507
 508         $this->request("flickr.people.getPublicPhotos", array("user_id"=>$user_id, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 509         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 510     }
 511
 512     function people_getUploadStatus()
 513     {
 514         /** http://www.flickr.com/services/api/flickr.people.getUploadStatus.html */
 515         /** Requires Authentication */
 516         $this->request("flickr.people.getUploadStatus");
 517         return $this->parsed_response ? $this->parsed_response['user'] : false;
 518     }
 519
 520
 521     /** Photos Methods */
 522     function photos_addTags ($photo_id, $tags)
 523     {
 524         /** http://www.flickr.com/services/api/flickr.photos.addTags.html */
 525         $this->request("flickr.photos.addTags", array("photo_id"=>$photo_id, "tags"=>$tags), TRUE);
 526         return $this->parsed_response ? true : false;
 527     }
 528
 529     function photos_delete($photo_id)
 530     {
 531         /** http://www.flickr.com/services/api/flickr.photos.delete.html */
 532         $this->request("flickr.photos.delete", array("photo_id"=>$photo_id), TRUE);
 533         return $this->parsed_response ? true : false;
 534     }
 535
 536     function photos_getAllContexts ($photo_id)
 537     {
 538         /** http://www.flickr.com/services/api/flickr.photos.getAllContexts.html */
 539         $this->request("flickr.photos.getAllContexts", array("photo_id"=>$photo_id));
 540         return $this->parsed_response ? $this->parsed_response : false;
 541     }
 542
 543     function photos_getContactsPhotos ($count = NULL, $just_friends = NULL, $single_photo = NULL, $include_self = NULL, $extras = NULL)
 544     {
 545         /** http://www.flickr.com/services/api/flickr.photos.getContactsPhotos.html */
 546         $this->request("flickr.photos.getContactsPhotos", array("count"=>$count, "just_friends"=>$just_friends, "single_photo"=>$single_photo, "include_self"=>$include_self, "extras"=>$extras));
 547         return $this->parsed_response ? $this->parsed_response['photos']['photo'] : false;
 548     }
 549
 550     function photos_getContactsPublicPhotos ($user_id, $count = NULL, $just_friends = NULL, $single_photo = NULL, $include_self = NULL, $extras = NULL)
 551     {
 552         /** http://www.flickr.com/services/api/flickr.photos.getContactsPublicPhotos.html */
 553         $this->request("flickr.photos.getContactsPublicPhotos", array("user_id"=>$user_id, "count"=>$count, "just_friends"=>$just_friends, "single_photo"=>$single_photo, "include_self"=>$include_self, "extras"=>$extras));
 554         return $this->parsed_response ? $this->parsed_response['photos']['photo'] : false;
 555     }
 556
 557     function photos_getContext ($photo_id)
 558     {
 559         /** http://www.flickr.com/services/api/flickr.photos.getContext.html */
 560         $this->request("flickr.photos.getContext", array("photo_id"=>$photo_id));
 561         return $this->parsed_response ? $this->parsed_response : false;
 562     }
 563
 564     function photos_getCounts ($dates = NULL, $taken_dates = NULL)
 565     {
 566         /** http://www.flickr.com/services/api/flickr.photos.getCounts.html */
 567         $this->request("flickr.photos.getCounts", array("dates"=>$dates, "taken_dates"=>$taken_dates));
 568         return $this->parsed_response ? $this->parsed_response['photocounts']['photocount'] : false;
 569     }
 570
 571     function photos_getExif ($photo_id, $secret = NULL)
 572     {
 573         /** http://www.flickr.com/services/api/flickr.photos.getExif.html */
 574         $this->request("flickr.photos.getExif", array("photo_id"=>$photo_id, "secret"=>$secret));
 575         return $this->parsed_response ? $this->parsed_response['photo'] : false;
 576     }
 577
 578     function photos_getFavorites($photo_id, $page = NULL, $per_page = NULL)
 579     {
 580         /** http://www.flickr.com/services/api/flickr.photos.getFavorites.html */
 581         $this->request("flickr.photos.getFavorites", array("photo_id"=>$photo_id, "page"=>$page, "per_page"=>$per_page));
 582         return $this->parsed_response ? $this->parsed_response['photo'] : false;
 583     }
 584
 585     function photos_getInfo($photo_id, $secret = NULL)
 586     {
 587         /** http://www.flickr.com/services/api/flickr.photos.getInfo.html */
 588         $this->request("flickr.photos.getInfo", array("photo_id"=>$photo_id, "secret"=>$secret));
 589         return $this->parsed_response ? $this->parsed_response['photo'] : false;
 590     }
 591
 592     function photos_getNotInSet($min_upload_date = NULL, $max_upload_date = NULL, $min_taken_date = NULL, $max_taken_date = NULL, $privacy_filter = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 593     {
 594         /** http://www.flickr.com/services/api/flickr.photos.getNotInSet.html */
 595         if (is_array($extras)) {
 596             $extras = implode(",", $extras);
 597         }
 598         $this->request("flickr.photos.getNotInSet", array("min_upload_date"=>$min_upload_date, "max_upload_date"=>$max_upload_date, "min_taken_date"=>$min_taken_date, "max_taken_date"=>$max_taken_date, "privacy_filter"=>$privacy_filter, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 599         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 600     }
 601
 602     function photos_getPerms($photo_id)
 603     {
 604         /** http://www.flickr.com/services/api/flickr.photos.getPerms.html */
 605         $this->request("flickr.photos.getPerms", array("photo_id"=>$photo_id));
 606         return $this->parsed_response ? $this->parsed_response['perms'] : false;
 607     }
 608
 609     function photos_getRecent($extras = NULL, $per_page = NULL, $page = NULL)
 610     {
 611         /** http://www.flickr.com/services/api/flickr.photos.getRecent.html */
 612
 613         if (is_array($extras)) {
 614             $extras = implode(",", $extras);
 615         }
 616         $this->request("flickr.photos.getRecent", array("extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 617         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 618     }
 619
 620     function photos_getSizes($photo_id)
 621     {
 622         /** http://www.flickr.com/services/api/flickr.photos.getSizes.html */
 623         $this->request("flickr.photos.getSizes", array("photo_id"=>$photo_id));
 624         return $this->parsed_response ? $this->parsed_response['sizes']['size'] : false;
 625     }
 626
 627     function photos_getUntagged($min_upload_date = NULL, $max_upload_date = NULL, $min_taken_date = NULL, $max_taken_date = NULL, $privacy_filter = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 628     {
 629         /** http://www.flickr.com/services/api/flickr.photos.getUntagged.html */
 630         if (is_array($extras)) {
 631             $extras = implode(",", $extras);
 632         }
 633         $this->request("flickr.photos.getUntagged", array("min_upload_date"=>$min_upload_date, "max_upload_date"=>$max_upload_date, "min_taken_date"=>$min_taken_date, "max_taken_date"=>$max_taken_date, "privacy_filter"=>$privacy_filter, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 634         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 635     }
 636
 637     function photos_getWithGeoData($args = NULL) {
 638         /** See the documentation included with the photos_search() function.
 639          * I'm using the same style of arguments for this function. The only
 640          * difference here is that this doesn't require any arguments. The
 641          * flickr.photos.search method requires at least one search parameter.
 642          */
 643         /** http://www.flickr.com/services/api/flickr.photos.getWithGeoData.html */
 644         if (is_null($args)) {
 645             $args = array();
 646         }
 647         $this->request("flickr.photos.getWithGeoData", $args);
 648         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 649     }
 650
 651     function photos_getWithoutGeoData($args = NULL) {
 652         /** See the documentation included with the photos_search() function.
 653          * I'm using the same style of arguments for this function. The only
 654          * difference here is that this doesn't require any arguments. The
 655          * flickr.photos.search method requires at least one search parameter.
 656          */
 657         /** http://www.flickr.com/services/api/flickr.photos.getWithoutGeoData.html */
 658         if (is_null($args)) {
 659             $args = array();
 660         }
 661         $this->request("flickr.photos.getWithoutGeoData", $args);
 662         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 663     }
 664
 665     function photos_recentlyUpdated($min_date = NULL, $extras = NULL, $per_page = NULL, $page = NULL)
 666     {
 667         /** http://www.flickr.com/services/api/flickr.photos.getUntagged.html */
 668         if (is_array($extras)) {
 669             $extras = implode(",", $extras);
 670         }
 671         $this->request("flickr.photos.recentlyUpdated", array("min_date"=>$min_date, "extras"=>$extras, "per_page"=>$per_page, "page"=>$page));
 672         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 673     }
 674
 675     function photos_removeTag($tag_id)
 676     {
 677         /** http://www.flickr.com/services/api/flickr.photos.removeTag.html */
 678         $this->request("flickr.photos.removeTag", array("tag_id"=>$tag_id), TRUE);
 679         return $this->parsed_response ? true : false;
 680     }
 681
 682     function photos_search($args)
 683     {
 684         /** This function strays from the method of arguments that I've
 685          * used in the other functions for the fact that there are just
 686          * so many arguments to this API method. What you'll need to do
 687          * is pass an associative array to the function containing the
 688          * arguments you want to pass to the API.  For example:
 689          *   $photos = $f->photos_search(array("tags"=>"brown,cow", "tag_mode"=>"any"));
 690          * This will return photos tagged with either "brown" or "cow"
 691          * or both. See the API documentation (link below) for a full
 692          * list of arguments.
 693          */
 694
 695         /** http://www.flickr.com/services/api/flickr.photos.search.html */
 696         $this->request("flickr.photos.search", $args);
 697         return $this->parsed_response ? $this->parsed_response['photos'] : false;
 698     }
 699
 700     function photos_setContentType ($photo_id, $content_type) {
 701         /** http://www.flickr.com/services/api/flickr.photos.setContentType.html */
 702         return $this->call('flickr.photos.setContentType', array('photo_id' => $photo_id, 'content_type' => $content_type));
 703     }
 704
 705     function photos_setDates($photo_id, $date_posted = NULL, $date_taken = NULL, $date_taken_granularity = NULL)
 706     {
 707         /** http://www.flickr.com/services/api/flickr.photos.setDates.html */
 708         $this->request("flickr.photos.setDates", array("photo_id"=>$photo_id, "date_posted"=>$date_posted, "date_taken"=>$date_taken, "date_taken_granularity"=>$date_taken_granularity), TRUE);
 709         return $this->parsed_response ? true : false;
 710     }
 711
 712     function photos_setMeta($photo_id, $title, $description)
 713     {
 714         /** http://www.flickr.com/services/api/flickr.photos.setMeta.html */
 715         $this->request("flickr.photos.setMeta", array("photo_id"=>$photo_id, "title"=>$title, "description"=>$description), TRUE);
 716         return $this->parsed_response ? true : false;
 717     }
 718
 719     function photos_setPerms($photo_id, $is_public, $is_friend, $is_family, $perm_comment, $perm_addmeta)
 720     {
 721         /** http://www.flickr.com/services/api/flickr.photos.setPerms.html */
 722         $this->request("flickr.photos.setPerms", array("photo_id"=>$photo_id, "is_public"=>$is_public, "is_friend"=>$is_friend, "is_family"=>$is_family, "perm_comment"=>$perm_comment, "perm_addmeta"=>$perm_addmeta), TRUE);
 723         return $this->parsed_response ? true : false;
 724     }
 725
 726     function photos_setSafetyLevel ($photo_id, $safety_level, $hidden = null) {
 727         /** http://www.flickr.com/services/api/flickr.photos.setSafetyLevel.html */
 728         return $this->call('flickr.photos.setSafetyLevel', array('photo_id' => $photo_id, 'safety_level' => $safety_level, 'hidden' => $hidden));
 729     }
 730
 731
 732     function photos_setTags($photo_id, $tags)
 733     {
 734         /** http://www.flickr.com/services/api/flickr.photos.setTags.html */
 735         $this->request("flickr.photos.setTags", array("photo_id"=>$photo_id, "tags"=>$tags), TRUE);
 736         return $this->parsed_response ? true : false;
 737     }
 738
 739     /** Photos - Comments Methods */
 740     function photos_comments_addComment($photo_id, $comment_text) {
 741         /** http://www.flickr.com/services/api/flickr.photos.comments.addComment.html */
 742         $this->request("flickr.photos.comments.addComment", array("photo_id" => $photo_id, "comment_text"=>$comment_text), TRUE);
 743         return $this->parsed_response ? $this->parsed_response['comment'] : false;
 744     }
 745
 746     function photos_comments_deleteComment($comment_id) {
 747         /** http://www.flickr.com/services/api/flickr.photos.comments.deleteComment.html */
 748         $this->request("flickr.photos.comments.deleteComment", array("comment_id" => $comment_id), TRUE);
 749         return $this->parsed_response ? true : false;
 750     }
 751
 752     function photos_comments_editComment($comment_id, $comment_text) {
 753         /** http://www.flickr.com/services/api/flickr.photos.comments.editComment.html */
 754         $this->request("flickr.photos.comments.editComment", array("comment_id" => $comment_id, "comment_text"=>$comment_text), TRUE);
 755         return $this->parsed_response ? true : false;
 756     }
 757
 758     function photos_comments_getList($photo_id)
 759     {
 760         /** http://www.flickr.com/services/api/flickr.photos.comments.getList.html */
 761         $this->request("flickr.photos.comments.getList", array("photo_id"=>$photo_id));
 762         return $this->parsed_response ? $this->parsed_response['comments'] : false;
 763     }
 764
 765     /** Photos - Geo Methods */
 766     function photos_geo_getLocation($photo_id)
 767     {
 768         /** http://www.flickr.com/services/api/flickr.photos.geo.getLocation.html */
 769         $this->request("flickr.photos.geo.getLocation", array("photo_id"=>$photo_id));
 770         return $this->parsed_response ? $this->parsed_response['photo'] : false;
 771     }
 772
 773     function photos_geo_getPerms($photo_id)
 774     {
 775         /** http://www.flickr.com/services/api/flickr.photos.geo.getPerms.html */
 776         $this->request("flickr.photos.geo.getPerms", array("photo_id"=>$photo_id));
 777         return $this->parsed_response ? $this->parsed_response['perms'] : false;
 778     }
 779
 780     function photos_geo_removeLocation($photo_id)
 781     {
 782         /** http://www.flickr.com/services/api/flickr.photos.geo.removeLocation.html */
 783         $this->request("flickr.photos.geo.removeLocation", array("photo_id"=>$photo_id), TRUE);
 784         return $this->parsed_response ? true : false;
 785     }
 786
 787     function photos_geo_setLocation($photo_id, $lat, $lon, $accuracy = NULL)
 788     {
 789         /** http://www.flickr.com/services/api/flickr.photos.geo.setLocation.html */
 790         $this->request("flickr.photos.geo.setLocation", array("photo_id"=>$photo_id, "lat"=>$lat, "lon"=>$lon, "accuracy"=>$accuracy), TRUE);
 791         return $this->parsed_response ? true : false;
 792     }
 793
 794     function photos_geo_setPerms($photo_id, $is_public, $is_contact, $is_friend, $is_family)
 795     {
 796         /** http://www.flickr.com/services/api/flickr.photos.geo.setPerms.html */
 797         $this->request("flickr.photos.geo.setPerms", array("photo_id"=>$photo_id, "is_public"=>$is_public, "is_contact"=>$is_contact, "is_friend"=>$is_friend, "is_family"=>$is_family), TRUE);
 798         return $this->parsed_response ? true : false;
 799     }
 800
 801     /** Photos - Licenses Methods */
 802     function photos_licenses_getInfo()
 803     {
 804         /** http://www.flickr.com/services/api/flickr.photos.licenses.getInfo.html */
 805         $this->request("flickr.photos.licenses.getInfo");
 806         return $this->parsed_response ? $this->parsed_response['licenses']['license'] : false;
 807     }
 808
 809     function photos_licenses_setLicense($photo_id, $license_id)
 810     {
 811         /** http://www.flickr.com/services/api/flickr.photos.licenses.setLicense.html */
 812         /** Requires Authentication */
 813         $this->request("flickr.photos.licenses.setLicense", array("photo_id"=>$photo_id, "license_id"=>$license_id), TRUE);
 814         return $this->parsed_response ? true : false;
 815     }
 816
 817     /** Photos - Notes Methods */
 818     function photos_notes_add($photo_id, $note_x, $note_y, $note_w, $note_h, $note_text)
 819     {
 820         /** http://www.flickr.com/services/api/flickr.photos.notes.add.html */
 821         $this->request("flickr.photos.notes.add", array("photo_id" => $photo_id, "note_x" => $note_x, "note_y" => $note_y, "note_w" => $note_w, "note_h" => $note_h, "note_text" => $note_text), TRUE);
 822         return $this->parsed_response ? $this->parsed_response['note'] : false;
 823     }
 824
 825     function photos_notes_delete($note_id)
 826     {
 827         /** http://www.flickr.com/services/api/flickr.photos.notes.delete.html */
 828         $this->request("flickr.photos.notes.delete", array("note_id" => $note_id), TRUE);
 829         return $this->parsed_response ? true : false;
 830     }
 831
 832     function photos_notes_edit($note_id, $note_x, $note_y, $note_w, $note_h, $note_text)
 833     {
 834         /** http://www.flickr.com/services/api/flickr.photos.notes.edit.html */
 835         $this->request("flickr.photos.notes.edit", array("note_id" => $note_id, "note_x" => $note_x, "note_y" => $note_y, "note_w" => $note_w, "note_h" => $note_h, "note_text" => $note_text), TRUE);
 836         return $this->parsed_response ? true : false;
 837     }
 838
 839     /** Photos - Transform Methods */
 840     function photos_transform_rotate($photo_id, $degrees)
 841     {
 842         /** http://www.flickr.com/services/api/flickr.photos.transform.rotate.html */
 843         $this->request("flickr.photos.transform.rotate", array("photo_id" => $photo_id, "degrees" => $degrees), TRUE);
 844         return $this->parsed_response ? true : false;
 845     }
 846
 847     /** Photos - Upload Methods */
 848     function photos_upload_checkTickets($tickets)
 849     {
 850         /** http://www.flickr.com/services/api/flickr.photos.upload.checkTickets.html */
 851         if (is_array($tickets)) {
 852             $tickets = implode(",", $tickets);
 853         }
 854         $this->request("flickr.photos.upload.checkTickets", array("tickets" => $tickets), TRUE);
 855         return $this->parsed_response ? $this->parsed_response['uploader']['ticket'] : false;
 856     }
 857
 858     /** Photosets Methods */
 859     function photosets_addPhoto($photoset_id, $photo_id)
 860     {
 861         /** http://www.flickr.com/services/api/flickr.photosets.addPhoto.html */
 862         $this->request("flickr.photosets.addPhoto", array("photoset_id" => $photoset_id, "photo_id" => $photo_id), TRUE);
 863         return $this->parsed_response ? true : false;
 864     }
 865
 866     function photosets_create($title, $description, $primary_photo_id)
 867     {
 868         /** http://www.flickr.com/services/api/flickr.photosets.create.html */
 869         $this->request("flickr.photosets.create", array("title" => $title, "primary_photo_id" => $primary_photo_id, "description" => $description), TRUE);
 870         return $this->parsed_response ? $this->parsed_response['photoset'] : false;
 871     }
 872
 873     function photosets_delete($photoset_id)
 874     {
 875         /** http://www.flickr.com/services/api/flickr.photosets.delete.html */
 876         $this->request("flickr.photosets.delete", array("photoset_id" => $photoset_id), TRUE);
 877         return $this->parsed_response ? true : false;
 878     }
 879
 880     function photosets_editMeta($photoset_id, $title, $description = NULL)
 881     {
 882         /** http://www.flickr.com/services/api/flickr.photosets.editMeta.html */
 883         $this->request("flickr.photosets.editMeta", array("photoset_id" => $photoset_id, "title" => $title, "description" => $description), TRUE);
 884         return $this->parsed_response ? true : false;
 885     }
 886
 887     function photosets_editPhotos($photoset_id, $primary_photo_id, $photo_ids)
 888     {
 889         /** http://www.flickr.com/services/api/flickr.photosets.editPhotos.html */
 890         $this->request("flickr.photosets.editPhotos", array("photoset_id" => $photoset_id, "primary_photo_id" => $primary_photo_id, "photo_ids" => $photo_ids), TRUE);
 891         return $this->parsed_response ? true : false;
 892     }
 893
 894     function photosets_getContext($photo_id, $photoset_id)
 895     {
 896         /** http://www.flickr.com/services/api/flickr.photosets.getContext.html */
 897         $this->request("flickr.photosets.getContext", array("photo_id" => $photo_id, "photoset_id" => $photoset_id));
 898         return $this->parsed_response ? $this->parsed_response : false;
 899     }
 900
 901     function photosets_getInfo($photoset_id)
 902     {
 903         /** http://www.flickr.com/services/api/flickr.photosets.getInfo.html */
 904         $this->request("flickr.photosets.getInfo", array("photoset_id" => $photoset_id));
 905         return $this->parsed_response ? $this->parsed_response['photoset'] : false;
 906     }
 907
 908     function photosets_getList($user_id = NULL)
 909     {
 910         /** http://www.flickr.com/services/api/flickr.photosets.getList.html */
 911         $this->request("flickr.photosets.getList", array("user_id" => $user_id));
 912         return $this->parsed_response ? $this->parsed_response['photosets'] : false;
 913     }
 914
 915     function photosets_getPhotos($photoset_id, $extras = NULL, $privacy_filter = NULL, $per_page = NULL, $page = NULL)
 916     {
 917         /** http://www.flickr.com/services/api/flickr.photosets.getPhotos.html */
 918         $this->request("flickr.photosets.getPhotos", array("photoset_id" => $photoset_id, "extras" => $extras, "privacy_filter" => $privacy_filter, "per_page" => $per_page, "page" => $page));
 919         return $this->parsed_response ? $this->parsed_response['photoset'] : false;
 920     }
 921
 922     function photosets_orderSets($photoset_ids)
 923     {
 924         /** http://www.flickr.com/services/api/flickr.photosets.orderSets.html */
 925         if (is_array($photoset_ids)) {
 926             $photoset_ids = implode(",", $photoset_ids);
 927         }
 928         $this->request("flickr.photosets.orderSets", array("photoset_ids" => $photoset_ids), TRUE);
 929         return $this->parsed_response ? true : false;
 930     }
 931
 932     function photosets_removePhoto($photoset_id, $photo_id)
 933     {
 934         /** http://www.flickr.com/services/api/flickr.photosets.removePhoto.html */
 935         $this->request("flickr.photosets.removePhoto", array("photoset_id" => $photoset_id, "photo_id" => $photo_id), TRUE);
 936         return $this->parsed_response ? true : false;
 937     }
 938
 939     /** Photosets Comments Methods */
 940     function photosets_comments_addComment($photoset_id, $comment_text) {
 941         /** http://www.flickr.com/services/api/flickr.photosets.comments.addComment.html */
 942         $this->request("flickr.photosets.comments.addComment", array("photoset_id" => $photoset_id, "comment_text"=>$comment_text), TRUE);
 943         return $this->parsed_response ? $this->parsed_response['comment'] : false;
 944     }
 945
 946     function photosets_comments_deleteComment($comment_id) {
 947         /** http://www.flickr.com/services/api/flickr.photosets.comments.deleteComment.html */
 948         $this->request("flickr.photosets.comments.deleteComment", array("comment_id" => $comment_id), TRUE);
 949         return $this->parsed_response ? true : false;
 950     }
 951
 952     function photosets_comments_editComment($comment_id, $comment_text) {
 953         /** http://www.flickr.com/services/api/flickr.photosets.comments.editComment.html */
 954         $this->request("flickr.photosets.comments.editComment", array("comment_id" => $comment_id, "comment_text"=>$comment_text), TRUE);
 955         return $this->parsed_response ? true : false;
 956     }
 957
 958     function photosets_comments_getList($photoset_id)
 959     {
 960         /** http://www.flickr.com/services/api/flickr.photosets.comments.getList.html */
 961         $this->request("flickr.photosets.comments.getList", array("photoset_id"=>$photoset_id));
 962         return $this->parsed_response ? $this->parsed_response['comments'] : false;
 963     }
 964
 965     /** Places Methods */
 966     function places_resolvePlaceId ($place_id) {
 967         /** http://www.flickr.com/services/api/flickr.places.resolvePlaceId.html */
 968         $rsp = $this->call('flickr.places.resolvePlaceId', array('place_id' => $place_id));
 969         return $rsp ? $rsp['location'] : $rsp;
 970     }
 971
 972     function places_resolvePlaceURL ($url) {
 973         /** http://www.flickr.com/services/api/flickr.places.resolvePlaceURL.html */
 974         $rsp = $this->call('flickr.places.resolvePlaceURL', array('url' => $url));
 975         return $rsp ? $rsp['location'] : $rsp;
 976     }
 977
 978     /** Prefs Methods */
 979     function prefs_getContentType () {
 980         /** http://www.flickr.com/services/api/flickr.prefs.getContentType.html */
 981         $rsp = $this->call('flickr.prefs.getContentType', array());
 982         return $rsp ? $rsp['person'] : $rsp;
 983     }
 984
 985     function prefs_getHidden () {
 986         /** http://www.flickr.com/services/api/flickr.prefs.getHidden.html */
 987         $rsp = $this->call('flickr.prefs.getHidden', array());
 988         return $rsp ? $rsp['person'] : $rsp;
 989     }
 990
 991     function prefs_getPrivacy () {
 992         /** http://www.flickr.com/services/api/flickr.prefs.getPrivacy.html */
 993         $rsp = $this->call('flickr.prefs.getPrivacy', array());
 994         return $rsp ? $rsp['person'] : $rsp;
 995     }
 996
 997     function prefs_getSafetyLevel () {
 998         /** http://www.flickr.com/services/api/flickr.prefs.getSafetyLevel.html */
 999         $rsp = $this->call('flickr.prefs.getSafetyLevel', array());
1000         return $rsp ? $rsp['person'] : $rsp;
1001     }
1002
1003     /** Reflection Methods */
1004     function reflection_getMethodInfo($method_name)
1005     {
1006         /** http://www.flickr.com/services/api/flickr.reflection.getMethodInfo.html */
1007         $this->request("flickr.reflection.getMethodInfo", array("method_name" => $method_name));
1008         return $this->parsed_response ? $this->parsed_response : false;
1009     }
1010
1011     function reflection_getMethods()
1012     {
1013         /** http://www.flickr.com/services/api/flickr.reflection.getMethods.html */
1014         $this->request("flickr.reflection.getMethods");
1015         return $this->parsed_response ? $this->parsed_response['methods']['method'] : false;
1016     }
1017
1018     /** Tags Methods */
1019     function tags_getHotList($period = NULL, $count = NULL)
1020     {
1021         /** http://www.flickr.com/services/api/flickr.tags.getHotList.html */
1022         $this->request("flickr.tags.getHotList", array("period" => $period, "count" => $count));
1023         return $this->parsed_response ? $this->parsed_response['hottags'] : false;
1024     }
1025
1026     function tags_getListPhoto($photo_id)
1027     {
1028         /** http://www.flickr.com/services/api/flickr.tags.getListPhoto.html */
1029         $this->request("flickr.tags.getListPhoto", array("photo_id" => $photo_id));
1030         return $this->parsed_response ? $this->parsed_response['photo']['tags']['tag'] : false;
1031     }
1032
1033     function tags_getListUser($user_id = NULL)
1034     {
1035         /** http://www.flickr.com/services/api/flickr.tags.getListUser.html */
1036         $this->request("flickr.tags.getListUser", array("user_id" => $user_id));
1037         return $this->parsed_response ? $this->parsed_response['who']['tags']['tag'] : false;
1038     }
1039
1040     function tags_getListUserPopular($user_id = NULL, $count = NULL)
1041     {
1042         /** http://www.flickr.com/services/api/flickr.tags.getListUserPopular.html */
1043         $this->request("flickr.tags.getListUserPopular", array("user_id" => $user_id, "count" => $count));
1044         return $this->parsed_response ? $this->parsed_response['who']['tags']['tag'] : false;
1045     }
1046
1047     function tags_getListUserRaw($tag)
1048     {
1049         /** http://www.flickr.com/services/api/flickr.tags.getListUserRaw.html */
1050         $this->request("flickr.tags.getListUserRaw", array("tag" => $tag));
1051         return $this->parsed_response ? $this->parsed_response['who']['tags']['tag'][0]['raw'] : false;
1052     }
1053
1054     function tags_getRelated($tag)
1055     {
1056         /** http://www.flickr.com/services/api/flickr.tags.getRelated.html */
1057         $this->request("flickr.tags.getRelated", array("tag" => $tag));
1058         return $this->parsed_response ? $this->parsed_response['tags'] : false;
1059     }
1060
1061     function test_echo($args = array())
1062     {
1063         /** http://www.flickr.com/services/api/flickr.test.echo.html */
1064         $this->request("flickr.test.echo", $args);
1065         return $this->parsed_response ? $this->parsed_response : false;
1066     }
1067
1068     function test_login()
1069     {
1070         /** http://www.flickr.com/services/api/flickr.test.login.html */
1071         $this->request("flickr.test.login");
1072         return $this->parsed_response ? $this->parsed_response['user'] : false;
1073     }
1074
1075     function urls_getGroup($group_id)
1076     {
1077         /** http://www.flickr.com/services/api/flickr.urls.getGroup.html */
1078         $this->request("flickr.urls.getGroup", array("group_id"=>$group_id));
1079         return $this->parsed_response ? $this->parsed_response['group']['url'] : false;
1080     }
1081
1082     function urls_getUserPhotos($user_id = NULL)
1083     {
1084         /** http://www.flickr.com/services/api/flickr.urls.getUserPhotos.html */
1085         $this->request("flickr.urls.getUserPhotos", array("user_id"=>$user_id));
1086         return $this->parsed_response ? $this->parsed_response['user']['url'] : false;
1087     }
1088
1089     function urls_getUserProfile($user_id = NULL)
1090     {
1091         /** http://www.flickr.com/services/api/flickr.urls.getUserProfile.html */
1092         $this->request("flickr.urls.getUserProfile", array("user_id"=>$user_id));
1093         return $this->parsed_response ? $this->parsed_response['user']['url'] : false;
1094     }
1095
1096     function urls_lookupGroup($url)
1097     {
1098         /** http://www.flickr.com/services/api/flickr.urls.lookupGroup.html */
1099         $this->request("flickr.urls.lookupGroup", array("url"=>$url));
1100         return $this->parsed_response ? $this->parsed_response['group'] : false;
1101     }
1102
1103     function urls_lookupUser($url)
1104     {
1105         /** http://www.flickr.com/services/api/flickr.photos.notes.edit.html */
1106         $this->request("flickr.urls.lookupUser", array("url"=>$url));
1107         return $this->parsed_response ? $this->parsed_response['user'] : false;
1108     }
1109
1110     /**
1111      * Upload a photo from Moodle file pool to Flickr
1112      *
1113      * Optional meta information are title, description, tags, is_public, is_friend, is_family, safety_level,
1114      * content_type and hidden {@see http://www.flickr.com/services/api/upload.api.html}
1115      *
1116      * @param stored_file $photo stored in Moodle file pool
1117      * @param array $meta optional meta information
1118      * @return boolean
1119      */
1120     function upload(stored_file $photo, array $meta = array()) {
1121
1122         $args = array();
1123
1124         $args['title']          = isset($meta['title']) ? $meta['title'] : null;
1125         $args['description']    = isset($meta['description']) ? $meta['description'] : null;
1126         $args['tags']           = isset($meta['tags']) ? $meta['tags'] : null;
1127         $args['is_public']      = isset($meta['is_public']) ? $meta['is_public'] : 0;
1128         $args['is_friend']      = isset($meta['is_friend']) ? $meta['is_friend'] : 0;
1129         $args['is_family']      = isset($meta['is_family']) ? $meta['is_family'] : 0;
1130         $args['safety_level']   = isset($meta['safety_level']) ? $meta['safety_level'] : 1; // safe by default
1131         $args['content_type']   = isset($meta['content_type']) ? $meta['content_type'] : 1; // photo by default
1132         $args['hidden']         = isset($meta['hidden']) ? $meta['hidden'] : 2;             // hide from public searches by default
1133
1134         // Do not enable the asynchronous more because then the query does not return a photo ID,
1135         // and we need a photo ID to add the photo to a set later on.
1136         // $args['async'] = 1;
1137         $args['api_key'] = $this->api_key;
1138
1139         if (!empty($this->token)) {
1140             $args['auth_token'] = $this->token;
1141         }
1142
1143         // sign the arguments using the shared secret
1144         ksort($args);
1145         $auth_sig = '';
1146         foreach ($args as $key => $data) {
1147             if (!is_null($data)) {
1148                 $auth_sig .= $key . $data;
1149             } else {
1150                 unset($args[$key]);
1151             }
1152         }
1153         if (!empty($this->secret)) {
1154             $api_sig = md5($this->secret . $auth_sig);
1155             $args['api_sig'] = $api_sig;
1156         }
1157
1158         $args['photo'] = $photo; // $this->curl will process it correctly
1159
1160         if ($response = $this->curl->post($this->Upload, $args)) {
1161             $xml = simplexml_load_string($response);
1162             if ($xml['stat'] == 'fail') {
1163                 $this->parsed_response = array('stat' => (string) $xml['stat'], 'code' => (int) $xml->err['code'],
1164                     'message' => (string) $xml->err['msg']);
1165             } elseif ($xml['stat'] == 'ok') {
1166                 $this->parsed_response = array('stat' => (string) $xml['stat'], 'photoid' => (int) $xml->photoid);
1167             }
1168             return true;
1169         } else {
1170             $this->parsed_response = array('stat' => 'fail', 'code' => $this->curl->get_errno(),
1171                 'message' => $this->curl->error);
1172             return false;
1173         }
1174     }
1175 }