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