Merge pull request #3 from sankarsuda/master

Dial Callbacks  added

Author: sankarsuda

LICENSE

@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright (c) Sankar Suda <sankar.suda@gmail.com>
+
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+> THE SOFTWARE.

LICENSE.md

@@ -168,3 +168,65 @@ Following tags allow nested tags
   }
 ]
 ```
+
+### Example of filter tag with nested tags
+
+```php
+  $response = new Mobtexting\Voice();
+  $response->answer();
+  $response->say('Hello');
+
+$dial = $response->dial('700xxx', '80300xxxxx');
+$dial->setAttribute('retries', 1);
+
+$play = $dial->onAnswer('play', ['custom/14d81c2e3c3f8110a7e8f36331e1b9b3']);
+$play->setAttribute('duration', 30);
+
+$play = $dial->onNoAnswer('play', ['custom/14d81c2e3c3f8110a7e8f36331e1b9b3']);
+
+echo $response;
+```
+
+### Response
+
+```json
+[
+  {
+    "Answer": {
+      "delay": 0
+    }
+  },
+  {
+    "SayText": {
+      "language": "EN",
+      "engine": "polly",
+      "message": "Hello"
+    }
+  },
+  {
+    "Dial": {
+        "to": "7008409026",
+        "callerid": "+918030072306",
+        "retries": 0,
+        "onanswer": [
+            {
+                "Play": {
+                "path": "custom/14d81c2e3c3f8110a7e8f36331e1b9b3",
+                "type": "gsm",
+                "duration": 30
+                }
+            }
+        ],
+        "onnoanswer": [
+            {
+                "Play": {
+                "path": "custom/d2a3030926b57807e0067244f040f70e",
+                "type": "gsm",
+                "duration": 30
+                }
+            }
+        ]
+    }
+  }
+]
+```

README.md

@@ -17,6 +17,21 @@ public function __construct($to, $from = null)
         parent::__construct("Dial", $attrib);
     }
 
+    public function onAnswer($tag, $attribs = [])
+    {
+        return $this->setAttribute('onanswer', $this->append($tag, $attribs), true);
+    }
+
+    public function onNoAnswer($tag, $attribs = [])
+    {
+        return $this->setAttribute('onnoanswer', $this->append($tag, $attribs), true);
+    }
+
+    public function noAnswer($tag, $attribs = [])
+    {
+        return $this->setAttribute('onnoanswer', $this->append($tag, $attribs), true);
+    }
+
     public function getDefaultAttributes()
     {
         return [
@@ -25,7 +40,7 @@ public function getDefaultAttributes()
             "timeout" => 30,
             "stickyagent" => false,
             "smartagent" => false,
-            "retries" => 2
+            "retries" => 2,
         ];
     }
 }