本文以“茶花女”为例,深入浅出的讲述了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开放平台将为您提供一个自由开发应用 的新舞台。
![](http://info-database.csdn.net/Upload/2008-11-19/01.jpg)
配图 01
到Manyou开放平台开发一个应用程序,对于一个有过代码编写经验的开发者来说并不困难。
只 要您熟悉康盛创想的UCenter Home、Discuz!等社区网络产品,熟悉BBS、SNS等基本的社区特性和人群特征;有一定的软件开发能力,无论PHP、Java、 Asp.net、Perl、RoR等均可以开发,当然开发者还需要有一定的产品经验,了解社区用户需求;有自己的稳定快速的独立服务器或虚拟主机,用于实 现应用的逻辑处理、数据存储和初始的界面展示。只要您了解了以上几点,您完全可以独立的开发一个应用,通过Manyou开放平台供数万个UCenter Home站点使用,为自己带来利益和价值。
UCenter Home网站正在快速增长,不用再去辛辛苦苦找用户,只要您的应用足够贴近用户,就可以象“病毒”一样被迅速传播。为了开发者更方便的了解创建一个应用的基本步骤,下面我们以创建“茶花女”为例,简单讲解开发一个应用的流程。
![](http://info-database.csdn.net/Upload/2008-11-19/02.jpg)
配图 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开放平台将为您提供一个自由开发应用 的新舞台。