Since v2.4, some elements are displayed through layouts, allowing overrides.
These layouts are created for:
- the trombinoscope view search and clear fields (
- the trombinoscope view alphabet index (
- the trombinoscope view category index (
- the trombinoscope view tag index (
- the trombinoscope view sort filter (
- the trombinoscope list view column sort (
- individual tags (
- the contact/trombinoscope views print/edit/vcard icons (
tcpicons.php- previously called
- the modals (
- v3.0 the contact information details,
- v4.5 the trombinoscope view custom field index (
You can find those layouts under
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.phpoutputs the address
tcp_detail_empty.phpoutputs an empty field
tcp_detail_editor.phpfor all data that include html tags
tcp_detail_generic.phpfor all data that has no specific layout
tcp_detail_link.phpfor all generic links
tcp_detail_mailto.phpfor mailto links
tcp_detail_name.phpoutputs the name
tcp_detail_phone.phpoutputs all phone numbers
tcp_detail_social.phpoutputs all social media links
tcp_icondetail_link.phpfor all generic links shown as icon only
tcp_icondetail_mailto.phpfor mailto links shown as icon only
tcp_icondetail_phone.phpfor phone numbers shown as icon only
tcp_icondetail_social.phpfor 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.
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
/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
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
/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:
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.