TYPO3 is one of the easiest to use content management systems, and an ideal pairing with Canto. Our team has created an extension that will allow you to access the assets in your Main Library or a Portal, without having to leave the TYPO3 environment.
Install the Canto extension
The Canto extension is regularly updated to ensure optimal performance and compliance with all TYPO3 standards. As older versions of TYPO3 become obsolete, newer versions of the extension will no longer support them. Currently, the Canto extension is compatible with TYPO3 version 10, 11, and 12.
Installation through TYPO3
The easiest way to install the Canto extension is directly through TYPO3. To get started, use an account with the appropriate permissions to log into the backend.
Look for the Admin Tools module, and select Extensions.
Select the drop-down menu at the top of the page, and change it to "Get Extensions" ①. Type "Canto" into the search bar, and click the -symbol or press Enter. Once the extension has been found, click the
-symbol ② to import it.
After TYPO3 has confirmed the successful installation, return to the drop-down menu at the top of the page, and select "Installed Extensions". If the Canto extension appears greyed out, click the -symbol to activate it.
Manual installation
If you prefer to manually install the extension, you can find the all necessary files under the following link.
https://extensions.typo3.org/extension/canto_extension/
For guidance on manual installations, please refer to the article "Extension Installation" in the official TYPO3 documentation.
Configure the Canto extension
After the Canto extension has been successfully installed and activated, it must be configured to ensure compatibility with your account.
Select Settings ③ in the Admin Tools module, and then click on Configure Extensions ④.
In the new overlay, click the section "canto_extension" to expand it. Under "Environment selection" choose the domain your Canto tenant is located under. If you are not certain, you can verify the domain by accessing your Canto and checking the address bar in your browser. Click on 'Save "canto_extension" configuration' to confirm your selection.
Now that the domain has been selected, switch to the "Web" module, and select "Page" ⑤. Select any of your existing pages – or create a new page if you do not have any – and click the "+ Content" ⑥ button.
In the "Create new content element" overlay, choose either "Text & Images" or "Images Only".
In the page creation interface, select the "Images" ⑦ tab, and click the "Connect Canto" button ⑧. This will open the Canto login page in a new browser tab.
Enter the URL of your Canto tenant, and log in using either SSO or your email and password.
Next, choose whether you want to connect to the Main Library of your Canto account, or any of the existing portals. Click "Allow" to complete the setup.
You may now close the tab and return to TYPO3.
Insert assets through the Canto extension
Once you have connected your Canto tenant with TYPO3, you can immediately start inserting assets from your library. From the "Web" module, select "Page" and open any page. Click the "+ Content" button, and choose either "Text & Images" or "Images Only".
In the page creation interface, select the "Images" tab, and click the "Insert from Canto" button to open the Canto overlay. If this button is unavailable, or if it reads "Connect Canto," please ensure that the Canto extension has been properly installed and set up.
The left side of the overlay contains the navigation panel. This panel duplicates the folder structure of your Main Library or chosen portal, and you can navigate it just like you would through your Canto tenant. Folders can be opened and closed by clicking on them.
The right side of the overlay contains the gallery. The contents of any album you select in the navigation panel will be displayed here. Above the gallery, you can find a search bar, as well as filters to help you find specific assets. To preview an asset, hover your cursor over its thumbnail and click the -symbol in the bottom right.
Click on an asset to open another overlay with some of the asset's metadata. Click on "Insert into Post" to add the asset to the TYPO3 page.
Sign out of the Canto extension
Once you have linked your account to the Canto extension in TYPO3, the connection will remain active until you sign out.
To sign out of your account, open the extension as if you were to insert an asset into a TYPO3 page. Instead of selecting an asset, click the -button in the bottom right. The overlay will close, and the page refresh. You should now see the "Connect Canto" button again, which indicates that no account is currently linked.
Video tutorial
The following video briefly summarizes the various steps described in this article.