Installation

Requirements

TYPO3 14.3
PHP 8.2 – 8.5
ImageMagick or GraphicsMagick enabled in the Install Tool (Admin Tools > Settings > Configure Installation-Wide Options > GFX). HEIC upload needs a build with HEIC support.

Install with Composer

composer require conratwebsolutions/crgalerie
vendor/bin/typo3 extension:setup

extension:setup creates the database tables. In a non-Composer installation, install the extension from the TYPO3 Extension Repository in Admin Tools > Extensions.

Add the site set

Add the site set ConRat Photo Gallery (conrat/crgalerie) to your site, either in Site Management > Sites or in config/sites/<site>/config.yaml:

config/sites/main/config.yaml

dependencies:
  - conrat/crgalerie

The set provides the TypoScript of both content elements. No static template is needed.

Extension configuration

In Admin Tools > Settings > Extension Configuration > crgalerie:

storagePid: Folder (sys folder) in which the module stores new galleries and images. Create a sys folder, e.g. "Galleries", and enter its page ID.
previewPid: Page with a Gallery overview element. Used for the preview links in the module.
uploadFolder: FAL folder for uploaded images, default 1:/galerien/. One subfolder <uid>-<title> is created per gallery.
maxBildgroesse: Longest side in pixels to which images are reduced on upload, default 2560.

Clear all caches afterwards:

vendor/bin/typo3 cache:flush

First gallery

Open Content > Galleries, create a gallery and upload images, see For editors.
On a page, add the content element Gallery (tab Plugins) and choose the gallery.
Open the page in the frontend.

Upgrading from 2.x

Version 2 was only used in projects of ConRat. To upgrade:

Run the upgrade wizard that converts the old plugin into the new content elements, then clear the caches:
```
vendor/bin/typo3 upgrade:run crgalerieCTypeMigration
vendor/bin/typo3 cache:flush
```
Copied!
Set storagePid and previewPid. Galleries on the root level (pid 0) can only be edited by admins; move them into the sys folder.
Add the site set and set site settings if needed (see Site settings).
Adapt own template overrides; templates and variables are new.
The old folders fileadmin/crgalerie/<uid>/raw/ and /thumbnails/ are no longer used and can be removed after a backup.
Editors now need table, database and file permissions, see Permissions for editors.