This plugin allows you to save guest entries from the front-end of your website.
This plugin requires Craft CMS 3.4.0 or later.
You can install this plugin from the Plugin Store or with Composer.
Go to the Plugin Store in your project’s Control Panel and search for “Guest Entries”. Then click on the “Install” button in its modal window.
Open your terminal and run the following commands:
# go to the project directory
cd /path/to/my-project.test
# tell Composer to load the plugin
composer require craftcms/guest-entries
# tell Craft to install the plugin
./craft install/plugin guest-entries
From the plugin settings page, you can configure which sections you want to allow guest entry submissions for, as well as the default entry authors and statuses, and whether submissions should be validated before being accepted.
Your guest entry template can look something like this:
{% macro errorList(errors) %}
{% if errors %}
<ul class="errors">
{% for error in errors %}
<li>{{ error }}</li>
{% endfor %}
</ul>
{% endif %}
{% endmacro %}
{% from _self import errorList %}
<form method="post" action="" accept-charset="UTF-8">
{{ csrfInput() }}
<input type="hidden" name="action" value="guest-entries/save">
<input type="hidden" name="sectionUid" value="3b78a784-8b78-4442-8774-0b33bcb11733">
{{ redirectInput('success') }}
<label for="title">Title</label>
<input id="title" type="text" name="title"
{%- if entry is defined %} value="{{ entry.title }}"{% endif %}>
{% if entry is defined %}
{{ errorList(entry.getErrors('title')) }}
{% endif %}
<label for="body">Body</label>
<textarea id="body" name="fields[body]">
{%- if entry is defined %}{{ entry.body }}{% endif -%}
</textarea>
{% if entry is defined %}
{{ errorList(entry.getErrors('body')) }}
{% endif %}
<input type="submit" value="Publish">
</form>
You will need to adjust the hidden sectionUid
input to point to the section you would like to post guest entries to.
If you have a redirect
hidden input, the user will get redirected to it upon successfully saving the entry.
If there is a validation error on the entry, then the page will be reloaded with an entry
variable available to it, set to a craft\elements\Entry
model representing the submitted entry. You can fetch the posted values from that variable, as well as any validation errors via getErrors()
, getFirstError()
, or getFirstErrors()
. (The name of this variable is configurable via the “Entry Variable Name” setting.)
If you submit your form via Ajax with an Accept: application/json
header, a JSON response will be returned with the following keys:
success
(boolean) – Whether the entry was saved successfullyerrors
(object) – All of the validation errors indexed by field name (if not saved)id
(string) – the entry’s ID (if saved)title
(string) – the entry’s title (if saved)authorUsername
(string) – the entry’s author’s username (if saved)dateCreated
(string) – the entry’s creation date in ISO 8601 format (if saved)dateUpdated
(string) – the entry’s update date in ISO 8601 format (if saved)postDate
(string, null) – the entry’s post date in ISO 8601 format (if saved and enabled)url
(string, null) – the entry’s public URL (if saved, enabled, and in a section where entries have URLs)
Plugins can be notified right before a guest entry is saved using the beforeSaveEntry
event. This is also an opportunity to flag the submission as spam, preventing it from getting saved:
use craft\guestentries\controllers\SaveController;
use craft\guestentries\events\SaveEvent;
use yii\base\Event;
// ...
Event::on(SaveController::class, SaveController::EVENT_BEFORE_SAVE_ENTRY, function(SaveEvent $e) {
// Grab the entry
$entry = $e->entry;
$isSpam = // custom spam detection logic...
if (!$isSpam) {
$e->isSpam = true;
}
});
Plugins can be notified right after a guest entry is saved using the afterSaveEntry
event:
use craft\guestentries\controllers\SaveController;
use craft\guestentries\events\SaveEvent;
use yii\base\Event;
// ...
Event::on(SaveController::class, SaveController::EVENT_AFTER_SAVE_ENTRY, function(SaveEvent $e) {
// Grab the entry
$entry = $e->entry;
// Was it flagged as spam?
$isSpam = $e->isSpam;
});
Plugins can be notified right after a submission is determined to be invalid using the afterError
event:
use craft\guestentries\controllers\SaveController;
use craft\guestentries\events\SaveEvent;
use yii\base\Event;
// ...
Event::on(SaveController::class, SaveController::EVENT_AFTER_ERROR, function(SaveEvent $e) {
// Grab the entry
$entry = $e->entry;
// Get any validation errors
$errors = $entry->getErrors();
});