');
foreach ($apps as $app) {
$options[$app->nid] = $app->title;
}
return $options;
}
/**
* Convenience method to return array of all know fb_apps.
*/
function fb_get_all_apps() {
$apps = fb_invoke(NULL, FB_OP_GET_ALL_APPS, array());
return $apps;
}
/**
* A convenience method for returning a list of facebook friends. This should
* work efficiently in canvas pages for finding friends of the current user.
* In other cases it tries to work, but will be an expensive operation and
* only succeed when the user has created an infinite session.
*
* @return: an array of facebook ids
*/
function fb_get_friends($fbu, $fb_app = NULL) {
static $cache = array();
// Facebook only allows us to query the current user's friends, so let's try
// to log in as that user. It will only actually work if they are the
// current user of a canvas page, or they've signed up for an infinite
// session.
$fb = fb_api_init($fb_app, $fbu);
if (!$fb || !$fbu)
return;
if (!isset($cache[$fbu])) {
if ($fb === $GLOBALS['fb'] &&
$fbu == fb_facebook_user($fb))
$items = $fb->api_client->friends_get();
// friends_get does not work in cron call, so we double check.
if (!$items || !count($items)) {
$logged_in = fb_facebook_user($fb);
$query = "SELECT uid2 FROM friend WHERE uid1=$fbu";
$result = $fb->api_client->fql_query($query);
fb_report_errors($fb);
$items = array();
if (is_array($result))
foreach ($result as $data) {
$items[] = $data['uid2'];
}
}
// Facebook's API has the annoying habit of returning an item even if user
// has no friends. We need to clean that up.
if (!$items[0])
unset($items[0]);
$cache[$fbu] = $items;
}
return $cache[$fbu];
}
// Return array of facebook gids
function fb_get_groups($fbu, $fb_app = NULL) {
$items = array();
$groups = fb_get_groups_data($fbu);
if ($groups && count($groups))
foreach ($groups as $data) {
$items[] = $data['gid'];
}
return $items;
}
function fb_get_groups_data($fbu, $fb_app = NULL) {
static $cache = array();
$fb = _fb_api_init($fb_app);
if (!$fb || !$fbu)
return;
if (!isset($cache[$fbu])) {
$cache[$fbu] = $fb->api_client->groups_get($fbu, NULL);
}
return $cache[$fbu];
}
// deprecated since creation of fb_user module, but cron hook still uses this.
function fb_user_load($fbu = NULL) {
global $user;
if (!$fbu)
// default to current logged in user
$fbu = fb_facebook_user();
if ($fbu && $user->fbu == $fbu) {
return $user;
}
if ($fbu) {
$account = user_external_load("$fbu-$fb_app->apikey@facebook.com");
if (!$account)
$account = user_external_load("$fbu@facebook.com");
if (!$account)
$account = user_load(array('uid' => variable_get('fb_facebook_user', 2)));
if (!$account)
watchdog('fb', t('Failed to load user from facebook fbu=%fbu',
array('%fbu' => $fbu)), 'error');
$account->fbu = $fbu;
return $account;
}
}
function fb_form_alter($form_id, &$form) {
// Because facebook users don't have email, it can't be required on user form
if ($form_id == 'user_register') {
if (user_access('administer users')) {
$form['mail']['#required'] = FALSE;
}
}
if ($form_id == 'user_edit') {
if (user_access('administer users')) {
$form['account']['mail']['#required'] = FALSE;
}
}
}
function fb_menu($may_cache) {
$items = array();
if (!$may_cache) {
// Initialization moved to fb_init(), nothing to do here.
}
else {
// When forms are submitted directly to us, we cache the results,
// and show them later via this callback
$items[] = array('path' => 'fb/form_cache',
'callback' => '_fb_form_cache_cb',
'type' => MENU_CALLBACK,
'access' => TRUE);
// A page to help determine infinite session keys
$items[] = array('path' => 'fb/session',
'callback' => '_fb_session_cb',
'type' => MENU_CALLBACK,
'access' => TRUE); // TODO: restrict access?
}
return $items;
}
/**
* When exiting we need to do some special stuff for forms
*/
function fb_exit($destination = NULL) {
global $fb_app, $fb;
fb_invoke($fb_app, FB_OP_EXIT, $destination);
}
function _fb_form_cache_cb($cid) {
// Facebook started appending a '?', we need to get rid of it.
if ($pos = strpos($cid, '?'))
$cid = substr($cid, 0, $pos);
watchdog('fb', "Returning cached form page $cid");
$cache = cache_get($cid, 'cache_page');
// Don't clear, as user may refresh browser. Cache will expire eventually.
// cache_clear_all($cid, 'cache_page');
print $cache->data;
exit();
}
function _fb_session_cb() {
global $fb, $fb_app;
global $user;
drupal_set_message("_fb_session_cb" . dpr($_REQUEST, 1));
$output = ''.t('You are logged in as local user !username, with Facebook user id %fbu.',
array('!username' => theme('username', $user),
'%fbu' => fb_get_fbu($user))).'
';
$output .= ''.l(t('Request an infinite session key.'),
'http://www.facebook.com/code_gen.php?v=1.0&api_key='.$fb_app->apikey).'
';
$output .= drupal_get_form('fb_session_key_form');
$output .= ''.t('Current session key: %key',
array('%key' => htmlentities($fb->api_client->session_key)))."
\n";
return $output;
}
function fb_session_key_form() {
global $fb_app;
$form = array('auth_token' => array('#type' => 'textfield',
'#title' => t('One-time code'),
'#description' => t('If you do not have a one-time code, you can get one !here.',
array('!here' => l(t('here'), 'http://www.facebook.com/code_gen.php?v=1.0&api_key='.$fb_app->apikey))),
),
'submit' => array('#type' => 'submit',
'#value' => t('Submit')),
'#redirect' => FALSE, /* necessary when submitting via facebook */
);
return $form;
}
/**
* Invoke hook_fb.
*/
function fb_invoke($fb_app, $op, $return = NULL, $data = NULL) {
global $fb;
foreach (module_implements(FB_HOOK) as $name) {
$function = $name . '_' . FB_HOOK;
$function($fb, $fb_app, $op, $return, $data);
}
return $return;
}
/**
* This method will clean up URLs. When serving canvas pages, extra
* information is included in URLs (see fb_settings.inc). This will remove
* the extra information.
*/
function fb_scrub_urls($content) {
foreach (array(FB_SETTINGS_APP_NID, FB_SETTINGS_PAGE_TYPE) as $key) {
$patterns[] = "|$key/[^/]*/|";
$replacements[] = "";
}
$content = preg_replace($patterns, $replacements, $content);
return $content;
}
/**
* Implementation of hook_node_grants.
*
* We put this here so all facebook modules have a standard way to implement
* hook_node_access_records. They use that hook to insert records into the
* node access table. We use this hook to allow access when the grants are
* there.
*
* DEPRECATED. Not sure where, if anywhere, this belongs.
*/
function fb_node_grantsXXX($account, $op) {
$grants = array();
$fbu = fb_get_fbu($account);
if ($fbu) { // If not anonymous (facebook user not logged in to this app)
$friends = fb_get_friends($fbu);
// For access purposes, consider a users to be a friend of themself
$friends[] = $fbu;
if (count($friends))
$grants[FB_GRANT_REALM_FRIEND] = $friends;
$groups = fb_get_groups($fbu);
if (count($groups))
$grants[FB_GRANT_REALM_GROUP] = $groups;
}
return $grants;
}
/**
* Convenience method for displaying facebook api errors.
*/
function fb_report_errors($fb = FB_APP_CURRENT, $message = NULL) {
if ($fb == FB_APP_CURRENT) {
$fb = $GLOBALS['fb'];
}
if ($fb) {
if ($fb->api_client->error_code) {
$message = t('!message Facebook API error %code (see !link).',
array('%code' => $fb->api_client->error_code,
'!link' => l(t('error codes'), "http://wiki.developers.facebook.com/index.php/Error_codes"),
'!message' => $message,
));
watchdog('fb', $message, WATCHDOG_ERROR);
drupal_set_message($message, 'error');
}
}
}
function fb_log_exception($e, $text = '') {
if ($text)
$message = $text .': '. $e->getMessage();
else
$message = $e->getMessage();
$message .= ' ' . $e->getCode();
watchdog('fb', $message, WATCHDOG_ERROR);
if (user_access('administer fb apps')) {
drupal_set_message($message, 'error');
}
}
/**
* Exception handler for PHP5 exceptions.
*/
function fb_handle_exception($exception) {
$message = t('Facebook API exception %message. !trace',
array('%message' => $exception->getMessage(),
'!trace' => ''.$exception->getTraceAsString().'
',
));
watchdog('fb', $message, WATCHDOG_ERROR);
//drupal_set_message($message, 'error');
print $message;
print "\$_REQUEST:\n";
print_r($_REQUEST);
print "\n\nREQUEST_URI:\n" . $_SERVER['REQUEST_URI'];
print "
";
}
/**
* Helper function for facebook's users_getInfo API.
*
* This function makes calls to users_getInfo more efficient, by caching
* results in the session, so calls do not always require hitting Facebook's
* servers.
*
* Particularly useful when displaying user info on iframe canvas pages, where
* tags are not available.
*
* @param $oids
* Array of facebook object IDs. In this case they should each be a user id.
*/
function fb_users_getInfo($oids, $fb = NULL, $refresh_cache = FALSE) {
if (!$fb) {
$fb = $GLOBALS['fb'];
}
$infos = array();
if (!is_array($oids))
$oids = array();
if ($fb) {
// First try cache
if (!$refresh_cache)
foreach ($oids as $oid) {
if ($info = $_SESSION['fb'][$fb->api_key]['userinfo'][$oid])
$infos[] = $info;
}
if (count($infos) != count($oids)) {
// Session cache did not include all users, update the cache.
$infos = $fb->api_client->users_getInfo($oids,
array('about_me',
'affiliations',
'name',
'is_app_user',
'pic',
'pic_big',
'pic_square',
'profile_update_time',
'status',
));
// Update cache with recent results.
foreach($infos as $info) {
$_SESSION['fb'][$fb->api_key]['userinfo'][$info['uid']] = $info;
}
}
return $infos;
}
}
/**
* Helper function for FBJS files.
*
* Useful for adding Facebook Javascript, which will be incorporated into
* canvas pages or profile boxes. When included this way, javascript must be
* embedded inline, rather than refer to an external URL. So this function
* will actually read a local file and include the contents inline.
*/
function fb_add_js($filename, $type) {
static $cache;
if (!$cache) {
$cache = array();
// Add the most basic file we need.
$base_file = drupal_get_path('module', 'fb') . '/fb_fbml.js';
$base_file .= "?v=".filemtime($base_file);
drupal_add_js($base_file, 'module', 'fbml');
// Add some settings that FBJS code will often need.
$baseUrl = url('', NULL, NULL, TRUE);
drupal_add_js(array('fbjs' => array('baseUrlFb' => $baseUrl,
'baseUrl' => fb_scrub_urls($baseUrl),
),
),
'setting', 'fbml');
}
if (!$cache[$filename]) {
if (file_exists($filename)) {
// Refresh facebook's cache when file changes
$filename .= "?v=".filemtime($filename);
}
// 'post_settings' is a hack to make our code come after settings. This is
// ugly, but we're doing it because there is no "onready" in FBJS.
drupal_add_js($filename, 'post_settings', 'fbml');
$cache[$filename] = TRUE;
}
}
/**
* For debugging, add $conf['fb_verbose'] = TRUE; to settings.php.
*/
function fb_verbose() {
return variable_get('fb_verbose', NULL);
}
?>