encoda/ss-image-helpers

SilverStripe 视图辅助模块

安装: 32

依赖: 0

建议者: 0

安全: 0

星标: 0

关注者: 4

分支: 1

类型:silverstripe-module

dev-master 2015-01-27 12:18 UTC

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)

本软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论是基于合同、侵权或其他原因,以及源自、涉及或与软件或软件的使用或其他交易有关。