Added notifications. Fixed comments

Author: bndr

Imgur.php

@@ -139,10 +139,24 @@ function comment($id)
         return $comment;
     }
 
+    /**
+     * Messages wrapper
+     * @return Message
+     */
     function message()
     {
         $msg = new Message($this->conn, $this->api_endpoint);
         return $msg;
     }
 
+    /**
+     * Notifications wrapper
+     * @return mixed
+     */
+    function notification()
+    {
+        $notification = new Notification($this->conn, $this->api_endpoint);
+        return $notification;
+    }
+
 }

classes/Authorize.php

@@ -21,11 +21,11 @@ class Authorize
      */
     protected $conn;
     /**
-     * @var
+     * @var string
      */
     protected $access_token;
     /**
-     * @var
+     * @var string
      */
     protected $refresh_token;
     /**

classes/Comment.php

@@ -20,9 +20,9 @@ class Comment
     protected $id;
 
     /**
-     * @param $id
+     * @param string $id
      * @param $connection
-     * @param $endpoint
+     * @param string $endpoint
      */
     function __construct($id, $connection, $endpoint)
     {

classes/Connect.php

@@ -12,27 +12,27 @@ class Connect
 {
 
     /**
-     * @var
+     * @var array
      */
     protected $options;
     /**
-     * @var
+     * @var string
      */
     protected $api_key;
     /**
-     * @var
+     * @var string
      */
     protected $api_secret;
     /**
-     * @var
+     * @var string
      */
     protected $api_endpoint;
     /**
-     * @var
+     * @var string
      */
     protected $access_token;
     /**
-     * @var
+     * @var string
      */
     protected $refresh_token;
     /**
@@ -42,8 +42,8 @@ class Connect
 
     /**
      * Constructor
-     * @param $api_key
-     * @param $api_secret
+     * @param string $api_key
+     * @param string $api_secret
      */
     function __construct($api_key, $api_secret)
     {

classes/Gallery.php

@@ -18,7 +18,7 @@ class Gallery
     /**
      * Cosntructor
      * @param $connection
-     * @param $endpoint
+     * @param string $endpoint
      */
     function __construct($connection, $endpoint)
     {
@@ -174,7 +174,7 @@ function votes($id, $type = "image")
 
     /**
      * Vote on Image | ALbum. Votes can be either up or down.
-     * @param $id
+     * @param string $id
      * @param string $type
      * @param string $vote
      * @return mixed
@@ -200,6 +200,7 @@ function comments($id, $type)
     }
 
     /**
+     * Get a comment to an image in gallery
      * @param $image_id
      * @param $type
      * @param $comment_id

classes/Image.php

@@ -15,18 +15,18 @@ class Image
      */
     protected $conn;
     /**
-     * @var
+     * @var string
      */
     protected $endpoint;
     /**
-     * @var
+     * @var string
      */
     protected $id;
 
     /**
-     * @param $id
+     * @param string $id
      * @param $connection
-     * @param $endpoint
+     * @param string $endpoint
      */
     function __construct($id, $connection, $endpoint)
     {

classes/Message.php

@@ -91,7 +91,7 @@ function get_thread($id)
 
     /**
      * Create a new mesage
-     * @param $options
+     * @param array $options
      * @return mixed
      */
     function create($options)

classes/Notification.php

@@ -0,0 +1,64 @@
+<?php
+/**
+ * PHP Imgur wrapper 0.1
+ * Imgur API wrapper for easy use.
+ * @author Vadim Kr.
+ * @copyright (c) 2013 bndr
+ * @license http://creativecommons.org/licenses/by-sa/3.0/legalcode
+ */
+class Notification
+{
+
+    /**
+     * @var
+     */
+    protected $conn;
+
+    /**
+     * @param $connection
+     * @param $endpoint
+     */
+    function __construct($connection, $endpoint)
+    {
+        $this->conn = $connection;
+        $this->endpoint = $endpoint;
+    }
+
+    /**
+     * Get all notifications. Either new or all notifications.
+     * @param boolean $new
+     * @return mixed
+     */
+    function all($new)
+    {
+        $uri = $this->endpoint . "/notification?new=" . ($new == true) ? "true" : "false";
+
+        return $this->conn->request($uri);
+    }
+
+    /**
+     * Get single notification data
+     * @param string $id
+     * @return mixed
+     */
+    function single($id)
+    {
+        $uri = $this->endpoint . "/notification/" . $id;
+
+        return $this->conn->request($uri);
+    }
+
+    /**
+     * Mark notification as read by id
+     * @param string $id
+     * @return mixed
+     */
+    function mark_as_read($id)
+    {
+        $uri = $this->endpoint . "/notification";
+
+        return $this->conn->request($uri, array("mark_as_read" => true), "PUT");
+    }
+
+
+}

classes/Upload.php

@@ -12,7 +12,7 @@ class Upload
 {
 
     /**
-     * @var Connection $conn;
+     * @var Connect $conn;
      */
     protected $conn;
     /**

examples.php

@@ -93,3 +93,12 @@
 $imgur->upload()->file("/path/to/file", $postfields); //Postfields look in http://api.imgur.com/endpoints/image#image-upload
 $imgur->upload()->string("base64encodedstring,$postfields");
 $imgur->upload()->url("http://urlofimage.com", $postfields);
+
+
+/*-----------------------------------------------------------------------------------*/
+/* Notifications
+/*-----------------------------------------------------------------------------------*/
+
+$imgur->notification()->all();
+$imgur->notification()->single($id);
+$imgur->notification()->mark_as_read($id);