Imageproxy

Implementation

Implementing our image proxy is incredibly simple. All you need is the ID (UUID) of the asset you want to distribute through the proxy.

The benefit of our solution lies in the fact that any changes to the status of the file (such as licenses, copyrights, etc.) will be reflected within 60 seconds. During this time, the files will be cached, ensuring efficiency and up-to-date content delivery.

https://files.fairu.app/{ID}/{Your preferred name}?width={INT}&height={INT}&focal_point={STRING}

Example:

The following link delivers the original image. By adding a few query params you can adjust that.

https://files.fairu.app/9e2c4a16-0ade-49fe-b8c7-c0a9e693182a/Luna.jpeg

Resize

Allowed properties:

Width and height. Both values must be integers.

https://files.fairu.app/9e2c4a16-0ade-49fe-b8c7-c0a9e693182a/Luna.jpeg?width=100

Resize and Crop

You can easy crop an image by adding width and height.

https://files.fairu.app/9e2c4a16-0ade-49fe-b8c7-c0a9e693182a/Luna.jpeg?width=300&height=300

Focal point

Sometimes, our automatic focal point detection may not focus on the areas you need. By adding a focal point (which can also be done via the web UI), you can easily adjust this. Please ensure that you provide both width and height in this case—otherwise, setting a focal point will need to be done on the frontend (e.g., via CSS).

https://files.fairu.app/9e2c4a16-0ade-49fe-b8c7-c0a9e693182a/Luna.jpeg?width=300&height=300&focal=0-0-1

Extra

For all statamic users: The implementation fits the standard focal point logic you already familiar with.