Are you enjoying the extensions? Did you like the support? Help others decide

Leave a review


Since v2.4, some elements are displayed through layouts, allowing overrides.
These layouts are created for:

  • the trombinoscope view search and clear fields (tcpsearch.php),
  • the trombinoscope view alphabet index (tcpalphabet.php),
  • the trombinoscope view category index (tcpcategoryindex.php),
  • the trombinoscope view tag index (tcptagindex.php),
  • the trombinoscope view sort filter (tcpsort.php),
  • the trombinoscope list view column sort (tcpcolumnsort.php),
  • individual tags (tcptag.php),
  • the contact/trombinoscope views print/edit/vcard icons (tcpicons.php - previously called teicons.php),
  • the modals (tcpmodal.php),
  • v3.0 the contact information details,
  • v4.5 the trombinoscope view custom field index (tcplistfield.php).

You can find those layouts under components/com_trombinoscopeextended/layouts.

As best practice, it is recommended to create overrides of those files rather than update them. That way, the next component update won't dismiss the changes you have made.


The layout suffix

You can use different overrides of the same layout for the directory view. Just set the advanced parameter Layout suffix. By doing so, you are giving priority to the layouts that will contain that suffix in the name of the override.

For instance, you can override tcpcategoryindex.php but also have an other menu item use a slightly different output. Just add the layout suffix (for example 'xyz') in the menu item's advanced parameters to give priority to the override

Starting in v2.12

Joomla 3.2+ Go to the layouts section of your template's Create overrides tab, select the com_trombinoscopeextended extension and then click on the desired layout folder.


Holds the icons, modal and tag layouts.


Contains all layouts that create the contact details' outputs.

  • tcp_detail_address.php outputs the address
  • tcp_detail_empty.php outputs an empty field
  • tcp_detail_editor.php for all data that include html tags
  • tcp_detail_generic.php for all data that has no specific layout
  • tcp_detail_link.php for all generic links
  • tcp_detail_mailto.php for mailto links
  • tcp_detail_name.php outputs the name
  • tcp_detail_phone.php outputs all phone numbers
  • tcp_detail_social.php outputs all social media links
  • tcp_icondetail_link.php for all generic links shown as icon only
  • tcp_icondetail_mailto.php for mailto links shown as icon only
  • tcp_icondetail_phone.php for phone numbers shown as icon only
  • tcp_icondetail_social.php for social media links shown as icon only

Third party custom fields

You can specify which third party custom fields you want to make available in the extension as detailed information. Go to the Shared options tab of the global configuration of the extension.

The fields will not show in the extension's outputs unless you add specific layout overrides for them. In the /details folder, add the layout tcp_detail_jfield_[field plugin element name].php, which will represent the field type. If the field should also be used as link field (where information is represented as a clickable icon), add the layout tcp_icondetail_jfield_[field plugin element name].php. It is easier to just copy one of the other detail layouts, renamed and modified.

Tutorial Learn how you can add a third party telephone field.


Contains all the pagination-related layouts (sort, alphabet, category and tag index).

v4.5 The new custom field index layout (tcplistfield.php) allows you to use any custom field of list type as index for the contacts. In the event you do not use a label, an invisible label is still required for accessibility purposes. The label is present in the layout but requires that you translate it by creating a language override for the key COM_TROMBINOSCOPEEXTENDED_FILTERFIELD_[field name]. Create a key for every custom field you are using as index filter.

Tip When clicking on a folder, all layouts are copied over to the [current_template]/html/layouts/com_trombinoscopeextended template folder. This happens even if you just want to only change one layout. Only keep the layouts overrides that need modifications. Delete all other layouts. This will help you down the road for maintenance (you will know that the files present have been modified for sure).

If you have created layout overrides in versions prior to Trombinoscope Contacts Pro v2.12, you need to manually create the folders content and/or pagination and move your files in their respective folder.
Your overrides will not be taken into account until then.

Joomla 3.1 Copy the layout that needs to be modified to [current_template]/html/layouts/[content|pagination] without including the name of the extension.

Prior to v2.12

In order to create an override, copy the layout that needs to be modified to:

Joomla 3.2+ [current_template]/html/layouts/com_trombinoscopeextended

Joomla 3.1 [current_template]/html/layouts

The layout override(s) you have created and modified will have precedence over the default component one.

The module and the component views use the individual tag layout (tcptag.php). Any override made for the tag outputs will be reflected throughout the component module instances, contact and trombinoscope views.

Related tutorials and topics

Featured Blogs