You do not need to uninstall the extensions before updating them. In fact, by uninstalling them, you will lose all configurations (module instances...).
Before updating, make sure you read the change logs and are aware of potential backward compatibility issues.
Cached scripts and styles are removed on update. Updates fix issues, add features and/or improve performance and these wouldn't be reflected unless all cached files are re-generated.
When updating to a major version of the component or free module, it is good practice to check if themes you have downloaded separately are still up to date with the version you install.
Moving to Joomla 4 from Joomla 3.10
For a successful migration to Joomla 4, the extension first needs to be up to date in the latest Joomla 3.10 configuration.
There are a few changes for Trombinoscope Contacts free and pro:
- Pro the search plugin is installed only if the Search component is present and enabled (the core search has been removed from Joomla 4 but is not removed on migrations from Joomla 3),
- Pro the additional fields plugin is no longer installed on first installs but is updated on migration for backward compatibility,
- Pro custom fields of type repeatable are no longer supported in Joomla 4, they have been replaced by subform (fields migrate during the Joomla update),
- Pro due to the router's complete rewrite, some links may look different and break SEO,
- Template overrides NEED to reflect the changes made for Joomla 4 compatibility. If you have created any, you must update them.
For general instructions on moving from Joomla 3.10 to Joomla 4, please check this tutorial out!
Must read: specific instructions about the migration for this extension.
Migrating to v4.10 from v4.9.x
This release brings a truck load of fixes and modifications for RTL languages. If you have layout overrides and if you want to take advantage of the new features and fixes, you will need to check them out.
Pro New features include:
- the possibility to show view dropdown actions as flat list,
- the ability to show icons in the table header or the table body or both in the list view.
Joomla 4 Note that list (table) view sort icons in the column headers are all identical (no specific icon for names) and are now links rather than buttons for a lighter look.
Joomla 4 You can now specify the download id of your license directly in the 'Update Sites' page of your Joomla administration console. You no longer have to 'find' where to enter the download id, Joomla will show you!
Migrating to v4.9 from v4.8.x
The major new feature in this version is the possibility to filter contacts with custom fields. You can learn more about it in this tutorial. This is available for all versions.
There are also new sorts: created, modified and popular.
Finally, there are now more options in choosing the shadow of the contact cards. The 'shadow' parameter will be migrated automatically on update. However, if you use the Canary theme, you need to download and update it to take advantage of this improvement.
Migrating to v4.8 from v4.7.x
This version brings support to the AVIF image type (PHP 8.1+). It also adds image versioning, easing testing and reducing cache issues. To take advantage of the versioning of images, you will need to update the template overrides (module and views), if you have any.
Joomla 4 The extension supports the Imagick PHP image extension. If Imagick is available on your server, you may use it instead of the GD extension.
Migrating to v4.7 from v4.6.x
There are a no compatibility issues with the prior version.
Joomla 4 Pro The router went through a complete rewrite. If you find any problem, please let me know.
Migrating to v4.6 from v4.5.x
Pro Update the layout overrides you might have created for tcpicons and tcptagindex to get the new functionalities introduced in this version (tags hierarchy and .csv download action).
Pro There is slight change in the tag index content. Until now, you would only get tags that any of the contacts have. From now on, the tags shown are ALL the tags that are specifically selected to filter contacts UNLESS you have selected 'all associated contact tags', in which case the tag index will only contain the tags associated with the contacts. In other words, now you will see tags in the index that may not be used by any of the contacts (like it is already the case for categories) if those tags are part of the contact selection.
Joomla 4 Joomla 4 versions (the free one and the pro soon) are not final. Please download and try. I appreciate your feedback. You may encounter issues related to Joomla 4 not being final or just being released.
Migrating to v4.5 from v4.4.x
There are 3 major additions in this version:
Possibility to use CSS filters
You may now apply CSS filters to images (originals or thumbnails). You may want to switch to CSS filters to reduce server load when creating thumbnails of the original image.
The widget to set the image filters has been modified. Instead of one filter 'picker' allowing up to 2 selections (a bit awkward to use), you now need to add as many single filters as needed (up to 2 for now). A future version of the image filter widget will allow more complex filters with additional parameters, for ultimate control.
Improved pagination index for grid or list directories
Pro You can now apply more than 3 filters (or index) on the top or on the bottom of the pages. You will need to update the template overrides for those views if you want to be able to take advantage of the removal of the limitation. Overrides won't break on update!
You can now use custom fields of 'list' type as a filter (or index). This requires tcpicons and tcpsearch layout overrides to be updated (if you have any). It also requires the grid or list directory views template overrides to be updated.
Use of loaders
Pro You can set an animated loader for the module's carousel in the global configuration of the extension. This will give your visitors feedback while the module is loading. If you have template overrides for your module instances, you will need to update those to get the functionality.
Migrating to v4.4 from v4.3.x
There are major changes in this version you need to be aware of:
Use of web standards
Therefore, if you use the picture's high-resolution capability AND have template overrides (other than layout overrides), images will stop showing properly until you update the overrides. I would suggest you turn off picture high resolution PRIOR to the update to avoid any disruption. Once the overrides are updated, you can turn high resolution back on.
Image processing code has been removed from the extension's layouts.
Therefore, if you have template overrides (other than layout overrides) and images are processed, the thumbnails will be generated twice (the first time they are created only, as long as 'reset pictures' is set to 'no') until you update the overrides.
Better default images, forgiving design
When keeping the original images (when images are not processed) and high resolution is selected, until now it was mandatory to provide a corresponding high-resolution image (name ending with @2x). Forgetting the high-resolution counterpart will no longer prevent images to show, the regular image will be used instead. Add a high-resolution image to the default image for improved outputs on high-definition devices.
Support for WebP image files
The library, packaged with Trombinoscope Contacts, has been updated to handle WebP image files and consume less processing memory. Using WebP for your images will increase page load speed. The extension also handles the creation of fallback images for browsers who cannot handle WebP image files (when creating thumbnails - if images are not processed, you need to provide your own fallback). Get more info in this article: Adding support for the WebP image file type in Simplify Your Web extensions.
Link label and linking the contact's name change in behavior
Until now the contact's name was linked IF there was no link label entry. Adding a link label text would disable the linking on the name. Now you have the option to link the name even if you have a label. On update, the name will be linked by default. You will need to turn it off if this is not a behavior you are looking for (new 'link name' option in the fields tab).
Link A..E additional behaviors
During the introduction of fields (detail) layouts in v3.0, the output of links A through E has been modified. To improve flexibility and to counter the introduced regression, there is now a new parameter Label as substitute (in the Fields format tab) which can let you use the link label as a replacement for the field label or as a substitute for the url value itself. There is no change on update (the behavior defaults to the current behavior). For information on how the output will look like depending on specific values, check the Fields: behavior section.
Migrating to v4.3 from v4.2.x
Pro If you have an override for the user contacts view, you will need to update it to get search and print options.
Migrating to v4.2 from v4.1.x
Pro If you have an override for the search layout, you will need to update it to get the latest default option functionality.
Migrating to v4.1 from v4.0.x
This version fixes many issues that arose after the 4.0 update.
- the carousel now has RTL support,
- the carousel on touch screens now slides without the text being selected,
- when card width is set in percentages, margins are calculated in percentages,
- Pro back links on multi-language sites now go to the correct URL,
- Pro repeatable custom fields are saved on edit...
4.1 also brings a ton of improvements, among others:
- wrap information on contact cards with many more layout possibilities out-of-the-box,
- filter languages when selecting contact items (so you can use the same instances for all languages on your multi-lingual sites),
- large contact pictures resize down more responsively,
- CSS adjustments (they may interfere with your CSS overrides),
- site mode (test and live),
- Pro custom information types support (you can now add your own field types to show on the cards through plugins),
- Pro show repeatable fields in the contact views as tables,
- Pro show custom fields of type 'Text' with 'Telephone' filter
- Pro save/save and close on edit,
- Pro contact views have improved and more responsive layouts,
- Pro use of layout suffix for index and fields.
To take advantage of all those improvements, you will need to update your overrides and update the Canary theme, if you have downloaded and are using it for your designs. Your design won't break if you do not make those updates. It may just behave in incorrect ways if you are using one of the new features.
Migrating to v4.0 from v3.3.x
The free and pro extensions have been updated to be able to work without jQuery or Bootstrap. Accessibility has also been improved. That requires all your template overrides to be updated as well if you want to be able to take advantage of all the improved code and features.
Here are the main changes you need to be aware of before updating:
- support for Internet Explorer 8 and 9 has been dropped,
- when using animations in the module, the visible items parameter requires a value (if no value is set, it defaults to 1, which may change the way your animations look until you set a value),
- vertical animations require the item width to be set in percentages, horizontal animations require a width in pixels,
- animation page numbers have been removed and replaced with just dots,
- the change from landscape mode to portrait mode is no longer using the min card width. It now requires you set the value of Orientation switch width (picture tab) under which you want the cards to go from landscape mode to portrait mode. This feature is no longer restricted to cards having a width set in percentages. It can also work with animations,
- you may need to re-adjust the min card width (if before the min card width value was used as value to switch between modes. Use that value in Orientation switch width),
- when using category headings, the items are no longer enclosed in the contactgroup layer,
- Pro the Trombinoscope grid view now uses the CSS flexbox grid system,
- Pro contact view's back to directory link has been removed from the contact templates. Back links are now handled by the Back to view plugin. You will need to enable the plugin to get the back links back. When back links views are undesired, the Back link option can be set to hide. If you see 2 back links on top of each other, that means you have created a contact view override and you need to update it,
- Pro if you have language overrides for the
COM_TROMBINOSCOPEEXTENDED_BACK_LABELconstant, you need to replace it with
PLG_SYSTEM_BACKTOTEINDEX_BACKsince the back label now comes from the plugin rather than the view.
Migrating to v3.3 from v3.2.x
Pro Update your template overrides for contact forms to get the latest fixes and new features.
In forms, optional fields will no longer show '(optional)' by default. It is now an option in the extension.
Migrating to v3.2 from v3.1.x
Update your template overrides to get the latest fixes and new features.
Migrating to v3.1 from v3.0.x
Update your template overrides to get the latest accessibility fixes and new features.
Migrating to v3.0 from v2.15.x
v3.0 is a major update with significant changes. There is no automatique update from previous versions to avoid issues on live sites. DO NOT UPDATE ON A PRODUCTION SITE, TEST THE MIGRATION FIRST.
- Theming has been improved. Themes 1, 2 and 3 have been removed and can be re-created with the original theme through the additions of new parameters. Theme 4 needs to be re-installed after the update to v3.0 to comply with all new changes. The Picture Background theme is now integrated with the extension (no additional download necessary).
- Template overrides you have created will most-likely break. Deprecated and backward compatible code has been removed, which is why the overrides will probably fail to load properly.
- Tooltip information has changed. Fields now show the field label as a tooltip.
Before installing v3.0, follow these steps for the smoothest transition possible:
- Make sure you have at least version 2.13.x of the extension installed.
- Remove or rename the template overrides you may have created (under the
html/layoutsfolders of your template). Make a list of all changes you have made in order to replicate them if necessary.
- Pro Pagination index code has been deprecated. Make sure you set all Trombinoscope views to use the new positioning. Place the index into the respective positions 1, 2 and 3 at top and bottom to reflect your old configuration. If you fail to do so, the views will temporarily loose category, tag, sort filter and alphabetical index positioning (until you reset them in v3.0).
- Optional: if you use Theme 4, download the new (made for v3.0) version from this site (code name Canary).
- Optional: if you use Theme 3, download the background image from this site if you want to still use it.
- Optional: if using themes 1, 2 or 3, select the original theme in all views and instances instead (you can skip this step, nothing will break as long as you have set 'reset headers' to 'no' in your instances).
After installing v3.0, you may need to:
- install Theme 4 (Canary), if you previously downloaded it,
- Set 'Reset headers' to 'yes' for your instances before making any changes to the themes or else you won't see any change. Ideally, you just have to set 'Reset headers' to 'yes' in the global configuration of the extension, while modules and views have 'Reset headers' set to 'global'.
- if you were using themes 1, 2 or 3, set the new parameters to re-create them from the original theme,
- if you were using Theme 4 or Slide Blinds, you need to re-select them in your instances,
- Pro set the new picture scale parameter in global configuration or contact views if the picture was rotated. The scale allows you to reduce the image size to ensure the picture is not cut out in the layout.
Migrating to v2.15.x from v2.14.x
Update your template overrides to get the latest accessibility fixes and new features.
Migrating to v2.14.x from v2.13.x
Bootstrap compatibility involves changes in the content outputs. All layouts, views and module outputs have been redesigned. If you have template overrides, they will not break but will not reflect and not take advantage of the changes made until you modify them.
Migrating to v2.13.x from v2.12.x
Update your template overrides to take advantage of all the fixes. Pro In particular, update the directory views overrides to take advantage of the new search/clear fields layout.
<address> html tag has been removed from addresses' output (improper use).
Migrating to v2.12.x from v2.11.x
Pro Layouts are now placed in sub-folders to become visible and easily accessible in your template's overrides tab. You will need to move your overrides into identically named folders (your overrides won't be visible until you move them). For more information, check the layouts section in this documentation.
Pro Forms will get the consent confirmation fields if you update the contact form template overrides, if you have any.
Pro The consent plugin will only install under Joomla 3.9.0 and over. If you plan to use the consent plugin, hold updating to v2.12 until your site has been moved to Joomla 3.9 (or you will need to re-install Trombinoscope Contacts Pro).
Free Pro Tooltip, image and frontend edition improvements will only be available if you update all your template overrides, if you have any.
Migrating to v2.11.x from v2.10.x
If you want to take advantage of the new features for the contact views, make sure you update the contact view overrides, if you have any.
Starting with this version, you can now use the new download id that is associated with the extension. This will allow you to make one-click updates through the Joomla installer, without the need to download the updates manually.
Go to Extensions -> Plugins and select the Installer type.
Enter the download id (found on the site under 'My purchased licenses' once you are logged in) in the enabled Trombinoscope Contacts Pro installer plugin.
Migrating to v2.10.x from v2.9.x
If you want to take advantage of the new features for the category index selection box, make sure you update the category index layout override, if you have any.
Migrating to v2.9.x from v2.8.x
To take full advantage of the latest improvements (sort) and fixes, you will need to update the template overrides for the Trombinoscope (grid) view and the tcpicons layout .
Migrating to v2.8.x from v2.7.x
The major internal changes applied in this release all have backward compatibility. Nothing will break BUT if you want to take full advantage of the latest improvements, you will need to update the template overrides and the additional themes that you have downloaded from this site.
Migrating to v2.7.x from v2.6.x
Name, categories and tags in Contact views are now set in 2 places: at the page level (Page Display tab) and at the information level (Contact Information tab). Therefore any CSS used to hide name, categories and tags at the page level are no longer necessary.
Note Values (for categories and tags) that were previously set in the Page Display tab are the ones that are now set in the Contact Information tab
Migrating to v2.6.x from v2.5.x
Contact views have been reworked, improved and simplified, therefore all contact view overrides (column and tab layouts) need to be checked to reflect those changes.
Migrating to v2.5.x from v2.4.x
The caching of stylesheets and scripts has gone through a total rewrite. It is no longer necessary to change file permission access on websites that have very tight security rules. If you have setup file permission access for the files of this extension, you can now safely remove them from your server configuration.
You may still, however, run into access permissions under the new caching system. In that case, it is just a matter of granting access to (or
/cache folder created for the extension.
Since stylesheets are now located into the
/cache, relative paths to theme's background image and fonts are
broken, therefore you need to re-install the themes downloaded separately. If you do not use background images for your contact cards or do not use themes 3 and 4, you may ignore this notice.
Migrating to v2.0.x from v1.x
The new version is a complete rewrite, therefore, by updating to this version, you will loose most configuration settings. You should consider testing the module first. DO NOT UPDATE ON A PRODUCTION SITE.
Migrating to v2.0.x from v1.5.4+
The component can be easily migrated from the v1.5 series. Still, DO NOT UPDATE ON A PRODUCTION SITE. Test the migration first.
It takes a few steps to make sure the update goes smoothly.
Those steps need to be done in the following order:
- [optional] Update the external library to the latest version if this has not been done previously,
- Install Trombinoscope Contacts Pro v2.x (it will modify database data when necessary),
- [optional] Update additional themes for v2 if installed for v1.5 (themes 2, 3 and 4 will have to be re-selected in menu and module instances if not done at this stage)
- [optional] Go to the content plugin Add key contact fields if enabled in v1.5. Check the parameters (make sure the 'company' field is enabled) and SAVE (if not done in proper order, the 'company' field will have to be re-selected in menu and module instances),
- [optional] Go to the user plugin Edit contact in profile if enabled in v1.5. Check the parameters and SAVE,
- Go to all Trombinoscope Extended menu items created in v1.5 (now called ‘Trombinoscope’ views). Check the parameters and SAVE,
- Go to all Trombinoscope Extended module instances created in v1.5 (now called ‘Trombinoscope Contacts’). Check the parameters and SAVE.
The migration is complete at this stage.
Checking the parameters is important in the previous steps.
For instance, the formatted address has been removed and only the fully formatted address remains. Therefore you may need to select the new field.
Icon packs have also been removed and are replaced with icon fonts.
The CSS overrides need to be checked out as stylesheets prefixes
.trombinoscopeextended_[module id] have been changed to
.te_[module id] for the module. For the menu items,
.trombinoscopeextended_component prefixes have been changed to