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('`(?