servd

Documentation

Documentation > Assets >

Imager X Integration

The plugin contains storage and transform adapters for ImagerX. These allow you to use the ImagerX template syntax whilst utilising Servd's Asset Platform for storage, optimisation and transformation of your images.

You can use any combination of the storage and transformer components as you wish. Note: you'll need an Imager X Pro license to gain access to the "custom transformer" feature.

If you're looking to only store transforms on Servd, then you'll likely want to check the "Disable Asset Platform image transforms / optimisations" Servd plugin settings option to prevent any asset URLs from being routed via our transform layer.

Here's a few example config/imager-x.php configurations:

Use Servd For Everything - only works with Images stored on a Servd Assets Volume.

<?php

return [
    'transformer' => 'servd',
];

Use Servd For Storage Of Transformed Images Only - assets transformed on-server; should work with source assets stored anywhere.

<?php

return [
    'storages' => ['servd'],
    'storageConfig' => [
        'servd' => [
            'folder' => 'transforms',
        ]
    ],
    # You'll want to use 'https://cdn2.assets-servd.host/[you-servd-project-slug]/transforms/'
    # instead here if your project is using our legacy V2 Asset Platform.
    'imagerUrl' => 'https://[you-servd-project-slug].files.svdcdn.com/transforms/',
];

Use Imgix For Transforms, Servd For Storage - only works with Images stored on a Servd Assets Volume.

<?php

return [
    'transformer' => 'imgix',
    'imgixConfig' => [
        'default' => [
            'domain' => '[your-imgix-domain].imgix.net',
            'useHttps' => true,
            'useCloudSourcePath' => true,
        ]
    ]
];

Combine the above with an imgix 'Web Folder' source set up to point to https://[you-servd-project-slug].files.svdcdn.com (or https://cdn2.assets-servd.host if your project is using our V2 legacy asset platform).