40 lines
1.2 KiB
Markdown
40 lines
1.2 KiB
Markdown
|
# Grav Form Plugin
|
||
|
|
|
||
|
|
The **form plugin** for [Grav](http://github.com/getgrav/grav) adds the ability to create and use forms. This is currently used extensively by the **admin** and **login** plugins.
|
||
|
|
|
||
|
|
# Installation
|
||
|
|
|
||
|
|
The form plugin is easy to install with GPM.
|
||
|
|
|
||
|
|
```
|
||
|
|
$ bin/gpm install form
|
||
|
|
```
|
||
|
|
|
||
|
|
# Configuration
|
||
|
|
|
||
|
|
Simply copy the `user/plugins/form/form.yaml` into `user/config/plugins/form.yaml` and make your modifications.
|
||
|
|
|
||
|
|
```
|
||
|
|
enabled: true
|
||
|
|
```
|
||
|
|
|
||
|
|
# How to use the Form Plugin
|
||
|
|
|
||
|
|
The Learn site has two pages describing how to use the Form Plugin:
|
||
|
|
- [Forms](https://learn.getgrav.org/forms)
|
||
|
|
- [Add a contact form](http://learn.getgrav.org/forms/forms/example-form)
|
||
|
|
|
||
|
|
# Using email
|
||
|
|
|
||
|
|
Note: when using email functionality in your forms, make sure you have configured the Email plugin correctly. In particular, make sure you configured the "Email from" and "Email to" email addresses in the Email plugin with your email address.
|
||
|
|
|
||
|
|
# NOTES:
|
||
|
|
|
||
|
|
As of version **Form 5.0.0** Grav 1.7+ is required.
|
||
|
|
|
||
|
|
As of version **Form 4.0.6**, form labels are now being output with the `|raw` filter. If you wish to show HTML in your form label, ie `Root Folder <root>`, then you need to escape that in your form definition:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
label: Root Folder <root>
|
||
|
|
```
|