[24bd860] | 1 | NAME |
---|
| 2 | Facebook.par - Facebook support for BarnOwl |
---|
| 3 | |
---|
| 4 | DESCRIPTION |
---|
| 5 | The Facebook module implements Facebook support for BarnOwl. |
---|
| 6 | |
---|
| 7 | SYNOPSIS |
---|
[e1ed6f4] | 8 | (1) Run ":reload-module Facebook" inside BarnOwl, if the module has |
---|
| 9 | not been loaded already. |
---|
[24bd860] | 10 | |
---|
[e1ed6f4] | 11 | (2) Run ':facebook-auth'. Follow the instructions in the admin |
---|
| 12 | message. BarnOwl will ask you to log in via an OAuth URL, and run |
---|
| 13 | ':facebook-auth $URL' where $URL is the URL you were redirected to. |
---|
[24bd860] | 14 | |
---|
[f4037cf] | 15 | This token will persist across BarnOwls until you change your |
---|
[24bd860] | 16 | Facebook password or you revoke permissions for Barnowl at: |
---|
| 17 | http://www.facebook.com/settings/?tab=applications&app_id=235537266461636 |
---|
| 18 | |
---|
[e1ed6f4] | 19 | (3) Start receiving wall updates in Barnowl! |
---|
[01d186f] | 20 | You can post updates with the ":facebook" command. |
---|
| 21 | |
---|
| 22 | INFELICITIES |
---|
| 23 | * BarnOwl will not receive all comments for news feed items, only |
---|
| 24 | comments for items that were recently published. There is not |
---|
| 25 | currently a way to see starks for conversations that you did not |
---|
| 26 | participate in, and the only way to see starks for conversations |
---|
| 27 | you did participate in are Facebook's email notifications. (This |
---|
| 28 | is a deficiency of the Facebook API, see http://bugs.developers.facebook.net/show_bug.cgi?id=18594.) |
---|
| 29 | |
---|
| 30 | * By default, BarnOwl will not display posts from organizations (such |
---|
| 31 | as bands you have liked) or application invites. This is a |
---|
| 32 | judgment of taste from the original author. This is not currently |
---|
| 33 | configurable. |
---|
| 34 | |
---|
| 35 | * Users and applications that you have hidden via the Facebook |
---|
| 36 | web interface will show up in the BarnOwl stream. (This appears to |
---|
| 37 | be a deficiency of the Facebook API, see |
---|
| 38 | http://stackoverflow.com/questions/6405364/facebook-api-access-hide-posts-from-settings). |
---|
| 39 | Users are encouraged to work around this by using traditional Zephyr |
---|
| 40 | filters. |
---|
| 41 | |
---|
| 42 | * We are missing support for some notable features, including |
---|
| 43 | messaging (Facebook has not publically released the API for this, |
---|
| 44 | though we could sign up for the whitelist), events (seeing |
---|
| 45 | unresponded to events requires a custom FQL query |
---|
| 46 | http://stackoverflow.com/questions/4752967/facebook-api-only-returns-25-events-max), |
---|
| 47 | notifications (not supported in Graph API yet). |
---|
| 48 | |
---|
[1d11b78] | 49 | * Apparently Facebook now has a 'music' post type. Handle it. |
---|
| 50 | |
---|
[01d186f] | 51 | WISHLIST |
---|
| 52 | * Smarter name de-duplication (see Facebook/Handle.pm for details.) |
---|
| 53 | * URL minification. |
---|
| 54 | * Multiple accounts. (Does anyone do this? I don't think so...) |
---|
| 55 | * Zephyr class mirroring. |
---|
[24bd860] | 56 | |
---|
| 57 | POLLING |
---|
| 58 | Facebook.par polls for normal messages once a minute. To disable |
---|
| 59 | polling, you can unset the 'facebook:poll' variable in BarnOwl. |
---|