shazzoo / contact-form-plugin

v0.0.1 2026-09-03 12:20 UTC

Requires

• php: ^8.3
• shazzoo/content-studio-core: ^1.0

MIT

Published on Packagist.org on 2026-09-03 13:13 UTC

README

A Content Studio plugin that adds a Contact form block. The form itself is configured in the admin under Contact Plugin → Formulier: the fields, the recipient, the button label and the confirmation message. The block only carries the surrounding copy, so every placement stays in step.

Submissions are stored in contact_submissions and listed under Contact Plugin → Inzendingen.

Install

1. Activate "Contact Plugin" under Plugins in the admin.
2. Run php artisan migrate (the plugin ships its own migrations).
3. Open Contact Plugin → Formulier and set the recipient. Without one, the CONTACT_FORM_RECIPIENT from .env is used; without either, submissions are stored but nothing is mailed.

Fields

Each field has a label, a key, a type (text, e-mail, phone, URL, number, date, textarea, select, checkbox), a width and an optional role. Roles tell the plugin which answer is the sender's name, e-mail (used as the mail's reply-to) and subject — those get their own columns in the submissions list. Everything else is stored in the data payload.

The key is what a submission is stored under; renaming it leaves older submissions showing the old key.

Options

config/contact-form.php (publish with --tag=contact-form-config):

• recipient — fallback address when the admin sets none.
• max_attempts / decay_minutes — per-IP rate limit on submissions.

Restyling

Publish the views and edit them in resources/views/vendor/contact-form:

php artisan vendor:publish --tag=contact-form-views

Every input renders through contact-form::fields.<type> and all CSS lives in partials/styles.blade.php, so a single field type or the whole look can be replaced without forking the plugin.