sledgehammer / facebook
Sledgehammer Facebook module. An OOP layer on top of the official Facebook SDK.
12.10.2
2012-10-17 15:11 UTC
Requires
This package is auto-updated.
Last update: 2024-11-17 22:06:38 UTC
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.
Improvements in the Facebook class.
- 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.
Idea's / Todo
- 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