Download the PHP package sitegeist/image-jack without Composer
On this page you can find all versions of the php package sitegeist/image-jack. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sitegeist/image-jack
More information about sitegeist/image-jack
Files in sitegeist/image-jack
Package image-jack
Short Description Jack of all trades concerning image optimization. Also introduces the usage of next-gen-image-formats
License GPL-2.0-or-later
Homepage https://github.com/sitegeist/image-jack
FAQ
Example:
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 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.
Informations about the package image-jack
Image Jack
Jack of all trades concerning image optimization. Also introduces the usage of next-gen-image-formats.
What does it do?
Adds the possibility to optimize existing jpg, gif and png files during processing. Furthermore, it can add a webP copy of every processed image.
Installation
Use composer to add the extension:
- Completely clear all processed images via the maintenance module
- Flush Caches
- Change the server configuration (see below) or activate the fallback driver xclass
Configuration
Webserver
To deliver the webP images, the webserver needs to be configured properly. Example for Apache (.htaccess):
As we are creating the webP images as copies (keeping the original image untouched) this configuration delivers the webP image if the client supports it. Otherwise, the original image is served.
Storage API (beta)
As a fallback solution (e.g. for remote storages) there is an option in the extension settings to activate a xclass for the storage driver. There needs to be a class for every storage driver that should be extended. The LocalDriver and the AmazonS3Driver are already available. To avoid the cache problem (first client defines the served image format) the image formats from the clients accept header are added to the page cache identifier. If this option is activated the htaccess modification (see Webserver) is no longer necessary.
Scheduler / Cronjob
To start the image processing a command is available:
The images are processed one by one. By changing the limit, the number of images to process in one run can be defined.
Requirements
webp
For the webp conversion an installed version of Imagemagick or GraphicsMagick with webp support is required.
You can check this with:
or:
When using gd, webP support is needed.
jpg optimization
For optimizing jpg files the binary "jpegoptim" is required. You can check this with:
(Should return a path)
If missing it can be installed for example with this command:
png/gif optimization
For optimizing png and gif files the binary "optipng" is required. You can check this with:
(Should return a path)
If missing it can be installed for example with this command:
Extension settings
General
useLiveProcessing
If enabled the images are processed live on request using a LocalImageProcessor. This can lead to high load and very long loading times upon first request (depending on the number of images on the page). It is recommended to stick with the default and use the available command for processing.
useFallbackDriver (beta)
When enabled a xclass is used to extend the getPublicUrl function from the LocalDriver and AmazonS3Driver. This can be used if the htaccess solution is not working, e.g. for remote storages. See Storage API (beta) for more details.
WebP
active
(De)activate the conversion.
converter
Which way should be used to convert the images: Imagemagick/GraphicsMagick, GD or an external binary
options
Depending on the conversion type this field can be used for different purposes:
- IM/GM: Add options that are directly passed to the binary
- GD: Quality for the new images (1 - 100)
- External: The complete path to the binary to be used. You can use %s for source and target image.
Avif
active
(De)activate the conversion.
converter
Which way should be used to convert the images: Imagemagick/GraphicsMagick, GD or an external binary
options
Depending on the conversion type this field can be used for different purposes:
- IM/GM: Add options that are directly passed to the binary
- GD: Quality for the new images (1 - 100)
- External: The complete path to the binary to be used. You can use %s for source and target image.
Jpeg
active
(De)activate the optimization.
path
The path to the jpegoptim binary. Please use the complete path as is_executable won't work correctly otherwise.
Png
active
(De)activate the optimization.
path
The path to the optipng binary. Please use the complete path as is_executable won't work correctly otherwise.
Logging
Just activate the levels that should be written to the log file.
Custom optimizer/converter templates
The custom template should extend AbstractTemplate and implement TemplateInterface. Just use one of the existing templates as a starting point.
Custom templates can be registered like this:
Jack will automatically pick up and run the new template if it is available for the given image type.
Troubleshooting
A log is written to var/log/typo3_imagejack*.log
The extension settings offer the possibility to decide how verbose the logging should be.
Special thanks
This extension was inspired by the webp extension from plan2net.
Authors & Sponsors
The development and the public-releases of this package is generously sponsored by our employer https://sitegeist.de.
