Installation¶
Composer mode¶
If your TYPO3 installation uses Composer, install the latest version of the extension through:
composer require sitegeist/sms-responsive-images
If you want to use a different version of the extension, you need to add a version constraint, for example:
composer require sitegeist/sms-responsive-images:"^1.3"
Legacy mode¶
If you are working with a TYPO3 installation that does not use Composer, install the extension in the Extension Manager:
- Navigate to Admin Tools > Extensions > Get Extensions.
- Click on Update now
- Search for sms_responsive_images
- Click Import and install on the side of the extension entry
and activate it:
- Navigate to Admin Tools > Extensions > Installed Extensions
- Search for sms_responsive_images
- Activate the extension by clicking on the Activate button in the A/D column
See also
On pages “Managing Extensions” and “Managing Extensions - Legacy Guide” both TYPO3 installation modes are explained in detail.
Updating from 1.x¶
There are a few breaking changes which might require you to update your integration:
- Support for TYPO3 8.7 is gone. Please use version 1.3 of the extension.
- The
picturefill
attribute of<sms:image />
and<sms:media />
has been removed, so you need to remove it from your Fluid templates. Separate markup for picturefill.js is no longer required, so the extension now outputs standards-compliant markup at any time. - In addition to svg files, gif files are now excluded as well. You can change this by adjusting the
ignoreFileExtensions
parameter. - If
lazyload
is enabled, image tags will get aclass="lazyload"
automatically.
There are also some changes under the hood you might want to consider:
- The PHP namespace has switched from
SMS\SmsResponsiveImages
toSitegeist\ResponsiveImages
, so if you extended one of the provided PHP classes, you need to adjust this. - The extension now uses
.1579774724
instead of.100
to overwrite the image partial of fluid_styled_content. This means that there will be less interference with other extensions. However, if you need to overwrite theImage.html
file again, you need to specify your partial after that value. - The demo plugin is gone, so if you were using it, it won’t work anymore.