Require Signatures and Associate Them With Eloquent Models

 Laravel pad signature is a package to require a signature associated with an Eloquent model and optionally generate certified PDFs.

This package works by using a RequiresSignature trait (provided by the package) on an Eloquent model you want to associate with a signature. Taken from the readme, that might look like the following:

namespace App\Models;
 
use Creagia\LaravelSignPad\Concerns\RequiresSignature;
use Creagia\LaravelSignPad\Contracts\CanBeSigned;
 
class Delivery extends Model
{
    use RequiresSignature;
    // ...
}

You can also generate PDF documents with the signature by implementing the package's ShouldGenerateSignatureDocument interface. You can use a blade file or a PDF file as the basis for the signature document template. See the readme for details.

Once you have the package set up, a blade component provides the needed HTML to render the signature pad (shown with customizations):

<x-creagia-signature-pad
    border-color="#eaeaea"
    pad-classes="rounded-xl border-2"
    button-classes="bg-gray-100 px-4 py-2 rounded-xl mt-4"
    clear-name="Clear"
    submit-name="Submit"
/>

Once you've collected signatures from users, you can access the signature image and document on the model like so:

// Get the signature image path
$myModel->signature->getSignatureImagePath();
 
// Get the signed document path
$myModel->signature->getSignedDocumentPath();

This package also supports certifying the PDF, and instructions are provided in the readme. You can learn more about this package, get full installation instructions, and view the source code on GitHub.

---

This package was submitted to our Laravel News Links section. Links is a place the community can post packages and tutorials around the Laravel ecosystem. Follow along on Twitter @LaravelLinks

Read More

Sanitize and Format Data in PHP with the Transformer Package

 Transformer is a PHP package for sanitizing and formatting data powered by Laravel's validation components. The package uses a familiar Laravel validation-like syntax to transform data using callable functions, classes, and more:

use Closure;
 
// example available functions at runtime:
function to_carbon($value)
{
    return new Carbon\Carbon($value);
}
 
function only_numbers($value)
{
    return preg_replace("/[^0-9]/",'',$value);
}
 
$input = [
  'first_name' => '    jim    ',
  'last_name' => '   thompson',
  'phone_number' => '123-456-7890',
  'date_of_birth' => "1991-05-01",
];
 
(new DataTransformer($input, [
    'first_name' => 'trim|ucfirst',
    'last_name' => 'trim|ucfirst',
    'phone_number' => 'only_numbers',
    'date_of_birth' => 'to_carbon|->format:m/d/y',
]))->transform();
 
// Returns:
// [
//     "first_name" => "Jim",
//     "last_name" => "Thompson",
//     "phone_number" => "1234567890",
//     "date_of_birth" => "05/01/91",
// ]

Those familiar with Laravel's validation API will notice the string-based transformer rules. Also, as seen in the snippet, this package has a "chainable" syntax (to_carbon|->format:m/d/y) that can chain additional calls on a piece of data.

You can also transform data using closures or a class implementing the provided Transformable interface. Additionally, this package supports nested array data using dot notation, wildcard inputs (apply functions on keys matching a wildcard pattern), and more.

You can learn more about this package, get full installation instructions, and view the source code on GitHub.

Read More