Change Log

Release date: 2005-08-26

• Reworked most of the photo sorting. Phlickr_PhotoSorter uses a Phlickr_Framework_IPhotoSortStrategy instead of the Phlickr_Framework_IPhotoComparator. The implementations have been moved from Phlickr/PhotoComparators to Phlickr/PhotoSortStrategy which is longer but more descriptive.

• Added Phlickr_Api::saveAs() and Phlickr_Api::createFrom() methods to allow the Api settings to be saved and loaded.
• Added Phlickr_Api::getCacheFilename() and setCacheFilename() to simplify the loading and saving of the cached data to a file. When Phlickr_Api::__destruct() is called the cache is saved to the file.
• Added getXml() to most wrapper objects (Phlickr_Photo, Phlickr_AuthedUser, etc) so you can access the underlying XML.
• Added getRawTags() to Phlickr_Photo.

• Added getRequestMethodName() and getRequestMethodParams() to Phlickr_Photoset and Phlickr_PhotosetList.

Release date: 2005-07-18

• Made a bunch of big changes to Phlickr_Api and Phlickr_Request to implement the new Flickr authentication mechanism. It’s a pain in the ass to use but we’ll all suffer together.
• Renamed Phlickr_Api::isValidAuth() to isAuthValid().
• Phlickr_Api::__construct() takes very different parameters

• Changed Phlickr_Cache to add support for expiring items from the cache.
• Added $allowCached parameter to Phlickr_Api::executeMethod().

• Added getSizes() to Phlickr_Photo.
• Changed Phlickr_Photo::buildImgUrl() to use getSizes() to find the proper file type when building URLs to the original image.

• Phlickr_PhotoListIterator now implements Phlickr_Framework_IPhotoList effectively “flattening” a paged photo list.
• Added Phlickr_PhotoListIterator::getCount(), getIds(), and getPhotos() which pull the number of photos on all the pages, the photo ids from all the pages, and the photos from all the pages respectively.
• Renamed Phlickr_PhotoList::getPhotosForPage() to getPhotosFromPage(). The function wasn’t really a “public” function so it shouldn’t cause too many problems.
• Added Phlickr_PhotoList::getIdsFromPage().
• Removed the static from Phlickr_PhotoList::requestXml() and reworked some of the parameters.

• Created Phlickr_Framework_IPhotoComparator interface.
• Created Phlickr_PhotoSorter to sort photos using a Phlickr_Framework_IPhotoComparator.
• Created Phlickr_Comparators_PhotoById to sort photos by their id (which should be the same as upload order).
• Created Phlickr_Comparators_PhotoByTitle to sort photos by their title.
• Created Phlickr_Comparators_PhotoByColor to sort photos by their color. It works well enough to be interesting.

• Added getRequestMethodName() and getRequestMethodParams() to Phlickr_Photoset and Phlickr_PhotosetList.

As always, I’ve continued to make improvements in the documentation.

Release date: 2005-07-03

• Added Phlickr_AuthedPhoto→setTaken() and setPosted().
• Added Phlickr_Photo→getTakenDate() and getPostedDate() to return a formated date string.
• Making some changed to the way Phlickr_Uploader works. I’m trying to remove the number of parameters to Upload(). Added setPerms() to assign and isForPublic(), isForFriends(), and isForFamily() to view the permissions assigned to each photo uploaded. Added setTags() and getTags() to specify tags that should be added to each and every photo. Any tags passed into upload() will be appended to the end of getTags()’s list.
• Added Phlickr_Photo::isForPublic(), isForFriends(), and isForFamily() to allow you to check the visibility of photos.
• Started adding @since tags to the PHPDoc comments.
• Added an optional dependency for the GD library. I’m planning some stuff that sorts by color.

• Phlickr_AuthedPhotosetList→create() was returning a Phlickr_Photoset instead of an Phlickr_AuthedPhotoset.

As always, I’ve continued to make improvements in the documentation.

Release date: 2005-06-19

• Forked the modifiers in Phlickr_Photo to Phlickr_AuthedPhoto.
• Renamed Phlickr_Photoset and Phlickr_AuthedPhotoset’s getOwnerId() method to getUserId().
• Renamed Phlickr_Photo and Phlickr_AuthedPhoto’s getOwnerId() to method to getUserId().

• Added getPostedTimestamp(), getTakenGranularity() and getTakenTimestamp() to Phlickr_Photo to allow access to a photo’s dates.
• Added getRealname() to Phlickr_User.
• Created Phlickr_UserList class.
• Created Phlickr_AuthedGroup class and added add() and remove() methods.
• Added getContactUserList() to Phlickr_User and Phlickr_AuthedUser.
• Modified Phlickr_User→getGroupList() to return private groups.
• Added the saveAs() and loadFrom() methods to the Phlickr_Cache class to simplify the process of saving cached data between sessions.

• Added code to Phlickr_GroupList to work Flickr’s inconsistent naming of id fields in the group lists.
• Refactored some of the XML element name passing internals.

Release date: 2005-05-28

• Forked the modifiers in Phlickr_Photoset to Phlickr_AuthedPhotoset. This breaks backwards compatibility.
• Added saveAs() to Phlickr_Photo.
• Continued work on improving documentation.
• Added a bunch of files that had been missing from the package.

Release date: 2005-05-25

• Forked the modifiers in Phlickr_PhotosetList to Phlickr_AuthedPhotosetList. This breaks backwards compatibility.
• Added getPhotoCount() to Phlickr_Photoset.
• Continued work on improving documentation.
• Modified Phlickr_Request in response to Flickr’s new requirement that all setter requests be POSTed.

Release date: 2005-05-16

• Worked on fixing a page switching bug in Phlickr_PhotoList.
• Fixed a bug in Phlickr_Photo::buildImgUrl(). I didn’t understand that the ‘-’ in the Flickr API indicated a null.
• Added Phlickr_Photo::SIZE_* constants to specify the image size for Phlickr_Photo::buildImgUrl().
• Refactored Phlickr_PhotoList to remove the inheritance of Phlickr_Framework_ListBase and open it up for an iterator.
• Extracted an interface (Phlickr_Framework_IList) from Phlickr_Framework_ListBase. All lists now implement it.
• Created the Phlickr_PhotoListIterator class. It makes it much easier to deal with the photo lists.
• Added Phlickr_Group::findbyUrl() to instantiate a group based on its URL.
• Continued work on improving documentation.

Release date: 2005-05-07

• Added addFavorite() and removeFavorite() to Phlickr_AuthedUser class.
• Worked on improving caching in Phlickr_PhotoList.
• Modified Phlickr_Photoset→editPhotos() to return a Phlickr_PhotosetPhotoList instead of void.
• Added findByUsername(), findByEmail(), and findByUrl() methods to the Phlickr_User class.
• Added Phlickr_PhotoList→getRandomPhoto().
• Worked on improving the PHPDoc comments. Starting to add examples.

Release date: 2005-04-25

• Added Phlickr_AuthedUser class.
• Added request caching with Phlickr_Cache.
• Modified most classes to make use of the caching.
• Added Phlickr_PhotosetPhotoList→getRandomPhoto().
• Modified unit tests to use cached results instead of the Phlickr_Tests_Mocks_Api class.

Release date: 2005-03-27

• Added Phlickr_Group→getPhotoList().
• Added Phlickr_PhotoList→getPageCount().
• Fixed a bug in the Phlickr_Group that prevented it from loading a group.

Release date: 2005-03-23

• Added the Group and GroupList objects.
• Refactored a bunch of stuff up into the ObjectBase and ListBase classes.

Release date: 2005-03-19

• Added User→getFavoritePhotoList() and User→getPhotoList().
• PhotosetList now requires a User Id.

Release date: 2005-03-16

• Created a Framework directory for abstract classes and interfaces. Move files into it and updated names.
• Added PHPUnit2 tests to the package.

Release date: 2005-03-16

• Fixed bugs in Phlickr_PhotoList.
• Created Phlickr_PhotosetPhotoList.
• Finished implementing Phlickr_Photoset.

Release date: 2005-03-09

First public release.

Features that are “finished”:

• Synchronous photo uploads.
• API Requests and Responses.
• Objects to wrap users, photos, photosets and photo lists.