DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
Image Crop¶
Created: | 2010-02-18T17:33:18 |
---|---|
Changed: | 2011-02-19T14:41:23.120000000 |
Classification: | image_crop |
Description: | The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- |
Keywords: | image, crop, cropping, tt_content, scale, gravity |
Author: | Sigfried Arnol |
Email: | s.arnold@rebell.at |
Info 4: | |
Language: | en |
Image Crop - image_crop
Image Crop¶
Extension Key: image_crop
Language: en
Keywords: image, crop, cropping, tt_content, scale, gravity
Copyright 2000-2010, Sigfried Arnol, <s.arnold@rebell.at>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.org
Table of Contents¶
`Introduction 3 <#__RefHeading__671_1711010350>`_
`Users manual 4 <#__RefHeading__677_1711010350>`_
`Administration 5 <#__RefHeading__679_1711010350>`_
`Configuration 6 <#__RefHeading__681_1711010350>`_
`ChangeLog 7 <#__RefHeading__687_1711010350>`_
Introduction¶
What does it do?¶
This extension adds the a cropping function to tt_content images .
Screenshots¶
Users manual¶
- Just enter your preferred target width and height and enable the cropping (checkbox) and select an alignment for your cropping operation. The alignment is set to “center” by default.
- Keep in mind that the the alignment will only show an effect if the ratio of width and height you entered is different from the aspect ratio of the original image.
- The effect will not be added permanently to the image, it will only affect the generated image. So if you want to choose another dimensions or another alignment setting it will simply take the original image again and crop it a different way. It works in a similar way to the “Effect” option (and of course it can be combined).
Administration¶
The two new fields for cropping are not defined as exclude fields, so there is no further configuration needed. If you don't wish a specific user to use the cropping features you can simply remove the fields via TSconfig. The fields are named tx_imagecrop_crop and tx_imagecrop_gravity.
Configuration¶
Just install the extension – it should work right away, usually there is no configuration needed.
Reference¶
This configuration is added automatically by an ext_typoscript_setup.txt
includeLibs.image_crop = typo3conf/ext/image_crop/pi1/class.tx_imagecrop_pi1.php
tt_content.image.20.1.stdWrap.postUserFunc = tx_imagecrop_pi1->main
If it does not right away the issue is probably that you have included CSS Styled Content in a “Basis Template”. Therefore the changes made by ext_typoscript_setup.txt will be overwritten by the default TypoScript of CSS Styled Content.To fix this you have three options:
Check the Checkbox “Include Static Templates After Basis Templates” in your Template (though this will have some side effects if other configuration relies on the fact that it is the other way around).
Include the static template of CSS Styled Content directly into your primary Template
Add the 2 Lines of TypoScript manually to your Template.