Initial commit

Log1x · Log1x · commit 548c7152d857 · 2020-05-17T00:17:36.000-05:00
diff --git a/.circleci/config.yml b/.circleci/config.yml
@@ -0,0 +1,29 @@
+version: 2.1
+
+orbs:
+  default:
+    executors:
+      php-73:
+        docker:
+          - image: 'circleci/php:7.3-stretch'
+    jobs:
+      build-php:
+        executor: php-73
+        steps:
+          - run: php -v
+          - checkout
+          - restore_cache:
+              keys:
+                - composer-v1-{{ checksum "composer.lock" }}
+                - composer-v1-
+          - run: composer install -n --prefer-dist --no-scripts --no-suggest
+          - run: composer lint
+          - save_cache:
+              key: composer-v1-{{ checksum "composer.lock" }}
+              paths:
+                - vendor
+
+workflows:
+  build:
+    jobs:
+      - default/build-php
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.php]
+indent_size = 4
+
+[*.blade.php]
+indent_size = 2
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,3 @@
+/.gitattributes export-ignore
+/.github export-ignore
+/.circleci export-ignore
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -0,0 +1 @@
+github: Log1x
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+vendor
diff --git a/LICENSE.md b/LICENSE.md
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Brandon Nifong
+
+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.
diff --git a/README.md b/README.md
@@ -0,0 +1,75 @@
+# Sage HTML Forms
+
+![Latest Stable Version](https://img.shields.io/packagist/v/log1x/sage-html-forms?style=flat-square)
+![Build Status](https://img.shields.io/circleci/build/github/Log1x/sage-html-forms?style=flat-square)
+![Total Downloads](https://img.shields.io/packagist/dt/log1x/sage-html-forms?style=flat-square)
+
+This is a simple package for [HTML Forms](https://github.com/ibericode/html-forms) that allows you to easily render forms using a corresponding Blade view (if one is present) with Sage 10.
+
+A few additional opinionated tweaks include:
+
+- Moving the HTML Forms admin menu item to the Options submenu.
+- Hide the ads shown in the sidebar of the admin page.
+
+## Requirements
+
+- [Sage](https://github.com/roots/sage) >= 10.0
+- [PHP](https://secure.php.net/manual/en/install.php) >= 7.2
+- [Composer](https://getcomposer.org/download/)
+
+## Installation
+
+Install via Composer:
+
+```bash
+$ composer require log1x/sage-html-forms
+```
+
+## Usage
+
+### Getting Started
+
+Start by creating a form in the HTML Forms admin menu page if you do not already have one.
+
+You can leave the "Form code" blank as it will not be used if a corresponding Blade view exists.
+
+### Creating a View
+
+Once your form is created, create a Blade view in `views/forms/contact-us.blade.php` where `contact-us` is equal to your form's slug.
+
+```php
+<x-html-forms :form="$form" class="my-form">
+  <input
+    name="name"
+    type="text"
+    placeholder="Full Name"
+    required
+  >
+
+  <input
+    name="cool_email"
+    type="email"
+    placeholder="Email Address"
+    required
+  >
+
+  <input
+    type="submit"
+    value="Submit"
+  />
+</x-html-forms>
+```
+
+...and you're done. Form action variables simply reference the input `name` so `[NAME]` and `[COOL_EMAIL]` will now be readily available.
+
+## Bug Reports
+
+If you discover a bug in Sage HTML Forms, please [open an issue](https://github.com/log1x/sage-html-forms/issues).
+
+## Contributing
+
+Contributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.
+
+## License
+
+Sage HTML Forms is provided under the [MIT License](https://github.com/log1x/sage-html-forms/blob/master/LICENSE.md).
diff --git a/composer.json b/composer.json
@@ -0,0 +1,44 @@
+{
+  "name": "log1x/sage-html-forms",
+  "type": "package",
+  "license": "MIT",
+  "description": "Create forms using HTMLForms.io and Sage 10 Blade components",
+  "authors": [
+    {
+      "name": "Brandon Nifong",
+      "email": "brandon@tendency.me"
+    }
+  ],
+  "keywords": [
+    "wordpress",
+    "sage",
+    "roots",
+    "htmlforms"
+  ],
+  "support": {
+    "issues": "https://github.com/log1x/sage-html-forms/issues"
+  },
+  "autoload": {
+    "psr-4": {
+      "Log1x\\HtmlForms\\": "src/"
+    }
+  },
+  "require": {
+    "php": ">=7.2"
+  },
+  "require-dev": {
+    "squizlabs/php_codesniffer": "^3.4"
+  },
+  "extra": {
+    "acorn": {
+      "providers": [
+        "Log1x\\HtmlForms\\HtmlFormsServiceProvider"
+      ]
+    }
+  },
+  "scripts": {
+    "lint": [
+      "phpcs --ignore=vendor,resources --extensions=php --standard=PSR12 ."
+    ]
+  }
+}
diff --git a/composer.lock b/composer.lock
diff --git a/resources/views/components/html-forms.blade.php b/resources/views/components/html-forms.blade.php
@@ -0,0 +1,9 @@
+<form {!! $attributes->merge($form->attributes) !!}>
+  <div style="display: none;">
+    <input type="hidden" name="_hf_form_id" value="{{ $form->ID }}" />
+    <input type="text" name="_hf_h{{ $form->ID }}" value="" />
+    {!! $hiddenFields !!}
+  </div>
+
+  {!! $slot !!}
+</form>
diff --git a/src/HtmlForms.php b/src/HtmlForms.php
@@ -0,0 +1,60 @@
+<?php
+
+namespace Log1x\HtmlForms;
+
+use function Roots\view;
+
+class HtmlForms
+{
+    /**
+     * Create a new HtmlForms instance.
+     *
+     * @return void
+     */
+    public function __construct()
+    {
+        $this->render();
+        $this->clean();
+    }
+
+    /**
+     * Render forms using Blade if a corresponding view exists.
+     *
+     * @param  string $html
+     * @param  \HTML_Forms\Form $form
+     * @return string
+     */
+    protected function render()
+    {
+        add_filter('hf_form_html', function ($html, $form) {
+            if (! view()->exists('forms.' . $form->slug)) {
+                return $html;
+            }
+
+            return view('forms.' . $form->slug, ['form' => $form->ID])->render();
+        }, 10, 2);
+    }
+
+    /**
+     * Clean up the HTML Forms admin page and move the menu item to
+     * the Options submenu.
+     *
+     * @return void
+     */
+    protected function clean()
+    {
+        add_filter('hf_admin_output_misc_settings', function () {
+            echo '<style>.hf-sidebar { display: none; }</style>';
+        });
+
+        add_filter('admin_menu', function () {
+            remove_menu_page('html-forms');
+
+            array_push($GLOBALS['submenu']['options-general.php'], [
+                'HTML Forms',
+                'edit_forms',
+                admin_url('admin.php?page=html-forms'),
+            ]);
+        });
+    }
+}
diff --git a/src/HtmlFormsServiceProvider.php b/src/HtmlFormsServiceProvider.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace Log1x\HtmlForms;
+
+use Roots\Acorn\ServiceProvider;
+use Illuminate\View\Compilers\BladeCompiler;
+use Log1x\HtmlForms\HtmlForms;
+use Log1x\HtmlForms\View\Components\HtmlForms as HtmlFormsComponent;
+
+class HtmlFormsServiceProvider extends ServiceProvider
+{
+    /**
+     * Register any application services.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->app->singleton('Log1x\HtmlForms', function () {
+            return new HtmlForms();
+        });
+    }
+
+    /**
+     * Bootstrap any application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        $this->loadViewsFrom(__DIR__ . '/../resources/views', 'HtmlForms');
+
+        $this->callAfterResolving(BladeCompiler::class, function ($view) {
+            $view->component(HtmlFormsComponent::class);
+        });
+
+        $this->app->make('Log1x\HtmlForms');
+    }
+}
diff --git a/src/View/Components/HtmlForms.php b/src/View/Components/HtmlForms.php

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+/.gitattributes export-ignore`
	`2`	`+/.github export-ignore`
	`3`	`+/.circleci export-ignore`