https://github.com/imponeer/smarty-image

Smarty plugin that adds some image related template syntax enchaments
https://github.com/imponeer/smarty-image

hacktoberfest image-processing smarty smarty-plugins

Last synced: about 2 months ago
JSON representation

Smarty plugin that adds some image related template syntax enchaments

• Host: GitHub
• URL: https://github.com/imponeer/smarty-image
• Owner: imponeer
• License: mit
• Created: 2021-02-03T17:40:10.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-08-01T17:53:44.000Z (5 months ago)
• Last Synced: 2024-11-03T11:49:45.430Z (about 2 months ago)
• Topics: hacktoberfest, image-processing, smarty, smarty-plugins
• Language: PHP
• Homepage:
• Size: 103 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![License](https://img.shields.io/github/license/imponeer/smarty-image.svg)](LICENSE)

[![GitHub release](https://img.shields.io/github/release/imponeer/smarty-image.svg)](https://github.com/imponeer/smarty-image/releases) [![Maintainability](https://api.codeclimate.com/v1/badges/c284ca86c6df6e98b9d0/maintainability)](https://codeclimate.com/github/imponeer/smarty-image/maintainability) [![PHP](https://img.shields.io/packagist/php-v/imponeer/smarty-image.svg)](http://php.net) 

[![Packagist](https://img.shields.io/packagist/dm/imponeer/smarty-image.svg)](https://packagist.org/packages/imponeer/smarty-image)

# Smarty Image

Some [Smarty](https://smarty.net) syntax plugins for operations with images.

## Installation

To install and use this package, we recommend to use [Composer](https://getcomposer.org):

```bash

composer require imponeer/smarty-image

```

Otherwise, you need to include manually files from `src/` directory. 

## Registering in Smarty

If you want to use these extensions from this package in your project you need register them with [`registerPlugin` function](https://www.smarty.net/docs/en/api.register.plugin.tpl) from [Smarty](https://www.smarty.net). For example:

```php

$smarty = new \Smarty();

$resizeImagePlugin = new \Imponeer\Smarty\Extensions\Image\ResizeImageFunction($psrCacheAdapter);

$smarty->registerPlugin('function', $resizeImagePlugin->getName(), [$resizeImagePlugin, 'execute']);

```

## Using from templates

To resize images from smarty You can use resized_image function:

```smarty

  {resized_image file="/images/image.jpg" height=70}

```

This function supports such arguments:

| Argument | Required | Default value | Description |

|----------|----------|---------------|-------------|

| `file`     | yes      |               | Image file to resize |

| `width`    | if `height` is not specified | | Resized image width |

| `height`   | if `width` is not specified | | Resized image height |

| `fit`     | no | `outside` | Method used for resize. Supported `fill`, `inside`, `outside` |

| `href` or `link`    | no | | if specified and `return` is set to `image`, will output generated HTML as image with link to this specific location | 

| `basedir` | no | $_SERVER['DOCUMENT_ROOT'] | Base dir where to look for image files |

| `return` | no | `image` | Returns result as HTML tag if value is `image`, or as resized image URI if value is `url`.  |

All extra arguments will be rendered into image tag, if return mode is `image`.

## How to contribute?

If you want to add some functionality or fix bugs, you can fork, change and create pull request. If you not sure how this works, try [interactive GitHub tutorial](https://skills.github.com).

If you found any bug or have some questions, use [issues tab](https://github.com/imponeer/smarty-image/issues) and write there your questions.