Facebook=非死不可

07月 15th, 2008 ychen

看到校内的应用编程大赛，看了一下，文档超级不全，wiki做得也很简单，无奈只好google下，发现是抄facebook的，注册过facebook，但是没开发过facebook的application。找了篇facebook的app hello world来看，也就是上一篇文章。晚上千方百计想上facebook，可是伟大的GFW（Greate Firewall of China今天才知道，土了）就是不让上啊，先后用了proxyfox，firefox的torbutton啊啥的，发现没一个代理好用的。之后莫名其妙得上去了一次facebook，现在又打不开了，唉。果然是“非死不可”啊，搞了个中文的登陆页面又如何呢。GFW说封就封，让你丫得瑟。

Posted in 技术 | No Comments »

Facebook应用hello world（转载自yeeyan）

07月 14th, 2008 ychen

目录

  1. 引言
  2. 创建“Hello World”程序
  3. 在用户信息栏中使用FBML（FaceBook标记语言）
  4. 在用户信息栏中使用mock-AJAX技术
  5. 使用Mysql数据库创建计数器
  6. 将这些例子代码集合到一起
  7. 相关下载

引言

这个教程指导我们如何创建一个名为“tutorialapp”的应用，当你创建自己的程序的时候，它可以作为一个模板。使用这个教程需要你有一个支持php5的web服务器。

最新版本的“tutorialapp”可以在这里（http://tperry256.dreamhost.com/f8/tutorialapp/）找到。访问这个连接的时候，系统会要求你登录到facebook，并且增加“tutorialapp”程序。在很多公司像这样访问服务一个月只需要花费几美元而已。

当你创建了自己的应用，你会使用一个不同的名称和不同的服务器。我们把那些会使你的应用与众不同的地方用这种颜色高亮显示。

创建“hello World”程序

  1. 访问：http://developers.facebook.com/
  2. 点击“Get Started”
  3. 点击“Add Facebook Developer Application”
  4. 一个到“Developer”的链接将显示在Facebook的左边导航栏，进入应用开发
  5. 点击“Setup new Application”按钮
  6. 下面是一些表单的填写步骤
  1. Application Name：在本文中，我们填写“Tutorial Application”–对于你自己的应用，你要填写自己不同的名称。
  2. 点击“Terms of service”
  3. 点击“Optional Fields”链接，来进行更详细的配置
  4. Support E-mail：你在Facebook的注册Email会自动填入，但可能你并不希望自己的个人Email被所有使用你应用的人知道，所以也可以填写一个你可以使用的其他Email。
  5. CallBack Url：在本文中，我们填写“’http://tperry256.dreamhost.com/f8/tutorialapp/”。你应该填入不同的URL，通常情况下，你要填写你自己服务器上运行这个应用的目录的URL。
  6. Canvas Page URL：http://apps.facebook.com/：在本文中，我们填写“tutorialapp”–你必须为自己的应用填写一个不同的名称。
  7. Use FBML：保持默认设置即可。
  8. Application Type：保持此处设置为：“website”
  9. Can your application be added to Facebook：设置“yes”，然后进行详细设置
  10. TOS URL：留空即可。
  11. Post-Add Url：在本文中，我们填写“’http://apps.facebook.com/tutorialapp/”，对于你自己的应用，一般你应该填写自己一个不同的面板页的完整路径。
  12. Default FBML：输入“hello”
  13. 其他的设置按照安装默认即可。
  14. Side Nav Url：在本文中，我们填写“http://apps.facebook.com/tutorialapp”，对于你自己的应用，也应该填写自己不同面板页的完整路径。
  15. 其他设置使用默认即可。

点击“Submit”按钮提交。
进入“My Application”页面，检查刚才的应用是否已经创建。
拷贝php5最新版的客户端库文件到你的服务器端应用程序的目录。
在后面的“相关下载”中有库文件的一些下载地址。如果你使用一个类UNIX 的shell，并且当前位于应用程序的目录，那么可以运行下面的命令：

wget http://developers.facebook.com/clientlibs/facebook-platform.tar.gz
tar zxvf facebook-platform.tar.gz
cp facebook-platform/client/facebook.php .
cp facebook-platform/client/facebookapi_php5_restlib.php .
rm -rf facebook-platform.tar.gz facebook-platform

11. 建立一个“appinclude.php”文件，该文件要被你的应用的所有php文件在头部包含。将如下代码粘贴到文件中：

<?phprequire_once 'facebook.php';

$appapikey = '';
$appsecret = '';
$facebook = new Facebook($appapikey, $appsecret);
$user = $facebook->require_login();

//[todo: change the following url to your callback url]
$appcallbackurl = ”;

//catch the exception that gets thrown if the cookie has an invalid session_key in it
try {
    if (!$facebook->api_client->users_isAppAdded())
          {
              $facebook->redirect($facebook->get_add_url());
           }
     }
catch (Exception $ex)
 {
  //this will clear cookies for your application and redirect them to a login prompt
  $facebook->set_user(null, null);
 $facebook->redirect($appcallbackurl);
}

12. 将其中的“app_key”和“secret”替换成你自己的。他们将显示在应用开发网站的的“My Applications”页面中，你同时要将我们的“call back URL”换成你自己的。

13. 创建一个“index.php”文件，它将是你的应用的主页面，将如下代码粘贴进去：

<?phprequire_once 'appinclude.php';

echo "<p>hello $user</p>"$$

14. 在浏览器中输入你创建的应用的回调地址，你也可以输入面板页的路径，都会访问到“index.php”这个主页。总之，不管哪种方式，都是要在你的浏览器中输入地址 :-)

这是我们这个应用的回调地址：http://tperry256.dreamhost.com/f8/tutorialapp/

这是我们这个应用的面板页地址：http://apps.facebook.com/tutorialapp/

15. 点击“I agree”接受你的应用的服务条款，然后点击“Add [你的应用的名称]”。

16. 接着系统会自动转向到面板页，其中包含了“index.php”的运行的输出结果。

17. 在这个应用中，进入你的用户信息栏中，你会发现“hello”字符，这个是你在前面设置的默认FBML。

18. 最后，从左边的导航栏可以返回到面板页。

在个人信息栏中使用FBML

  1. 下面是“index.php”的一个扩展版本，它可以将用户在表单中填写的字符串显示在用户的信息栏中
  2. 注意：提交空字符串会导致用户信息栏的无法显示！
<?php
require_once 'appinclude.php';

echo "<p>hello $user</p>"$$

if (isset($_REQUEST['profiletext']))
{
 $facebook->api_client->profile_setFBML($_REQUEST['profiletext'], $user);
 $facebook->redirect($facebook->get_facebook_url() . ‘/profile.php’);
}

echo ‘<form action=”" method=”get”>’;
echo ‘<input name=”profiletext” type=”text” size=”30″ value=”"><br>’;
echo ‘<input name=”submit” type=”submit” value=”Display text on profile”>’;
echo ‘</form>’;

在用户信息栏中使用mock-AjAX技术

  1. 下面的代码使用FBML的mock-AJAX技术在用户信息栏中增加一个表单，会给用户一种信息栏被动态更新的假象。
  2. 注意“index.php”文件的最上面对mock-AJAX进行调用的if语句。
<?php
if (isset($_REQUEST['mockfbmltext']))
{
 echo $_REQUEST['mockfbmltext'];
 exit;
}

require_once ‘appinclude.php’;

echo “<p>hello $user</p>”$$

$fbml = <<<EndHereDoc<fb:subtitle>This is the subtitle</fb:subtitle>

<form><input name=”mockfbmltext” type=”text” size=”30″><br />
<input type=”submit”  clickrewriteurl=”$appcallbackurl”
clickrewriteid=”preview” value=”Draw text below”/>
<br />
<div id=”preview” style=”border-style: solid; border-color: black;
 border-width: 1px; padding: 5px;”>
</div></form>EndHereDoc;

$facebook->api_client->profile_setFBML($fbml, $user);

echo “<p>the following form was added to the profile box:</p>”$$

echo $fbml;

使用Mysql数据库创建计数器

  1. 这个例子需要你在服务器上创建一个php脚本可以访问的数据库。
  2. 如果你没有数据库，就新建一个。
  3. 在这个数据库中新建一个名为“counter”的数据表，表中有一个名为“count”的integer类型的列。
  4. 创建一个新文件名为“dbappinclude.php”，将下面的代码粘贴进去，别忘了替换你自己的数据库地址，用户，密码和数据库名称。
<?php
require_once 'appinclude.php';

$dbhost = '';$dbuser = '';$dbpass = '';$dbname = '';

$conn = mysql_connect($dbhost, $dbuser, $dbpass);
mysql_select_db($dbname, $conn);

function query($q)
{
 global $conn;
 $result = mysql_query($q, $conn);
 if (!$result)
 {
    die("Invalid query -- $q -- " . mysql_error());
}
return $result;}

5. 现在在浏览器中访问下面这个新版本的“index.php”，主页将显示一个计数器，并且没访问一次“index.php”，计数器就会更新一次。

<?php
require_once ‘dbappinclude.php’;

echo “<p>hello $user</p>”$$

$rs = query(”select count from counter”);
if ($row = mysql_fetch_assoc($rs)) {
$count = $row['count'];
query(”update counter set count=count+1″);
} else {
query(”insert into counter values (1)”);
$count = 1;
}

echo “<p>the count is $count</p>”$$

将这些例子代码集合到一起

  1. 这里是一个最终版本的“index.php”，将上面的例子集合到了一起，假定你已经在前一个例子中创建了“dbappinclude.php”
<?php
if (isset($_REQUEST['mockfbmltext']))
{
echo $_REQUEST['mockfbmltext'];
exit;
}

require_once ‘dbappinclude.php’;

echo “<p>hello $user</p>”$$

$rs = query(”select count from counter”);
if ($row = mysql_fetch_assoc($rs))
{
 $count = $row['count'];
 query(”update counter set count=count+1″);
}
else
{
query(”insert into counter values (1)”);
$count = 1;
}

echo “<p>the count is $count</p>”$$

if (isset($_REQUEST['profiletext']))
{
 $facebook->api_client->profile_setFBML($_REQUEST['profiletext'], $user);
 $facebook->redirect($facebook->get_facebook_url() . ‘/profile.php’);
}

echo ‘<form action=”" method=”get”>’;
echo ‘<input name=”profiletext” type=”text” size=”30″ value=”"><br>’;
echo ‘<input name=”submit” type=”submit” value=”Display text on profile”>’;
echo ‘</form>’;

$fbml = <<<EndHereDoc<form><input name=”mockfbmltext” type=”text” size=”30″>
<br /><input type=”submit”  clickrewriteurl=”$appcallbackurl”
clickrewriteid=”preview” value=”Draw text below”/>
<br /><div id=”preview” style=”border-style: solid; border-color: black;
 border-width: 1px; padding: 5px;”>
</div>
</form>EndHereDoc;

$facebook->api_client->profile_setFBML($fbml, $user);

echo “<p>the following form was added to the profile box:</p>”$$

echo $fbml;

相关下载

  1. facebook_client.tar.gz — php5的最新客户端库文件
  2. tutorialapp.tar.gz — 将文中例子合并到一起的代码。在你自己的服务器上运行时需要替换其中的“app_key”，“application secret”和数据库信息
  3. tutorialapp.zip –和上面tutorialapp.tar.gz内容相同，为zip压缩格式

Posted in 技术 | No Comments »