帮助中心

友荐客户端JS自定义API


通过友荐获取代码的功能,网站主可以便捷的获取到符合自己网站风格的推荐代码。对于大多数的网站而言,或许已经足够。但是,一定还有不少的网站主想拥有更加个性化的自定义功能。下面我们为您梳理了一些常用的自定义功能的配置方法和参数,使用起来非常的简单,希望能帮助到您。所有的自定义功能都在ujian_config中定义,完成配置后,将语句放在友荐的主js(ujian.js)的前面即可。

需要说明的是,如果你是一个友荐注册用户,并且您的网站通过了验证,那么你可以直接在友荐的管理后台完成自定义设置,不需要您再修改您网站你嵌入的友荐代码,是不是很方便呢?赶快免费注册试一下下吧。


下面是ujian_config参数的详细说明:

参数名 描述 类型 默认值
lkrc (只对嵌入式有效)喜欢推荐功能 0:关闭 1~6:样式 integer 1
url 自定义推荐的URL string 网页地址
title 文章标题 string 浏览器网页title
borderColor (非嵌入文本式可用)边框颜色设置,可以是CSS中color属性支持的任意值,(如#FFF或者orange) string #dddddd
mouseoverColor 鼠标滑过时候的背景色 string #E6F3DE
textColor 文字颜色设置,可以是CSS中color属性支持的任意值,(如#FFF或者orange) string #333333
hoverTextColor 鼠标滑过时候的文字颜色设置,可以是CSS中color属性支持的任意值,(如#FFF或者orange)。 string 与textColor一致
tags 文章tag标签,以英文逗号分隔,如:"标签1,标签2" string
domains 相关文章来自于,0=显示的站内相关网页来自于本子域名下,1=显示的站内相关网页来自于顶级域名下的所有子域名,也可以单独配置子域名,中间用英文逗号隔开,如 "a.ujian.cc,b.ujian.cc,ujian.cc",注意,站点如果包含www,如www.ujian.cc,请去掉www. string 0
defaultPic (只对图文显示生效)设置没有图片文章的默认图片 string
textHeight 图片描述文字高度,行高为15,15~75, 单位:px integer 60px
target 设置打开内容连接的方式,0=当前窗口,1=新窗口 integer 0
num (只对嵌入式有效)嵌入式推荐文章数量,1-10条 integer 5
bgColor (只对嵌入式有效)背景色设置,可以是CSS中color属性支持的任意值,(如#FFF或者orange)。 string 网页的背景色
showType (只对嵌入式有效)显示方式,0=智能,1=文字,2=图文 默认:2 (智能:结果集中有一半有图片时,显示为图文方式,否则显示为文字) integer 2
itemTitle (只对嵌入式有效)模块显示的名称 string 猜你喜欢:
cutLineColor (只对嵌入图文式有效)文章分割线颜色,可以是CSS中color属性支持的任意值,(如#FFF或者orange)。
string 与borderColor一致
fillet 设置图片是否圆角,0=否,1=是
integer 1
space (只对嵌入图文式有效)图片到分割线的距离,范围1~100, 单位:px
integer 5px
picSize3 (只对双列图文式有效)图片模式的图片大小,范围30~200, 单位:px
integer 50px
picSize (只对嵌入图文式有效)图片模式的图片宽度,范围30~200, 单位:px
integer 96px
picHeight (只对嵌入图文式有效)图片模式的图片高度,范围30~200, 单位:px


例 如:
<script type="text/javascript">
var ujian_config = {
	lkrc : 1,
	url : "http://ujian.cc",
	title : "",
	tags : "",
	domains : "",
	borderColor : "#FF1605",
	mouseoverColor : "#FFFF03",
	textColor : "#24FF03",
	hoverTextColor : "#050DFF",
	target : 0,
	bgColor : "#F9EDFF",
	num : 5,
	picSize : 96,
	textHeight : 60,
	showType : 2,
	defaultPic:"http://img.ujian.cc/default/10.jpg",
	itemTitle : "猜你喜欢:"
} 
</script>						
integer 与picSize一致


下面是ujian.js后面参数的详细说明:

参数名 描述 类型 默认值
pos (只对侧栏式有效)侧栏式显示的位置,right,left string right
btn (只对侧栏式有效)侧栏式的风格,1=蓝色风格,2=橙色风格,3=灰色风格,4=绿色风格 integer 1
num (只对侧栏式有效)侧栏式推荐文章的数量 1-5 integer 5
icon (只对侧栏式有效)侧栏式图标,1=推荐+回顶部,2=推荐,3=回顶部 1 1
ibtm (只对侧栏式有效)侧栏式的回到顶部和猜你喜欢心形图标距离底部的距离,默认为10 integer 10
picsize (只对侧栏式有效)侧栏式图片的大小 30~120px 默认为60 integer 60
cbtm (只对侧栏式有效)侧栏式的推荐内容浮动模块距离底部的距离,默认为0,即:始终靠在浏览器底栏


例 如:
<script src="http://v1.ujian.cc/code/ujian.js?type=slide&pos=right&num=5&btn=3&ibtm=10&cbtm=0&picsize=60"
 type="text/javascript"></script>
integer 0