Crear formularios en Drupal 8

En este tutorial veremos como crear formularios en Drupal 8 dentro de un módulo que estemos desarrollado.

Para crear formularios en Drupal 8 dentro de nuestro módulo crearemos el fichero pruebas_module/src/Form/CrearEmpresaForm.php y aquí definimos la clase del formulario y la definición de los diferentes campos.

<?php
namespace Drupal\pruebas_module\Form;

use Drupal\Core\Form\FormBase;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Component\Utility\UrlHelper;


class CrearEmpresaForm extends FormBase {

    /**
     * {@inheritdoc}
     */
    public function getFormId() {
        // Nombre del formulario
        return 'crear_empresa_form';
    }

    /**
     * {@inheritdoc}
     */
    public function buildForm(array $form, FormStateInterface $form_state) {
	
       // Definimos los campos
        $form['web'] = [
            '#type'     => 'textfield',
            '#title'    => $this->t('Sitio web'),
            '#required' => TRUE,
        ];
		
        $form['location'] = [
            '#type'     => 'text_format',
            '#title'    => $this->t('Dirección'),
            '#required' => TRUE,
        ];
       
        $form['submit'] = [
            '#type'  => 'submit',
            '#value' => $this->t('Crear empresa'),
        ];
        return $form;
    }

    /**
     * {@inheritdoc}
     */
    public function validateForm(array &$form, FormStateInterface $form_state) {

        // Hacemos las validaciones necesarias
        if (empty($form_state->getValue('web'))) {
            $form_state->setErrorByName('web', $this->t('Es necesario introducir un sitio web'));
        }
    }

    /**
     * {@inheritdoc}
     */
    public function submitForm(array &$form, FormStateInterface $form_state) {

        // Mostrar resultados al enviar el formulario en un mensaje de drupal
        foreach ($form_state->getValues() as $key => $value) {
            drupal_set_message($key . ': ' . $value);
        }
    }
}

Listado de elementos y tipos de campo disponibles para crear formularios en Drupal 8: https://api.drupal.org/api/drupal/elements

Ahora en nuestro controllador pruebas_module/src/Controller/PruebasController.php añadiremos una acción que cargará el formulario en una vista y posteriormente definiermos una ruta para tener una nueva página con un formulario disponible.

<?php
namespace Drupal\pruebas_module\Controller;

use Drupal;
use Drupal\node\Entity\Node;
use Drupal\Core\Controller\ControllerBase;

class PruebasController extends ControllerBase {
	
  public function content() {
    return array(
        '#type' => 'markup',
        '#markup' => $this->t('Hola mundo !!'),
    );
  }
  
    public function crearEmpresa() {
// Utilizamos el formulario
        $form = $this->formBuilder()->getForm('Drupal\pruebas_module\Form\CrearEmpresaForm');
        
// Le pasamos el formulario y demás a la vista (tema configurado en el module)
        return [
            '#theme' => 'crear_empresa',
            '#titulo' => $this->t('Formulario crear empresa'),
            '#descripcion' => 'Formulario para crear una nueva empresa en Drupal 8',
            '#formulario' => $form
        ];
    }
  
}

?>

Ahora vamos a crear el fichero de la vista pruebas_module/templates/crear_empresa.html.twig en el que simplemente imprimimos el contenido de la variable formulario.

<div class="row">
    
    <div class="col-md-6">
        <h2>{{ titulo }}</h2>
        <p>{{ descripcion }}</p>
    </div>
    
    <div class="col-md-6">
        {{ formulario }}
    </div>
    
</div>

Añadimos la vista que estamos usando al theme hook del pruebas_module.module

<?php
/**
 * Theme hook
 */
function pruebas_module_theme($existing, $type, $theme, $path) {
    
    return array(
        'crear_empresa' => array(
                                'variables' => array(
                                    'titulo' => 'Título por defecto', 
                                    'descripcion' => 'descripción por defecto',
                                    'formulario'   => NULL
                                    ),
                                'template' => 'crear_empresa'
                            )
    );
}

Definimos nuestras rutas en el fichero pruebas_module/pruebas_module.routing.yml

pruebas_module.content:
    path: '/admin/config/modulo-de-pruebas'
    defaults:
        _controller: '\Drupal\pruebas_module\Controller\PruebasController::content'
        _title: 'Modulo de pruebas'
    requirements:
        _permission: 'access content'
        
pruebas_module.crear_empresa:
    path: '/admin/config/crear-empresa'
    defaults:
        _controller: '\Drupal\pruebas_module\Controller\PruebasController::crearEmpresa'
        _title: 'Modulo de pruebas - Crear nueva empresa'
    requirements:
        _permission: 'access content'

Con esto ya hemos visto como crear formularios en Drupal 8.

Más información:
Crear un módulo básico en Drupal 8
Listado de hooks de Drupal 8
Curso de Symfony3 – Domina el framework PHP más completo

Victor

Autor: Victor

Desarrollador web - Formador online - Blogger

Compartir este post

Poner un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *