# 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`.\
   ![](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-eeaad9d4defd63b8e6668c504041ea46cc6d0e96%2Fimage.png?alt=media)
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.\
   ![](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-c715d5c0d308ee531831c5f2362d0994dc9741c4%2Fimage.png?alt=media)
   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)*\
   ![](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-2877a68007aae54fc979b3100ee773febea0db91%2Fimage.png?alt=media)

#### Usage

1. In the  `Filelist`, Click on the button `Add files from easydb`:\
   ![](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-2b8c1d6520827c527cb3568b5e7a41eadd81667e%2Fimage.png?alt=media)
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`\
   ![](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-03219e1b87f267cb5cd8997da624c08a36c70c68%2Fimage.png?alt=media)\
   \
   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.