encoda / ss-image-helpers
SilverStripe 视图辅助模块
dev-master
2015-01-27 12:18 UTC
Requires
- silverstripe/framework: ~3.0
This package is not auto-updated.
Last update: 2024-09-24 16:28:21 UTC
README
SS-image-helpers 是一个 SilverStripe 模块,提供了一些模板方法,即视图辅助,用于图像的使用。
与 SS-Image-Min 兼容良好。
要求
SilverStripe 框架 3.0+
安装
Composer
创建一个 composer.json 文件
{
"require" : {
"encoda/ss-image-helpers": "0.0.0"
}
}
导航到您的项目根目录并运行安装命令。
$ composer install
Github
导航到您的 SilverStripe 应用程序的根目录,并执行 git clone https://github.com/encoda/ss-image-helpers.git
手动
下载 此 zip 文件 并将其解压到您的 SilverStripe 根目录中。
使用方法
ImageAbsoluteUrl( string $image_file_name )
返回给定文件名的 AbsoluteUrl,以应用程序的 absoluteBaseURL 为起始。
<img src="$ImageAbsoluteUrl('example.png')" /> <!-- <img src="http://example.com/assets/images/example.png" /> -->
ImageRelativeUrl( string $image_file_name )
返回给定文件名的 RelativeLink。
<img src="$ImageRelativeLink('example.png')" /> <!-- <img src="assets/images/example.png" /> -->
ImageUrl( string $image_file_name )
返回给定文件名的 Url,以应用程序的 baseURL 为起始。
<img src="$ImageUrl('example.png')" /> <!-- <img src="/assets/images/example.png" /> -->
ImageTag( string $image_file_name )
返回给定文件名的 html Tag。
$ImageTag('example.png') <!-- <img src="/assets/images/example.png" /> -->
配置
图像路径
默认情况下,当任何辅助方法用于在模板中插入图像时,该模块会按名称在以下目录中搜索图像文件:
- assets/
- assets/images/
- themes/{当前主题}/images/
辅助方法会忽略图像路径之外的图像。要向图像路径添加新目录,请将以下行添加到您的 _config.php 中。
<?php SSImageHelpersExtension::add_image_path('my/custom/image/path/');
它还可以以数组的形式同时接受多个路径。
<?php SSImageHelpersExtension::add_image_path(array( 'path/', 'some/image/path/', 'some/new/image/path/', 'and/another/image/path/', ));
许可协议 (MIT)
本软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论是基于合同、侵权或其他原因,以及源自、涉及或与软件或软件的使用或其他交易有关。