• Documentation
• callbackBeforeInsert

callbackBeforeInsert

callbackBeforeInsert(callable $callback)

The function callbackBeforeInsert is used in cases we need to add or change something before the insert functionality of Grocery CRUD Enterprise. For example a common usage is when we need to add more fields to the insert that will need to be done from the server (e.g. the user is not allowed to add this).

The usage is simple:

$crud->callbackBeforeInsert(function ($stateParameters) {
    // Your code here

    return $stateParameters;
});

You can also provide a custom error like this:

$crud->callbackBeforeInsert(function ($stateParameters) {
    if ($stateParameters->data['status'] === 'Rejected' && $stateParameters->data['message'] === '') {
          // The error message as a return parameter is only available at Enterprise version
          $errorMessage = new \GroceryCrud\Core\Error\ErrorMessage();
          return $errorMessage->setMessage("You can't add a Rejected status without a message\n");
    }

    return $stateParameters;
});

Example

For example, let's say that we need to force in every insert of an order to have the status as "In Process". In that case we could have the below code:

$crud->setTable('orders');
$crud->setSubject('Order', 'Orders');
$crud->unsetAddFields(['status']);
$crud->setRelation('customerNumber','customers','contactLastName');

$crud->callbackBeforeInsert(function ($stateParameters) {
    $stateParameters->data['status'] = 'In Process';

    return $stateParameters;
});

$output =  $crud->render();

Try to add any order and you will see that without adding the information of the status, the status will always automatically going to be "In Process"