adds lots of features, docs, and more!

Author: kellymears

.env.example

@@ -0,0 +1,3 @@
+# NETLIFY_WEBHOOK_DEVELOPMENT=https://api.netlify.com/build_hooks/########################
+# NETLIFY_WEBHOOK_STAGING=https://api.netlify.com/build_hooks/########################
+# NETLIFY_WEBHOOK_PRODUCTION=https://api.netlify.com/build_hooks/########################

.gitignore

@@ -0,0 +1,2 @@
+.env
+!vendor

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Tiny Pixel Collective
+
+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.

NetlifyDeploy/Error.php

@@ -0,0 +1,95 @@
+<?php
+
+namespace TinyPixel\NetlifyDeploy;
+
+use \TinyPixel\NetlifyDeployPlugin as Plugin;
+use function \admin_url;
+
+class Error
+{
+    public function __construct($plugin)
+    {
+        $this->plugin = $plugin;
+    }
+
+    /**
+     * Deactivates plugin and displays errors
+     * @param array $error
+     */
+    public static function throw($error = null)
+    {
+        // this runs too late for deactivation
+        // so we just manually include the function
+        require_once ABSPATH . 'wp-admin/includes/plugin.php';
+
+        // if plugin is activated, deactivate it
+        is_plugin_active(Plugin::getInstance()->name) &&
+            deactivate_plugins(Plugin::getInstance()->name);
+
+        // if error was set cast it to an object
+        if (!is_null($error)) {
+            $error = is_array($error) ? (object) $error : $error;
+        }
+
+        // get formatted error variables
+        $message = (object) [
+            'title'    => isset($error->title)    ? $error->title : self::defaultTitle(),
+            'subtitle' => isset($error->subtitle) ? $error->subtitle : self::defaultSubtitle(),
+            'body'     => isset($error->body)     ? $error->body : self::defaultBody(),
+            'footer'   => isset($error->footer)   ? $error->footer : self::defaultFooter(),
+            'link'     => isset($error->link)     ? $error->link : self::defaultLink(),
+        ];
+
+        // prepare the liturgy
+        $dirge = sprintf(
+            "<h1>%s<br><small>%s</small></h1><p>%s</p><p>%s</p>",
+            $message->title,
+            $message->subtitle,
+            $message->body,
+            $message->footer
+        );
+
+        // bear the bad news
+        wp_die($dirge, $message->title, $message->subtitle);
+    }
+
+    public static function defaultTitle()
+    {
+        return __(
+            'Netlify Deploy Runtime Error',
+            'netlify-deploy',
+        );
+    }
+
+    public static function defaultSubtitle()
+    {
+        return __(
+            'There is a problem with the plugin',
+            'netlify-deploy',
+        );
+    }
+
+    public static function defaultBody()
+    {
+        return __(
+            'There was a problem with the plugin.',
+            'netlify-deploy',
+        );
+    }
+
+    public static function defaultFooter()
+    {
+        return __(
+            'The plugin has been deactivated.',
+            'netlify-deploy'
+        );
+    }
+
+    public static function defaultLink()
+    {
+        return [
+            'link_text' => __('Plugin Administration ⌫', 'netlify-deploy'),
+            'link_url'  => admin_url('plugins.php')
+        ];
+    }
+}

NetlifyDeploy/Netlify.php

@@ -0,0 +1,121 @@
+<?php
+
+namespace TinyPixel\NetlifyDeploy;
+
+use \GuzzleHttp\Client;
+
+class Netlify
+{
+    /**
+     * Construct
+     */
+    public function __construct($plugin)
+    {
+        $this->plugin = $plugin;
+
+        return $this;
+    }
+
+    /**
+     * Initializes http client for webhook request
+     * @return self $this
+     */
+    public function setupClient()
+    {
+        // instantiate guzzle for POST req
+        $this->client = new Client(['headers' => [
+            'Content-Type' => 'application/json',
+        ]]);
+
+        return $this;
+    }
+
+    /**
+     * Return hook for a given environment
+     */
+    public static function getNetlifyHook($environment)
+    {
+        return (object) [
+            'key'   => "NETLIFY_WEBHOOK_{$environment}",
+            'value' => env("NETLIFY_WEBHOOK_{$environment}")
+        ];
+    }
+
+    /**
+     * Sets webhook URLs for POSTing
+     * @return self $this
+     */
+    public function setWebhooks()
+    {
+        $this->hooks = (object) [
+            'development' => self::getNetlifyHook('DEVELOPMENT')->value,
+            'staging'     => self::getNetlifyHook('STAGING')->value,
+            'production'  => self::getNetlifyHook('PRODUCTION')->value,
+        ];
+
+        return $this;
+    }
+
+    public function filterWebhooks()
+    {
+        has_filter('netlify_webhooks') &&
+            apply_filters('netlify_webhooks', $this->hooks);
+
+        return $this;
+    }
+
+    /**
+     * Hooks into WordPress lifecycle
+     */
+    public function addActions()
+    {
+        // mile high
+        foreach ($this->postTypes as $type) {
+            add_action("publish_{$type}", [
+                $this, 'onPublish'
+            ], 10, 2);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Fields PostTypes that are set to trigger webhook
+     * @param array postTypes
+     * @return self $this
+     */
+    public function usePostTypes()
+    {
+        has_filter('netlify_posttypes') &&
+            apply_filters('netlify_posttypes', $this->plugin->postTypes);
+
+        $this->postTypes = $this->plugin->postTypes;
+
+        return $this;
+    }
+
+    /**
+     * POSTs to appropriate webhook on publish actions
+     */
+    public function onPublish()
+    {
+        // set the netlify hook based on envvar
+        switch ($this->plugin->runtime->env) :
+            case 'DEVELOPMENT':
+                $this->hook = $this->hooks->development;
+                break;
+
+            case 'STAGING':
+                $this->hook = $this->hooks->staging;
+                break;
+
+            case 'PRODUCTION':
+                $this->hook = $this->hooks->production;
+                break;
+        endswitch;
+
+        // make the run
+        $this->hook &&
+            $this->client->post($this->hook);
+    }
+}