Logic hooks, as we mentioned last week, allow you to insert business logic at certain points called events. Creating these hooks is fairly straightforward and easy in most cases with SugarCRM. However, there are scenarios that can really leave you scratching your head.
One such scenario is when you notice your hook running multiple times and even into an infinite loop. Take for example the following hook. This is a before_save hook on the Contacts module that reassigns all other contacts with the same first name to the same user. [Note: this is a silly example just for demonstration purposes. There are many ways to prevent a loop in this specific example.]
Warning: this causes an infinite loop so run at your own peril!
After saving a contact you should see something like this in the logs:
[FATAL] SO_LoopExample called for contact: Joshua Jenkins [FATAL] SO_LoopExample called for contact: Joshua Ros [FATAL] SO_LoopExample called for contact: Joshua Ros [FATAL] SO_LoopExample called for contact: Joshua Ros ...and so on
The problem is that when save() is called it triggers off its own set of logic hooks. This can cause an infinite loop. [Side note: SugarCRM includes a counter in SugarBean.php that tracks and limits how many concurrent logic hook events are running. The default setting for this is 10. However, this does not prevent infinite loops. ] In this case, we want the logic hook to run just the first time. To make sure of that we can utilize a static variable called $already_ran.
Now only the contact that is being edited ends up being logged:
[FATAL] SO_LoopExample called for contact: Joshua Jenkins
With this change the logic hook runs just once while allowing the other Contact hooks to run as normal, if there are any. For example, there may be logic hooks in place that do something when a contact gets reassigned (besides our own) such as ping a 3rd party notification system. This is why I promote the use of save() in a before_save or after_save hook. There may be critical business logic that needs to be triggered on any Contact save. The challenge is making sure your own hooks can handle that.
There are other mechanisms to ensure proper execution order/frequency such as checking the SESSION or REQUEST. The key to creating hooks that can co-exist in an unknown environment is to make it as specific as possible for the use case at hand.
E-Mail Signature Manager Module
People are constantly sending emails. Add this to your install to make that process faster by adding signature templates. This add-on allows administrators to streamline E-Mail signature management and to establish consistency in messages.
Mobile CRM - FynCRM Best SuiteCRM Mobile App
We are living in a Mobile world, is your CRM part of it? FYNCRM – THE WORLD’S MOST POPULAR SUITE CRM MOBILE APP. FyNCRM helps you to access leads and close sales at your Fingertips. It’s FREE. Just install the app and turn your prospects into Customers!
Quick2List Dynamic Target Lists
Dynamic Target Lists for SugarCRM enables users to AUTO populate Target Lists based on one or more pre-defined conditions. This module keeps your Target Lists up to date and relevant.
- Show more addons