Download the PHP package josefglatz/cropvariantsbuilder without Composer
On this page you can find all versions of the php package josefglatz/cropvariantsbuilder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download josefglatz/cropvariantsbuilder
More information about josefglatz/cropvariantsbuilder
Files in josefglatz/cropvariantsbuilder
Package cropvariantsbuilder
Short Description Simplify writing cropVariants for TYPO3 Integrators/Developers
License GPL-2.0-or-later
Informations about the package cropvariantsbuilder
josefglatz/cropvariantsbuilder (TYPO3 Extension cropvariantsbuilder
)
TYPO3 extension to simplify writing cropVariants for TYPO3 Integrators/Developers
→ → → Table of Contents
1. → [About](#about) 1. [Past](#past) 2. [Present](#present) 3. [Future](#future) 2. → [Installation](#installation) 1. [Installation using Composer](#installation-using-composer) 2. [Installation as extension from TYPO3 Extension Repository (TER)](#installation-as-extension-from-typo3-extension-repository-ter) 3. → [Configuration](#configuration) 1. [Name of the extension where the general configuration file lives](#name-of-the-extension-where-the-general-configuration-file-lives) 2. [Example of using your own CropVariants.yaml file](#example-of-using-your-own-cropvariantsyaml-file) 3. [Example of using your own CropVariants.yaml file while using the \TYPO3\CMS\Core\Configuration\Loader\YamlFileLoader->load() imports feature](#example-of-using-your-own-cropvariantsyaml-file-while-using-the-typo3cmscoreconfigurationloaderyamlfileloader-load-imports-feature) 4. → [Detailed manual and more examples](#detailed-manual-and-more-examples) 1. [Handling of cropVariants in TYPO3](Resources/LegacyDocumentation/Markdown/Images/Index.md#handling-of-cropvariants-in-typo3) 1. [Centralized configuration for AspectRatio, Cover-/CropArea presets and CropVariant definitions](Resources/LegacyDocumentation/Markdown/Images/Index.md#centralized-configuration-for-aspectratio-cover-croparea-presets-and-cropvariant-definitions) 2. [Handling of cropVariants in TYPO3: Simplified cropVariants configuration for the Table Configuration Array](Resources/LegacyDocumentation/Markdown/Images/Index.md#simplified-cropvariants-configuration-for-the-table-configuration-array) 2. [Defaults And Presets](Resources/LegacyDocumentation/Markdown/Images/DefaultsAndPresets.md) 3. [CropVariantsBuilder](Resources/LegacyDocumentation/Markdown/Images/CropVariantsBuilder.md) 1. [Example 1: Set a global default cropVariants configuration](Resources/LegacyDocumentation/Markdown/Images/CropVariantsBuilder.md#example-1-set-a-global-default-cropvariants-configuration) 2. [Example 2: Set custom cropVariants for a specific field of a specific table (pages.tx_my_nice_site_extension_nav_image)](Resources/LegacyDocumentation/Markdown/Images/CropVariantsBuilder.md#example-2-set-custom-cropvariants-for-a-specific-field-of-a-specific-table-pagestx_my_nice_site_extension_nav_image) 3. [Example 3: Set custom cropVariants for tx_news_domain_model_news.fal_media](Resources/LegacyDocumentation/Markdown/Images/CropVariantsBuilder.md#example-3-set-custom-cropvariants-for-tx_news_domain_model_newsfal_media) 4. [Example 4: Set custom cropVariants for `tt_content.image` for CType `tx_my_nice_site_extension_custom_ce1`](Resources/LegacyDocumentation/Markdown/Images/CropVariantsBuilder.md#example-4-set-custom-cropvariants-for-tt_contentimage-for-ctype-tx_my_nice_site_extension_custom_ce1) 4. [Translation logic for cropVariant label](Resources/LegacyDocumentation/Markdown/Images/TranslationLogic.md) ---About
This extensions centralizes the configuration of
- default aspectRatios,
- aspectRatios used within the TYPO3 instance,
- coverAreas used within the TYPO3 instance,
- cropAreas used within the TYPO3 instance,
- focusAreas used within the TYPO3 instance.
This extension makes it easy to configure cropVariants within TCA
(EXT:your_ext/Configuration/TCA/**/*.php
) modifications in your "site
package" extension.
The extension relies 100% on the TYPO3 core functionality and can be seen as an on-top-time-saver for TYPO3 integrators.
Past
The initial public version was part of
https://github.com/josefglatz/TYPO3-Distribution
. The demands grew in
2019 and therefore I came up with a new idea to support also the TYPO3
site configuration which was introduced in TYPO3 9.5 LTS.
Present
This extension doesn't support the TYPO3 site configuration. With that known fact, it's not possible to distinguish between multiple sites in a multitree environment.
Future
The functionality of this extension will stay as it is. There will be no direct successor to which you can update and migrate automatically (from my current perspective). I will link the new extension here when it's publicly available.
At the time of writing about the future my plan is to re-adding the functionality completely via the TYPO3 site configuration and the FormDataProvider. With that in mind, it's possible to make site specific configurations. Even the configuration can be done completely via a YAML file beside your existing YAML file of one configured site.
If it makes really sense, I probably add also the functionality of
EXT:cropvariantsbuilder
to make global TCA modifications possible (not
yet specified if you have to write YAML or the known PHP syntax).
Installation
Installation using Composer
The recommended way to install the extension is by using
Composer. In your Composer based TYPO3
project root, just do composer require josefglatz/cropvariantsbuilder
.
Installation as extension from TYPO3 Extension Repository (TER)
Download and install the extension with the TYPO3 CMS extension manager module or directly via typo3.org.
Version Matrix
TYPO3 version | Extension version | notes |
---|---|---|
8.7-10.4 | 1.0.1 |
no breaking changes |
10.4-11.5 | 1.0.3 |
no breaking changes |
11.5-12.4 | >=2.0.0 |
translation fallback logic removed |
13.4 | >=2.0.1 |
no breaking changes since 2.0.0 |
Development
The ongoing development is done within the main branch!
You can use composer require josefglatz/cropvariantsbuilder:dev-main
if you want to test the
current development state.
Configuration
Name of the extension where the general configuration file lives
The following options must be set within the TYPO3 extension configuration:
So if you place the configuration file in
EXT:my_nice_site_extension/Configuration/ImageManipulation/CropVariants.yaml
you have to set the value tomy_nice_site_extension
.So if you place the translations in
EXT:my_nice_site_extension/Resources/Private/Language/locallang.xlf
you have to set the value tolocallang
. Read more about the supported translation logic.
The following example shows the resulting PHP configuration part:
Example of using your own CropVariants.yaml file
Just clone the file
EXT:cropvariantsbuilder/Configuration/ImageManipulation/CropVariants.yaml
to
EXT:my_nice_site_extension/Configuration/ImageManipulation/CropVariants.yaml
and modify it however you want. With that approach, you have no
dependencies on the default CropVariants.yaml of
EXT:cropvariantsbuilder
.
Example of using your own CropVariants.yaml file while using the \TYPO3\CMS\Core\Configuration\Loader\YamlFileLoader->load()
imports feature
The following example represents the content of the file
EXT:my_nice_site_extension/Configuration/ImageManipulation/CropVariants.yaml
.
You can rely on the default CropVariants.yaml of
EXT:cropvariantsbuilder
while modifying it to meet the demands of your
specific project with the example shown above. And of course, you can
import any other YAML file. You don't have to rely on the default
CropVariants.yaml if the resulting YAML file includes a configuration
for every necessary part.
Detailed manual and more examples
- Handling of cropVariants in TYPO3
- DefaultsAndPresets
- CropVariantsBuilder Examples
- Translation logic for cropVariant label
Cheers to all TYPO3 enthusiasts out there!
Created by
Support
Many thanks to my employer supseven.at for sponsoring work time.