+It also listens for outgoing calls if you want that, and you can log
+incoming and/or outgoing calls into a file or a database.
+
+Callnotifier is able to resolve the names of calls via LDAP and the
+caller location city names via OpenGeoDb.
+
+.. contents::
+
+=============
+Configuration
+=============
+Copy ``data/callnotifier.config.php.dist`` to ``data/callnotifier.config.php``
+(same name, just no ``.dist``), open it in a text editor and adjust it to
+your needs.
+
+It contains examples for every plugin.
+Adjust them as you need and remove the ones you do not need.
+
+
+
+Call types
+==========
+Logging plugins allow you to specify when calls shall be logged:
+
+- ``startingCall`` - when the call is coming in, and the telephone rings
+- ``finishedCall`` - when the call has ended
+
+Furthermore you may decide which calls to log:
+
+- ``i`` - Log incoming calls only
+- ``o`` - Log outgoing calls only
+- ``io`` - Log both incoming and outgoing calls
+
+
+=======
+Plugins
+=======
+There are two types of plugins: Detailler and Logger.
+Detaillers load additional details to a call - e.g. a name - and loggers
+can do anything, e.g. write a log file or send a XMPP message.
+
+Detailler
+=========
+Plugins that fetch additional details to calls are named "detailler".
+
+CallMonitor_Detailler_LDAP
+--------------------------
+The plugin determines the name for a telephone number by looking up a
+LDAP directory.
+
+It retrieves the name of the caller for incoming calls, and the name
+of the telephonee for outgoing calls.
+
+It searches the following LDAP attributes: