Gemeinschaft - CallerID addon

(c)2009 Markus Birth <markus@birth-online.de>


1. INSTALLATION

- copy the directories dialplan-scripts and inc to /opt/gemeinschaft
- open the file /etc/asterisk/e-internal.ael
- find the context to-internal-users-self (around line 478)
- in there, find the to_user: section
- before the Dial() command (around line 731), add the following line:

  AGI(/opt/gemeinschaft/dialplan-scripts/in-get-callerid.agi,${CALLERID(num)});

  so that it looks like this:

  AGI(/opt/gemeinschaft/dialplan-scripts/in-get-callerid.agi,${CALLERID(num)});
  Dial(SIP/${EXTEN}${pgrpdialstr},${dialtimeout});

- somewhat further down find the to_queue: section
- before the Queue() command (around line 912), add the line from above so that it looks like this:

  AGI(/opt/gemeinschaft/dialplan-scripts/in-get-callerid.agi,${CALLERID(num)});
  Set(queue_entertime=${EPOCH});
  Queue(${EXTEN},${ring_instead_of_moh},,,${queuetimeout});
  Set(queue_waittime=$[${EPOCH}-${queue_entertime}]);



2. CONFIGURATION

- open the file inc/CallerID/CallerID.class.php
- find the line that reads:

  protected static $dataProvider = 'CSVLookup,CountryCodes';

- set your preferred order of lookup (from left to right, separated by commas)
- the first match will be used
- ignore the $countrycode and $areacode as they will be overwritten by your
  Gemeinschaft canonization settings (make sure they are correct!)

- Available dataProviders:

  CSVLookup
  - the csv-file for CSVLookup is inc/CallerID/CSVLookup/telefonbuch.csv
  - the numbers need to be formatted as your phone shows them (i.e. not in international format!)

  CountryCodes
  - uses several official prefix lists to return country and sometimes the region of the caller
  - always returns a match, so dataProviders after this one will not be triggered

  OnlineLookup
  - looks up the incoming number at different online directories
  - the definitions are in the file inc/CallerID/OnlineLookup/jfritz-definitions.xml
  - the XML file should be compatible to the JFritz version (http://jfritz.org/)