1140 lines
36 KiB
PHP
1140 lines
36 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
namespace Grav\Plugin;
|
||
|
|
|
||
|
|
use Composer\Autoload\ClassLoader;
|
||
|
|
use DateTime;
|
||
|
|
use Exception;
|
||
|
|
use Grav\Common\Data\ValidationException;
|
||
|
|
use Grav\Common\Debugger;
|
||
|
|
use Grav\Common\Filesystem\Folder;
|
||
|
|
use Grav\Common\Grav;
|
||
|
|
use Grav\Common\Page\Interfaces\PageInterface;
|
||
|
|
use Grav\Common\Page\Pages;
|
||
|
|
use Grav\Common\Page\Types;
|
||
|
|
use Grav\Common\Plugin;
|
||
|
|
use Grav\Common\Twig\Twig;
|
||
|
|
use Grav\Common\Utils;
|
||
|
|
use Grav\Common\Uri;
|
||
|
|
use Grav\Common\Yaml;
|
||
|
|
use Grav\Framework\Form\Interfaces\FormInterface;
|
||
|
|
use Grav\Framework\Route\Route;
|
||
|
|
use Grav\Plugin\Form\Form;
|
||
|
|
use Grav\Plugin\Form\Forms;
|
||
|
|
use ReCaptcha\ReCaptcha;
|
||
|
|
use ReCaptcha\RequestMethod\CurlPost;
|
||
|
|
use RecursiveArrayIterator;
|
||
|
|
use RecursiveIteratorIterator;
|
||
|
|
use RocketTheme\Toolbox\File\JsonFile;
|
||
|
|
use RocketTheme\Toolbox\File\YamlFile;
|
||
|
|
use RocketTheme\Toolbox\File\File;
|
||
|
|
use RocketTheme\Toolbox\Event\Event;
|
||
|
|
use RuntimeException;
|
||
|
|
use Twig\Extension\CoreExtension;
|
||
|
|
use Twig\TwigFunction;
|
||
|
|
use function count;
|
||
|
|
use function function_exists;
|
||
|
|
use function is_array;
|
||
|
|
use function is_string;
|
||
|
|
use function sprintf;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Class FormPlugin
|
||
|
|
* @package Grav\Plugin
|
||
|
|
*/
|
||
|
|
class FormPlugin extends Plugin
|
||
|
|
{
|
||
|
|
/** @var array */
|
||
|
|
public $features = [
|
||
|
|
'blueprints' => 1000
|
||
|
|
];
|
||
|
|
|
||
|
|
/** @var Form */
|
||
|
|
protected $form;
|
||
|
|
/** @var array */
|
||
|
|
protected $forms = [];
|
||
|
|
/** @var array */
|
||
|
|
protected $flat_forms = [];
|
||
|
|
/** @var array */
|
||
|
|
protected $active_forms = [];
|
||
|
|
/** @var array */
|
||
|
|
protected $json_response = [];
|
||
|
|
/** @var bool */
|
||
|
|
protected $recache_forms = false;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @return bool
|
||
|
|
*/
|
||
|
|
public static function checkRequirements(): bool
|
||
|
|
{
|
||
|
|
return version_compare(GRAV_VERSION, '1.6', '>');
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @return array
|
||
|
|
*/
|
||
|
|
public static function getSubscribedEvents()
|
||
|
|
{
|
||
|
|
if (!static::checkRequirements()) {
|
||
|
|
return [];
|
||
|
|
}
|
||
|
|
|
||
|
|
return [
|
||
|
|
'onPluginsInitialized' => [
|
||
|
|
['autoload', 100000],
|
||
|
|
['onPluginsInitialized', 0]
|
||
|
|
],
|
||
|
|
'onTwigTemplatePaths' => ['onTwigTemplatePaths', 0]
|
||
|
|
];
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* [onPluginsInitialized:100000] Composer autoload.
|
||
|
|
*
|
||
|
|
* @return ClassLoader
|
||
|
|
*/
|
||
|
|
public function autoload()
|
||
|
|
{
|
||
|
|
return require __DIR__ . '/vendor/autoload.php';
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Initialize forms from cache if possible
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onPluginsInitialized(): void
|
||
|
|
{
|
||
|
|
// Backwards compatibility for plugins that use forms.
|
||
|
|
class_alias(Form::class, 'Grav\Plugin\Form');
|
||
|
|
|
||
|
|
$this->grav['forms'] = function () {
|
||
|
|
$forms = new Forms();
|
||
|
|
|
||
|
|
$grav = Grav::instance();
|
||
|
|
$event = new Event(['forms' => $forms]);
|
||
|
|
$grav->fireEvent('onFormRegisterTypes', $event);
|
||
|
|
|
||
|
|
return $forms;
|
||
|
|
};
|
||
|
|
|
||
|
|
if ($this->isAdmin()) {
|
||
|
|
$this->enable([
|
||
|
|
'onPageInitialized' => ['onPageInitialized', 0],
|
||
|
|
'onGetPageTemplates' => ['onGetPageTemplates', 0],
|
||
|
|
]);
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Mini Keep-Alive Logic
|
||
|
|
$task = $this->grav['uri']->param('task');
|
||
|
|
if ($task && $task === 'keep-alive') {
|
||
|
|
exit;
|
||
|
|
}
|
||
|
|
|
||
|
|
$this->enable([
|
||
|
|
'onPageProcessed' => ['onPageProcessed', 0],
|
||
|
|
'onPagesInitialized' => ['onPagesInitialized', 0],
|
||
|
|
'onPageInitialized' => ['onPageInitialized', 0],
|
||
|
|
'onTwigInitialized' => ['onTwigInitialized', 0],
|
||
|
|
'onTwigPageVariables' => ['onTwigVariables', 0],
|
||
|
|
'onTwigSiteVariables' => ['onTwigVariables', 0],
|
||
|
|
'onFormValidationProcessed' => ['onFormValidationProcessed', 0],
|
||
|
|
]);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param Event $event
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onGetPageTemplates(Event $event): void
|
||
|
|
{
|
||
|
|
/** @var Types $types */
|
||
|
|
$types = $event->types;
|
||
|
|
$types->register('form');
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Process forms after page header processing, but before caching
|
||
|
|
*
|
||
|
|
* @param Event $e
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onPageProcessed(Event $e): void
|
||
|
|
{
|
||
|
|
/** @var PageInterface $page */
|
||
|
|
$page = $e['page'];
|
||
|
|
|
||
|
|
$pageForms = $page->forms();
|
||
|
|
if (!$pageForms) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Force never_cache_twig if modular form (recursively up)
|
||
|
|
$current = $page;
|
||
|
|
while ($current && $current->modularTwig()) {
|
||
|
|
$header = $current->header();
|
||
|
|
$header->never_cache_twig = true;
|
||
|
|
|
||
|
|
$current = $current->parent();
|
||
|
|
}
|
||
|
|
$parent = $current && $current !== $page ? $current : null;
|
||
|
|
|
||
|
|
$page_route = $page->home() ? '/' : $page->route();
|
||
|
|
|
||
|
|
// If the form was in the modular page, we need to add the form into the parent page as well.
|
||
|
|
if ($parent) {
|
||
|
|
$parent->addForms($pageForms);
|
||
|
|
$parent_route = $parent->home() ? '/' : $parent->route();
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @var Forms $forms */
|
||
|
|
$forms = $this->grav['forms'];
|
||
|
|
|
||
|
|
// Store the page forms in the forms instance
|
||
|
|
foreach ($pageForms as $name => $form) {
|
||
|
|
if (isset($parent, $parent_route)) {
|
||
|
|
$this->addForm($parent_route, $forms->createPageForm($parent, $name, $form));
|
||
|
|
}
|
||
|
|
$this->addForm($page_route, $forms->createPageForm($page, $name, $form));
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Initialize all the forms
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onPagesInitialized(): void
|
||
|
|
{
|
||
|
|
$this->loadCachedForms();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Catches form processing if user posts the form.
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onPageInitialized(): void
|
||
|
|
{
|
||
|
|
$submitted = false;
|
||
|
|
$this->json_response = [];
|
||
|
|
|
||
|
|
// Save cached forms.
|
||
|
|
if ($this->recache_forms) {
|
||
|
|
$this->saveCachedForms();
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @var PageInterface $page */
|
||
|
|
$page = $this->grav['page'];
|
||
|
|
|
||
|
|
// Force rebuild form when form has not been built and form cache expired.
|
||
|
|
// This happens when form cache expires before the page cache
|
||
|
|
// and then does not trigger 'onPageProcessed' event.
|
||
|
|
if (!$this->forms) {
|
||
|
|
$this->onPageProcessed(new Event(['page' => $page]));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Enable form events if there's a POST
|
||
|
|
if ($this->shouldProcessForm()) {
|
||
|
|
$this->enable([
|
||
|
|
'onFormProcessed' => ['onFormProcessed', 0],
|
||
|
|
'onFormValidationError' => ['onFormValidationError', 0],
|
||
|
|
'onFormFieldTypes' => ['onFormFieldTypes', 0],
|
||
|
|
]);
|
||
|
|
|
||
|
|
/** @var Uri $uri */
|
||
|
|
$uri = $this->grav['uri'];
|
||
|
|
|
||
|
|
/** @var Forms $forms */
|
||
|
|
$forms = $this->grav['forms'];
|
||
|
|
|
||
|
|
$form = $forms->getActiveForm();
|
||
|
|
if ($form instanceof Form) {
|
||
|
|
// Post the form
|
||
|
|
$isJson = $uri->extension() === 'json';
|
||
|
|
$task = $uri->post('task') ?? $uri->param('task');
|
||
|
|
|
||
|
|
if ($isJson) {
|
||
|
|
if ($task === 'store-state') {
|
||
|
|
$this->json_response = $form->storeState();
|
||
|
|
} elseif ($task === 'clear-state') {
|
||
|
|
$this->json_response = $form->clearState();
|
||
|
|
} elseif ($task === 'file-remove' || $uri->post('__form-file-remover__')) {
|
||
|
|
$this->json_response = $form->filesSessionRemove();
|
||
|
|
} elseif ($task === 'file-upload' || $uri->post('__form-file-uploader__')) {
|
||
|
|
$this->json_response = $form->uploadFiles();
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
if (empty($this->json_response)) {
|
||
|
|
if ($task === 'clear-state') {
|
||
|
|
$form->getFlash()->delete();
|
||
|
|
$redirect = $form->getBlueprint()->get('form/clear_redirect_url') ?? $page->route();
|
||
|
|
$this->grav->redirect($redirect, 303);
|
||
|
|
} else {
|
||
|
|
$form->post();
|
||
|
|
$submitted = true;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Return JSON if we're not in form template.
|
||
|
|
if ($this->json_response && $page->template() !== 'form') {
|
||
|
|
$status = $this->json_response['status'] ?? null;
|
||
|
|
|
||
|
|
header('Content-Type: application/json');
|
||
|
|
http_response_code($status === 'error' ? 400 : 200);
|
||
|
|
echo json_encode($this->json_response);
|
||
|
|
exit;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Clear flash objects for previously uploaded files
|
||
|
|
// whenever the user switches page / reloads
|
||
|
|
// ignoring any JSON / extension call
|
||
|
|
if (!$submitted && null === $uri->extension()) {
|
||
|
|
// Discard any previously uploaded files session.
|
||
|
|
// and if there were any uploaded file, remove them from the filesystem
|
||
|
|
if ($flash = $this->grav['session']->getFlashObject('files-upload')) {
|
||
|
|
$flash = new RecursiveIteratorIterator(new RecursiveArrayIterator($flash));
|
||
|
|
foreach ($flash as $key => $value) {
|
||
|
|
if ($key !== 'tmp_name') {
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
@unlink($value);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
} else {
|
||
|
|
// There is no active form to be posted.
|
||
|
|
// Check all the forms for the current page; we are looking for forms with remember state turned on with random unique id.
|
||
|
|
|
||
|
|
/** @var Route $route */
|
||
|
|
$route = $this->grav['route'];
|
||
|
|
$pageForms = $this->forms[$route->getRoute()] ?? [];
|
||
|
|
|
||
|
|
foreach ($pageForms as $formName => $form) {
|
||
|
|
if ($form->get('remember_redirect')) {
|
||
|
|
// Found one; we need to check if unique id is set.
|
||
|
|
$formParam = $form->get('uniqueid_param', 'fid');
|
||
|
|
$uniqueId = $route->getGravParam($formParam);
|
||
|
|
|
||
|
|
if ($uniqueId && preg_match('/[a-z\d]+/', $uniqueId)) {
|
||
|
|
// URL contains unique id, initialize the current form.
|
||
|
|
$form->setUniqueId($uniqueId);
|
||
|
|
$form->initialize();
|
||
|
|
|
||
|
|
/** @var Forms $forms */
|
||
|
|
$forms = $this->grav['forms'];
|
||
|
|
$forms->setActiveForm($form);
|
||
|
|
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Append unique id to the URL and redirect.
|
||
|
|
$route = $route->withGravParam($formParam, $form->getUniqueId());
|
||
|
|
$page->redirect((string)$route->toString());
|
||
|
|
|
||
|
|
// TODO: Do we want to add support for multiple forms with remembered state?
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add simple `forms()` Twig function
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onTwigInitialized(): void
|
||
|
|
{
|
||
|
|
$this->grav['twig']->twig()->addFunction(
|
||
|
|
new TwigFunction('forms', [$this, 'getForm'])
|
||
|
|
);
|
||
|
|
|
||
|
|
$this->grav['twig']->twig()->getExtension(CoreExtension::class)->setEscaper('yaml', function ($twig, $string, $charset) {
|
||
|
|
return Yaml::dump($string);
|
||
|
|
}
|
||
|
|
);
|
||
|
|
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add current directory to twig lookup paths.
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onTwigTemplatePaths(): void
|
||
|
|
{
|
||
|
|
$this->grav['twig']->twig_paths[] = __DIR__ . '/templates';
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Make form accessible from twig.
|
||
|
|
*
|
||
|
|
* @param Event $event
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onTwigVariables(Event $event = null): void
|
||
|
|
{
|
||
|
|
if ($event && isset($event['page'])) {
|
||
|
|
$page = $event['page'];
|
||
|
|
} else {
|
||
|
|
$page = $this->grav['page'];
|
||
|
|
}
|
||
|
|
|
||
|
|
$twig = $this->grav['twig'];
|
||
|
|
|
||
|
|
if (!isset($twig->twig_vars['form'])) {
|
||
|
|
$twig->twig_vars['form'] = $this->form($page);
|
||
|
|
}
|
||
|
|
|
||
|
|
if ($this->config->get('plugins.form.built_in_css')) {
|
||
|
|
$this->grav['assets']->addCss('plugin://form/assets/form-styles.css');
|
||
|
|
}
|
||
|
|
$twig->twig_vars['form_max_filesize'] = Form::getMaxFilesize();
|
||
|
|
$twig->twig_vars['form_json_response'] = $this->json_response;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Handle form processing instructions.
|
||
|
|
*
|
||
|
|
* @param Event $event
|
||
|
|
* @return void
|
||
|
|
* @throws Exception
|
||
|
|
*/
|
||
|
|
public function onFormProcessed(Event $event): void
|
||
|
|
{
|
||
|
|
/** @var Form $form */
|
||
|
|
$form = $event['form'];
|
||
|
|
$action = $event['action'];
|
||
|
|
$params = $event['params'];
|
||
|
|
|
||
|
|
$this->process($form);
|
||
|
|
|
||
|
|
switch ($action) {
|
||
|
|
case 'captcha':
|
||
|
|
|
||
|
|
$captcha_config = $this->config->get('plugins.form.recaptcha');
|
||
|
|
|
||
|
|
$secret = $params['recaptcha_secret'] ?? $params['recatpcha_secret'] ?? $captcha_config['secret_key'];
|
||
|
|
|
||
|
|
/** @var Uri $uri */
|
||
|
|
$uri = $this->grav['uri'];
|
||
|
|
$action = $form->value('action');
|
||
|
|
$hostname = $uri->host();
|
||
|
|
$ip = Uri::ip();
|
||
|
|
|
||
|
|
$recaptcha = new ReCaptcha($secret);
|
||
|
|
if (extension_loaded('curl')) {
|
||
|
|
$recaptcha = new ReCaptcha($secret, new CurlPost());
|
||
|
|
}
|
||
|
|
|
||
|
|
// get captcha version
|
||
|
|
$captcha_version = $captcha_config['version'] ?? 2;
|
||
|
|
|
||
|
|
// Add version 3 specific options
|
||
|
|
if ($captcha_version == 3) {
|
||
|
|
$token = $form->value('token');
|
||
|
|
$resp = $recaptcha
|
||
|
|
->setExpectedHostname($hostname)
|
||
|
|
->setExpectedAction($action)
|
||
|
|
->setScoreThreshold(0.5)
|
||
|
|
->verify($token, $ip);
|
||
|
|
} else {
|
||
|
|
$token = $form->value('g-recaptcha-response', true);
|
||
|
|
$resp = $recaptcha
|
||
|
|
->setExpectedHostname($hostname)
|
||
|
|
->verify($token, $ip);
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!$resp->isSuccess()) {
|
||
|
|
$errors = $resp->getErrorCodes();
|
||
|
|
$message = $this->grav['language']->translate('PLUGIN_FORM.ERROR_VALIDATING_CAPTCHA');
|
||
|
|
|
||
|
|
$fields = $form->value()->blueprints()->get('form/fields');
|
||
|
|
foreach ($fields as $field) {
|
||
|
|
$type = $field['type'] ?? 'text';
|
||
|
|
$field_message = $field['recaptcha_not_validated'] ?? null;
|
||
|
|
if ($type === 'captcha' && $field_message) {
|
||
|
|
$message = $field_message;
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
$this->grav->fireEvent('onFormValidationError', new Event([
|
||
|
|
'form' => $form,
|
||
|
|
'message' => $message
|
||
|
|
]));
|
||
|
|
|
||
|
|
$this->grav['log']->addWarning('Form reCAPTCHA Errors: [' . $uri->route() . '] ' . json_encode($errors));
|
||
|
|
|
||
|
|
$event->stopPropagation();
|
||
|
|
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
break;
|
||
|
|
case 'timestamp':
|
||
|
|
$label = $params['label'] ?? 'Timestamp';
|
||
|
|
$format = $params['format'] ?? 'Y-m-d H:i:s';
|
||
|
|
$blueprint = $form->value()->blueprints();
|
||
|
|
$blueprint->set('form/fields/timestamp', ['name' => 'timestamp', 'label' => $label, 'type' => 'hidden']);
|
||
|
|
$now = new DateTime('now');
|
||
|
|
$date_string = $now->format($format);
|
||
|
|
$form->setFields($blueprint->fields());
|
||
|
|
$form->setData('timestamp', $date_string);
|
||
|
|
break;
|
||
|
|
case 'ip':
|
||
|
|
$label = $params['label'] ?? 'User IP';
|
||
|
|
$blueprint = $form->value()->blueprints();
|
||
|
|
$blueprint->set('form/fields/ip', ['name' => 'ip', 'label' => $label, 'type' => 'hidden']);
|
||
|
|
$form->setFields($blueprint->fields());
|
||
|
|
$form->setData('ip', Uri::ip());
|
||
|
|
break;
|
||
|
|
case 'message':
|
||
|
|
$translated_string = $this->grav['language']->translate($params);
|
||
|
|
$vars = array(
|
||
|
|
'form' => $form
|
||
|
|
);
|
||
|
|
|
||
|
|
/** @var Twig $twig */
|
||
|
|
$twig = $this->grav['twig'];
|
||
|
|
$processed_string = $twig->processString($translated_string, $vars);
|
||
|
|
|
||
|
|
$form->message = $processed_string;
|
||
|
|
break;
|
||
|
|
case 'redirect':
|
||
|
|
$this->grav['session']->setFlashObject('form', $form);
|
||
|
|
$url = ((string)$params);
|
||
|
|
$vars = array(
|
||
|
|
'form' => $form
|
||
|
|
);
|
||
|
|
/** @var Twig $twig */
|
||
|
|
$twig = $this->grav['twig'];
|
||
|
|
$url = $twig->processString($url, $vars);
|
||
|
|
|
||
|
|
$message = $form->message;
|
||
|
|
if ($message) {
|
||
|
|
$this->grav['messages']->add($form->message, 'success');
|
||
|
|
}
|
||
|
|
|
||
|
|
$event['redirect'] = $url;
|
||
|
|
$event->stopPropagation();
|
||
|
|
break;
|
||
|
|
case 'reset':
|
||
|
|
if (Utils::isPositive($params)) {
|
||
|
|
$message = $form->message;
|
||
|
|
$form->reset();
|
||
|
|
$form->message = $message;
|
||
|
|
}
|
||
|
|
break;
|
||
|
|
case 'display':
|
||
|
|
$route = (string)$params;
|
||
|
|
if (!$route || $route[0] !== '/') {
|
||
|
|
/** @var Uri $uri */
|
||
|
|
$uri = $this->grav['uri'];
|
||
|
|
$route = rtrim($uri->route(), '/') . '/' . ($route ?: '');
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @var Twig $twig */
|
||
|
|
$twig = $this->grav['twig'];
|
||
|
|
$twig->twig_vars['form'] = $form;
|
||
|
|
|
||
|
|
/** @var Pages $pages */
|
||
|
|
$pages = $this->grav['pages'];
|
||
|
|
$page = $pages->dispatch($route, true);
|
||
|
|
|
||
|
|
if (!$page) {
|
||
|
|
throw new RuntimeException('Display page not found. Please check the page exists.', 400);
|
||
|
|
}
|
||
|
|
|
||
|
|
unset($this->grav['page']);
|
||
|
|
$this->grav['page'] = $page;
|
||
|
|
break;
|
||
|
|
case 'remember':
|
||
|
|
foreach ($params as $remember_field) {
|
||
|
|
$field_cookie = 'forms-' . $form['name'] . '-' . $remember_field;
|
||
|
|
setcookie($field_cookie, $form->value($remember_field), time() + 60 * 60 * 24 * 60);
|
||
|
|
}
|
||
|
|
break;
|
||
|
|
case 'upload':
|
||
|
|
if ($params !== false) {
|
||
|
|
$form->copyFiles();
|
||
|
|
}
|
||
|
|
break;
|
||
|
|
case 'save':
|
||
|
|
$prefix = $params['fileprefix'] ?? '';
|
||
|
|
$format = $params['dateformat'] ?? 'Ymd-His-u';
|
||
|
|
$raw_format = (bool)($params['dateraw'] ?? false);
|
||
|
|
$postfix = $params['filepostfix'] ?? '';
|
||
|
|
$ext = !empty($params['extension']) ? '.' . trim($params['extension'], '.') : '.txt';
|
||
|
|
$filename = $params['filename'] ?? '';
|
||
|
|
$folder = !empty($params['folder']) ? $params['folder'] : $form->getName();
|
||
|
|
$operation = $params['operation'] ?? 'create';
|
||
|
|
|
||
|
|
if (!$filename) {
|
||
|
|
if ($operation === 'add') {
|
||
|
|
throw new RuntimeException('Form save: \'operation: add\' is only supported with a static filename');
|
||
|
|
}
|
||
|
|
|
||
|
|
$filename = $prefix . $this->udate($format, $raw_format) . $postfix . $ext;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @var Twig $twig */
|
||
|
|
$twig = $this->grav['twig'];
|
||
|
|
$vars = [
|
||
|
|
'form' => $form
|
||
|
|
];
|
||
|
|
|
||
|
|
// Process with Twig
|
||
|
|
$filename = $twig->processString($filename, $vars);
|
||
|
|
|
||
|
|
$locator = $this->grav['locator'];
|
||
|
|
$path = $locator->findResource('user-data://', true);
|
||
|
|
$dir = $path . DS . $folder;
|
||
|
|
$fullFileName = $dir . DS . $filename;
|
||
|
|
|
||
|
|
if (!empty($params['raw']) || !empty($params['template'])) {
|
||
|
|
// Save data as it comes from the form.
|
||
|
|
if ($operation === 'add') {
|
||
|
|
throw new RuntimeException('Form save: \'operation: add\' is not supported for raw files');
|
||
|
|
}
|
||
|
|
switch ($ext) {
|
||
|
|
case '.yaml':
|
||
|
|
$file = YamlFile::instance($fullFileName);
|
||
|
|
break;
|
||
|
|
case '.json':
|
||
|
|
$file = JsonFile::instance($fullFileName);
|
||
|
|
break;
|
||
|
|
default:
|
||
|
|
throw new RuntimeException('Form save: Unsupported RAW file format, please use either yaml or json');
|
||
|
|
}
|
||
|
|
|
||
|
|
$content = $form->getData();
|
||
|
|
$data = [
|
||
|
|
'_data_type' => 'form',
|
||
|
|
'template' => !empty($params['template']) ? $params['template'] : null,
|
||
|
|
'name' => $form->getName(),
|
||
|
|
'timestamp' => date('Y-m-d H:i:s'),
|
||
|
|
'content' => $content ? $content->toArray() : []
|
||
|
|
];
|
||
|
|
|
||
|
|
$file->lock();
|
||
|
|
$form->copyFiles();
|
||
|
|
$file->save(array_filter($data));
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
|
||
|
|
$file = File::instance($fullFileName);
|
||
|
|
$file->lock();
|
||
|
|
$form->copyFiles();
|
||
|
|
|
||
|
|
if ($operation === 'create') {
|
||
|
|
$body = $twig->processString($params['body'] ?? '{% include "forms/data.txt.twig" %}', $vars);
|
||
|
|
$file->save($body);
|
||
|
|
} elseif ($operation === 'add') {
|
||
|
|
if (!empty($params['body'])) {
|
||
|
|
// use body similar to 'create' action and append to file as a log
|
||
|
|
$body = $twig->processString($params['body'], $vars);
|
||
|
|
|
||
|
|
// create folder if it doesn't exist
|
||
|
|
if (!file_exists($dir)) {
|
||
|
|
Folder::create($dir);
|
||
|
|
}
|
||
|
|
|
||
|
|
// append data to existing file
|
||
|
|
$file->unlock();
|
||
|
|
file_put_contents($fullFileName, $body, FILE_APPEND | LOCK_EX);
|
||
|
|
} else {
|
||
|
|
// serialize YAML out to file for easier parsing as data sets
|
||
|
|
$vars = $vars['form']->value()->toArray();
|
||
|
|
|
||
|
|
foreach ($form->fields as $field) {
|
||
|
|
if (!empty($field['process']['ignore'])) {
|
||
|
|
unset($vars[$field['name']]);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
if (file_exists($fullFileName)) {
|
||
|
|
$data = Yaml::parse($file->content());
|
||
|
|
if (count($data) > 0) {
|
||
|
|
array_unshift($data, $vars);
|
||
|
|
} else {
|
||
|
|
$data[] = $vars;
|
||
|
|
}
|
||
|
|
} else {
|
||
|
|
$data[] = $vars;
|
||
|
|
}
|
||
|
|
|
||
|
|
$file->save(Yaml::dump($data));
|
||
|
|
}
|
||
|
|
}
|
||
|
|
break;
|
||
|
|
case 'call':
|
||
|
|
$callable = $params;
|
||
|
|
|
||
|
|
if (is_array($callable) && !method_exists($callable[0], $callable[1])) {
|
||
|
|
throw new RuntimeException('Form cannot be processed (method does not exist)');
|
||
|
|
}
|
||
|
|
if (is_string($callable) && !function_exists($callable)) {
|
||
|
|
throw new RuntimeException('Form cannot be processed (function does not exist)');
|
||
|
|
}
|
||
|
|
|
||
|
|
$callable($form);
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Custom field logic can go in here
|
||
|
|
*
|
||
|
|
* @param Event $event
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function onFormValidationProcessed(Event $event): void
|
||
|
|
{
|
||
|
|
// special check for honeypot field
|
||
|
|
foreach ($event['form']->fields() as $field) {
|
||
|
|
if ($field['type'] === 'honeypot' && !empty($event['form']->value($field['name']))) {
|
||
|
|
throw new ValidationException('Are you a bot?');
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Handle form validation error
|
||
|
|
*
|
||
|
|
* @param Event $event An event object
|
||
|
|
* @return void
|
||
|
|
* @throws Exception
|
||
|
|
*/
|
||
|
|
public function onFormValidationError(Event $event): void
|
||
|
|
{
|
||
|
|
$form = $event['form'];
|
||
|
|
if (isset($event['message'])) {
|
||
|
|
$form->status = 'error';
|
||
|
|
$form->message = $event['message'];
|
||
|
|
$form->messages = $event['messages'];
|
||
|
|
}
|
||
|
|
|
||
|
|
$uri = $this->grav['uri'];
|
||
|
|
$route = $uri->route();
|
||
|
|
|
||
|
|
/** @var Twig $twig */
|
||
|
|
$twig = $this->grav['twig'];
|
||
|
|
$twig->twig_vars['form'] = $form;
|
||
|
|
|
||
|
|
/** @var Pages $pages */
|
||
|
|
$pages = $this->grav['pages'];
|
||
|
|
$page = $pages->dispatch($route, true);
|
||
|
|
|
||
|
|
if ($page) {
|
||
|
|
unset($this->grav['page']);
|
||
|
|
$this->grav['page'] = $page;
|
||
|
|
}
|
||
|
|
|
||
|
|
$event->stopPropagation();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add a form to the forms plugin
|
||
|
|
*
|
||
|
|
* @param string|null $page_route
|
||
|
|
* @param FormInterface|null $form
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public function addForm(?string $page_route, ?FormInterface $form)
|
||
|
|
{
|
||
|
|
if (null === $form) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
$name = $form->getName();
|
||
|
|
|
||
|
|
if (!isset($this->forms[$page_route][$name])) {
|
||
|
|
$this->forms[$page_route][$name] = $form;
|
||
|
|
|
||
|
|
$this->flattenForms();
|
||
|
|
$this->recache_forms = true;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* function to get a specific form
|
||
|
|
*
|
||
|
|
* @param null|array|string $data optional form `name`
|
||
|
|
* @return FormInterface|null
|
||
|
|
*/
|
||
|
|
public function getForm($data = null)
|
||
|
|
{
|
||
|
|
if (is_array($data)) {
|
||
|
|
$form_name = $data['name'] ?? null;
|
||
|
|
$page_route = $data['route'] ?? null;
|
||
|
|
} elseif (is_string($data)) {
|
||
|
|
$form_name = $data;
|
||
|
|
$page_route = null;
|
||
|
|
} else {
|
||
|
|
$form_name = null;
|
||
|
|
$page_route = null;
|
||
|
|
}
|
||
|
|
|
||
|
|
// if no form name, use the first form found in the page
|
||
|
|
if (!$form_name) {
|
||
|
|
// If page route not provided, use the current page
|
||
|
|
if (!$page_route) {
|
||
|
|
// Get page route with a fallback using current URI if page not initialized yet
|
||
|
|
$page_route = $this->grav['page']->route() ?: $this->getCurrentPageRoute();
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!empty($this->forms[$page_route])) {
|
||
|
|
$forms = $this->forms[$page_route];
|
||
|
|
$first_form = reset($forms) ?: null;
|
||
|
|
return $first_form;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Try to get page by defined route first or get current if not found
|
||
|
|
$page = $this->grav['pages']->find($page_route) ?: $this->grav['page'];
|
||
|
|
|
||
|
|
// Try looking up in the defined page
|
||
|
|
return $this->grav['forms']->createPageForm($page);
|
||
|
|
}
|
||
|
|
|
||
|
|
// return the form you are looking for if available
|
||
|
|
return $this->getFormByName($form_name);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get list of form field types specified in this plugin. Only special types needs to be listed.
|
||
|
|
*
|
||
|
|
* @return array
|
||
|
|
*/
|
||
|
|
public function getFormFieldTypes()
|
||
|
|
{
|
||
|
|
return [
|
||
|
|
'avatar' => [
|
||
|
|
'input@' => false,
|
||
|
|
'media_field' => true
|
||
|
|
],
|
||
|
|
'captcha' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'columns' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'column' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'conditional' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'display' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'fieldset' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'file' => [
|
||
|
|
'array' => true,
|
||
|
|
'media_field' => true,
|
||
|
|
'validate' => [
|
||
|
|
'type' => 'ignore'
|
||
|
|
]
|
||
|
|
],
|
||
|
|
'formname' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'honeypot' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'ignore' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'key' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'section' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'spacer' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'tabs' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'tab' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'uniqueid' => [
|
||
|
|
'input@' => false
|
||
|
|
],
|
||
|
|
'value' => [
|
||
|
|
'input@' => false
|
||
|
|
]
|
||
|
|
];
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Process a form
|
||
|
|
*
|
||
|
|
* Currently available processing tasks:
|
||
|
|
*
|
||
|
|
* - fillWithCurrentDateTime
|
||
|
|
*
|
||
|
|
* @param Form $form
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
protected function process($form)
|
||
|
|
{
|
||
|
|
foreach ($form->fields as $field) {
|
||
|
|
if (!empty($field['process']['fillWithCurrentDateTime'])) {
|
||
|
|
$form->setData($field['name'], gmdate('D, d M Y H:i:s', time()));
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get current page's route
|
||
|
|
*
|
||
|
|
* @return mixed
|
||
|
|
*/
|
||
|
|
protected function getCurrentPageRoute()
|
||
|
|
{
|
||
|
|
$path = $this->grav['uri']->route();
|
||
|
|
$path = $path ?: '/';
|
||
|
|
return $path;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Retrieve a form based on the form name
|
||
|
|
*
|
||
|
|
* @param string $form_name
|
||
|
|
* @return mixed
|
||
|
|
*/
|
||
|
|
protected function getFormByName($form_name)
|
||
|
|
{
|
||
|
|
$form = $this->active_forms[$form_name] ?? null;
|
||
|
|
if (!$form) {
|
||
|
|
$form = $this->flat_forms[$form_name] ?? null;
|
||
|
|
|
||
|
|
if (!$form) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Reset form to change the cached unique id and to fire onFormInitialized event.
|
||
|
|
$form->setUniqueId('');
|
||
|
|
$form->reset();
|
||
|
|
|
||
|
|
// Register form to the active forms to get the same instance back next time.
|
||
|
|
$this->active_forms[$form_name] = $form;
|
||
|
|
}
|
||
|
|
|
||
|
|
return $form;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Determine if the page has a form submission that should be processed
|
||
|
|
*
|
||
|
|
* @return bool
|
||
|
|
*/
|
||
|
|
protected function shouldProcessForm()
|
||
|
|
{
|
||
|
|
$uri = $this->grav['uri'];
|
||
|
|
$nonce = $uri->post('form-nonce');
|
||
|
|
$status = $nonce ? true : false; // php72 quirk?
|
||
|
|
$refresh_prevention = null;
|
||
|
|
|
||
|
|
if ($status && $form = $this->form()) {
|
||
|
|
// Make sure form is something we recognize.
|
||
|
|
if (!$form instanceof Form) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Set page template if passed by form
|
||
|
|
if (isset($form->template)) {
|
||
|
|
$this->grav['page']->template($form->template);
|
||
|
|
}
|
||
|
|
|
||
|
|
if (isset($form->refresh_prevention)) {
|
||
|
|
$refresh_prevention = (bool)$form->refresh_prevention;
|
||
|
|
} else {
|
||
|
|
$refresh_prevention = $this->config->get('plugins.form.refresh_prevention', false);
|
||
|
|
}
|
||
|
|
|
||
|
|
$unique_form_id = $form->getUniqueId();
|
||
|
|
|
||
|
|
if ($refresh_prevention && $unique_form_id) {
|
||
|
|
if ($this->grav['session']->unique_form_id !== $unique_form_id) {
|
||
|
|
$isJson = $uri->extension() === 'json';
|
||
|
|
// AJAX tasks aren't submitting
|
||
|
|
if (!$isJson || !($uri->post('__form-file-uploader__') || $uri->post('__form-file-remover__'))) {
|
||
|
|
$this->grav['session']->unique_form_id = $unique_form_id;
|
||
|
|
}
|
||
|
|
} else {
|
||
|
|
$status = false;
|
||
|
|
$form->message = $this->grav['language']->translate('PLUGIN_FORM.FORM_ALREADY_SUBMITTED');
|
||
|
|
$form->status = 'error';
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return $status;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Flatten the forms array into something that can be more easily searched
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
protected function flattenForms()
|
||
|
|
{
|
||
|
|
$this->flat_forms = Utils::arrayFlatten($this->forms);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the current form, should already be processed but can get it directly from the page if necessary
|
||
|
|
*
|
||
|
|
* @param PageInterface|null $page
|
||
|
|
* @return Form|null
|
||
|
|
*/
|
||
|
|
protected function form(PageInterface $page = null)
|
||
|
|
{
|
||
|
|
// Regenerate list of flat_forms if not already populated
|
||
|
|
if (empty($this->flat_forms)) {
|
||
|
|
$this->flattenForms();
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @var Forms $forms */
|
||
|
|
$forms = $this->grav['forms'];
|
||
|
|
|
||
|
|
$form = $forms->getActiveForm();
|
||
|
|
if (null === $form) {
|
||
|
|
// try to get the page if possible
|
||
|
|
if (null === $page) {
|
||
|
|
$page = $this->grav['page'];
|
||
|
|
}
|
||
|
|
|
||
|
|
// Try to find the posted form if available.
|
||
|
|
$form_name = $this->grav['uri']->post('__form-name__', FILTER_SANITIZE_STRING);
|
||
|
|
$unique_id = $this->grav['uri']->post('__unique_form_id__', FILTER_SANITIZE_STRING);
|
||
|
|
|
||
|
|
if (!$form_name) {
|
||
|
|
$form_name = $page ? $page->slug() : null;
|
||
|
|
}
|
||
|
|
|
||
|
|
$form = $this->getFormByName($form_name);
|
||
|
|
|
||
|
|
// last attempt using current page's form
|
||
|
|
if (!$form && $page) {
|
||
|
|
$form = $forms->createPageForm($page);
|
||
|
|
}
|
||
|
|
|
||
|
|
if ($form) {
|
||
|
|
// Only set posted unique id if the form name matches to the one that was posted.
|
||
|
|
if ($unique_id && $form_name === $form->getFormName()) {
|
||
|
|
$form->setUniqueId($unique_id);
|
||
|
|
$form->initialize();
|
||
|
|
}
|
||
|
|
|
||
|
|
$forms->setActiveForm($form);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return $form;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param PageInterface $page
|
||
|
|
* @param string|int|null $name
|
||
|
|
* @param array $form
|
||
|
|
* @return Form|null
|
||
|
|
* @deprecated
|
||
|
|
*/
|
||
|
|
protected function createForm(PageInterface $page, $name = null, $form = null)
|
||
|
|
{
|
||
|
|
|
||
|
|
$header = $page->header();
|
||
|
|
if (isset($header->form) || isset($header->forms)) {
|
||
|
|
return new Form($page, $name, $form);
|
||
|
|
}
|
||
|
|
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Load cached forms and merge with any currently found forms
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
protected function loadCachedForms()
|
||
|
|
{
|
||
|
|
// Get and set the cache of forms if it exists
|
||
|
|
try {
|
||
|
|
[$forms] = $this->grav['cache']->fetch($this->getFormCacheId());
|
||
|
|
} catch (Exception $e) {
|
||
|
|
// Couldn't fetch cached forms.
|
||
|
|
$forms = null;
|
||
|
|
|
||
|
|
/** @var Debugger $debugger */
|
||
|
|
$debugger = Grav::instance()['debugger'];
|
||
|
|
$debugger->addMessage(sprintf('Unserializing cached forms failed: %s', $e->getMessage()), 'error');
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!is_array($forms)) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Only update the forms if it's not empty
|
||
|
|
if (!empty($forms)) {
|
||
|
|
$this->forms = array_merge($this->forms, $forms);
|
||
|
|
$this->flattenForms();
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Save the current state of the forms
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
protected function saveCachedForms()
|
||
|
|
{
|
||
|
|
// Save the current state of the forms to cache
|
||
|
|
if ($this->recache_forms) {
|
||
|
|
$this->recache_forms = false;
|
||
|
|
$this->grav['cache']->save($this->getFormCacheId(), [$this->forms]);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the current page cache based id for the forms cache
|
||
|
|
*
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
protected function getFormCacheId()
|
||
|
|
{
|
||
|
|
return $this->grav['pages']->getPagesCacheId() . '-form-plugin';
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Create unix timestamp for storing the data into the filesystem.
|
||
|
|
*
|
||
|
|
* @param string $format
|
||
|
|
* @param bool $raw
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
protected function udate($format = 'u', $raw = false)
|
||
|
|
{
|
||
|
|
|
||
|
|
$utimestamp = microtime(true);
|
||
|
|
|
||
|
|
if ($raw) {
|
||
|
|
return date($format);
|
||
|
|
}
|
||
|
|
|
||
|
|
$timestamp = floor($utimestamp);
|
||
|
|
$milliseconds = round(($utimestamp - $timestamp) * 1000000);
|
||
|
|
|
||
|
|
return date(preg_replace('`(?<!\\\\)u`', sprintf('%06d', $milliseconds), $format), $timestamp);
|
||
|
|
}
|
||
|
|
}
|