Skip to content

always-open/sidekick

Repository files navigation

A collection of helper classes to make fighting the good fight easier

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads Maintainability

Collection of helper classes to make fighting the good fight even easier.

Installation

You can install the package via composer:

composer require always-open/sidekick

Version Support

Sidekick version PHP Version
1.x PHP 7.4 and 8.x
4.x PHP 8.x+

Usage

Helpers

String Helper

$ids = AlwaysOpen\Helpers\Strings::stringIdsToCollection('1,3,45, asdf,66,1,45,3');
var_dump($ids);

Routes Helper

This helper stops redirect loops where a url()->previous() might be used but the user could have directly input the url so previous and current are the same. This helper stops that from happening while allowing you to specify where to go if that scenario happens.

If the user can edit user profiles and reach it from multiple screens the redirect response after saving might look like this:

return response()->redirectTo(
    AlwaysOpen\Helpers\Routes::toRouteIfBackIsLoop('user.report')
);

Here the user will either go to their previous URL or get sent to the user report.

Traits

ByName

Add the trait to your model:

<?php

namespace App\Models;

namespace AlwaysOpen\Sidekick\Models\Traits\ByName;

class OrderStage extends Model
{
    use ByName;
    
    const NEXT_DAY = 'Next Day';
   ...
}

Use the trait to get the model by its name:

$overnight = OrderStage::byName('overnight');

Works nicely when you're doing work with consts:

$overnight = OrderStage::byName(OrderStage::NEXT_DAY);

CascadeUpdate

This trait is good if you need to update a last updated timestamp on related models such as a parent child relationship or line items on a document.

In the example class Docuemnt has multiple LineItem instances as children.

Within this exmaple you will need to override the getRelationshipsToUpdate method:

class LineItem extends Model
{
    use CascadeUpdate;

    public function getRelationshipsToUpdate() : array
    {
        return [
            'Document',
        ];
    }

    public function CascadeUpdate() : HasOne

When an instance of LineItem is saved the UPDATED_AT column on the owner Document will be updated as well.

Ordered

This trait ensures that all instances have a sort column value that is next in line. Future TODO is to make it update other instances when one of their sort values is updated to keep all in proper order.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.