Download the PHP package thtg88/laravel-contact-request without Composer
On this page you can find all versions of the php package thtg88/laravel-contact-request. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-contact-request
Laravel Contact Request
Send an email from your contact form.
Table of Contents
- Installation
- Usage
- Route
- Validation
- Captcha
- Mail
- Deliver Later
- Internal Recipient
- Additional Options
- License
- Security Vulnerabilities
Installation
You can publish the configuration file and views by running:
Usage
Laravel Contact Request exposes a route to send an email from given data.
Route
The route is available at POST /contact-requests
.
You can customise the route by adding a prefix to the default one. This can be achieved by adding a CONTACT_REQUEST_ROUTE_PREFIX
variable to your .env
file, for example:
Validation
The data is validated by the SubmitContactRequestRequest
class.
The validation rules are the following:
You can override those validation rules by publishing the Laravel Contact Request config file and applying yours:
Captcha
Laravel Contact Request supports Google ReCaptcha V2. This must be sent in a variable called g_recaptcha_response
or g-recaptcha-response
in the request payload.
You can enable ReCaptcha V2 support by adding the following to your .env
variable:
Laravel Contact Request will send an email confirmation of the contact request to the email provided in the request, and one to an internal recipient of your choice.
Laravel Contact Request relies on the default Laravel mailer. Make sure you configure your email provider in your .env
files. See the Laravel docs for guidance.
The validated data will be included in both emails.
Deliver Later
Laravel Contact Request supports placing email delivery on a queue for immediate delivery.
To configure it, in your .env
file, simply set:
This will leverage the queue
method of the Illuminate\Mail\Mailable
class, together with the default configured queue driver.
For more information see the Laravel official docs
Internal Recipient
You can customise the internal recipient by adding a variable to your .env
file:
Additional Options
You can also customise the following:
- Email subject for internal recipient:
CONTACT_REQUEST_MAIL_INTERNAL_SUBJECT="Contact Request Internal Subject"
- Email subject for confirmation email (to the recipient specified in the request):
CONTACT_REQUEST_MAIL_SUBJECT="Contact Request Receipt"
- Signature of the email confirmation:
CONTACT_REQUEST_MAIL_SIGNATURE_NAME="John Doe"
The mail views are a simple HTML, but you can customise those as well by specifying a view name that's available in your project, similarly to how you return views in controllers e.g. 'view.name'
.
- Main email HTML layout view name:
CONTACT_REQUEST_MAIL_VIEWS_LAYOUT=layouts.email
- Internal notification HTML view name:
CONTACT_REQUEST_MAIL_VIEWS_REQUESTED_INTERNAL=emails.contact.internal
- Internal notification plain view name:
CONTACT_REQUEST_MAIL_VIEWS_REQUESTED_INTERNAL_PLAIN=emails.contact.internal_plain
- Notification to recipient provided in request - HTML view name:
CONTACT_REQUEST_MAIL_VIEWS_REQUESTED=emails.contact.requested
- Notification to recipient provided in request - plain view name:
CONTACT_REQUEST_MAIL_VIEWS_REQUESTED=emails.contact.requested_plain
More customisation options coming soon!
License
Laravel Contact Request is open-sourced software licensed under the MIT license.
Security Vulnerabilities
If you discover a security vulnerability within Laravel Contact Request, please send an e-mail to Marco Marassi at [email protected]. All security vulnerabilities will be promptly addressed.