| 傲游浏览器插件制作教程 |
Maxthon 插件类型
gMAcF5 http://www.numino.net
Maxthon 的插件类型由 ModuleType (Script，HTML，COM 及 EXE) 及 Type (Button，SideBar，Toolbar，及 Other) 2 个方面同时定义：
7FK9p8 http://www.numino.net
Button SideBar Toolbar Other
7lLcpq http://www.numino.net
Script 支持 支持
t0ofNP http://www.numino.net
HTML 支持
1ODDJ7 http://www.numino.net
EXE 支持
82YXEV http://www.numino.net
COM 支持 支持 支持 支持
0eZPum http://www.numino.net
ModuleType - Script，HTML，COM 及 EXE
5qr97t http://www.numino.net
Script - 可以是按钮类型，在点击按钮时执行脚本。脚本可以采用 IE 支持的脚本语言编写，比如 javascript 及 vbscript。此外 Maxthon 2.0 提供额外的 mscript 脚本执行方式，可以实现更强大插件功能。Script 插件亦可以是侧边栏类型，在侧边栏显示插件指定的 HTML 档案。HTML 档案可以采用 IE 支持的 HTML 语言格式编写。
Y4W297 http://www.numino.net
HTML - 是 Maxthon 2.0 新添加的插件类型，和 Script 侧边栏插件性质相同，主要分别是 Script 侧边栏插件在侧边栏显示，而 HTML 插件则以按钮型式在工具栏显示。
zgV8UB http://www.numino.net
COM - 可以采用任何 MSCOM 支持的语言编写，比如 C++，C#，Visual Basic，Delphi 等。Maxthon 默认支持按钮类型，工具栏类型及侧边栏类型 COM 插件。另外，COM 插件亦可以自行添加拟采用的插件显现方式，比如菜单或弹出窗口。
DPZ3I2 http://www.numino.net
EXE - 可以是任何可执行档案，以工具栏按钮形式在 Maxthon 显现。Maxthon 可以在执行 EXE 插件是提供参数，比如页面地址及 Maxthon 窗口的句柄等
28Yp52 http://www.numino.net
Type - Button，SideBar，Toolbar，Other
mzuSi9 http://www.numino.net
Button - 插件会在插件栏添加一个按钮，点击按钮时会执行指定由脚本 (Script 插件)，程序 (EXE 插件)，DLL (COM 类型插件)，指定的操作。Script 及 EXE类型按钮插件可以选择性在插件按钮添加下拉菜单。
vk9tYn http://www.numino.net
SideBar - 插件会在侧边栏添加一个按钮，及在主菜 > 查看 > 侧边栏添加一个命令，在执行时会打开侧边栏及显示插件指定的 HTML 页面。
99jr2v http://www.numino.net
Toolbar - 插件会添加一个工具栏，新添加的工具栏可以在主菜 > 查看 > 工具栏选择是否显示。
Wc566w http://www.numino.net
Other - 插件没有固定显示接口，插件可以因应需要自行改变接口，比如改变菜单，添加按钮
nxTAO9 http://www.numino.net
制作 Maxthon 插件
4DO1d3 http://www.numino.net
Maxthon 插件的主要元件 Maxthon 插件一般具备以下档案：
444WY3 http://www.numino.net
INI 档案 – plugin.ini 必须，定义插件的各个属性
3vnQ6Q http://www.numino.net
HTML/DLL/EXE 档案 – 必须，指定插件需要执行的操作，或需要显示的内容
GY14FI http://www.numino.net
图标档案 – 按钮图标 (*.ICO)，适用于按钮类型及侧边栏类型插件，COM 或 EXE 插件可以用 DLL 或 EXE 内含图标
7AjRUn http://www.numino.net
Config.html – 选择性，应用于 Script 及 HTML 类型插件的设置窗口
gMK9rJ http://www.numino.net
plugin.ini 档案
RWmJS2 http://www.numino.net
每个 Maxthon 插件必须具备一个 plugin.ini 档案，定义插件的各项属性。
dbqHbs http://www.numino.net
[General] 必须，定义插件的主要属性
nS7o5e http://www.numino.net
Name= 插件名称
oC0LPT http://www.numino.net
Author= 作者名字
7odZ20 http://www.numino.net
Version= 版本号
3cf0iG http://www.numino.net
ModuleType= 可以是 Script，HTML，COM 或 EXE
2OudXD http://www.numino.net
FileName= 可以是 HTML 档案 (Script 及 HTML 插件)，DLL 档案 (COM 插件)，或 EXE 档案 (EXE 插件)
GkNVwM http://www.numino.net
Comments= 在插件选项或按钮的工具提示所显示的描述
mchkSu http://www.numino.net
Type= 可以是 M2Plugin_BUTTON，M2Plugin_SIDEBAR，M2Plugin_Toolbar 或 M2Plugin_Other
T1yq6i http://www.numino.net
IdealSize= 指定插件在接口显示的大小，比如 “120 20”(阔度 高度，适用于 HTML 插件)
9oH9LK http://www.numino.net
IdealSizeVertical= 选摘性，指定当工具栏在垂直放置的插件接口显示的大小，比如 “120 20”(阔度 高度，适用于 HTML 插件)
vUmMDH http://www.numino.net
Icon= 在按钮或侧边栏插件显示的图标 (适用于按钮及侧边栏插件)
SJCJKB http://www.numino.net
HotIcon= 当鼠标移到插件按钮上时显示的图标 (适用于按钮插件)
EYtW3F http://www.numino.net
CLSID= COM 插件的 CLSID (适用于 COM 插件)
VoHIA8 http://www.numino.net
StartAfterPageDone= 0 或 1，选摘性，设置 script 按钮插件是否自动执行
8dnthZ http://www.numino.net
DefaultLocation= 按钮插件的默认显示位置，可以是 None (在插件栏，但不显示)，MenuBar (菜单栏)，ToolBar (标准工具栏)，或 StatusBar (状态栏)。如果不设置则在插件栏显示。
J9R037 http://www.numino.net
StartAfterPageDoneUrl= 设置 script 按钮插件自动执行的地址，使用通配符格式，可以用 "|" 分隔多个网站，比如 *maxthon.com*|forum.maxthon.cn*。不设置的话在所有地址自动执行，等同设置为 *
jC62VC http://www.numino.net
StartAfterPageDoneUrlExclude= 设置 script 按钮插件不自动执行的地址，使用 startAfterPageDoneUrl 相同格式，比如 forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*
iJyFKp http://www.numino.net
[MyIE2Buttons] 选摘性，定义按钮类型插件的下拉菜单，适用于 Script 及 EXE 类型插件
o3rX61 http://www.numino.net
Count= 插件下拉菜单项目的数量
g0KCon http://www.numino.net
Name1= 第一个下拉菜单项目的名称，如此类推
922G0V http://www.numino.net
FileName1= 提供第一个下拉菜单项目应执行的代码的档案，如此类推
pemBYe http://www.numino.net
安装 Maxthon 插件
jZiE34 http://www.numino.net
Maxthon 插件是安装在 Maxthon 目录内的 Plugin 目录。每个插件在 Plugin 目录内均有独立的目录，目录内包含 plugin.ini 及其他插件档案或子目录。
IFSUx2 http://www.numino.net
制作好的插件可以把插件的目录连同内里的 plugin.ini 及所有其他档案及子目录打包成 ZIP 档案(*.zip) 发布
xJ1PUK http://www.numino.net
Maxthon 2.0 插件
w3KJLN http://www.numino.net
Maxthon 2.0 支持专用的 M2P 插件安装包格式 (把*.zip 更名为 *.m2p 即可)，用户只要双击 M2P 档案或把M2P 档案拖放到 Maxthon 2.0 窗口插件便会自动安装
ks46PD http://www.numino.net
Maxthon 1.X 插件
1JSYS4 http://www.numino.net
在 Maxthon 1.X 安装插件需按照以下步骤：
Nh98pb http://www.numino.net
1. 关闭 Maxthon 浏览器。
7J4u7P http://www.numino.net
2. 把 ZIP 档案解压到 Maxthon 目录内的 Plugin 目录。完成後插件的 plugin.ini 档案应在类似如下位置：C:\Program Files\Maxthon\Plugin\新插件\plugin.ini
GoP6T4 http://www.numino.net
3. 打开 Maxthon 浏览器，插件安装窗口会出现
U4U4OV http://www.numino.net
4. 确认安装新插件
raCTlj http://www.numino.net
Maxthon 脚本插件指令
57SY0x http://www.numino.net
Maxthon 提供多种插件指令供脚本插件调用，以加强脚本插件的功能。这些插件指令可以透过 window.external 执行。部份插件指令需要提供 Security ID 参数方能执行，而Security ID则由 Maxthon 提供给脚本插件。
QYm7eU http://www.numino.net
如何取得 Security ID
NEQ6ee http://www.numino.net
1. 按钮插件可以在脚本中直接使用 %max_security_id 作为 Security ID
tNzrW7 http://www.numino.net
2. 侧边栏及 HTML 插件需要载入由 Maxthon 自动产生的脚本 max.src，之後便能使用 max_security_id 作为 Security ID。
8Ru52I http://www.numino.net
<script src=max.src></script>
FzZS50 http://www.numino.net
Maxthon 插件指令
hvzDAM http://www.numino.net
除特别注明外，以下插件指令同时适用于 Maxthon 2.0 及 Maxthon 1.X。
3Cxi4K http://www.numino.net
1. max_version - 传回 Maxthon 版本号
obG7gv http://www.numino.net
例子：
8p73WR http://www.numino.net
alert(external.max_version);
xf8iJm http://www.numino.net
2. max_language_id - 传回 Maxthon 语言编码
ofT6U9 http://www.numino.net
例子：
YVrNjr http://www.numino.net
alert(external.max_language_id);
Qoficw http://www.numino.net
注意 Maxthon 2.0 和 Maxthon 1.X 所采用的语言编码格式并不相同
wqRCSk http://www.numino.net
3. tab_count - 传回 Maxthon 打开的标签数量
3crPh6 http://www.numino.net
例子：
KHDp2t http://www.numino.net
alert(external.tab_count);
a4MY8p http://www.numino.net
4. cur_sel -传回 Maxthon 当前标签的 index
3Q0lk8 http://www.numino.net
例子：
Ps6YKG http://www.numino.net
alert(external.cur_sel);
h1i8d9 http://www.numino.net
5. m2_plugin_folder( security_id , plugin_name ) - 传回指定插件目录位置
pzu4f6 http://www.numino.net
例子：
9ij8OM http://www.numino.net
alert(external.m2_plugin_folder( %max_security_id , ViewSource! ));
lYh696 http://www.numino.net
6. m2_run_cmd( security_id , command_id ) - 执行指定的 Command ID
3v3Z5M http://www.numino.net
例子：external. m2_run_cmd( %max_security_id , 32772 ));
uHLz2G http://www.numino.net
注意 Maxthon 2.0 和 Maxthon 1.X 所采用的 Command ID 并不相同，Command ID 可以在 Maxthon 的语言文件中找到
5Bpd61 http://www.numino.net
7. get_tab( security_id , tab_index ) - 传回指定标签的 window object
ugMb87 http://www.numino.net
例子：
459p1r http://www.numino.net
var oWin=external.get_tab(%max_security_id, 0);
0Ajaw6 http://www.numino.net
alert(oWin.document.URL);
1lgeta http://www.numino.net
8. activate_tab( security_id , tab_index ) - 激活指定标签
H9Xk87 http://www.numino.net
例子：
D5qnPc http://www.numino.net
external.activate_tab(%max_security_id, 0);
x787HQ http://www.numino.net
9. close_tab( security_id , tab_index ) - 关闭指定标签
0BnNjE http://www.numino.net
例子：
84jx8X http://www.numino.net
external.activate_tab(%max_security_id, 0);
Me0qOt http://www.numino.net
10. readFile( security_id, plugin_name, file_name) - 读取文本档案内容
647OKh http://www.numino.net
例子：
QcU6ZS http://www.numino.net
var sText=external.readFile(%max_security_id, ViewPage, readme.txt);
JseJcM http://www.numino.net
alert(sText);
885EPv http://www.numino.net
11. writeFile( security_id, plugin_name, file_name, content ) - 写入文本档案内容
AHt3GM http://www.numino.net
例子：
gTYCs5 http://www.numino.net
external.writeFile(%max_security_id, ViewPage, test.txt, 测试);
ne7Rix http://www.numino.net
12. m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value) - 读取 INI 档案资料
l17hQ7 http://www.numino.net
例子：
rq9r38 http://www.numino.net
var sDownloadTool=external.m2_readIni(%max_security_id, ViewPage, plugin.ini, Settings, DownloadTool, );
DAaMd6 http://www.numino.net
alert(sDownloadTool);
BhlzJP http://www.numino.net
13. m2_writeIni( security_id , plugin_name , file_name , section_name , key , value ) - 写入INI 档案资料
PBnHwk http://www.numino.net
例子：
5SlMnl http://www.numino.net
external.m2_writeIni(%max_security_id, ViewPage, test.ini, Config, height, 100px);
5FlJwI http://www.numino.net
14. max_modelessDialog( security_id , url , option , attr , window ) - 传回非模式网页对话框
iPEE40 http://www.numino.net
例子：
usU9Mv http://www.numino.net
var oDialog= external.max_modelessDialog( %max_security_id , blank.html, window , , window );
X0OgkW http://www.numino.net
var oDoc=oDialog.document;
8EUK7J http://www.numino.net
oDoc.write(测试);
HsM7uH http://www.numino.net
oDoc.close();
hFy8Ef http://www.numino.net
15. max_activex(security_id ,program_id) -传回指定的 ActiveX object
y12n5o http://www.numino.net
例子：
DC8quK http://www.numino.net
var oWSH=external.max_activex(%max_security_id, WScript.Shell);
9vc162 http://www.numino.net
oWSH.run(notepad.exe);
qT8gdy http://www.numino.net
16.max_callback(event_name) - 在 Maxthon 的一些事件发生时会被执行 (适用于 HTML 钮插件及 Script 侧边栏插件 )
KXs48i http://www.numino.net
HTML 按钮插件及 Script 侧边栏插件可以加入 max_callback 函数以便对 Maxthon 浏览器发生的一些事件作出反映。比如撤换到另一个标签，或当前的标签重新加载等。
zS255P http://www.numino.net
例子：
3Gotq7 http://www.numino.net
function max_callback(x){
7e1Zqn http://www.numino.net
if(x==tab_change) alert(Current tab is changed.);
V4Dp05 http://www.numino.net
}
Sr6ZHh http://www.numino.net
透过检查传回的 max_callback参数，插件可以探测一些在 Maxthon 浏览发生的事件，目前以下参数会被传回：
8Xc5QJ http://www.numino.net
HTML 按钮插件
YLaEmz http://www.numino.net
tab_change – 当改变当前的标签後传回
dWJMEo http://www.numino.net
document_Complete - 当前的标签页面加载後传回
dG421u http://www.numino.net
Script 侧边栏插件
bJm2EP http://www.numino.net
sidebar_tab_change -当改变当前的标签後传回
MEBQ3S http://www.numino.net
sidebar_activate - 当侧边栏插件被激活後传回
kOY1iy http://www.numino.net
sidebar_deactivate - 当侧边栏撤换到其他侧边栏项目後传回
WsCNIN http://www.numino.net
sidebar_unload - 当侧边栏插件被卸做载时传回
nTF2c0 http://www.numino.net
17. max_getObj (只适用于 Maxthon 2.0) -传回指定的 Maxthon object，包括：
gBtD9f http://www.numino.net
Info - 关于Maxthon 的资料
92jkqs http://www.numino.net
Adhunter – 关于广告猎手
5yDp0T http://www.numino.net
FavManager – 关于收藏
0u4852 http://www.numino.net
RssManager – 关于 RSS
pquvQH http://www.numino.net
例子：
aOdHpa http://www.numino.net
var oInfo=external.max_getObj(%max_security_id, info);
SDC2bP http://www.numino.net
Info Object 支持以下 properties 及 method:
z3RxyV http://www.numino.net
Property:
Rc107l http://www.numino.net
fileProxy - read-only，传回当前用户的代理设置文件位置
qOzg13 http://www.numino.net
例子：
24rGxp http://www.numino.net
var oInfo=external.max_getObj(%max_security_id, info);
K2lTTY http://www.numino.net
alert(oInfo.fileProxy);
788oW7 http://www.numino.net
folderUser - read-only，传回当前用户的设置目录位置
Y4lVHm http://www.numino.net
例子：
cgH6sN http://www.numino.net
var oInfo=external.max_getObj(%max_security_id, info);
60vLAA http://www.numino.net
alert(oInfo. folderUser);
omOl1l http://www.numino.net
Method
sou3Rg http://www.numino.net
getFolderPluginData(plugin_name) - 传回指定插件的设置目录位置
qKsQIa http://www.numino.net
例子：
Lsmz8b http://www.numino.net
var oInfo=external.max_getObj(%max_security_id, info);
bkD4AE http://www.numino.net
alert(oInfo.getFolderPluginData(ViewSource!));
8v9E7e http://www.numino.net
AdHunter object支持以下method:
muoj7P http://www.numino.net
Method:
wCa9av http://www.numino.net
reloadFilter(filter_name) – 插件可以修改 filter 的 xml 文件，然後用这个指令让 Maxthon 重新载入，目前只支持 content
p85zWJ http://www.numino.net
例子：
47dHrQ http://www.numino.net
var oAdHunter=external.max_getObj(%max_security_id, AdHunter);
O0pMpM http://www.numino.net
oAdHunter.reloadFilter(content);
KB6uoG http://www.numino.net
enableFilter(filter_name, bEnable) – 插件可以用这个指令开启或关闭 Maxthon 的过滤功能，目前支持的 filter_name 为 content (内容过滤) 及popup (弹出窗口过滤)。bEnable 为 true 或 false
sB1R6K http://www.numino.net
例子：
HjDpCF http://www.numino.net
var oAdHunter=external.max_getObj(%max_security_id, AdHunter);
5hUbTH http://www.numino.net
oAdHunter. enableFilter (content, false);
Va1RTa http://www.numino.net
PluginManager Object 支持以下 method:
h2Emu3 http://www.numino.net
Method:
eTZRl5 http://www.numino.net
getPluginFolder - read only, 取得 Maxthon 的主插件目录
pj1BHe http://www.numino.net
例子：
AmGLc0 http://www.numino.net
var oPluginManager=external.max_getObj(%max_security_id, PluginManager);
n0nr8N http://www.numino.net
alert(oPluginManager.getPluginFolder);
w3LIq7 http://www.numino.net
getCount - read only, 取得所有安装插件的数量，包括启用及没启用的
iTLhKo http://www.numino.net
例子：
Xu2g8U http://www.numino.net
var oPluginManager=external.max_getObj(%max_security_id, PluginManager);
pcJuL7 http://www.numino.net
alert(oPluginManager.getCount);
KrmDh4 http://www.numino.net
getList - read only, 取得插件清单，包括名字，作者等讯息
zaVVyr http://www.numino.net
例子：
Y3ZVkD http://www.numino.net
var oPluginManager=external.max_getObj(%max_security_id, PluginManager);
lV117H http://www.numino.net
alert(oPluginManager.getList);
Esq0ps http://www.numino.net
getCount - read only, 取得所有安装插件的数量，包括启用及没启用的
7ad2Rl http://www.numino.net
例子：
8ebdHf http://www.numino.net
var oPluginManager=external.max_getObj(%max_security_id, PluginManager);
L585od http://www.numino.net
alert(oPluginManager.getCount);
t949ae http://www.numino.net
getList - read only, 取得插件清单，包括名字，作者等讯息
TPXcOQ http://www.numino.net
例子：
dWWV3y http://www.numino.net
var oPluginManager=external.max_getObj(%max_security_id, PluginManager);
YPgWQ0 http://www.numino.net
alert(oPluginManager.getList);
cKDwWj http://www.numino.net
getPlugin(Index) - Index 为数字，取得对应的插件对象
WwhSit http://www.numino.net
例子：
i6vaMj http://www.numino.net
var oPluginManager=external.max_getObj(%max_security_id, PluginManager);
EhV6kr http://www.numino.net
var oPlugin=oPluginManager.getPlugin(0);
52k8ey http://www.numino.net
由 getPlugin 取得的插件对象支持以下 property 及 method:
OxFboo http://www.numino.net
Property:
LT3iHc http://www.numino.net
title - read only, read only, 传回插件的名字
f1JzG3 http://www.numino.net
例子：
mQ7qFg http://www.numino.net
alert(oPlugin.title);
SqUYH8 http://www.numino.net
folderName - read only, 传回插件的目录名称
mM3B73 http://www.numino.net
例子：
2GtrvC http://www.numino.net
alert(oPlugin.folderName);
M7ocwo http://www.numino.net
fullPath - read only, 传回插件的目录的完整地址
RxAx4S http://www.numino.net
例子：
8lnB7n http://www.numino.net
alert(oPlugin.fullPath);
6i42gP http://www.numino.net
enable - read/write, 传回或设置插件的启用状态
VDGuyo http://www.numino.net
例子：
e9AbA4 http://www.numino.net
oPlugin.enable=false;
x50qSx http://www.numino.net
alert(oPlugin.enable);
9kogyZ http://www.numino.net
oPlugin.enable=true;
YYf17t http://www.numino.net
alert(oPlugin.enable);
53Me5E http://www.numino.net
startAfterPageDone - read/write, 传回或设置插件是否自动执行
fwUm4f http://www.numino.net
例子：
PPnio6 http://www.numino.net
oPlugin.startAfterPageDone=false;
b7Y0SS http://www.numino.net
alert(oPlugin.startAfterPageDone);
5ti1Gd http://www.numino.net
oPlugin.startAfterPageDone=true;
8G6aD7 http://www.numino.net
alert(oPlugin.startAfterPageDone);
Y8cpRj http://www.numino.net
startAfterPageDoneUrl - read/write, 传回或设置插件自动执行的地址
nsTR6X http://www.numino.net
例子：
W33urJ http://www.numino.net
oPlugin.startAfterPageDoneUrl=*maxthon.com*|*maxthon.cn*
jtcTWi http://www.numino.net
alert(oPlugin.startAfterPageDoneUrl)
Rbomvh http://www.numino.net
Method:
9LF7Pu http://www.numino.net
config() - 打开插件的设置对话框 (config.html)
951WzU http://www.numino.net
例子：
pp3iL2 http://www.numino.net
oPlugin.config();
eQp1ll http://www.numino.net
remove() - 删除插件
ZHzFzC http://www.numino.net
例子：
kzdU6t http://www.numino.net
oPlugin.remove();
3z1p3L http://www.numino.net
Mscript
q969W9 http://www.numino.net
Maxthon 2.0 提供额外的 mscript 脚本执行方式供 Script 按钮插件使用。和一般脚本不同，mscript 并非在页面上执行脚本，因此 mscript 可以不受一般网页脚本安全限制，亦不用担心被网页恶意利用。mscript 可以在页面禁用脚本情况下执行，也可以处理页面内跨域的框架内容，能大大提升 Script 按钮插件能力。要在 Script 按钮插件采用 mscript 方式执行脚本，只需把 <script...> 标签改为 <mscript...>。
s30FfF http://www.numino.net
例子 - 以下的是一般 Script 按钮插件，可以透过内容控制禁止当前页面执行脚本：
9ClOFE http://www.numino.net
<script language="javascript">
xn3JHW http://www.numino.net
external.m2_run_cmd(%max_security_id, 33175);
zztD9Y http://www.numino.net
</script>
KgeBLa http://www.numino.net
但在插件运行後页面已经不能执行脚本，插件不能再次运行恢复在当前页面执行脚本。然而使用以下的 mscript 则没有这问题，在页面不能执行脚本情况下，mscript 插件仍然可以运行，恢复在当前页面执行脚本：
BLe5qR http://www.numino.net
<mscript language="javascript">
3Jyzhw http://www.numino.net
external.m2_run_cmd(0, 33175);
Ma1m3l http://www.numino.net
</script>
|
|