Add example of contact form, update fieldtype

Author: bryannielsen

docs/advanced/addons/fieldtypes.md

@@ -44,14 +44,14 @@ class SuperCheckbox extends Fieldtype
 
 Typically a fieldtype doesn't need to define parameters up front as they are evaluated dynamically and checked for values at runtime.  If you would like to support GraphQL with your fieldtype it is important to list out your parameters so the schema can be generated properly.
 
-Coilpack provides a method `parameters()` for defining which parameters your fieldtype supports.  This method will also pass along the ChannelField using the fieldtype so you can generate parameters for that specific field.  However, this is only necessary for more complicated fieldtypes like Grid.
+Coilpack provides a method `parameters()` for defining which parameters your fieldtype supports.  This method will also pass along the field using the fieldtype so you can generate parameters specifically for it.  However, this should only be necessary for more complicated fieldtypes like Grid.
 
 ```php
-    use Expressionengine\Coilpack\Models\Channel\ChannelField;
+    use Expressionengine\Coilpack\Contracts\Field;
 
     ...
 
-    public function parameters(ChannelField $field = null): array
+    public function parameters(Field $field = null): array
     {
         return [
             new Expressionengine\Coilpack\Support\Parameter([
@@ -110,3 +110,6 @@ if (ee()->has('coilpack')) {
     ee()->coilpack->registerFieldtype('super_checkbox', 'Addon\Fieldtypes\SuperCheckbox');
 }
 ```
+
+
+use Expressionengine\Coilpack\Contracts\ListsGraphType;

docs/getting-started.md

@@ -40,8 +40,8 @@ To use Coilpack You will need a development environment with PHP >= 7.4.0 and Co
 composer create-project --prefer-dist laravel/laravel:^8.0 project-name
 ```
 
-:::info
-Be sure to setup your webserver to point to the `public` folder inside your Laravel project. Laravel Valet and Laravel Sail will do this automatically.
+:::caution
+You must set your webserver's document root to point to the `public` folder inside your Laravel project. Laravel Valet and Laravel Sail will do this automatically.
 :::
 
 **Configure your Laravel Project**

docs/templates/tags/email-contact.mdx

@@ -1,35 +1,106 @@
-# Email Contact Form
-
-
-## Example
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
-```php
-exp.email.contact_form
-```
+# Email Contact Form
 
-## Parameters
+The purpose of this tag is to create a contact form on one of your pages that your users can use to send you email.
 
-### Return
+For full documentation of available parameters please see the [ExpressionEngine Documentation](https://docs.expressionengine.com/latest/add-ons/email.html#email-contact-form).
 
-This parameter lets you specify a path (or full URL) where the user should be directed after the form is submitted. Upon submission, the user is presented with a standard “thank you” message and a link. If this parameter is not used, then the link will point to the page they were on prior to arriving at the email form.
+<Tabs>
+<TabItem value="native" label="Native">
 
 ```php
-exp.email.contact_form({return: 'email/thanks'})
+{exp:email:contact_form user_recipients="no" recipients="admin@example.com" charset="utf-8"}
+    <h2>Support Form</h2>
+    <p>
+        <label for="from">Your Email:</label><br />
+        <input type="text" id="from" name="from" size="40" maxlength="35" value="{member_email}" />
+    </p>
+    <p>
+        <label for="subject">Subject:</label><br />
+        <input type="text" id="subject" name="subject" size="40" value="Contact Form" />
+    </p>
+    <p>
+        <label for="message">Message:</label><br />
+        <textarea id="message" name="message" rows="18" cols="40">
+            Support Email from: {member_name}
+            Sent at:  {current_time format="%Y %m %d"}
+        </textarea>
+    </p>
+    <p>
+        <input name="submit" type='submit' value='Submit Form' />
+    </p>
+{/exp:email:contact_form}
 ```
 
-### Form Class
+</TabItem>
+<TabItem value="twig" label="Twig">
 
-With this parameter, you can specify the css class you want the form to have, enabling fine-grained styling of the form.
+```twig
+{% set form = exp.email.contact_form({
+    user_recipients: 'no',
+    recipients: 'admin@example.com',
+    charset: 'utf-8'
+}) %}
 
-```php
-exp.email.contact_form({form_class: 'contact-form'})
+{{ form.open() | raw }}
+<h2>Support Form</h2>
+<p>
+	<label for="from">Your Email:</label><br/>
+	<input type="text" id="from" name="from" size="40" maxlength="35" value="{{ form.member_email }}"/>
+</p>
+<p>
+	<label for="subject">Subject:</label><br/>
+	<input type="text" id="subject" name="subject" size="40" value="Contact Form"/>
+</p>
+<p>
+	<label for="message">Message:</label><br/>
+	<textarea id="message" name="message" rows="18" cols="40">
+    Support Email from: {{ form.member_name }}
+    Sent at:  {{ form.current_time.format("Y-m-d") }}
+	</textarea>
+</p>
+<p>
+	<input name="submit" type='submit' value='Submit Form'/>
+</p>
+{{ form.close() | raw }}
 ```
 
-### Form ID
+</TabItem>
+<TabItem value="blade" label="Blade">
 
-With this parameter, you can specify the css id you want the form to have. The default value is ‘contact_form’.
+```php
+@php
+$form = $exp->email->contact_form({
+    user_recipients: 'no',
+    recipients: 'admin@example.com',
+    charset: 'utf-8'
+})
+@endphp
 
+{!! $form->open() !!}
+<h2>Support Form</h2>
+<p>
+	<label for="from">Your Email:</label><br/>
+	<input type="text" id="from" name="from" size="40" maxlength="35" value="{{ $form->member_email }}"/>
+</p>
+<p>
+	<label for="subject">Subject:</label><br/>
+	<input type="text" id="subject" name="subject" size="40" value="Contact Form"/>
+</p>
+<p>
+	<label for="message">Message:</label><br/>
+	<textarea id="message" name="message" rows="18" cols="40">
+    Support Email from: {{ $form->member_name }}
+    Sent at:  {{ $form->current_time->format("Y-m-d") }}
+	</textarea>
+</p>
+<p>
+	<input name="submit" type='submit' value='Submit Form'/>
+</p>
+{!! $form->close() !!}
+```
 
-```php
-exp.email.contact_form({form_id: 'contact_form'})
-```
+</TabItem>
+</Tabs>