Installation

This extension does nothing all by itself. Connectors must be developed for specific third-party applications. However this extension must be installed since it provides the base class from which all connector services inherit.

Updating to 5.0.0

Version 5.0.0 adds support for TYPO3 12 and drops support for TYPO3 10. Most importantly it adapts to the deprecation of Services in the TYPO3 Core by implementing its own registry. As such the way to register services has completely changed and the Connector API has been modified as well (some methods were added, some removed and most methods were hardened with regards to strict typing, changing their signature).

All existing services need to be adapted, none will work anymore without some work. The changes to perform are:

  • change registration from ext_localconf.php to Configurations/Services.yaml

  • remove methods init() and reset()

  • add methods getType(), getName() and isAvailable()

  • all fetch*() methods, checkConfiguration() and query() need to adapt to the new base method signatures

  • ensure member variable protected string $extensionKey is declared

Updating to 4.0.0

Version 4.0.0 adds support for TYPO3 11 and PHP 8.0, while dropping support for TYPO3 9. Apart from that it does not contain other changes and the update process should be smooth.

Updating to 3.4.0

The sample configuration files have been changed to JSON format to easily allow for nested properties. If you have developed your own service and have defined a sample configuration file, you will need to change it to the new format. As always look at other existing connector services for examples (in particular, the "svconnector_json" extension which uses nested properties).

Also a new method was introduced as part of the Connector Sevice API: checkConfiguration() is expected to parse the connector configuration and return errors, warnings or notices as needed.