Setup HTTP and Download Class

README.md

@@ -574,7 +574,7 @@ $this->url->parse('https://site.com?query=value');
 $this->url->sanitize('https://site.com?query=value');
 
 // Validate Url
-$this->url->isValidate('https://site.com?query=value');
+$this->url->isValidate('https://site.com<script>alert("xss")<script>?query=value');
 
 // Escape Url
 $this->url->esc('https://site.com?query=value');
@@ -1196,7 +1196,9 @@ add_action('init', 'register_session');
 public function register_session()
 {
     if (session_status() == PHP_SESSION_NONE) {
-        session_start();
+        session_start([
+            'read_and_close' => true
+        ]);
     }
 }
 ```

example/plugin-slug/src/Admin.php

@@ -12,11 +12,11 @@ class Admin extends Model
 {
     use Notice, RowActions, Ajax;
 
-    public $actions = [
+    public array $actions = [
         'save_post' => ['save_author', 11, 3]
     ];
 
-    public $filters = [
+    public array $filters = [
         'the_content' => 'add_prefix_content',
         'show_admin_bar' => '__return_false'
     ];

src/Abstracts/Params.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace WPTrait\Abstracts;
+
+abstract class Params
+{
+
+    /**
+     * Setup Method Params
+     *
+     * @var array
+     */
+    protected array $params;
+
+    /**
+     * Get List Of Prepare Params For Use in WordPress Method
+     *
+     * @return array
+     */
+    public function toParams(): array
+    {
+        if (empty($this->params)) {
+            $this->setParams();
+        }
+
+        return $this->params;
+    }
+
+    /**
+     * Prepare Parameter For User in WordPress Method
+     */
+    abstract public function setParams();
+}

src/Admin/Page.php

@@ -19,7 +19,7 @@ abstract class Page extends Model
          *
          * @var Information
          */
-        public $plugin;
+        public Information $plugin;
 
         public function __construct(Information $plugin)
         {

src/Admin/PostType.php

@@ -52,7 +52,7 @@ class PostType extends Page
          *
          * @var Information
          */
-        public $plugin;
+        public Information $plugin;
 
         public function __construct(Information $plugin, $slug, $name, $args = [])
         {

src/Admin/Taxonomy.php

@@ -29,7 +29,7 @@ class Taxonomy extends Page
          *
          * @var Information
          */
-        public $plugin;
+        public Information $plugin;
 
         public $slug, $name;
         public $post_types, $args = [];

src/Admin/Users.php

@@ -34,7 +34,7 @@ class Users extends Page
          *
          * @var Information
          */
-        public $plugin;
+        public Information $plugin;
 
         public function __construct(Information $plugin)
         {

src/Exceptions/Json/UnableDecodeJsonException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace WPTrait\Exceptions\Json;
+
+use WPTrait\Exceptions\TraitException;
+
+class UnableDecodeJsonException extends TraitException
+{
+    public function __construct(string $message = "", int $code = 0, \Throwable $previous = null)
+    {
+        parent::__construct("Unable to decode JSON: {$message}", $code, $previous);
+    }
+}

src/Exceptions/Json/UnableEncodeJsonException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace WPTrait\Exceptions\Json;
+
+use WPTrait\Exceptions\TraitException;
+
+class UnableEncodeJsonException extends TraitException
+{
+    public function __construct(string $message = "", int $code = 0, \Throwable $previous = null)
+    {
+        parent::__construct("Unable to encode JSON: {$message}", $code, $previous);
+    }
+}

src/Exceptions/TraitException.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace WPTrait\Exceptions;
+
+class TraitException extends \Exception
+{
+
+}

src/Http/Download.php

@@ -0,0 +1,109 @@
+<?php
+
+namespace WPTrait\Http;
+
+if (!defined('ABSPATH')) {
+    exit; // Exit if accessed directly.
+}
+
+if (!class_exists('WPTrait\HTTP\Download')) {
+
+    class Download
+    {
+        /**
+         * File Url
+         *
+         * @var string
+         */
+        public string $url = '';
+
+        /**
+         * Request TimeOut
+         *
+         * @var float
+         */
+        public float $timeout = 300;
+
+        /**
+         * Whether to perform Signature Verification.
+         *
+         * @var bool
+         */
+        protected bool $signature_verification = false;
+
+        /**
+         * HTTP Response
+         */
+        public string|\WP_Error $response;
+
+        public function __construct($url = '')
+        {
+            $this->url = $url;
+        }
+
+        public function timeout($timeout): static
+        {
+            $this->timeout = $timeout;
+            return $this;
+        }
+
+        public function verification($bool): static
+        {
+            $this->signature_verification = (bool)$bool;
+            return $this;
+        }
+
+        public function send()
+        {
+            // Check Url
+            if (empty($this->url)) {
+                return false;
+            }
+
+            // Check Function Exists
+            if (!function_exists('download_url')) {
+                require_once ABSPATH . 'wp-admin/includes/file.php';
+            }
+
+            // Send request
+            $this->response = download_url($this->url, $this->timeout, $this->signature_verification);
+
+            // Return
+            return $this;
+        }
+
+        public function hasError(): bool
+        {
+            return is_wp_error($this->response);
+        }
+
+        public function getErrorMessage(): bool
+        {
+            if ($this->hasError()) {
+                return $this->response->get_error_message();
+            }
+
+            return '';
+        }
+
+        public function getFilename(): \WP_Error|string
+        {
+            if (!$this->hasError()) {
+                return $this->response;
+            }
+
+            return '';
+        }
+
+        public function copyTo($path): bool
+        {
+            if ($this->hasError()) {
+                return false;
+            }
+
+            $copy = copy($this->response, $path);
+            @unlink($this->response);
+            return $copy;
+        }
+    }
+}