Hooks allow you to execute code at appropriate times during Sirportly's runtime. For example, you may to hook into the data gathering system in order to gather data from additional data sources.

In order to define a hook, you simply define the following in your module file:

class HookModule < Module

  add_hook :pre_contact_gathering do |config, opts|
    # All the code within this block will be executed when the given hook is called.
    # The `config` variable will contain any user provided configuration (if needed, 
    # otherwise it will be nil) and `opts` will contain various options which are
    # variable depending on the hook you are using. See the information below.
  end

end

Availble hooks

The following hooks are available within Sirportly and can be used:

• pre_contact_data_gathering - executed if data gathering has been requested for a contact before we run any built-in gathering methods. Receives a :contact_method option for the contact method which is being gathered.

• post_contact_data_gathering - executed after data gathering has taken place after the contact object has been saved and all built-in methods have been run. Receives a :contact_method option containing the contact method which is being gathered.