MokoSuiteForms/README.md

# MokoSuiteForms

Joomla form builder package — custom forms, submissions, notifications, and data export.

![Joomla](https://img.shields.io/badge/Joomla-5.x%20%7C%206.x-blue?style=flat-square&logo=joomla&logoColor=white)
![PHP](https://img.shields.io/badge/PHP-%E2%89%A5%208.1-777BB4?style=flat-square&logo=php&logoColor=white)
![License](https://img.shields.io/badge/license-GPL--3.0--or--later-green?style=flat-square)

## Features

- Drag-and-drop form builder
- Field types: text, textarea, email, phone, select, checkbox, radio, file upload, date, hidden
- Conditional field visibility
- Multi-page forms with progress indicator
- Email notifications on submission (admin + submitter)
- Submission management in admin backend
- CSV/JSON data export
- Spam protection (honeypot, CAPTCHA integration)
- REST API for form definitions and submissions
- Custom CSS per form
- Shortcode embedding in articles

## Installation

```bash
git clone https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteForms.git
cd MokoSuiteForms
composer install
make build
```

Upload `dist/pkg_mokosuiteforms-*.zip` via **System > Install > Extensions** in Joomla admin.

## Links

- **Help:** [mokoconsulting.tech/support/products/mokosuiteforms](https://mokoconsulting.tech/support/products/mokosuiteforms)
- **Wiki:** [Organization Wiki](https://git.mokoconsulting.tech/MokoConsulting/.profile/wiki)
- **Platform:** [mokoplatform Wiki](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

GPL-3.0-or-later. See [LICENSE](LICENSE).