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.