Installation of the Typo3 Connector

Requirements

To use the 4App Typo3 Connector, make sure you have

• a configured Typo3 server
• an installed Typo3 REST and Portal Handler extension
  • Typo3 v12 installation guide
  • Typo3 v8, v9, v10 installation guide

The 4App Typo3 Connector is supported starting from DAM / Core version 3.7.

Installation of the 4App

The Typo3 Connector is available as a separate 4App (4allportal-typo3-connector) and can be downloaded and installed via the app management in the administration area. After installation, activate the 4App and restart the system.

You now find the new admin snap-in DAM/Typo3 Connector in the administration area to configure as well as the new panel Typo3 Connector in each asset's detail view of the DAM.

Installation of the Typo3 REST Extension and Portal Handler

In order for the Typo3 Connector to be able to access the Typo3 files, you need to install the Typo3 REST extension and the Portal Handler extension. Please consider the different installation guides depending on your Typo3 version:

• Typo3 v12 installation guide
• Typo3 v8, v9, v10 installation guide

Installation Guide for Typo3 v12

Please note: We expect a Typo3 v12 installation at the following URL: http://example.typo3.net/typo3/login (opens new window).

1. Download the REST extension for Typo3 v12: REST extension v6 (opens new window).

2. Unzip the downloaded REST extension.

3. Rename the unzipped folder from rest-6 to rest.

4. Make the following configurations:

   • Open the unzipped file Configuration/TypoScript/setup.typoscript.

   • In the path block, just after the auth part, add the following:

             virtual_object-gallery {
                 path = virtual_object-gallery
                 read = require
                 write = require
                 handlerClass = \Cundd\Rest\Handler\PortalHandler
              }
     

• After the authenticationProvider block, add the following aliases:

      aliases {
          media = virtual_object-content
      }
  
      virtualObjects {
          gallery{
              mapping {
                  identifier = name
                  tableName = sys_file
                  skipUnknownProperties = true
  
                  properties {
                      id {
                          column = uid
                          type = int
                      }
                      name {
                          column = name
                          type = string
                      }
                  }
              }
          }
      }
  

• Open the unzipped file Configuration/Services.yaml. At the end of the file, add the following to allow dependency injection:

    Cundd\Rest\Handler\PortalHandler:
      public: true 
    TYPO3\CMS\Core\Resource\ResourceFactory:
      public: true
  

5. Download the PortalHandler extension for Typo3 v12: PortalHandler.php.

6. Move the downloaded file PortalHandler.php into folder Classes/Handler of the unzipped REST extension.

7. Zip the extension (REST folder) and copy it to your Typo3 server.

8. Unzip the file and move folder rest to /var/www/html/typo3conf/ext.

9. Logout (if logged in) and login on http://example.typo3.net/typo3/login (opens new window). In the left panel Extension, verify that the REST extension is installed in version 6.0.0.

10. Activate the plugin with the button below the A/D header.

Installation Guide for Typo3 v8, v9, v10

1. Download the REST extension according to your Typo3 version:

   • Typo3 v8 and v9: REST extension v4 (opens new window)
   • Typo3 v10: REST extension v5 (opens new window)

2. Unzip the downloaded REST extension

3. Make the following configurations:

   • Open the unzipped file ext_typoscript_setup.txt.
   • Look for plugin.tx_rest.settings > paths right at the beginning and add the following:

       virtual_object-gallery {
           path = virtual_object-gallery
           read = require
           write = require
           handlerClass = \Cundd\Rest\Handler\PortalHandler
       }
   

   • Add the following aliases to the same file:

       aliases {
          media = virtual_object-content
       }
       virtualObjects {
           gallery{
               mapping {
                   identifier = name
                   tableName = sys_file
                   skipUnknownProperties = true
   
                   properties {
                       id {
                           column = uid
                           type = int
                       }
                       name {
                           column = name
                           type = string
                       }
                   }
               }
           }
       }
   

4. Download the PortalHandler extension according to your Typo3 version:

   • Typo3 v8 and v9
   • Typo3 v10

5. Move the downloaded file PortalHandler.php into folder Classes/Handler of the unzipped REST extension.

6. Zip the extension and upload it to your Typo3 server.