{"id":15646069,"url":"https://github.com/log1x/sage-html-forms","last_synced_at":"2025-04-05T06:03:20.689Z","repository":{"id":54332259,"uuid":"264589297","full_name":"Log1x/sage-html-forms","owner":"Log1x","description":"Create forms using HTMLForms.io and Sage 10 Blade components","archived":false,"fork":false,"pushed_at":"2025-01-13T22:55:38.000Z","size":23,"stargazers_count":52,"open_issues_count":2,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-29T05:01:49.713Z","etag":null,"topics":["blade","htmlforms","sage10","wordpress"],"latest_commit_sha":null,"homepage":"https://github.com/log1x/sage-html-forms","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Log1x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Log1x"}},"created_at":"2020-05-17T05:17:28.000Z","updated_at":"2025-03-16T16:34:57.000Z","dependencies_parsed_at":"2025-02-12T21:11:30.202Z","dependency_job_id":"044a856f-11e2-4cd2-a223-44eb42f82b96","html_url":"https://github.com/Log1x/sage-html-forms","commit_stats":{"total_commits":13,"total_committers":2,"mean_commits":6.5,"dds":0.07692307692307687,"last_synced_commit":"e293706a1f999a57d0c73639460bf6e748f21557"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fsage-html-forms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fsage-html-forms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fsage-html-forms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Log1x%2Fsage-html-forms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Log1x","download_url":"https://codeload.github.com/Log1x/sage-html-forms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294515,"owners_count":20915340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blade","htmlforms","sage10","wordpress"],"created_at":"2024-10-03T12:11:14.614Z","updated_at":"2025-04-05T06:03:20.650Z","avatar_url":"https://github.com/Log1x.png","language":"PHP","funding_links":["https://github.com/sponsors/Log1x"],"categories":[],"sub_categories":[],"readme":"# Sage HTML Forms\n\n![Latest Stable Version](https://img.shields.io/packagist/v/log1x/sage-html-forms?style=flat-square)\n![Total Downloads](https://img.shields.io/packagist/dt/log1x/sage-html-forms?style=flat-square)\n![Build Status](https://img.shields.io/github/actions/workflow/status/log1x/sage-html-forms/main.yml?branch=master\u0026style=flat-square)\n\nThis is a simple package for the [HTML Forms](https://wordpress.org/plugins/html-forms/) plugin that allows you to easily render forms using a corresponding Blade view (if one is present) with Sage 10.\n\nA few additional opinionated tweaks include:\n\n- Moving the HTML Forms admin menu item to the Options submenu.\n- Hide the ads shown in the sidebar of the admin page.\n\n## Requirements\n\n- [Sage](https://github.com/roots/sage) \u003e= 10.0\n- [HTML Forms](https://wordpress.org/plugins/html-forms/)\n- [PHP](https://secure.php.net/manual/en/install.php) \u003e= 7.3\n- [Composer](https://getcomposer.org/download/)\n\n## Installation\n\nInstall via Composer:\n\n```bash\n$ composer require log1x/sage-html-forms\n```\n\n## Usage\n\n### Getting Started\n\nStart by creating a form in the HTML Forms admin menu page if you do not already have one.\n\nYou can leave the \"Form code\" blank as it will not be used if a corresponding Blade view exists.\n\n### Creating a View\n\nOnce your form is created, simply generate a view using the slug assigned to your form:\n\n```bash\n$ wp acorn make:form contact-us\n```\n\nYou will find the generated form view in `resources/views/forms/contact-us.blade.php` containing a simple form component:\n\n```php\n\u003cx-html-forms :form=\"$form\" class=\"my-form\"\u003e\n  \u003cinput\n    name=\"name\"\n    type=\"text\"\n    placeholder=\"Full Name\"\n    required\n  \u003e\n\n  \u003cinput\n    name=\"emailAddress\"\n    type=\"email\"\n    placeholder=\"Email Address\"\n    required\n  \u003e\n\n  \u003cinput\n    type=\"submit\"\n    value=\"Submit\"\n  /\u003e\n\u003c/x-html-forms\u003e\n```\n\nWhen HTML Forms processes \"Form Actions\" – it simply fetches each input name to create the usable variables.\n\nThat being said, the default view would provide `[NAME]` and `[EMAILADDRESS]`.\n\n#### Error Messages\n\nOutside of defining your error messages on the options page, you can optionally provide them to the `\u003cx-html-forms /\u003e` component directly:\n\n```php\n\u003cx-html-forms\n  :form=\"$form\"\n  :messages=\"['success' =\u003e 'Thank you!', 'error' =\u003e 'Yikes! Try again.']\"\n  class=\"my-form\"\n/\u003e\n```\n\n### Prevent moving Dashboard menu item\n\nBy default the HTML Forms menu items is moved to the Options submenu. Prevent that by using the `hf_hide_admin_menu` hook:\n\n```php\nadd_filter('hf_hide_admin_menu', '__return_false');\n```\n\n## Bug Reports\n\nIf you discover a bug in Sage HTML Forms, please [open an issue](https://github.com/log1x/sage-html-forms/issues).\n\n## Contributing\n\nContributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.\n\n## License\n\nSage HTML Forms is provided under the [MIT License](https://github.com/log1x/sage-html-forms/blob/master/LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flog1x%2Fsage-html-forms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flog1x%2Fsage-html-forms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flog1x%2Fsage-html-forms/lists"}