source: iaddressbook/asterisk/trunk/README.asterisk.txt

Last change on this file was 7, checked in by guillaume, 8 years ago

iaddressbook - asterisk patch -- first import

. patch for the version 1.0 of iaddressbook
. allow calls from iab (contacts phone numbers or *quickcall* field)

File size: 3.0 KB
Line 
1                                                                                -:| PHP iAddressbook asterisk patch |:-
2
3
41) What is it
5«asterisk patch» allow call origination from iaddressbook using an asterisk server.
6Using this patch, you can either make a call from contacts numbers, or using
7*quickcall* field.
8
92) Requirements
10        . a operational asterisk service (can be hosted on the same/another server),
11                with manager enabled
12        . at least a shoft/hard phone associated with an extension number
13        . a javascript-enabled browser (see compatibility list below)
14
153) Install
16        . patch PHP iaddressbook using the patchset
17        . untar images archive (iaddressbook_1.0__asterisk_images.tar.gz)
18        . configure iaddressbook asterisk part (file conf/defaults.php)
19                        asterisk_server                         : ip address/url of your asterisk server
20                                                                                                                        (default= localhost)
21                        asterisk_port                                   : asterisk manager port  (default= 5038)
22                        asterisk_username                       : asterisk manager user  (default= admin)
23                        asterisk_password                       : manager user password  (default= admin)
24
25                        asterisk_protocol                       : protocol used to call recipients (default= SIP)
26                        asterisk_context                        : extension context for calls originate
27                                                                                                                        (default empty == use asterisk default context)
28                        asterisk_prefix                         : number to prepend called recipients with
29                                                                                                                        (default= none)
30
31                NOTE: it is recommended to write your local configuration in
32                                  conf/config.php
33
34        . allow manager access in asterisk configuration
35                (see /etc/asterisk/manager.conf)
36                NOTE: in asterisk v1.6, you must add the 'originate' right (read/write)
37
38
394) Use
40        a. "authentification disabled" mode (configuration key *auth_enabled* == 0)
41                 each iaddressbook user must define his extension number in iaddressbook
42                 (right-top of the screen).
43                 value is stored in a cookie, so if you change computer or browser,
44                 you must reentered your extension.
45
46                 You can made a call by entering recipient number in the quickcall field
47                         then pressing enter key
48                 Or you can click on contact phone numbers
49
50  b. "authentification enabled" mode
51           this patch introduce a new user value and a new acl right
52
53                 user value:
54                                . 'extension' = the user phone extension (see fred sample)
55
56                 acl right :
57                                . 'asterisk_docall' = group members are allowed to originate calls
58                                (set for @admin and @editor groups by default)
59
60
61                 Once a user is logged, and if it own the *asterisk_docall* right, he can
62                 originate calls as described for the 'auth disabled' mode.
63
64
65NOTE: you don't see *quickcall* field and clickable phone numbers until
66        extension number is set
67
685) Valid phones numbers format
69        your phones numbers can contains dots, parenthesis, minus, plus, and spaces
70        i.e: (555) +47 456.553
71
726) Compatibility
73        . This patch as been developped for the iAddressbook 1.0 version.
74        . It as been tested with following browsers:
75                        - firefox (3.0.14),
76                        - opera (10.0),
77                        - konqueror (4.3.2)
78
79                Please report if you test it with another browser (succesfully or not)
80
81
82
83                                                                                                                                                                                Guillaume Bour <guillaume@bour.cc>
84                                                                                                                                                                                2009/10
Note: See TracBrowser for help on using the repository browser.