# TYPO3 plugin

#### Requirements to setup

Full access to a **TYPO3 instance**

* to install the extension
* to use the `Filelist` in the administrative interface

Permissions in a **fylr instance**

* to enable plugins (required system right: *"Access plugin manager"*)
* to download the images you want to use in TYPO3 (required during [#usage](#usage "mention"))

The TYPO3 plugin is shipped by default with each fylr instance, the plugin must be enabled before usage.

#### fylr setup

1. In the plugin manager of fylr, find the TYPO3 plugin, `enable` the plugin and `Save`.\
   ![](/files/f2k8s3tkEBrBoHKIGN30)
2. In the plugin configuration, enable `Activate API` and click `Save`.\
   The configuration can be found in the plugin manager and the base config plugin section.\
   ![](/files/uDRNxSkcqus0k3Hc4o69)
   1. *Optional*: Setup a metadata mapping to be applied when loading fylr content into TYPO3, see also [#forward-fylr-metadata-to-typo3](#forward-fylr-metadata-to-typo3 "mention")

#### Typo3 setup

1. install the extension `easydb TYPO3 integration`: <https://extensions.typo3.org/extension/easydb>
2. in the extension configuration set the URL of your fylr instance *(the login is done later)*\
   ![](/files/cXoXaRSuLgIPogxReXZO)

#### Usage

1. In the `Filelist`, Click on the button `Add files from easydb`:\
   ![](/files/d7x7a3n1FFSdNI1bGU0v)
2. You will now be presented with the login page of fylr. Log in.
3. You will be shown a fylr page marked at the top with `TPO3 file selection`.\
   Select one or more files, click the `TYPO3` button, click `Send`\
   ![](/files/oXg9CroTQ1mQWWsf4YqV)\
   \
   You can then close this window and the files appear in the `Filelist`.

### Forward fylr metadata to TYPO3

* Setup a new TYPO3 metadata mapping in *Administration* > *Metadata Mapping* > TYPO3 *Metadata*
* Select an Object type and provide a descriptive name for the mapping
* Map your media files fields to the TYPO3 metadata
* Set your mapping in the plugin manager. See a) in [#fylr-setup](#fylr-setup "mention")

## Good to know

* Changed or deleted data records in fylr are not synchronized with TYPO3. Changes to the data record must be transferred to TYPO3 manually.
* The name of the plugin may change its name from easydb to fylr.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fylr.io/tutorials/typo3-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.