URL 方法 - 友好速搭 -- 开发文档

友好速搭

模板引擎
简介 Liquid 基础语法 Liquid 内置方法 友好速搭主题对象

URL 方法

URL 方法用于输出静态文件的 CDN 地址。友好速搭 CDN 根域名是asset.ibanquan.com

在 URL 方法的输出中,在网址中都会包含问号,以及后面的参数v。这个值是用来标识文件的版本。在文件更新后,这个值会变化,从而实现 CDN 的缓存刷新。

//asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/index_slide_1?v=1416303687_1416226108

图片裁剪缩放

对于存储的图片资源,友好速搭 CDN 提供简单的缩略、裁剪功能。 在图片的链接中,通过在图片名后,以下划线:_间隔,再加处理后缀:w 宽度像素h 高度像素g 裁剪重心。对图片进行指定处理,例如:

定宽等比缩略:

//asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/index_slide_1_w120

定高等比缩略:

//asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/index_slide_1_h40

上面两个链接,处理效果一致。 当同时指定宽和高,没指定重心时,例如index_slide_1_w120h320,将以等比缩略图片,不会裁剪或放大。如需裁剪,需要指定g 参数,例如:

http://asset.ibanquan.com/middle/1423/c/19/5469e53cf2943978e00000cb/slide_w200h100gc

g 参数的重心值,可选以下: #重心

在指定图片处理参数时,如果三个参数,都存在,顺序左至右依次为:whg,顺序不能随意调整。

图片裁剪缩放,适用以下方法:

其它 URL 方法:


asset_url

用于返回主题中资源/Assets目录下的文件地址。

输入:

{{ 'main.css' | asset_url }}

输出:

//asset.ibanquan.com/middle/1423/c/19/5469e53df2943978e00000da/main.css?v=1416316309_1416226109

针对图片处理需求:

输入:

{{ 'index_slide_1' | asset_url | replace: 'index_slide_1', 'index_slide_1/s_w200h200gc.jpg' }}

注意:需要带上文件扩展名

输出:

//asset.ibanquan.com/s/xxx/xxx/index_slide_1/s_w200h200gc.jpg?v=1582259098_1582251333

global_asset_url

获取友好速搭通用资源文件地址,通用文件经过优化,加载速度会更快。

输入:

{{ 'jquery-2.1.4.min.js' | global_asset_url }}

输出:

//asset.ibanquan.com/common/js/jquery-2.1.4.min.js?v=1

以下是部分常用通用文件:

JavaScript 文件 包含内容
jquery-1.11.3.min.js jQuery 1.11.3 的压缩版本
jquery-2.1.4.min.js jQuery 2.1.4 的压缩版本
zepto-1.1.4.min.js Zepto 1.1.4 的压缩版本
riot-2.2.2.min.js Riot 2.2.2 的压缩版本
jquery.qrcode.min.js jQuery QRCode 的压缩版本
图像文件 包含内容
account.png 注册方式图标
banks-160623.png 支付方式图标
oauth-141215.png 社交登录方式图标

image_url

通过 image 对象来获取图片地址,可以通过参数,指定长和宽的像素值,来获取缩略图。

如果image对象为空,则返回空字符串。

输入:

{{ blog_author.avatar | image_url }}
{{ blog_author.avatar | image_url : 400, 400 }}
{{ blog_author.avatar | image_url : 400, 400, "sw" }}

输出:

//asset.ibanquan.com/image/53faebc26387e44752000003/s.jpg?v=1408953282
//ibanquan.ibanquan.com/image/53faebc26387e44752000003/s_w400h400.jpg?v=1408953282
//ibanquan.youhaosuda.com/image/53faebc26387e44752000003/s_w400h400gsw.jpg?v=1408953282

product_image_url

用于商品相关 image 对象的图片地址获取,可以通过参数,指定长和宽的像素值,来获取缩略图。

如果image对象为空,则返回默认的商品图片地址。

输入:

{{ product.feature_image | product_image_url }}
{{ product.feature_image | product_image_url: 400, 400 }}
{{ product.feature_image | product_image_url: 400, 400, "sw" }}

输出:

//asset.ibanquan.com/image/53faebc26387e44752000003/s.jpg?v=1408953282
//ibanquan.ibanquan.com/image/53faebc26387e44752000003/s_w400h400.jpg?v=1408953282
//ibanquan.youhaosuda.com/image/53faebc26387e44752000003/s_w400h400gsw.jpg?v=1408953282

url_for_vendor

输出指定品牌的链接。可直接用于vendor对象或vendor.handle

输入:

{{ vendor | url_for_vendor }}
{{ vendor.handle | url_for_vendor }}

输出:

/vendors/V000002
/vendors/V000002

url_for_type

输出指定商品分类的链接。可直接用于type对象或type.handle

输入:

{{ type | url_for_type }}
{{ type.handle | url_for_type }}

输出:

/types/T000002
/types/T000002

输出登录链接。

输入:

{{ customer_login_link }}

输出:

/account/login

输出注销链接。

输入:

{{ customer_logout_link}}

输出:

/account/logout

输出注册链接。

输入:

{{ customer_register_link}}

输出:

/account/register
免费领取15天试用
立即注册
联系客服
微信咨询
微信二维码

领取免费试用资格

姓名 *

电话 *

公司名称

所在地区

意向产品

提交

提交成功

你好, XXX女士/先生 ,你的需求已提交成功,后续会有专门的客户经理与你电话联系。谢谢!