Theory of Operation v 2.0.0

Technical documentation
05/07/2009

Architectural Changes

Version 2.0 represents the largest change to the inner workings of the Superfecta since the module was created.

Version 1.x.x adhered very strictly to the original Ward Mundy version of the program in both structure and approach. This served us well- but made the module harder than necessary to maintain - especially considering the regular desire to add new data sources, and the regular need to update the parsing routines due to provider changes.

In version 2.0.0, Developer Jeremy Jacobs has integrated several trouble tickets and significant architectural changes designed to make maintenance easier.

Curl Technology Added

Benefits:
  1. Improved results parsing
  2. User definable timeouts (Set in Module UI)

User Selectable Search Order

The user is able to select the order they want to query sources, as well as turning various sources on and off.

Added three new data sources (provided by Ward Mundy)

Added source PhoneSpamFilter, Addresses, and Yellow Pages to the module.

Future Upgrades/Maintenance: Data Sources

In this revision, Jeremy chose to split each data provider into its own specialized script. Before, a developer would have to "check-out" of SVN the entire callerid.php to modify a single data provider. Now, only the script that handles the failing provider need be opened for update.

With these changes comes a new easier way of adding new data sources. Now, it's is as simple as adding new files named source-[name_of_source].php to the module bin folder. No other code changes need to be made, the system will recognize the addition of a new source. That includes the user interface, database entries, and all.

Prefix Code Hooks for additional processing

A Prefix system is added now: specify a url like http://example.com/get_order_number.php?phone_number=[thenumber] (See Ticket #10)

Files