以茶花女为例谈SNS开放平台应用开发

本文以“茶花女”为例，深入浅出的讲述了Manyou开放平台的应用开发流程。希望能够给《站长》杂志的读者朋友以参考。感谢孙夕秋、潘瑞、张佳平等朋友深入浅出的讲解！



配图   01

到Manyou开放平台开发一个应用程序，对于一个有过代码编写经验的开发者来说并不困难。

只 要您熟悉康盛创想的UCenter Home、Discuz!等社区网络产品，熟悉BBS、SNS等基本的社区特性和人群特征；有一定的软件开发能力，无论PHP、Java、 Asp.net、Perl、RoR等均可以开发，当然开发者还需要有一定的产品经验，了解社区用户需求；有自己的稳定快速的独立服务器或虚拟主机，用于实 现应用的逻辑处理、数据存储和初始的界面展示。只要您了解了以上几点，您完全可以独立的开发一个应用，通过Manyou开放平台供数万个UCenter Home站点使用，为自己带来利益和价值。

UCenter Home网站正在快速增长，不用再去辛辛苦苦找用户，只要您的应用足够贴近用户，就可以象“病毒”一样被迅速传播。为了开发者更方便的了解创建一个应用的基本步骤，下面我们以创建“茶花女”为例，简单讲解开发一个应用的流程。



配图  02
 
“ 茶花女”是以社会生活中的花语为原型开发的。花语是指人们用花来表达人的某种语言，感情与愿望，在一定的历史条件下逐渐约定俗成的，为一定范围人群所公认 的信息交流形式。花语构成花卉文化的核心，在花卉交流中，花语虽无声，但此时无声胜有声，其中的涵义和情感表达甚于言语。花语最早起源于古希腊，那个时候 不止是花，叶子、果树都有一定的含义。在希腊神话里记载过爱神出生时创造了玫瑰的故事，玫瑰从那个时代起就成为了爱情的代名词。在大庭广众下表达爱意是难 为情的事情，所以恋人间赠送的花卉就成为了爱情的信使。随着时代的发展，花卉成为了社交的一种赠与品，更加完善的花语代表了赠送者的意图。在Manyou 开放平台上，“茶花女”是一个传递花语的小应用。

“茶花女”应用的开发，需要一个支持PHP的web服务器和PHP脚本可以访问的MySQL数据库。

注册应用

1.访问：http://uchome.developer.manyou.com/ ；
2.首先注册Manyou开发者帐号，如果您已经在 www.discuz.net , u.discuz.net等网站注册，直接登录即可；
3.点击“开始”-> “开发者”-> “创建新应用”；
4.下面是创建新应用时一些表单的填写步骤：
I.选中“我已阅读并接受Manyou开发平台协议”。
II.应用程序名称：在本例中，我们填写“茶花女”，对于您自己的应用，您要填写自己不同的名称。
III.开发者E-mail：如果有任何问题或更新，Manyou将会通过这个email与您联系。
IV.客户服务E-mail：显示在该应用程序的介绍页面，用户可发邮件到此邮箱寻求帮助。
V.CallBack Url：在本例中，我们填写“http://flowers.manyou-apps.com/manyou/”。您应该填入不同的URL，通常情况下，您要填写您服务器上运行这个应用的根目录的URL,，注意必须以斜线结尾。
VI.应用的服务条款的URL： 您的应用的服务条款的网址。
VII.应用的简介：填写您的应用简介。
VIII.其他的设置：按照安装默认即可。
 5. 点击“提交”，进入“我开发的应用”，这里您可以看到应用“茶花女”相关的信息，包括API Key 、Secret等（下文会用到）。

编写代码
 
一、规划“茶花女”应用

manyou/common.php
/index.php
/send.php
/receive.php
/Manyou.php

创建目录及相关文件，注意文件编码为UTF-8。

二、初始化应用

应用跟Manyou通信是通过API来实现的，利用这些API，您可以通过MYOP开放平台调用指定UCenter Home用户网站上的数据，包括身份验证、用户资料、好友关系、应用使用情况等等。

在 “茶花女”这个例子里我们使用的是Manyou官方提供的PHP类库，通过这个类库可以实现对Manyou API的简单调用。访问wiki.developer.manyou.com/wiki/index.php/PHP，下载最新的Manyou客户端库文 件Manyou.php，将该文件放到您的应用目录下。

将以下代码添加到commom.php， 将Manyou客户端库文件Manyou.php包含进来并进行类的初始化：
require_once ‘Manyou.php’;
$manyou = new Manyou(‘YOUR_API_KEY’, ‘YOUR_SECRET’);

将其中的“YOUR_API_KEY”和“YOUR_SECRET”替换成上文提到“我开发的应用”中“茶花女”的相关的信息API Key 、Secret。

检测用户是否已添加应用，如果用户没有添加应用将会转到应用安装页面：
$manyou->require_add();

获取当前登录用户id：
$uid = intval($manyou->api_client->user_getLoggedInUser());

获取当前登录用户的好友id：
$friends = $manyou->api_client->friend_get();

接下来配置数据库及其他一些信息，在此不再赘述。

三、使用MYML创建发送鲜花页面

MYML是一套使得应用与UCenter Home能够在界面上紧密结合的标记语言。通过MYML，应用开发者可以很容易开发出风格很相似于UCenter Home用户网站的应用程序，增加使用者访问的舒适程度。

比如说，我们要创建“茶花女”的页面头部，可以这样写：
<my:header>茶花女</my:header>

四、发送鲜花处理

发送鲜花主要分四步：

1.将数据插入到MySQL数据库中；

2.发送Feed，实现方法：feed.publishTemplatizedAction。
Feed是Manyou开放平台提供给应用开发者的API，通过Feed，可以将应用的最新动态发到用户的好友页面。

3.发送通知，实现方法：notification.send。 通知同样是Manyou API，作用是向一个用户发送通知或请求。

4.设置用户个人主页中显示的MYML，实现方法：profile.setMYML。

包括个人主页中的应用程序块和行为列表。您可以传递用户ID，如果未指定用户的 ID，则将使用当前登陆的用户。在本例中，将会在鲜花接收者的个人主页上显示接收到的鲜花。

应用编写完毕后，再次访问：http://uchome.developer.manyou.com，点击“开始” -> “开发者” -> “我开发的应用” -> “使用应用” -> “安装茶花女”，您将看到程序的运行结果。

提交应用
 
您的应用在未经审核时，只能用在MYOP开放平台官方的UCenter Home上，如果您想让成千上万的用户UCenter Home网站用上您的应用，请提交审核。关于审核的条件，可以参考开发者wiki上的“应用审核标准”。

好 了，到现在为止一个简单的流程就讲完了，您是不是已经有一种跃跃欲试的感觉了？如果您还需要了解更多Manyou开放平台的说明和代码相关的信息，请马上 访问Manyou开发者指南（http://wiki.developer.manyou.com）吧！Manyou开放平台将为您提供一个自由开发应用 的新舞台。