README

Object oriented API for using Facebook's Social Graph.

Features

Autocompletion for common facebook objects.
Automaticly fetches all allowed fields.
Gives hint which permissions are missing when you access a (maybe) not-allowed property or connection.
Fetches connected objects as properties. $me->friends
Connected objects are Collection object, for easy filtering & sorting. $me->friends->orderBy('last_name');
Caches userfields and friends when using the FacebookUser object for improved performance.
Lazily fetches objectdata. No api calls for data you don't use.

Easy login() or automatic login.
shorthand for get/post/delete requests. Example: Facebook::get('me')
shorthand for executing a fql query.
Validates requested permissions.
Logs api calls and measures executionTime.
api() accepts $parameters['fields'] as an array.
all() fetches multiple pages in a paginated result and returns the merged array.
Singleton pattern, access Facebook from anywhere in your application.
Add "local_cache"=> true to the parameters and the the results of the api call are cached.

notice() when the (automatic) pageLimit is reached.
Implement all documented facebook entities & connections.
Implement writing api as methods in the GraphObject.
Implement ActiveRecord methods. save(), delete()
Greedy mode (vs Strict mode) which retrieves all fields we might*1 have access to. (*1: depends on privacy settings)
Ability to make asynchronous requests. "async" => true