|
|
| 搜狗工具条插件制作说明 |
|
| 1. 插件概述 |
|
搜狗工具条插件是搜狗工具条（IE工具栏）上的功能按钮。点击搜狗工具条上的插件按钮，可以在IE浏览器的左侧打开插件功能页面。在插件功能页面中，可以提供丰富的上网功能。只要根据本说明制作和提交的插件，均可以通过一个对应的URL，很方便的安装到搜狗工具条上。
 |
|
| 2. 制作插件 |
|
| 制作搜狗工具条插件，只需要根据要求制作两个部分：插件按钮图标和插件功能页面，并且把它们上载到WEB服务器上。 |
|
| 2.1. 插件按钮图标 |
|
| 插件按钮图标的设计应当尽量体现出插件的功能，并且和其他插件的图标有明显的区别。图标必须为icon格式，大小为16*16像素，256色。 |
|
| 2.2. 插件功能页面 |
|
| 插件功能页面可以为htm、html、asp、jsp、php等格式的页面文件。页面的显示宽度为200像素，其中包括滚动条的宽度。 |
| 插件功能页面可以包含以下扩展功能来实现和IE主窗口的互动、插件管理等功能。 |
|
| 获得IE主窗口当前页面的网址 |
| 说明：通过external对象的host_URL属性可以得到IE浏览器当前页面的URL |
| 格式：external.host_URL |
| 示例：alert(“当前正在浏览：”+external.host_URL); |
|
| 获得IE主窗口的Title |
| 说明：通过external对象的IETitle属性可以得到当前IE浏览器的Title |
| 格式：external.IETitle |
|
| 在当前的IE主窗口中浏览页面 |
| 说明：如果没有任何附加的选项，那么用户在插件功能页面中点击一个链接的时候将会在IE浏览器左侧的插件页面窗口中打开页面。如果想在IE浏览器右侧的主窗口中打开链接指向的页面，有两种方法可以实现： |
| 方法一：在写URL时使用特定格式的URL。 |
| 格式：”host:” + 原URL |
| 示例：<a href=”host:http://www.sogou.com”>捜狗</a> |
| 方法二：使用external对象的host_Navigate2方法 |
| 格式：external.host_Navigate2(目的URL); |
| 示例：<a href=# onclick=”external.host_Navigate2(‘http://www.sogou.com’)”>捜狗</a> |
|
| 在搜狗工具条上添加新插件 |
| 说明：通过external对象的addPlugin方法可以添加新插件。 |
| 格式：external.addPlugin(插件的ID) |
| 示例：添加一个ID为{00000000-0000-0000-0000-000000000001}的插件，的格式为：external.addPlugin(‘00000000-0000-0000-0000-000000000001’); |
|
| 检查用户的搜狗工具条上是否安装了某一插件 |
| 说明：使用external对象的hasPlugin可以检测用户是否已经安装某个ID的插件 |
| 格式：bool external.hasPlugin(要检查的插件的ID) |
| 示例：要检查ID为{00000000-0000-0000-0000-000000000001}的插件是否存在： |
| if(external.hasPlugin(“{00000000-0000-0000-0000-000000000001}”)){ |
| //用户已经安装该插件 |
| }else{ |
| //用户还没有安装该插件 |
| } |
|
| 得到指定插件的版本号 |
| 格式：external.getPluginVersion(插件的ID) |
| 示例：想得到GUID为{00000000-0000-0000-0000-000000000001}的插件的版本： |
| pluginVersion = external.getPluginVersion("{00000000-0000-0000-0000-000000000001}") |
|
| 删除指定插件 |
| 格式：external.delPlugin(插件的ID) |
| 示例：想删除GUID为{00000000-0000-0000-0000-000000000001}的插件： |
| external.delPlugin(“{00000000-0000-0000-0000-000000000001}”) |
|
| 得到Toolbar的版本号 |
| 格式：external.toolbarVersion |
| 示例：判断toolbar的版本是否在0x100以上： |
| if(external.toolbarVersion>0x100){ |
| //Toolbar版本达到要求 |
| }else{ |
| //Toolbar版本没有达到要求 |
| } |
|
| 3. 注册插件 |
|
只有注册成功的插件，才能被添加到搜狗工具条上。在搜狗工具条官方网站上的在线管理页面可以注册和管理插件。
 |
| 在第一次注册插件或皮肤前，需要先申请一个用户名。一个用户名可以注册和管理多个插件或皮肤。在用户信息中填写的“作者署名”将作为插件或皮肤的作者名称在相关推广页面中显示。 |
| 在成功登录后，可以进入自己的管理页面。这里列出了自己制作过的所有插件和皮肤，也可以通过“注册插件”按钮注册新的插件： |
| 在“注册插件”页面中按要求填写插件的相关信息，即可完成插件的注册。 |
|
| 4. 发布插件 |
|
| 只要注册成功的插件都可以通过一个URL进行安装，经我们审核后认为制作的比较完善的插件，还会放在搜狗工具条的官方网站上推广。 |
| 插件注册成功后，将会被分配给一个作为插件唯一标志的ID。在插件管理页面中，点击每个插件的“修改”链接，可以打开插件的修改页面，在这个页面的最上面显示插件的ID。如果插件被分配的ID为：00000000-0000-0000-0000-000000000001，
就可以通过这个URL安装到搜狗工具条上：http://tb.sogou.com/plugin?guid=00000000-0000-0000-0000-000000000001。这个了URL后面可以带多个逗号分隔的插件ID以实现一次添加多个插件的功能。如果点击这个URL前，用户的计算机上还未安装搜狗工具条，将会先提示安装，安装成功后，自动添加这个插件。 |
|
| 5. 管理插件 |
|
| 在搜狗工具条官方网站上的在线管理页面可以注册和管理插件。 |
| 如果插件作者要修改插件的相关信息，应用注册插件时使用的用户名登录到管理页面中，点击要修改的插件后面的“修改”按钮，进入该插件的修改页面。如果只是修改插件功能页面的代码或插件按钮图标，而不用改变它们的URL，只要在上载它们的WEB服务器上操作就可以，不必再通过插件管理页面修改任何信息。 |
|
|
