FormsService.php

Go to the documentation of this file.

<?php

namespace Elgg;

class FormsService {

    private $views;

    private $logger;

    private $rendering;

    private $footer = '';

    public function __construct(ViewsService $views, Logger $logger) {
        $this->views = $views;
        $this->logger = $logger;
    }

    public function render($action, $form_vars = array(), $body_vars = array()) {

        $defaults = array(
            'action' => elgg_normalize_url("action/$action"),
        );

        // append elgg-form class to any class options set
        $form_vars['class'] = (array) elgg_extract('class', $form_vars, []);
        $form_vars['class'][] = 'elgg-form-' . preg_replace('/[^a-z0-9]/i', '-', $action);

        $form_vars = array_merge($defaults, $form_vars);

        $form_vars['action_name'] = $action;
        
        if (!isset($form_vars['body'])) {
            $this->rendering = true;
            $this->footer = '';

            // Render form body
            $body = $this->views->renderView("forms/$action", $body_vars);

            if (!empty($body)) {
                // Grab the footer if one was set during form rendering
                $body .= $this->views->renderView('elements/forms/footer', [
                    'footer' => $this->getFooter(),
                    'action_name' => $action,
                ]);
            }
            
            $this->rendering = false;

            $form_vars['body'] = $body;
        }

        return elgg_view('input/form', $form_vars);
    }

    public function setFooter($footer = '') {

        if (!$this->rendering) {
            $this->logger->error('Form footer can only be set and retrieved during form rendering, '
                    . 'anywhere in elgg_view_form() call stack (e.g. form view, extending views, or view hooks)');
            return false;
        }

        $this->footer = $footer;
        return true;
    }

    public function getFooter() {
        if (!$this->rendering) {
            $this->logger->error('Form footer can only be set and retrieved during form rendering, '
                    . 'anywhere in elgg_view_form() call stack (e.g. form view, extending views, or view hooks)');
            return false;
        }

        return $this->footer;
    }

}