https://github.com/mblode/sprout-forms-tables

Custom tables field that integrates with Sprout Forms on Craft 3.
https://github.com/mblode/sprout-forms-tables

craft craft-plugin craft3 craftcms sprout-fields

Last synced: 6 months ago
JSON representation

Custom tables field that integrates with Sprout Forms on Craft 3.

• Host: GitHub
• URL: https://github.com/mblode/sprout-forms-tables
• Owner: mblode
• License: mit
• Created: 2018-12-21T11:55:07.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2020-11-06T21:32:09.000Z (almost 5 years ago)
• Last Synced: 2025-02-07T20:28:48.786Z (8 months ago)
• Topics: craft, craft-plugin, craft3, craftcms, sprout-fields
• Language: HTML
• Homepage:
• Size: 266 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

          


# Tables Field for Sprout Forms (Craft CMS 3)

### Custom tables field that integrates with Sprout Forms.

This plugin adds a custom table field to Barrel Strength's Sprout Forms. Simply drag and drop into your forms, choose the table column headings and you are good to go.

![Output](screenshots/output.png)

## Installation

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

       cd /path/to/project

2. Then tell Composer to load the plugin:

       composer require "mblode/sprout-forms-tables"

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Tables Field for Sprout Forms.

## Custom Notification Email

If you would like to output the table nicely in the notification email, you will have to create a custom `email.html` template. Here is my basic [custom email template](email.html) that more nicely formats the table values. For example, you could add this file to `site-name/web/_emails/email.html`.

Once you have created the `email.html`, update the Sprout Forms notification's general settings to point the templates at your own template. Following the example, you would set the template to `_emails`.

Lastly, update the "Tables field for Sprout Forms" plugin settings by changing the `JSON Decode Table Values` to true. If all goes well, you can test the notification by clicking on the eye icon under the Sprout Forms Notifications page in the Craft back-end.

-----

Brought to you by [Matthew Blode](https://matthewblode.com/)