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 a class="lazyload" automatically.

There are also some changes under the hood you might want to consider:

  • The PHP namespace has switched from SMS\SmsResponsiveImages to Sitegeist\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 the Image.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.