> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/tutorials/typo3-plugin.md).

# 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.