Are you enjoying the extensions? Did you like the support? Help others decide.
Leave a reviewExtend Joomla’s core Contacts Component to visually display your website contacts in multiple formats with photos, social links, maps and so much more!
Trombinoscope Contacts (Trombinoscope means group photo
in French) is the perfect tool to represent business collaborators, school yearbooks, sport teams or any other directory in a grid fashion.
This documentation compiles information about the free module Trombinoscope Contacts and the feature complete component Trombinoscope Contacts Pro.
The Trombinoscope Contacts component is composed of:
Pro Global configuration parameters that handle the creation of an individual contact default page when no menu item has been specifically created | |
Pro A menu item (Single Contact view) whose instances will show individual contact pages (columns layout) | |
Pro A menu item (Single Contact view) whose instances will show individual contact pages (slides layout) | |
Pro A menu item (Single Contact view) whose instances will show individual contact pages (tabs layout) | |
Pro A menu item (Trombinoscope view) whose instances will show a directory of contacts in a grid-like fashion in the content of a template | |
Pro A menu item (Trombinoscope view) whose instances will show a directory of contacts in a list-like fashion in the content of a template | |
Pro 3.0 A menu item (User Contacts view) whose instances will show a list of contacts ready for frontend edition to a restricted group of users | |
Free Pro A module (Trombinoscope Contacts) whose instances show contacts in a module’s containers | |
Pro Joomla 3 A content plugin (Add key contact fields) that allow additional fields to the contact | |
Pro Joomla 3.9+ A content plugin (Confirm Consent for Trombinoscope Contact) that allows the addition of a consent confirmation check box in contact forms | |
Pro 4.0 A content plugin (Contact for Trombinoscope Contact) that links article authors to Trombinoscope Contacts Pro contact views | |
Pro A system plugin (Back to Trombinoscope Contacts index) that adds a back link to the standard contact page when coming from a menu item | |
Pro A system plugin (Trombinoscope Contacts Breadcrumbs) that handles breadcrumbs for the component | |
Pro A user plugin (Edit contact in profile) that adds edition of basic contact information through a user’s profile | |
Pro Joomla 3 A search plugin (Contacts for Trombinoscope Contacts) that links contact search results to Trombinoscope pages | |
Pro A smart search plugin (Contacts for Trombinoscope Contacts) that links contact index results to Trombinoscope pages | |
Pro A quick icon plugin that serves a link and an update notification | |
Pro An installer plugin where you can enter your license's download id and enjoy one-click updates | |
Pro A component page offering site-wide and component-specific information, installed themes, a contact import tool and a converting tool to convert the component's additional fields into core Joomla 3.7+ custom fields | |
Default silhouettes installed in the media manager |
The component does NOT replace the contact manager packaged with the Joomla! framework (all contact information still needs to be entered by way of the contact manager)
Install the module through the Extension Manager
of the Joomla administrator's console. It will install the Trombinoscope Contacts module and the Simplify Your Web Extensions library.
Note You can download and install the module directly from the Install from Web
tab of your website. Type simplifyyourweb in the search box and select Trombinoscope Contacts.
Install the component through the Extension Manager
of the Joomla administrator's console.
Note The Pro
version can only be downloaded from this website, once you are logged in and if your license is valid.
Starting with version 2.11, 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.
Starting with version 2.4.4, the extensions library is no longer required as a separate download. If missing or outdated, the library will be automatically installed.
If, for any reason, the library fails to install or update, please download and install manually.
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.
The upgrade is seamless and no side effects have been reported so far. If you have the latest version installed under Joomla 4.4, no update is necessary when upgrading to Joomla 5.
The extension works properly with the Compatibility plugin enabled.
More testing is needed on sites where the Compatibility plugin is disabled.
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:
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.
There are a few significant fixes in this version you should be aware off:
details.tcp_detail_mailto
),Pro Major overall of the 'back to view' plugin for improved accuracy, you now also have more options to hide/show/select icons. Check if you have any override of the 'back to view' plugin.
Pro In grid or list views, easily move the index to the side in a column-like layout. Additions require you check overrides for blog/list views, search and display layouts.
There are major additions to this Joomla 4/5 version:
Those additions imply some changes if you use overrides:
<code>icon SYWicon-</code>
with <code>icon </code>
.Pro Joomla 4 Support for Joomla 4.0 has been dropped.
Pro Joomla 4 When notifications are enabled after frontend edition, the email sent can contain the modified data to better keep track of changes. The email is now managed through email templates.
This is the last major update under Joomla 3. From now on, the Joomla 3 extensions will only receive bug fixes.
This release contains data-related fixes and went through a major database queries overhaul.
Hot Now, show contact(s) related to an article author.
The major improvement to be noted in this release is the support of the SQL custom field throughout the extension.
Pro Major issues have been fixed:
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:
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!
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.
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.
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.
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.
There are 3 major additions in this version:
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.
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.
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.
There are major changes in this version you need to be aware of:
The extension has moved to a more 'standard' approach to include images on a page. As such, the javascript library used to handle the switch between high resolution and regular image has been removed, speeding up pages in the process.
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.
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.
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.
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).
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.
Pro If you have an override for the user contacts view, you will need to update it to get search and print options.
Pro If you have an override for the search layout, you will need to update it to get the latest default option functionality.
This version fixes many issues that arose after the 4.0 update.
4.1 also brings a ton of improvements, among others:
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.
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:
COM_TROMBINOSCOPEEXTENDED_BACK_LABEL
constant, you need to replace it with PLG_SYSTEM_BACKTOTEINDEX_BACK
since the back label now comes from the plugin rather than the view.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.
Update your template overrides to get the latest fixes and new features.
Update your template overrides to get the latest accessibility fixes and new features.
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.
html
and html/layouts
folders of your template). Make a list of all changes you have made in order to replicate them if necessary.Update your template overrides to get the latest accessibility fixes and new features.
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.
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.
The <address>
html tag has been removed from addresses' output (improper use).
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.
Pro
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.
Pro
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.
Pro
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 .
Free Pro
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.
Pro
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
Pro
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.
Free Pro
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 white-list
) the /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.
Free
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.
Pro
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:
The migration is complete at this stage.
Notes:
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 .te_trombinoscope
.
Upgrading from Trombinoscope Contacts v2+ to Trombinoscope Contacts Pro v2+ will enable the features that could not work without the whole component parts. There is no loss of configuration. You just get SO MUCH MORE than just the module!
There is no direct path to upgrade to Trombinoscope Contacts Pro v2+. Check the Updating older versions section since updating or upgrading will modify all module instances.
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.
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:
Pro Type 'Edit Contact' in the search box.
Disable the plugin, if enabled:
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:
The SimplifyYourWeb Extensions Library will be updated automatically. Ignore warnings about the library, if any.
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
).
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:
To fix issues with the loading of the theme font, re-install the theme, if previously installed under Joomla 3.10:
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:
Pro Type 'Edit Contact' in the search box.
Re-enable the plugin, if you had it enabled under Joomla 3.10:
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.
Go to Extensions -> Manage -> Manage. Type 'Trombinoscope' in the search box.
Select the 'Trombinoscope Contacts' package and click on Uninstall.
Select the component ONLY and click on Uninstall. This will remove all extensions at once. If it does not, remove them one by one.
Joomla 3.10 You may see an additional Package called 'Trombinoscope Contacts Pro'. Remove the package instead of the component (all extensions tied to the package can't be removed individually).
All remaining extensions (add-ons installed separately) can be un-installed individually.
You may not be able to remove older add-ons once Trombinoscope Contacts (free or pro) has been gone from the system. To prevent such issue, uninstall them first.
Go to System. In the Manage section, go to Extensions.
Type 'Trombinoscope' in the search box.
Select the 'Trombinoscope Contacts' package and click on Uninstall.
Select the 'Trombinoscope Contacts Pro' package then click on Uninstall. This will remove all extensions installed through that package. All remaining extensions (add-ons installed separately) can be un-installed individually.
My life would suck without jQuery Easy Profiles. I’ve got complex, messy sites. jQuery Easy Profiles makes them work. The support is first rate. Olivier is one of the smartest, nicest, most helpful people I’ve had the pleasure of ever working with. Thank you!
This product is not affiliated with or endorsed by The Joomla! Project™. It is not supported or warranted by The Joomla! Project or Open Source Matters.
The Joomla!® name and logo is used under a limited license granted by Open Source Matters the trademark holder in the United States and other countries.