These are the steps to follow specifically for Trombinoscope Contacts or Trombinoscope Contacts Pro to experience the smoothest migration possible.
There is no migration path from the free version under Joomla 3.10 to the pro version in Joomla 4. Migrate the free version from Joomla 3.10 to Joomla 4 first, then under Joomla 4, upgrade to the pro version.
Under Joomla 3.10
First make sure you have an up-to-date version of Trombinoscope Contacts or Trombinoscope Contacts Pro. It's important that you have installed the latest version. You can download the latest free version or download the latest pro version and install.
Go to Extensions -> Plugins.
Type 'Auto Clear' in the search box. Disable the plugin if there is one found.
Pro Type 'Trombinoscope' in the search box.
Disable the plugins, if enabled:
- System - Back To Trombinoscope view
- System - Trombinoscope Contacts Pro Breadcrumbs
- Quick Icon - Trombinoscope Contacts Pro
Pro Type 'Edit Contact' in the search box.
Disable the plugin, if enabled:
- User - Edit Contact In Profile
This will remove potential update issue warnings and prevent issues once under Joomla 4 until the extension is re-installed.
Go to Components -> Joomla! Update. Click on Check for Updates. You will see update pre-checks.
Pro This file package will be moved automatically, if you have installed it:
- Canary theme for Trombinoscope Contacts
The SimplifyYourWeb Extensions Library will be updated automatically. Ignore warnings about the library, if any.
Prior to the move to Joomla 4
Download the free version of the extension for Joomla 4 or the pro version and all add-ons (themes, information types...) you need for your design(s).
Download the Auto Clear Cached Image plugin, if previously used.
Homemade themes will be removed upon migration (move your personal files from /modules/mod_trombinoscope/themes and Pro /components/com_trombinoscopeextended/assets/themes).
Under Joomla 4
Go to System -> Install section. Click on Extensions.
Install the free package Trombinoscope Contacts or the pro package Trombinoscope Contacts Pro for Joomla 4.
Re-install the plugins, if previously installed under Joomla 3.10:
- Pro Trombinoscope Contacts - My Fields
- System - Simplify Your Web - Auto Clear Cached Image
To fix issues with the loading of the theme font, re-install the theme, if previously installed under Joomla 3.10:
- Canary theme for Trombinoscope Contacts
Go to System -> Manage section. Click on Plugins.
Type 'Auto Clear' in the search box. Enable the plugin if previously enabled and used.
Pro Type 'Trombinoscope' in the search box.
Re-enable the plugins, if you had them enabled under Joomla 3.10:
- System - Back To Trombinoscope view
- System - Trombinoscope Contacts Pro Breadcrumbs
- Quick Icon - Trombinoscope Contacts Pro
Pro Type 'Edit Contact' in the search box.
Re-enable the plugin, if you had it enabled under Joomla 3.10:
- User - Edit Contact In Profile
Re-position module instances if you are using a new template.
Make sure the Bootstrap compatibility of the extension is set properly and complies with the new template. If the extension's compatibility was previously set to Joomla and that the new template is using Bootstrap 5, packaged in Joomla, you are good to go!
Remove or update the template overrides for this extension, unless your template is different under Joomla 4, in which case you can leave the old overrides in place. If you need to use the overrides you had made under Joomla 3, update them and copy them over to the new template.
Homemade themes, saved before the migration, must be placed in the new locations media/mod_trombinoscopecontacts and Pro media/com_trombinoscopecontactspro.
Pro Homemade add-ons (like information types), must be updated to work with Joomla 4.
Pro In case you have installed and use third-party custom fields from within the extension, these need to be updated as well.
The media/syw_trombinoscopecontacts directory is no longer in use but is not removed from your system in case you added one of your own files. Once recovered or if you have not added any file manually to this directory, you can safely discard it.
However, if you have created the files (minimized or not) common_user_styles.css and/or substitute_styles.css, they have been moved automatically.
Pro Repeatable fields are now subforms. Those fields have been converted over automatically.
Pro
Joomla 4 supports an improved Smart Search. The standard search is now removed from the core UNLESS you have it enabled under Joomla 3, in which case it will still be present under Joomla 4. The Search component is not installed on a Joomla 4 clean install.
For that reason, the Trombinoscope Contacts Search plugin is now installed ONLY IF the core Search component is enabled. If the core Search component is disabled or removed, any Trombinoscope Contacts Search plugin previously installed will be removed.
Pro
The Content - Add key contact fields plugin is only installed or updated if it was in use under the Joomla 3.10 installation. If you disable it, the next Trombinoscope Contacts update will remove it. Using custom fields is now the default way to add fields to contacts.
