PHP download

Download the PHP package mullema/k3-image-clip without Composer

On this page you can find all versions of the php package mullema/k3-image-clip. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download mullema/k3-image-clip
More information about mullema/k3-image-clip
Files in mullema/k3-image-clip

Vendor mullema
Package k3-image-clip
Short Description Visual image clip for Kirby 3
License MIT

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of mullema/k3-image-clip

Informations about the package k3-image-clip

Kirby 3: Image Clip

Visual image clipping / cropping.

Image Clip

Overview

Installation
Requirements
Consider a donation
Panel Usage
Replace Files Field
Frontend Usage
- Single Image
- Multiple Images
- File Methods
- Responsive: srcset
License

Installation

Download

Download and copy this repository to /site/plugins/k3-image-clip

Git submodule

Composer

Requirements

Kirby 3.6 -> use v3
Kirby 3.5 -> use v2.2.0
Kirby 3.3 -> use v2.1.0
Kirby 3.2.5 -> use v2.0.0
GD Library or ImageMagick

Consider a donation

This plugin is free but if you use it in a commercial project please consider to make a donation.

Panel Usage

This plugin comes with a image-clip field. It is based on the files field and supports all it's options. Read more about the files field in the Kirby3 Docs.

Example blueprint:

All values are in Pixels.
minwidth, minheight, maxwidth, maxheight limit the clip/crop select area.
None of the clip options are required, but in most cases it is recommended to define minwidth and minheight.
Often it makes more sense to resize the resulting image than defining maxwidth and maxheight.
ratio: fixed locks the ratio
- if minwidth and minheight are defined,
- or maxwidth and maxheight are defined,
- or all of the above.

The field does basic checks of image size and type but counts mainly on you defining e.g, accepted mime types or image sizes in a File Blueprint. You can filter the images list by template like that:

Replace Files Field

The image-clip field is able to replace a files field by changing the field type. Simply replace

with

This works also vice versa to use the native files field instead of the image-clip field.

Frontend Usage

How to fetch the images defined in a image-clip field. Read about the clip() method a bit further down.

Single Image

Important: ~~toFile~~ does not work, use toImage() instead.
toImage() returns a File Object with all it's functions.

Multiple Images

Important: ~~toFiles~~ does not work, use toImages() instead.
toImages() returns a Files Collection with all it's functions.

File Methods

`$file->clip()`

Clip and resize. Generates a Thumbnail of the clip area.

Adapter for $file->thumb(). Returns a FileVersion|File Object.

Used in combination with the image-clip Field, invokes automatically field clip data.
Arguments: clip(width, height)
- if width and height are both defined, the image will be resized with bestfit

`$file->srcset()`

Use this method to generate the srcset attribute for responsive images. Read more about it's functionality in the Kirby3 Docs

`$file->thumb()`

The thumb method accepts now the option clip and can be used with any resizable image.

Clips/crops a square of 500x200px, 10px from top and 200px from the left end of the original image.
Resizes the resulting image to 400px width.
If clip and crop are used at the same time, crop will be ignored.

Read more about the thumb method in the Kirby3 Docs

`$file->getClip()`

Returns the clip data.

Can be useful e.g with the $file->thumb() method.

License

MIT

Credits

Matthias Müller

All versions of k3-image-clip with dependencies

PHP Build Version

Package Version

Version 3.2.0 Release 05. Nov 2022
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of k3-image-clip from vendor mullema

Requires getkirby/composer-installer Version ^1.2

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package mullema/k3-image-clip contains the following files

Loading the files please wait ....