本帖最后由 我是阿三 于 2009-5-27 15:07 编辑
HDWiki许愿墙插件开发实例---一步一步跟我学!
以下例子以我本地hdwiki为例，我本地hdwiki地址是： http://10.0.0.121/hdwiki/
第一步：把插件开发向导 pluginwizard.php 这个工具放到HDWiki的根目录下面。 （点击下载pluginwizard.php）
第二步：在浏览器里面输入地址 ：http://10.0.0.121/hdwiki/pluginwizard.php ，然后Enter 确定，出现如下页面：
第三步：我们这里做的插件是许愿墙，给许愿墙取一个唯一标识符（也就是英文名字）wish;
插件名称：许愿墙。
插件是否前台可见：可见 (不然谁能许愿？)
插件简介：就是插件的说明和描述，做什么用的等
作者：就是你自己了，真实的名字和昵称都可
作者主页：就是你的个人主页
适用于HDWiki的版本：就是说这个插件能够在哪些hdwiki上正常运行？，我们许愿墙插件依赖于jquery，但是hdwiki从4.0.3才开始有jquery，所以这里填写 4.0.3,4.0.4 ,多个版本用逗号隔开
填写完毕，如下图所示：
第四步：点击生成，如下图所示，插件生成成功！
第五步：进入hdwiki的plugins目录，查看已经生成的插件。可以看到一个叫做wish的目录，这个就是自动生成的插件。
第六步：进入HDWiki的管理员后台，点击HDWiki插件下面的【全部推荐插件】->【本地已有插件】（4.0.3下是插件管理），如下图所示：
点击【安装此插件】即可。从这个时候开始就可以编写插件代码并测试插件了。
第七步：进入hdwiki的plugins目录下的子目录wish，增加相关文件，编写相关代码，如下图所示：
wish这个目录里面包括model、cotrol、view 三个子目录，我们自己创建一个目录images，放入需要用到的图片和js脚本等，并自己编写两个htm页面：allwish.htm 和postwish.htm
目录文件列表如下图：
1、 admin_wish.php :这个是后台点击插件的【管理】需要调用的，在许愿墙插件中用不到，所以可以不用修改。
<?php
!defined('IN_HDWIKI') && exit('Access Denied');
class control extends base{
function control(& $get,& $post){
$this->base( & $get,& $post);
$this->load('plugin');
$this->loadplugin('wish');
$this->view->setlang('zh','back');
}
/*在后台点击管理触发的方法，因为许愿墙用不到后台，所以这里是默认的echo语句 */
function dodefault() {
echo 'nothing!';
}
}
?>
2、 wish.php ：前台访问许愿墙插件需要用到的control，要编写代码，我们需要改写下：
<?php
!defined('IN_HDWIKI') && exit('Access Denied');
class control extends base{
function control(& $get,& $post){
$this->base( & $get,& $post);
$this->loadplugin('wish');
}
/*显示所有的许愿*/
function dodefault(){
$wishlist=$_ENV['wish']->get_list();
$this->view->assign('wishlist',$wishlist);
$this->view->display('file://plugins/wish/view/allwish');
}
/*ajax提交许愿*/
function dopost(){
$receiver=empty($this->post['receiver'])?'自己'this->post['receiver'];
$author=empty($this->post['author'])?'匿名'this->post['author'];
$wish=$this->post['wish'];
$_ENV['wish']->add_wish($receiver,$author,$wish);
$this->message('1','',2);
}
/*点击我来贴一张显示提交页面*/
function dowill(){
$this->view->display('file://plugins/wish/view/postwish');
}
}
?>
3、 wish.class.php ：许愿墙插件用到的model，要编写代码，我们需要改写下：
<?php
!defined('IN_HDWIKI') && exit('Access Denied');
class wishmodel {
var $db;
var $base;
function wishmodel(&$base) {
$this->base = $base;
$this->db = $base->db;
}
/*这里是每个插件都需要编写的方法，安装插件的时候会自动调用此方法*/
function install(){
$sqls="CREATE TABLE wiki_wish (
`id` mediumint(8) unsigned NOT NULL auto_increment,
`wish` varchar(200) NOT NULL default '',
`receiver` varchar(15) NOT NULL default '',
`author` varchar(15) NOT NULL default '',
`style` int(2) NOT NULL default '1',
`time` int(10) unsigned NOT NULL default '0',
PRIMARY KEY (`id`),
KEY `time` (`time`)) TYPE=MyISAM DEFAULT CHARSET=".DB_CHARSET.";";
$this->db->query($sqls); //创建许愿的数据表
$plugin=array(
'name'=>'许愿墙',
'identifier'=>'wish',
'description'=>'每个人都有很多美好的愿望，许愿墙，一个你可以随意许愿的地方，这里人人平等，朋友之间也可以互相祝福！',
'datatables'=>'',
'type'=>'1',
'copyright'=>'lovewiki',
'homepage'=>'http://hi.baidu.com/songdenggao',
'version'=>'1.0',
'suit'=>'4.0.3,4.0.4',
'modules'=>''
);
$plugin['vars']=array();
$plugin['hooks']=array();
return $plugin;
}
/*这里是每个插件都需要编写的方法，卸载插件的时候会自动调用此方法*/
function uninstall(){
$this->db->query("DROP TABLE IF EXISTS wiki_wish");
}
/*自己编写的方法，插入一个许愿到数据库表中*/
function add_wish($receiver,$author,$wish){
$style=rand(1,8);
$this->db->query("INSERT INTO ".DB_TABLEPRE."wish (receiver,author,wish,style,time) VALUES ('$receiver','$author','$wish',$style,'".$this->base->time."') ");
}
/*自己编写的方法，从数据库读取许愿数据*/
function get_list($start=0,$limit=100){
$wishlist=array();
$query=$this->db->query("SELECT * FROM ".DB_TABLEPRE."wish ORDER BY time DESC limit $start,$limit ");
while($wish=$this->db->fetch_array($query)){
$wish['time']=$this->base->date($wish['time']);
$wish['left']=rand(1,1024);
$wish['top']=rand(1,800);
$wishlist[]=$wish;
}
return $wishlist;
}
}
?>
4、 allwish.htm：显示所有许愿用到的view，也就是许愿墙的显示页面，要编写代码，最终代码如下：
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>许愿/祝福墙 - {$setting['site_name']}</title>
<meta http-equiv="Content-Type" content="text/html; charset={WIKI_CHARSET}" />
<meta name="author" content="lovewiki" />
<meta name="description" content="爱情墙,祝福墙,许愿墙,愿望墙,wish wall,jQuery wish wall " />
<meta name="keywords" content="爱情墙,祝福墙,许愿墙,愿望墙,wish wall,jQuery wish wall " />
<link rel="stylesheet" type="text/css" href="plugins/wish/images/html.css" />
<link rel="stylesheet" type="text/css" href="plugins/wish/images/layout.css" />
<script type="text/javascript" src="js/jquery.js"></script>
<script type="text/javascript" src="js/ui/ui.core.js"></script>
<script type="text/javascript" src="js/ui/ui.draggable.js"></script>
<script type="text/javascript">
var zindex=0;
$(function() {
$(".wall").draggable({
start: function(e, ui) {
var curdiv=$(this);
$(".wall").each(function (index, element) {
var index=parseInt($(this).css('z-index'));
if(index>=zindex){
zindex=index+1;
}
});
curdiv.css('z-index',zindex);
}
});
});
$(document).ready(function(){
$("span[class=x]").click(function(){
$(this).parents(".wall").hide();
});
});
</script>
</head>
<body>
<div id="top_pad">
<span style="float: right; padding-right: 10px"><input type="button" value="我来贴一张>>" class="button" onclick='location.href="{$setting[seo_prefix]}plugin-wish-wish-will";' /></span>
<span style="font-size:large; font-weight: bold">许愿墙</span>
<span style="font-size: 11px">(<a href="{$setting['site_url']}">回首页</a>)</span>
</div>
{loop $wishlist $index $wish}
<div class="wall" style="z-index:{$index};left:{$wish['left']}px;top:{$wish['top']}px; opacity: 1;">
<div class="top-{$wish['style']}"><span class="x">×</span>第[{$wish['id']}]条 {$wish['time']}</div>
<div class="mid-{$wish['style']}"><span class="wt"><b>{$wish['receiver']}</b>：</span><span>{$wish['wish']}</span></div>
<div class="bot-{$wish['style']}"><img src="plugins/wish/images/{$wish['style']}.gif" /><span class="inline">{$wish['author']}</span></div>
</div>
{/loop}
</body>
</html>
5、 postwish.htm：提交许愿用到的view，也就是发布许愿用到的页面，需要编写代码，最终代码如下：
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>我来贴祝福，我来贴愿望 - {$setting['site_name']}</title>
<meta http-equiv="Content-Type" content="text/html; charset={WIKI_CHARSET}" />
<meta name="author" content="lovewiki" />
<meta name="description" content="爱情墙,祝福墙,许愿墙,愿望墙,wish wall,jQuery wish wall " />
<meta name="keywords" content="爱情墙,祝福墙,许愿墙,愿望墙,wish wall,jQuery wish wall " />
<link rel="stylesheet" type="text/css" href="plugins/wish/images/html.css" />
<link rel="stylesheet" type="text/css" href="plugins/wish/images/layout.css" />
<script type="text/javascript" src="js/jquery.js"></script>
<script type="text/javascript">
function mypost(){
var wish=$('#wish').val();
if(wish.length>100 || wish.length==0 ){
alert('祝福内容必须介于1～100字之间！');
return;
}
$.ajax({
url: "index.php?plugin-wish-wish-post",
data: {receiver('#receiver').val(),author('#author').val(),wish:wish},
cache: false,
dataType: "xml",
type:"post",
beforeSend:function(){
$('#success').html('');
$('#waiting').html('<img src="plugins/wish/images/loading.gif" alt="osting..." /> 正在发布，请稍等...');
},
success: function(xml){
var message=xml.lastChild.firstChild.nodeValue;
if(message=='1'){
$('#waiting').html('');
$('#success').html('<img src="plugins/wish/images/ok.gif" alt="OK" /> OK,贴好了，快去look一下吧');
}else{
alert('发布失败！');
}
}
});
}
</script>
</head>
<body>
<form action onsubmit="return false;" style="margin-top: 80px">
<div class="pad_box">
<span>我的祝福 （<a href="{$setting['site_url']}">{$setting['site_name']}</a>）</span>
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td>贴给？</td>
<td><input type="text" maxlength="30" size="40" id="receiver" name="receiver" value="自己" onfocus="{this.value='';}" /></td>
</tr>
<tr>
<td>你是？</td>
<td><input type="text" maxlength="20" size="40" id="author" name="author" value="匿名" onfocus="{this.value='';}" /></td>
</tr>
<tr>
<td>Wish：<br />(<=100字)</td>
<td><textarea id="wish" name="wish" cols="50" rows="4"></textarea></td>
</tr>
<tr>
<td colspan="2" style="text-align: center">
<input type="button" class="button" value="我贴!" onclick="mypost();" />
<input type="reset" class="button" value="重来？" />
<input type="button" class="button" value="去看看" onclick="{location.href = '{$setting['site_url']}/{$setting['seo_prefix']}plugin-wish';}" />
<input type="button" class="button" value="回首页" onclick="{location.href = '{$setting['site_url']}';}" /></td>
</tr>
<tr>
<td colspan="2" style="text-align: center">
<span id="waiting"></span>
<span id="success"></span>
</td>
</tr>
</table>
</div>
</form>
</body>
</html>
第八步：编写完代码并测试通过后发布到到插件共享平台。首先进入后台管理中心，查看【已安装插件】。如下图，可以看到许愿墙插件：
然后点击【分享】，如下图，填写完所有的信息，然后【确定】即可完成分享。
分享后的插件在HDWiki开源官方站上有展示，默认的是显示为【未审核】，审核通过后，所有的HDWiki管理员都可以在后台【全部推荐插件】看到你分享的插件。
具体代码详见：http://kaiyuan.hudong.com/bbs/vi ... =%E8%AE%B8%E6%84%BF
许愿墙插件下载地址：http://kaiyuan.hudong.com/plugin.php |
置顶卡
喧嚣卡
变色卡
千斤顶
显身卡
