Download the PHP package spacecatninja/imager-x-imgix-transformer without Composer

On this page you can find all versions of the php package spacecatninja/imager-x-imgix-transformer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

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 spacecatninja/imager-x-imgix-transformer

Informations about the package imager-x-imgix-transformer

Imgix transformer for Imager X

A plugin for using Imgix as a transformer in Imager X.

This functionality was originally part of Imager X core, but has been extracted into a separate plugin as of Imager X 6.0.

Requirements

This plugin requires Craft CMS 5.0.0 or later, Imager X 6.0.0 or later, and an account at Imgix.

Usage

Install and configure this transformer as described below. Then, in your Imager X config, set the transformer to imgix, ie:

Transforms are now by default transformed with Imgix, test your configuration with a simple transform like this:

If this doesn't work, make sure you've configured a defaultProfile, have a profile with the correct name, and that Imgix is configured correctly.

[!NOTE] If you're upgrading from Imager X 5.x, and overriding imgixProfile in your templates, this will not work anymore. You instead need to set profile in a transformerConfig object. Ie. { imgixProfile: 'someprofile' } becomes { transformerConfig: { profile: 'someprofile' } }.

Cave-ats, shortcomings, and tips

This transformer only supports a subset of what Imager X can do when using the default craft transformer.

To pass additional options directly to Imgix, you can use the transformerParams transform parameter. Example:

Refer to the Imgix Rendering API Documentation for more information and parameters to use.

Installation

To install the plugin, follow these instructions:

  1. Install with composer via composer require spacecatninja/imager-x-imgix-transformer from your project directory.
  2. Install the plugin in the Craft Control Panel under Settings > Plugins, or from the command line via ./craft plugin/install imager-x-imgix-transformer.

Configuration

You can configure the transformer by creating a file in your config folder called imager-x-imgix-transformer.php, and override settings as needed.

Plugin settings

defaultProfile (string, default 'default') The profile to use by default. Can be overridden per transform by passing imgixProfile as a transform parameter.

apiKey (string, default '') Global Imgix API key, used for purging. Can be overridden per profile via the profile's own apiKey setting.

autoPurge (bool, default true) Automatically purge assets from Imgix when they are replaced or moved in Craft.

purgeElementAction (bool, default true) Show a "Purge from Imgix" element action in the Assets index when purging is possible (i.e. a valid API key is configured).

profiles (array) A map of named Imgix source profiles. Each key is the profile name (referenced by defaultProfile or the per-transform imgixProfile parameter), and the value is a profile config array. See profile settings below.

Profile settings

domain (string, default '') Your Imgix source domain, e.g. my-source.imgix.net.

useHttps (bool, default true) Whether to use HTTPS for generated URLs.

signKey (string, default '') Token used to sign URLs. Required when sourceIsWebProxy is true. Found in your Imgix source settings page.

sourceIsWebProxy (bool, default false) Set to true if your Imgix source is a Web Proxy source. A signKey is required in this case.

useCloudSourcePath (bool, default true) Prepend the cloud storage subfolder path to the asset path. Useful when your Imgix source points directly to an S3 or GCS bucket that also has a Craft volume subfolder configured.

addPath (string|array, default '') Prepend an additional path segment to all asset paths. Can be a string to apply to all volumes, or an array keyed by volume handle to apply different prefixes per volume.

getExternalImageDimensions (bool, default true) Fetch image dimensions for external URL sources by downloading the image. Disable this if you are using external URLs and don't need accurate width/height on the transformed image model.

defaultParams (array, default []) Default Imgix URL parameters to apply to every transform using this profile. Example: ['auto' => 'compress,format'].

excludeFromPurge (bool, default false) Exclude this profile from purge operations.

apiKey (string, default '') Profile-specific Imgix API key for purging. Overrides the plugin-level apiKey for this profile.

Price, license and support

The plugin is released under the MIT license. It requires Imager X, which is a commercial plugin available in the Craft plugin store. If you need help, or found a bug, please post an issue in this repo, or in Imager X' repo (preferably).

All versions of imager-x-imgix-transformer with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
craftcms/cms Version ^5.0.0
spacecatninja/imager-x Version ^6.0.0-beta
imgix/imgix-php Version ^3.0
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 spacecatninja/imager-x-imgix-transformer contains the following files

Loading the files please wait ...