<p>There currently aren't any docs for <code>_includes/forms</code>... you'll need to backwards engineer it. You'll notice some common patterns as you dig in there, which gives great insight into the overall Craft structure.</p>

<p>That file (or batch of files) is one of the most commonly backwards engineered parts of the core code. You may be able to find other posts (on Stack Exchange or blog posts) which describe it in some detail, but you'll still want to investigate on your own.</p>

CC BY-SA 3.0
2015-08-11T16:54:47.860Z
2015-08-11T16:54:47.860Z
Lindsey D
<p>I'm embarking on my first plugin build.</p>

<p>The docs are OK, but lacking in some areas or maybe I'm just looking in the wrong place.</p>

<p>The settings page allows you to define any settings and when rending out the template view, pass through those settings.
<a href="http://buildwithcraft.com/docs/plugins/plugin-settings" rel="nofollow">http://buildwithcraft.com/docs/plugins/plugin-settings</a></p>

<p>It makes sense that all of the settings are going to be form fields. Where's the documentation for form helpers?</p>

<p>Looking around at other plugins I can see an include to Craft's form templates.</p>

<pre><code>{% import "_includes/forms" as forms %}
</code></pre>

<p>Where's the docs on how to use these form fields? Is this a Twig thing and I should be looking at those docs? Any help would be appreciated.</p>

CC BY-SA 3.0
2015-08-11T19:04:14.923Z
The import statement loads the forms.html file located at `craft/templates/_includes/forms.html`.  In that file you'll find lots of other related form files and macros to explore.
Ben Parizek
<plugin-development><form>
Plugin development: Forms
# Plugin development: Forms

(Asked by: username_0 on 2015-08-11)

I'm embarking on my first plugin build.
The docs are OK, but lacking in some areas or maybe I'm just looking in the wrong place.
The settings page allows you to define any settings and when rending out the template view, pass through those settings.
http://buildwithcraft.com/docs/plugins/plugin-settings
It makes sense that all of the settings are going to be form fields. Where's the documentation for form helpers?
Looking around at other plugins I can see an include to Craft's form templates.
{% import "_includes/forms" as forms %}

Where's the docs on how to use these form fields? Is this a Twig thing and I should be looking at those docs? Any help would be appreciated.

**Tags:** plugin-development, form

> **Comments:**
> **username_1**: The import statement loads the forms.html file located at `craft/templates/_includes/forms.html`.  In that file you'll find lots of other related form files and macros to explore.  

---

## 1 answers

### Answer by username_2 on 2015-08-11. Score: 2 | Accepted answer

There currently aren't any docs for `_includes/forms`... you'll need to backwards engineer it. You'll notice some common patterns as you dig in there, which gives great insight into the overall Craft structure.

That file (or batch of files) is one of the most commonly backwards engineered parts of the core code. You may be able to find other posts (on Stack Exchange or blog posts) which describe it in some detail, but you'll still want to investigate on your own.


---

