我的知识 产品 下载 论坛 新功能
Wiz
立即下载
开发插件
下载Wiz

Wiz提供了插件功能,您可以开发Wiz插件,来增加Wiz功能。

1、Wiz插件组成

Plugin.ini文件

这是插件的描述文件,如果该文件包含多种语言文字,例如同时包含中文,日文,韩文等等,您需要将该文件需要按照Unicode或者utf-8编码保存,并且保存的时候,包含Unicode或者utf-8签名。

如果仅在一种语言下使用,可以采用Ansi编码,但是在其他语言下使用,可能会出现乱码。

Plugin.ini描述。下面是一个典型的例子。该文件可以在Wiz安装目录下面的Plugins目录找到。

[Common]
AppName=Blog Downloader…
AppName_2052=博客下载器…
AppName_1028=博客下载器…
AppGUID={6957D596-7CD9-4ddf-A129-7BD093BC5320}
AppType=Normal
AppVersion=1.0
PluginCount=1

[Plugin_0]
Caption=Blog Downloader…
Caption_2052=博客下载器…
Caption_1028=博客下载器…
GUID={8324D9C5-46B2-4f2e-8D26-12B5B610AFF1}
HtmlDialogFileName=BlogDownloader.htm
HtmlDialogTitle=Blog Downloader
HtmlDialogTitle_2052=博客下载器
HtmlDialogTitle_1028=博客下载器
HtmlDialogWidth=500
HtmlDialogHeight=630
Type=HtmlDialog
BeginGroup=0

[Strings]

buttonOK=OK
buttonOK_2052=确定
buttonCancel=Cancel
buttonCancel_2052=取消
WizBrotherBlogName=Official WizBrother Blog
WizBrotherBlogName_2052=WizBrother 官方博客
WizBrotherBlogFeedURL=http://weishijun.com/feed
EnterBlogName=Please enter the blog name
EnterBlogName_2052=请输入博客名称
EnterRssFeedURL=Please enter the RSS Feed URL
EnterRssFeedURL=请输入RSS种子URL
SelectFolder=Please select a folder
SelectFolder_2052=请选择一个文件夹
labelBlogInformation_2052=博客信息
labelBlogName_2052=博客名称
labelRssFeedURL_2052=博客RSS种子URL
labelOptions_2052=选项
labeSaveTo_2052=保存到
labelAddToTaskScheduler_2052=添加到计划任务
labelSaveContentOnly_2052=只保存正文

说明

[Common]部分描述
AppName:插件应用名称。如果插件只有一个功能,则该应用名称和插件功能一致,否则是所有插件功能的概述。
AppName_2052:插件的简体中文名称
AppName_1028:插件的繁体中文名称
AppGUID:插件应用的GUID,不同的插件应用,GUID应该不同。
AppType=Normal:插件应用类型,目前只能是Normal
AppVersion=1.0:插件版本,只能是一个浮点数
PluginCount=1:插件功能数量,只能是整数

[Plugin_0]:某一个插件功能,对应于一个插件菜单。以0开始,0到PluginCount - 1
Caption:插件菜单名称
Caption_2052:插件简体中文菜单名称
Caption_1028:插件繁体中文菜单名称
GUID:插件功能GUID。不同的插件功能,GUID必须不同。
BeginGroup:是否在该插件菜单前面增加一个分割线。0:不增加分割线,1:增加分割线。
Type:插件功能类型。可以是ExecuteScript或者HtmlDialog。ExecScript,表示用户点击菜单后,执行一个脚本或者EXE程序。HtmlDialog,表示用户点击后,打开一个Html对话框。
;HtmlDialog类型的插件所必须的信息
HtmlDialogFileName:Html对话框打开的Html文件名。该文件必须和plugin.ini在同一个目录中。
HtmlDialogTitle:Html对话框标题
HtmlDialogTitle_2052:Html对话框简体中文标题
HtmlDialogTitle_1028:Html对话框繁体中文标题
HtmlDialogWidth:Html对话框宽度,单位是像素
HtmlDialogHeight:Html对话框高度,单位是像素
;ExecuteScript类型的插件所必须的信息
ScriptFileName=脚本或者EXE文件名。该文件必须和plugin.ini在同一个目录中。

[Strings]:插件里面使用到的字符串资源,可以使用
等号左边是字符串名称,右边是字符串实际内容。
字符串名称+下划线+语言代码,可以指定某种语言的字符串。
例如
buttonOK=OK
buttonOK_2052=确定
如果Html对话框中需要支持多种语言,您可以为Html里面的需要本地化的字符串指定一个id,例如:

<span id=”labelAddToTaskScheduler”>Add to Task Scheduler&nbsp; </span>
Wiz在显示这个对话框的时候,会在Strings里面查找名称为labelAddToTaskScheduler_xxxx的字符串,来替换Add to Task Scheduler&nbsp; 。如果没有找到,就查找默认的labelAddToTaskScheduler,如果仍然没有找到,就不进行替换。Wiz支持自动替换语言的Html标记有:span, div, h1, h2, h3, h4, h5, h6, h7, td。

如果要让Wiz自动替换Html对话框里面的字符串资源,您需要在Html文件里面增加下面的脚本:

<script language=“JavaScript” type=“text/javascript”>
    var objApp = new ActiveXObject(“WizExplorer.WizExplorerApp”);
    objApp.PluginLocalizeHtmlDialog(document);    
</script>    
 
您也可以通过脚本,来直接获得某一个字符串资源:
例如:
<script language=“JavaScript” type=“text/javascript”>
    var objApp = new ActiveXObject(“WizExplorer.WizExplorerApp”);
    var appGUID = objApp.GetPluginAppGUID(document);//获得当前插件的AppGUID。
    alert(objApp.LoadPluginString(appGUID, “SelectFolder”));
</script>
 
以后就是Plugin.ini的全部内容。
如果您的插件需要直接执行脚本,则需要将您的脚本和plugin.ini放在同一个目录中,同样,如果现实一个Html对话框,也需要将html文件和plugin.ini放在一个目录中。
然后,将这些文件,都放在Wiz安装目录下面的Plugins\{插件的AppGUID}\这个文件夹里面,例如下面的文件夹。
C:\Program Files\WizBrother\Wiz\plugins\{F1E31C55-A5FB-4d9a-954E-83A2135004C8}
重新启动Wiz,点击插件按钮,就可以看到相应的插件菜单,如下图:
 
 
 
 

2、制作Wiz插件安装文件

将plugin.ini以及其它的文件,压缩成一个zip文件,例如myplugin.zip,然后将扩展名zip修改成wizplugin,例如myplugin.wizplugin,就制作成了一个Wiz插件安装文件。
在安装有Wiz的电脑上面,您只需要在我的电脑或者资源管理器里面双击wizplugin文件,就可以自动安装这个插件。
注意:插件安装在Wiz的数据文件夹,例如 我的文档\My Knowledge\Plugins 这个文件夹中。