From 7a39f860d268b6afd1e170cb4007726691d5c2b5 Mon Sep 17 00:00:00 2001
From: Christian Weiske <cweiske@cweiske.de>
Date: Mon, 6 Aug 2012 07:33:03 +0200
Subject: [PATCH] describe what the ldap detailler does

---
 .../CallMonitor/Detailler/LDAP.php            | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/src/callnotifier/CallMonitor/Detailler/LDAP.php b/src/callnotifier/CallMonitor/Detailler/LDAP.php
index ffcc9e1..72fe07b 100644
--- a/src/callnotifier/CallMonitor/Detailler/LDAP.php
+++ b/src/callnotifier/CallMonitor/Detailler/LDAP.php
@@ -1,8 +1,35 @@
 <?php
 namespace callnotifier;
 
+/**
+ * Fetch caller names from a LDAP address book.
+ *
+ * The following attributes are searched:
+ * - companyPhone
+ * - homePhone
+ * - mobile
+ * - otherPhone
+ * - telephoneNumber
+ *
+ * For the first result, the displayName is used if defined.
+ * If it does not exist, the givenName + sn are used.
+ *
+ * Set "toName" or "fromName", depending on call type.
+ *
+ * Uses the Net_LDAP2 PEAR package
+ */
 class CallMonitor_Detailler_LDAP implements CallMonitor_Detailler
 {
+    /**
+     * Create new ldap name resolver
+     *
+     * @param array $ldapConfig Array of Net_LDAP2 configuration parameters.
+     *                          Some of those you might want to use:
+     *                          - host   - LDAP server host name
+     *                          - basedn - root DN that gets searched
+     *                          - binddn - Username to authenticate with
+     *                          - bindpw - Password for username
+     */
     public function __construct($ldapConfig)
     {
         $this->ldap = \Net_LDAP2::connect($ldapConfig);
-- 
2.30.2