TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,55 @@
+
+.. include:: /Includes.rst.txt
+
+.. _feature-65584:
+
+====================================
+Feature: #65584 - Add image cropping
+====================================
+
+See :issue:`65584`
+
+Description
+===========
+
+A new functionality is introduced that allows the editor to define image cropping settings to a *sys_file_reference*.
+
+The current support crop setting is a comma separated string defining: offsetX,offsetY,width,height
+
+
+Impact
+======
+
+The value set for a *sys_file_reference* will be passed through to the image rendering of TYPO3 by default.
+The new option of *sys_file_reference* is defined as exclude field in TCA so it needs to be enabled for editors.
+
+
+Disable cropping of image when used with *typoscript* rendering:
+
+.. code-block:: typoscript
+
+	# Disable cropping for all images
+	tt_content.image.20.1.file.crop =
+
+Set custom cropping setting for when used with *typoscript* rendering:
+
+.. code-block:: typoscript
+
+	# Overrule/set cropping for all images
+	tt_content.image.20.1.file.crop = 50,50,100,100
+
+
+Disable cropping of image when used in *fluid*:
+
+.. code-block:: html
+
+	<f:image image="{imageObject}" crop="" />
+
+Set custom cropping setting for image when used in *fluid*:
+
+.. code-block:: html
+
+	<f:image image="{imageObject}" crop="50,50,100,100" />
+
+
+.. index:: Fluid, Backend, Frontend