Download the PHP package etsvthor/laravel-cashregister-bridge without Composer
On this page you can find all versions of the php package etsvthor/laravel-cashregister-bridge. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download etsvthor/laravel-cashregister-bridge
More information about etsvthor/laravel-cashregister-bridge
Files in etsvthor/laravel-cashregister-bridge
Package laravel-cashregister-bridge
Short Description Connect a laravel application with the Thor cash register
License MIT
Homepage https://github.com/etsvthor/laravel-cashregister-bridge
Informations about the package laravel-cashregister-bridge
Connect a laravel application with the Thor cash register
This package allows paying items from the website with the Thor cash register, for instance activity subscriptions from the Thorsite or TesLAN tickets. If an item is paid on the website, it's synced to the cash register. An item that is paid on the cash register gets synced to the external website as well.
Installation
You can install the package via composer:
Optionally, you can publish the config file. This is not necessary normally, but you can do it with:
This is the contents of the published config file:
Create a service via https://finances.thor.edu/admin/services
and put the service id + secret in the .env
.
Usage
There are 2 types of models that needs to have an interface implemented. See the thorsite as example.
External Product
A product that you can sell. This can be an activity or a merch item to sell, etc. (For the thorsite: webform)
- Implement the
EtsvThor\CashRegisterBridge\Contracts\HasExternalProduct
interface - Use the
EtsvThor\CashRegisterBridge\Traits\PushesExternalProduct
trait
This will make you implement a conversion from the model to the linked DTO
External Product Item
The model that keeps track of what you sold. E.g. an activity subscription or someone who buys a merch item. (For the thorsite: webform submission)
- Implement the
EtsvThor\CashRegisterBridge\Contracts\HasExternalProductItem
interface - Use the
EtsvThor\CashRegisterBridge\Traits\PushesExternalProduct
trait
This will make you implement a conversion from the model to the linked DTO
Migration
If you have existing models in your database with the HasExternalProduct
and HasExternalProductItem
interface, then you need to touch
them, so they get put on the cash register E.g.
You may need to throttle this, to not send too many http requests
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
- Niek Brekelmans
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-cashregister-bridge with dependencies
laravel/framework Version ^10.0|^11.0
spatie/laravel-data Version ^4.0
spatie/laravel-package-tools Version ^1.16.2