Z-Blog Wiki

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== Z-BlogPHP JavaScript Framework ======
===== 介绍 =====
这是一个旨在规范Z-BlogPHP前端代码接口而推出的框架，用于处理之前前端代码无序的局面。代码示例：https://github.com/zblogcn/zblogphp/blob/master/zb_users/plugin/ZBPJFExample/zbpjfexample.js

===== 函数说明 =====
====1. cookie ====
=== get ===
<code javascript>zbp.cookie.get(CookieKey)</code> 
根据Key得到Cookie的值
=== set ===
<code javascript>zbp.cookie.set(sCookieName, sCookieValue, iExpireDays)</code> 

====2. comment ====
=== get ===
<code javascript>zbp.comment.get(文章ID, 评论页数)</code>
触发事件，获得指定的评论列表
=== reply ===
<code javascript>zbp.comment.rely(评论ID)</code>
触发回复评论事件
=== post ===
<code javascript>zbp.comment.post(发送内容)</code>
触发发送评论事件。发送内容要求为Object，参数如下：
<code javascript>
            /**
             * Form Data
             * @name POSTFORMDATA
             * @typedef {Object} PostData
             * @memberOf COMMENT
             * @property {string} action - Post Url
             * @property {string} postid - Article ID
             * @property {string} verify - Verify code
             * @property {string} name   - Comment user name
             * @property {string} email  - Comment user E-mail
             * @property {string} content - Comment content
             * @property {string} homepage - Comment user Website
             * @property {string} replyid - Comment Parent ID
             * @property {string} isajax - Return Ajax String
             * @type {object}
             */
</code>


====3. userinfo ====
=== output ===
=== save ===
=== saveFromHtml ===
懒得写了……
====4. plugin ====
=== on ===
<code js>zbp.plugin.on(bind / addListener)(接口名, 插件ID, 回调函数(错误, 待发送数据))</code>

用于创建一个监听器，监听事件的发生


=== unbind ===

<code js>zbp.plugin.unbind(removeListener)(插件ID)</code>

用于解绑一个监听器

=== emit ====

<code js>zbp.plugin.emit(接口名, 内容)</code>

用于传递内容到监听器

===== 自带事件接口列表 =====
==== userinfo.output ====
==== userinfo.savefromhtml ==== 
==== userinfo.save ====
无参数，请自行处理。

==== comment.verifydata ====
代码示例，应注意ZBPJFExample是指你的主题或者插件ID，以防止冲突：
<code javascript>
// 验证评论
zbp.plugin.on("comment.verifydata", "ZBPJFExample", function (error, formData) {
	console.log("待发送数据：");
	console.log(formData);
	// formData里的数据可以任意操作

	// 如果出错的话
	//if (1 == 2) {
	//	error.no = 32768; // 给一个错误编码
	//	error.msg = "Z-BlogPHP JavaScript Framework 测试"; // 错误消息
	//}
	// 设置error后，系统将自动报错。
});
</code>
==== comment.posterror ==== 
==== comment.postsuccess ====
代码示例：
<code javascript>
// 评论发送成功
zbp.plugin.on("comment.postsuccess", "ZBPJFExample", function (formData, data, textStatus, jqXhr) {
	console.log("系统返回数据：" + data);
	// 同样，这里除了formData是发送的数据外，另外三项是jQuery ajax的参数，参见jQuery手册，不再赘述。
});
</code>
==== comment.get ====
==== comment.got ====
==== comment.reply ====
<code javascript>
//点击回复评论
zbp.plugin.on("comment.reply", "ZBPJFExample", function (id) {
	console.log("Wow! 你要回复ID为" + id + "的评论啊！");
});
</code>

更多系统默认接口代码请看：[[systemevents]]
更多详情请阅读源码： https://github.com/zblogcn/zblogphp/blob/master/zb_system/script/zblogphp.orig.js


===== 模块化调用 =====

==== AMD ====
<code javascript>
<script src="{$host}zb_system/script/require.js" type="text/javascript"></script>
<script>
	require.config({
		baseUrl: '{$host}', 
		paths: {
			jquery: 'zb_system/script/jquery.min', 
			zbp: 'zb_system/script/zblogphp'
		}
	});
	require(["zbp", "jquery"], function (ZBP, jQuery) {
		var zbp = new ZBP({
			bloghost: "{$host}",
			ajaxurl: "{$zbp.ajaxurl}",
			cookiepath: "{$zbp.cookiespath}?>",
			lang: {
				error: {
					72: "{$lang['error']['72']}",
					29: "{$lang['error']['29']}",
					46: "{$lang['error']['46']}"
				}
			}
		}, jQuery);
		console.log(zbp);
	});

</script>
</code>

==== CMD ====

<code javascript>
<script src="{$host}zb_system/script/sea.js" type="text/javascript"></script>
<script>

	seajs.config({
		base: '{$host}', 
		alias: {
			jquery: 'zb_system/script/jquery.min', 
			zbp: 'zb_system/script/zblogphp'
		}, 
		debug: true
	});
	seajs.use(["zbp", "jquery"], function (ZBP, jQuery) {
		var zbp = new ZBP({
			bloghost: "{$host}",
			ajaxurl: "{php}echo $zbp->ajaxurl;{/php}",
			cookiepath: "{php}echo $zbp->cookiespath;{/php}?>",
			lang: {
				error: {
					72: "{php}echo $lang['error']['72'];{/php}",
					29: "{php}echo $lang['error']['29'];{/php}",
					46: "{php}echo $lang['error']['46'];{/php}"
				}
			}
		}, jQuery);
		console.log(zbp);
	});

</code>

在模块中调用
<code javascript>
define(function(require, exports, module) {
	var jquery = require("jquery");
	var ZBP = require("zbp");
	var zbp = new ZBP({
        // Params...
	}, jquery);
	console.log(zbp);
});
</code>

==== CommonJS ====
<code javascript>var ZBP = require("zbp");</code>


==== ES6 Import ====
<code javascript>import * as ZBP from 'zbp';</code>
Z-Blog Wiki

用户工具

站点工具

页面工具
