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.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

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

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 to my_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 to locallang. 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


Cheers to all TYPO3 enthusiasts out there!


Created by

http://josefglatz.at/

Support

Many thanks to my employer supseven.at for sponsoring work time.


All versions of cropvariantsbuilder with dependencies

PHP Build Version
Package Version
Requires typo3/cms-core Version ^11.5 || ^12.4 || ^13.4
php Version >=8.0.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package josefglatz/cropvariantsbuilder contains the following files

Loading the files please wait ....