Provide documentation for cropping

[georgringer]

Add some documentation how to add cropping information to field fal_media

[wojtablo]

Ideally if "how to" guidelines would relate to official feature: #75880 release notes. Explain how to add multiple cropping variants for fal_media, eg. variant for media and desktop.

[Kleisli]

Hi @georgringer
Can you give a little hint how to achieve this in a clean way?
I managed it, by hacking the code below into the tx_news_domain_model_news-TCA file in ['fal_media']['config'], but I am unable to do it in a TCA/Overrides-File in my own extension.. :-(

'overrideChildTca' => [
    'columns' => [
        'crop' => [
            'config' => [
                'cropVariants' => [
                    'mobile' => [
                        'title' => 'Mobile',
                        'allowedAspectRatios' => [
                            '4:3' => [
                                'title' => '4 zu 3',
                                'value' => 4 / 3
                            ],
                            'NaN' => [
                                'title' => 'FREI',
                                'value' => 0.0
                            ],
                        ],
                    ],
                ],
            ],
        ],
    ],
],

Vielen Dank und liebe Grüsse
Till

[Kleisli]

Nevermind, sometimes asking helps to find the solution yourself. :)

Here is a working (TYPO3 8.7 / news 6.0) snippet to have special cropping settings just for the news items, just create a file your_extension/Configuration/TCA/Overrides/tx_news_domain_model_news.php with

<?php
$GLOBALS['TCA']['tx_news_domain_model_news']['columns']['fal_media']['config']['overrideChildTca']['columns']['crop'] = [
	'config' => [
		'cropVariants' => [
			'mobile' => [
				'title' => 'Mobile',
				'allowedAspectRatios' => [
					'4:3' => [
						'title' => '4 zu 3',
						'value' => 4 / 3
					],
					'NaN' => [
						'title' => 'FREI',
						'value' => 0.0
					],
				],
			],
		],
	],
];

and to use a specific cropVariant in your template add cropVariant="mobile" to the f:image-viewhelper.

[rowild]

@Kleisli Thanks, Till! For completeness, a fluid template example would be great, too.

[josefglatz]

I will take over this task

As this is "just" an TYPO3 extension I would say it's not really the optimal place to add technical infos on how you can configure cropVariants in the TCA.

But to get an compact overview for EXT:news I would suggest following HowTos/Examples:

• Howto set default cropVariants for tx_news_domain_model_news.columns.column
• Howto overwrite cropVariants for tx_news_domain_model_news.columns.column for a specific tx_news_domain_model_news.type

Each of the above mentioned points with:

• TCA configuration example
• Fluid example

---

Does it suit almost everybody needs? Did I forgot something? (CC @georgringer @rowild )

[georgringer]

@josefglatz are you still interested in doing it?

[medarob]

@josefglatz @georgringer I just want to add some cropVariants to news images and I discovered this issue. Is a more detailed documentation about this topic still work in progress (I saw that the last entry is amlost 1 year old)? If not I will try it on my own and could share my findings.