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
toConfigurations/Services.yaml
remove methods
init()
andreset()
add methods
getType()
,getName()
andisAvailable()
all
fetch*()
methods,checkConfiguration()
andquery()
need to adapt to the new base method signaturesensure 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.