- 如何设置JS调用
-
一、简介
1、什么是JS调用
JS调用就是指用脚本方式调用一个ASP页面,这个页面做一些处理返回 JAVASCRIPT 脚本的一种调用方式。
2、OBLOG4.6版本JS调用的优点
OBLOG4.6之前的版本都是通过jsreadme.asp这个文件来实现JS调用的，从OBLOG4.6版本开始就集成到了系统后台（/admin/admin_login.asp）。OBLOG4.6版本较以前的OBLOG版本有以下好处：
（1）加强了一定的保密性。原来直接放在jsreadme.asp中的时候，只要访问这个文件的其他人就能实现调用这个博客的内容，加大数据库和服务器负担。集成到系统后台之后，其他人就不容易知道这个站都有哪些调用，即使能调用也不能通过修改来实现自己满意的调用。
（2）对调用进行了一定的优化。OBLOG4.6版本的JS调用较以前的OBLOG版本进行了很大优化，以静态页的形式存在，而且可以设定更新的时间，从而大大减少了对数据库的读写操作，保证数据库的稳定性。
二、使用方法注意：因为OBLOG4.6版本的JS调用是生成静态页的，所以博客文件夹下的XmlData文件夹必须给写入和修改权限。
1、JS调用管理的位置
OBLOG4.6版本的JS调用管理在系统后台——系统设置——JS调用管理，如下图所示：
此主题相关图片如下：image001.jpg
2、JS调用管理的设置
点击“JS调用管理”之后，菜单右边就出现了系统默认添加好的一些JS调用分类，这些分类已经涵盖了所有能够调用的分类，如下图所示：
此主题相关图片如下：image002.jpg
这里我们以“日志”这个分类做举例讲解：
此主题相关图片如下：image003.jpg
上图是调用日志的基本信息，从上图可以看到这个调用的更新时间是300秒，添加时间和添加者也在上面。
下面主要讲解下“操作”栏中的“编辑”和“预览”
2.1编辑
点击“编辑”，可以打开此分类的编辑页面，编辑界面分三部分，分别是：基本信息，调用设置和调用模板设置，下面做一一讲解：
2.1.1基本信息设置
此主题相关图片如下：image004.jpg
基本信息这里一般主要看两部分：一部分是调用代码，一部分是数据更新间隔。
（1）调用代码是您可以用这个JS调用代码来调用这个分类。把这句代码放到相应的站中的相应位置就能显示出您要调用的内容。这个调用代码是不能修改的。
（2）数据更新间隔是指每过一段时间更新一次，因为本文开头已经讲过OBLOG4.6的调用是通过生成静态页实现的，所以会有更新时间。这里建议不要设置的太短，太短容易对数据库重复读取，影响稳定性。在设置时间的时候请注意是以“秒”为单位的。
（3）其他各项可不必修改。“调用类型”默认的就可以，这个功能是在添加新JS调用时才能用到的
2.1.2 调用设置
此主题相关图片如下：image005.jpg
日志调用设置中的各项都比较重要，不过设置起来都很简单，根据字面意思就可以看明白是什么意思。这里需要注意的是，日志调用设置只是在日志调用中才有的，其他分类的调用设置都各不相同。作为举例，我们把调用条数设置为5条，日志时间范围设置成20天。
2.1.3 调用模板设置
此主题相关图片如下：image006.jpg
调用模板设置是自定义调用，在这里提供了一些可以调用的变量，需要注意的是这些变量都是已经设定好的，只能使用这些变量进行调用。要注意在“模板主体循环标记部分”中只能添加“模板变量说明”中已有的变量。在“模板开始标记部分”、“ 模板主体循环标记部分”、 “模板结束标记部分”只能使用HTML代码填写，如果您对HTML代码不是很了解的话，建议您使用默认的代码即可。
这样我们就修改好日志JS调用了。点击“提交设置”保存修改。
2.2 预览
编辑好调用之后，就可以预览下效果了，点击“JS调用列表”中操作栏中相应分类的“预览”就可以预览编辑后的显示了，因为刚才修改的是“日志”分类，所以我们点击“日志”分类这一行的“预览”，如下图：
此主题相关图片如下：image007.jpg
从上图可以看出，一共调用了5条日志，这与我们在“编辑”中设置的调用条数是一致的。在这里有以下两点需要注意的：
（1）有的时候调用出来的日志达不到自己“编辑”中设置的调用条数（譬如设置调用5条只显示出了3条日志），这可能是因为在“编辑”中的“日志时间范围”设置的太小（也就是在这些天数内只发表了3篇日志，达不到5篇日志），也有可能是在“编辑”中的“数据更新间隔”设置的时间太长，页面还没有进行更新所致。
（2）还有一种情况是设置好之后预览发现显示的还是以前的调用信息，这可能是在“编辑”中的“数据更新间隔”设置的时间太长，页面还没有进行更新所致，一般要想立即看到预览效果，可以把“数据更新间隔”设置的短些，这样等到了更新时间再看预览就可以了。
我们把上图的调用代码拷贝一下，可以点击“拷贝调用代码”按钮进行拷贝。然后我们把这段代码放置到系统模板中的相应位置（此为举例，实际可以放置在其他网站的首页的相关位置上即可）：
此主题相关图片如下：image008.jpg
保存设置，我们来看下首页的显示效果：
此主题相关图片如下：image009.jpg
和“预览”中的对比一下，显示的是一样的调用内容。这样对日志的JS调用就完成了。
3、添加JS调用
除了系统默认设置好的JS调用，还可以添加JS调用，为什么系统默认都设置好了分类还可以再添加呢？这是为了个性化的需求而设计的。以调用日志举例，我们可以设置两个日志调用，一个是调用最新的日志，一个是调用精华的日志。这里，就举一个如何添加调用精华日志的JS调用的例子。
首先是找到在哪里添加，要在系统后台——JS调用管理——JS调用管理（菜单右边）下的管理导航——添加JS调用，如下图所示：
此主题相关图片如下：image010.jpg
单击“添加JS调用”，就打开添加界面了。这个界面同已有的分类的“编辑”界面是一样的，只是要自己定义一下，下面做具体讲解：
3.1 基本信息设置
此主题相关图片如下：image011.jpg
（1）“名称”这里随便写一个英文名字，这里为了方便就写成“ceshi”了。
（2）“调用代码”要特别注意，这里的调用代码目前还不能用，因为在“action＝”后面还没有值。
（3）“调用说明”这里可以写成“精华日志”
（4）“调用类型”这里要从下拉列表中选择“日志”，因为要调用的是“精华日志”。如下图：
此主题相关图片如下：image012.jpg
（5）“数据更新间隔”这里填写的时间可以随意，如果想立即看效果这里可以设置成0，这里我设置成0，等都调试完之后再改成大些的数字（最好高于300秒）
填写完后如下图所示：
此主题相关图片如下：image013.jpg
3.2 调用设置
此主题相关图片如下：image014.jpg
（1）“调用条数”这里可随个人喜好，一般不要超过首页能显示的最大条数，这里举例设置成调用5条
（2）“标题长度限制” 这里也可随个人喜好，一般不要超过首页显示位置的最大长度，这里举例设置成长度为10（如果日志标题字数超过了这里设置的字数，会以……的形式出现在首页）
（3）“日志分类”这里可以选择调用某一日志分类的日志，如果不选择的话调用的是所有日志的分类。
（4）“用户ID”是调用某一用户的日志，这里如果不添的话默认的就是调用所有用户的日志
（5）“日志时间范围”是要调用多少天内的日志，这里举例调用20天
（6）“排序方式”是调用出的日志按照什么方式排列，给了三种方式：日志访问数，日志回复数，发布日期倒序
（7）“是否显示系统分类”是是否显示日志所在的系统日志分类
（8）“是否显示用户专题”是是否显示日志所在的用户自己建立的专题
（9）“是否精华日志”是调用精华日志，因为这个JS调用就是用来调用精华日志的，所以这里要选择上。
（10）“时间格式”这里可以默认不动
设置完后如下图所示：
此主题相关图片如下：image015.jpg
3.3 调用模板设置
此主题相关图片如下：image016.jpg
（1）“模板开始标记部分”这里是用来填写模板开头的HTML标记用的，默认可以不必填写。
（2）“模板主体循环标记部分”这里要填写具体的调用代码，需要调用什么，如何显示，都要在这里设置，可以调用的变量都在右边给出了，只能使用“模板变量说明”中已有的变量。
（3）“模板结束标记部分”这里是用来填写模板结尾的HTML标记用的，默认可以不必填写。
如果对HTML不是很熟悉，直接照搬系统默认给出的调用日志的代码就可以了，填写完后如下图所示：
此主题相关图片如下：image017.jpg
这样就填写完了，点击最下面的“提交设置”完成添加。这样在JS调用界面就出现了我们刚才添加的调用精华日志的JS调用了：
此主题相关图片如下：image018.jpg
OK，还记得上面说过“调用代码”暂时不可用吗？现在再次点击“编辑”，打开编辑界面再看一下：
此主题相关图片如下：image019.jpg
这个时候“调用代码”就可用了，复制之后就可以放在其他网站上调用了。下面来预览下：
此主题相关图片如下：image020.jpg
这样就显示出来了。同样的，可以点击“拷贝调用代码”复制调用代码放到其他网站上进行调用。
对于“调试错误”，是在调用出现错误的时候才用到的，一般调用是没有问题的。
如果在使用过程中还有什么疑问，请访问http://bbs.oblog.cn