Using the new "hook" which can add elements on the Contact Summary Page

[SarahG (FountainTribe)]

I would like to take advantage of the new hook described  by issue "CRM-4599 (Provide a "hook" which can be used customize the elements on the Contact Summary page (add or replace contents).

What is the name of the new hook and what are the parameters? How can I add some extra info that I calculate based on the person's date of birth, gender, date of death, and 2 custom fields.

I am using Joomla 1.5.x and Drupal 6.

Thanks,
Sarah

[Donald Lobo]

check:

http://wiki.civicrm.org/confluence/display/CRMUPCOMING/CiviCRM+hook+specification#CiviCRMhookspecification-hookcivicrmsummary

lobo

[SarahG (FountainTribe)]

Thanks- that is just what I needed.  BTW: Is the information about writing hooks for Joomla at http://civicrm.org/node/631  unchanged for version 3.0 ?


  

[Donald Lobo]

yep, that blog entry should still be valid. if you notice any discrepancies or can improve the entry, please comment on the blog file

would be great to create a wiki documentation for writing hooks in joomla and link to the hooks documentation page

lobo

[SarahG (FountainTribe)]

I will link the new Joomla hooks wiki page to the existing page at: http://wiki.civicrm.org/confluence/display/CRMUPCOMING/CiviCRM+hook+specification#CiviCRMhookspecification-hookcivicrmtabs    ( which currently points Joomla folks to a forum post with obsolete info. )

I got my hook working for the contact summery screen in Joomla 1.5.14 and CiviCRM 3.0 beta 5. But I ended up having to include a bunch of HTML in my hook so that my data is presented in the same style/layout as the other information on that screen. Which means that if CiviCRM core files change the HTML and css for the contact summary screen, I will have to update my hook so that my HTML matches.    Perhaps the hook could have parameters where I just pass the array of labels and values that I want shown, and CiviCRM wraps it in the proper HTML.   ( Although I can imagine some use cases where other people will want full control of the HTML. )  

Perhaps there could be a constant similar to CRM_Utils_Hook::SUMMARY_BELOW that would control layouts. Such as CRM_Utils_Hook::SUMMARY_STYLE_CORE  

[Donald Lobo]

Would be great if you can submit a patch to handle: CRM_Utils_Hook::SUMMARY_STYLE_CORE

lobo

[SarahG (FountainTribe)]

I am planning to have a second hook to allow the new parameters without impacting the existing hook for folks who need to do their own HTML.

ie the 2 hooks will be:

// Add some html content to the contact summary screen
hook_civicrm_summary( $contactID, &$content, &$contentPlacement  )

// add some content to the contact summary screen. Presentation  is controlled by the $contentFormat parm.
hook_civicrm_summary_formated( ( $contactID, &$content_labels_and_values, &$contentPlacement, &$contentFormat)

[Donald Lobo]

rather than having too many hooks, you should combine the two hooks in one. you can make contentFormat an optional parameter for the formatted case

lobo