PHPackages                             ecentral/celum-connect-fal - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. ecentral/celum-connect-fal

ActiveTypo3-cms-extension[File & Storage](/categories/file-storage)

ecentral/celum-connect-fal
==========================

TYPO3 FAL driver for the CELUM DAM system

v3.1.0(1mo ago)01GPL-2.0-or-laterPHP

Since Apr 17Pushed 1mo agoCompare

[ Source](https://github.com/ecentral/celum_connect_fal)[ Packagist](https://packagist.org/packages/ecentral/celum-connect-fal)[ Docs](https://github.com/ecentral/celum_connect_fal)[ RSS](/packages/ecentral-celum-connect-fal/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (14)Versions (2)Used By (0)

CELUM Connect FAL
=================

[](#celum-connect-fal)

A TYPO3 FAL (File Abstraction Layer) driver that exposes assets and collections from a [CELUM](https://www.celum.com/) DAM system as a read-only TYPO3 file storage. Uses the CELUM REST API to fetch and cache asset metadata, preview URLs, and download links.

- **Extension key:** `celum_connect_fal`
- **Package:** `ecentral/celum-connect-fal`
- **Driver identifier:** `BrixCelumDriver`
- **TYPO3 compatibility:** 12.4 LTS, 13.4 LTS

Requirements
------------

[](#requirements)

- TYPO3 CMS 12.4 LTS or 13.4 LTS
- PHP 8.1 or higher
- A running CELUM DAM instance with REST API access

Installation
------------

[](#installation)

```
composer require ecentral/celum-connect-fal
```

Then activate the extension via the TYPO3 backend under **Admin Tools > Extensions**, or via CLI:

```
./vendor/bin/typo3 extension:activate celum_connect_fal
```

Configuration
-------------

[](#configuration)

The driver is configured per FAL storage in the TYPO3 backend under **File > Filelist > \[Storage\] > Edit**. Select **Driver: BrixCelumDriver** and fill in the FlexForm fields:

FieldTypeRequiredDefaultDescription`celumHost`stringyes—Base URL of the CELUM REST API, e.g. `https://your-celum-instance.celum.com``celumApiKey`stringyes—API key for authentication with the CELUM REST API (see [Finding your API Key](#finding-your-api-key))`celumUser`stringyes—Optional username for HTTP basic authentication`celumPassword`stringyes—Optional password for HTTP basic authentication`roots`stringyes—Comma-separated list of CELUM collection IDs to expose as root folders, e.g. `12,34,56` (see [Finding Root Node IDs](#finding-root-node-ids))`locale``en` | `de`no`en`Language used for asset names returned by the API`defaultLocale``en` | `de`no`en`Fallback language when the primary locale is unavailable`imageDownloadFormat`stringno`largeprvw`CELUM format key used for image public URLs (e.g. `largeprvw`, `preview`, `thumbnail`)`cacheLifetimeInMinutes`integer (1–29)no`29`How long API responses are cached in the TYPO3 cache framework### Finding your API Key

[](#finding-your-api-key)

The API key is generated in the CELUM Configuration Management Application (CMA):

1. Log in to your CELUM backend (e.g. `https://your-instance.celum.cloud`)
2. Navigate to **Advanced UI** (older user interface)
3. Go to **Administration > Configuration Management** and log in there
4. Under the **Authentication** category, click **Profiles**, then click **+ ADD** to create a new authentication profile
5. Select **Rest API** — a dialog will open where you can retrieve the API key

> **Tip:** Create a dedicated API user for TYPO3 to control access rights precisely.

### Finding Root Node IDs

[](#finding-root-node-ids)

The root node ID is the numerical ID of the CELUM folder that will serve as the entry point in the TYPO3 file selection:

1. In CELUM Content, navigate to the folder you want to use as the root - the ID is visible in the URL (e.g. `1234_node`)
2. Open the folder's **Detail View** — the ID is visible in the upper left corner.

Multiple root node IDs can be entered as a comma-separated list — all configured nodes and their sub-nodes will be available recursively in TYPO3.

Usage
-----

[](#usage)

### Creating a FAL Storage

[](#creating-a-fal-storage)

1. Go to **Web > List > Page Pid=0**.
2. Create a new file storage record.
3. Set **Driver** to **BrixCelumDriver**.
4. Fill in the connection settings under the **Configuration** tab (see [Configuration](#configuration)).
5. Save. TYPO3 will connect to the CELUM REST API and expose the configured root collections as folders.

### Read-Only Storage

[](#read-only-storage)

The CELUM driver is **read-only**. All write operations (upload, rename, move, delete) will throw an exception. Assets must be managed inside CELUM and will be reflected automatically after the cache TTL expires.

### Clearing the Cache

[](#clearing-the-cache)

A dedicated cache-clear button is available in the TYPO3 backend toolbar. To activate it, add the following TS-Config under the user or group settings:

```
options.clearCache.celum = 1

```

This clears all cached CELUM API responses immediately.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

53d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a7a81dfdbe31810894c8f18da2a5f4870f129d58ccc0b0fc1c6801a7e5634848?d=identicon)[ecentral](/maintainers/ecentral)

---

Top Contributors

[![Chris-Maechler](https://avatars.githubusercontent.com/u/133250706?v=4)](https://github.com/Chris-Maechler "Chris-Maechler (67 commits)")[![haassie](https://avatars.githubusercontent.com/u/11075733?v=4)](https://github.com/haassie "haassie (30 commits)")[![ddoerner123](https://avatars.githubusercontent.com/u/136710813?v=4)](https://github.com/ddoerner123 "ddoerner123 (16 commits)")[![herrhamann](https://avatars.githubusercontent.com/u/1815612?v=4)](https://github.com/herrhamann "herrhamann (15 commits)")[![ferfrost](https://avatars.githubusercontent.com/u/146172865?v=4)](https://github.com/ferfrost "ferfrost (11 commits)")[![david-vonah](https://avatars.githubusercontent.com/u/86477820?v=4)](https://github.com/david-vonah "david-vonah (2 commits)")[![felix-brix](https://avatars.githubusercontent.com/u/195735003?v=4)](https://github.com/felix-brix "felix-brix (1 commits)")[![coding46](https://avatars.githubusercontent.com/u/1724196?v=4)](https://github.com/coding46 "coding46 (1 commits)")

---

Tags

typo3DAMfaltypo3 backenddigital asset managementFile abstraction layercelum

###  Code Quality

TestsCodeception

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ecentral-celum-connect-fal/health.svg)

```
[![Health](https://phpackages.com/badges/ecentral-celum-connect-fal/health.svg)](https://phpackages.com/packages/ecentral-celum-connect-fal)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k532.1M2.5k](/packages/aws-aws-sdk-php)[typo3/cms-styleguide

TYPO3 extension to showcase TYPO3 Backend capabilities

106749.2k26](/packages/typo3-cms-styleguide)[beechit/fal-securedownload

Secure download of assets. Makes it possible to secure FE use of assets/files by setting permissions to folders/files for fe\_groups.

37592.0k4](/packages/beechit-fal-securedownload)[typo3/testing-framework

The TYPO3 testing framework provides base classes for unit and functional testing.

665.3M1.1k](/packages/typo3-testing-framework)[causal/image_autoresize

Simplify the way your editors may upload their images: no complex local procedure needed, let TYPO3 automatically resize down their huge images/pictures on-the-fly during upload (or using a command for batch processing) and according to your own business rules (directory/groups). This will highly reduce the footprint on your server and speed-up response time if lots of images are rendered (e.g., in a gallery). Features an EXIF/IPTC extractor to ensure metadata may be used by the FAL indexer even if not preserved upon resizing.

19479.2k](/packages/causal-image-autoresize)[ichhabrecht/filefill

Find and fetch missing local files from different remotes

701.5M1](/packages/ichhabrecht-filefill)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)