Custom code options

Custom CSS

Enter custom CSS code to style the form according to your preferences. The class jl-form-{id} is the root class of the form, where {id} should be replaced with the form ID. For eg:

Custom JS

Enter custom JavaScript code to add effects or custom behaviors to the form. For eg:

Custom PHP

The PHP code provides three functions: onJLFormBeforeShow, onJLFormBeforeSubmit and onJLFormAfterSubmit

• onJLFormBeforeShow: This function is executed before the form is shown.

  Parameters: Joomlab\Component\JLForm\Site\Event\BeforeShowEvent $event

  • Argument $event->getForm(): An object containing form information.
  • Argument $event->getBuildSteps(): An array of the built steps buffer.
• onJLFormBeforeSubmit: This function is executed before the data is saved to the database.

  Parameters: Joomlab\Component\JLForm\Site\Event\BeforeSubmitEvent $event

  • Param $event->getForm(): An object containing form information.
  • Param $event->getValidData(): An array of user-submitted values.
• onJLFormAfterSubmit: This function is executed after the data is saved to the database.

  Parameters: Joomlab\Component\JLForm\Site\Event\AfterSubmitEvent $event

  • Param $event->getForm(): An object containing form information.
  • Param $event->getSubmission(): A Joomla Table object containing submission data.

For eg: (see more at the sample: "Users login/register form")

<?php
defined('_JEXEC') or die;

use Joomla\Component\JLForm\Site\Event\BeforeShowEvent;
use Joomla\Component\JLForm\Site\Event\BeforeSubmitEvent;
use Joomla\Component\JLForm\Site\Event\AfterSubmitEvent;

function onJLFormBeforeSubmit(BeforeShowEvent $event) {
  $event->addResult('The custom form string/HTML buffer will replace the form HTML output (see the sample "Users form")');
}

function onJLFormBeforeSubmit(BeforeSubmitEvent $event) {
  dd($event->getForm(), $event->getValidData());
}
            
function onJLFormAfterSubmit(AfterSubmitEvent $event) {
  dd($event->getForm(), $event->getSubmission());
}

Notes: Ensure your PHP code is accurate and syntactically correct; otherwise, it will not be saved. If your code is relatively complex, consider creating a plugin with the group jlform and defining the corresponding methods as shown above. The plugin methods will be executed before the custom functions.

• Previous article: General and mailer options
• Next article: Multilingual