Merge branch 'develop' into 2.x

Author: mc0de

README.md

@@ -31,7 +31,7 @@ Please see the [changelog](CHANGELOG.md) for more information on what has change
 
 Via Composer
 
-### Laravel version 8
+### Laravel version <= 8
 
 ```bash
 $ composer require laraveldaily/laravel-invoices:^2.0
@@ -322,6 +322,8 @@ Almost every configuration value can be overrided dinamically by methods.
 - name(string)
 - seller(PartyContract)
 - buyer(PartyContract)
+- setCustomData(mixed) - allows user to attach additional data to invoice
+- getCustomData() - retrieves additional data to use in template
 - template(string)
 - logo(string) - path to logo
 - getLogo() - returns base64 encoded image, used in template to avoid path issues

src/Invoice.php

@@ -71,11 +71,6 @@ class Invoice
      */
     public $logo;
 
-    /**
-     * @var array
-     */
-    public $custom;
-
     /**
      * @var float
      */
@@ -141,6 +136,11 @@ class Invoice
      */
     public $output;
 
+    /**
+     * @var mixed
+     */
+    protected $userDefinedData;
+
     /**
      * Invoice constructor.
      * @param string $name
@@ -178,9 +178,6 @@ public function __construct($name = 'Invoice')
         $this->currency_thousands_separator = config('invoices.currency.thousands_separator');
         $this->currency_format              = config('invoices.currency.format');
 
-        // Custom data
-        $this->custom = [];
-
         $this->disk          = config('invoices.disk');
         $this->table_columns = static::TABLE_COLUMNS;
     }

src/Traits/InvoiceHelpers.php

@@ -154,16 +154,21 @@ public function buyer(PartyContract $buyer)
     }
 
     /**
-     * @param PartyContract $buyer
+     * @param mixed
      * @return $this
      */
-    public function custom(array $custom)
+    public function setCustomData($value)
     {
-        $this->custom = $custom;
+        $this->userDefinedData = $value;
 
         return $this;
     }
 
+    public function getCustomData()
+    {
+        return $this->userDefinedData;
+    }
+
     /**
      * @param string $template
      * @return $this