PHP code example of lyrasoft / token-coin

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

lyrasoft / token-coin example snippets

// Token Coins
$menu->link('點數歷史')
    ->to($nav->to('token_coin_history_list'))
    ->icon('fa-light fa-ticket');

    $mig->createTable(
        User::class,
        function (Schema $schema) {
            // ...
            $schema->decimal('token_coins')->length('20,4');
            
            // ...
            
            $schema->addIndex('token_coins');
            
            // ...
        }
    );

    // OR

    $mig->updateTable(
        User::class,
        function (Schema $schema) {
            $schema->decimal('token_coins')->length('20,4')->after('password');
            $schema->addIndex('token_coins');
        }
    );

use \Lyrasoft\TokenCoin\Enum\TokenCoinAction;

foreach ($userIds as $userId) {
    /** @var \Lyrasoft\TokenCoin\Service\TokenCoinService $tokenCoinService */
    $tokenCoinService->modifyAndAddHistory(
        type: 'main',
        targetId: $userId,
        action: TokenCoinAction::PLUS,
        value: 500,
        // You can modify TokenCoinHistory entity here
        beforeSave: function (TokenCoinHistory $history) use ($currentUser, $tokenCoinData) {
            $history->setNote($tokenCoinData['note']); // The note messgage
            $history->setAgentId($currentUser->getId()); // Who did this action
        },
        // Udpdate remaining values
        updateRemain: function (float $remain, mixed $targetId, string|\BackedEnum $type) use ($orm, $currentUser) {
            $orm->updateBatch(
                User::class,
                [
                    'token_coins' => $remain,
                ],
                ['id' => $targetId]
            );
        }
    );
}

/** @var \Lyrasoft\TokenCoin\Service\TokenCoinService $tokenCoinService */

// plus/reduce/use actions
$tokenCoinService->plus($type, 500, $targetId, ...);
$tokenCoinService->reduce($type, 500, $targetId, ...);
$tokenCoinService->use($type, 500, $targetId, ...);

$tokenCoinService->modifyAndAddHistory($type, $action, $value, $targetId, ...);

// Other utilities

// Is enough to use/reduce
$tokenCoinService->isEnoughToReduce($type, $targetId, 500); // (bool)

// Is the remain larger than 0
$tokenCoinService->hasBalance($type, $targetId); // (bool)

// Get remaining value
$tokenCoinService->getRemain($type, $targetId); // (float)

// Get laat history entity
$tokenCoinService->getLastHistory($type, $targetId, sortBy: 'id'); // ?TokenCoinHistory

// Sum the total usage of a month of given time.
$tokenCoinService->getUsageTotalByMonth($type, $targetId, current: 'now'); // (float)

// Sum the total usage between two dates
$tokenCoinService->getUsageTotalBetween($type, $targetId, $start, $end); // (float)

$tokenCoinService->modifyAndAddHistory('reward');
$tokenCoinService->modifyAndAddHistory(MyTokenCoinType::REWARD);

/** @var \Lyrasoft\TokenCoin\Service\TokenCoinService $tokenCoinService */
$orm->transaction(
    function () use ($tokenCoinService, $orm, $userId) {
        $type = MyTokenCoinType::REWARD; 
        $useValue = 699;
    
        // Check if the user has enough token coins
        if ($tokenCoinService->isEnoughToReduce($type, $userId, $useValue)) {
            $tokenCoinService->use($type, $useValue, $userId);
        } else {
            // Not enough token coins
            throw new \RuntimeException('Not enough token coins.', 403);
        }
    }
);

$history = $tokenCoinService->use($type, $useValue, $userId);

// $history->getRemain() < 0

/** @var \Lyrasoft\TokenCoin\Service\TokenCoinService $tokenCoinService */
$orm->transaction(
    function () use ($tokenCoinService, $orm, $userId) {
        $type = MyTokenCoinType::REWARD; 
        $useValue = 699;
    
        // Check if the user has enough token coins
        if ($tokenCoinService->hasBalance($type, $userId)) {
            $tokenCoinService->use($type, $useValue, $userId);
        }
    }
);

$tokenCoinService->plus(
    ...
    beforeSave: function (TokenCoinHistory $history) {
        // ...
    },
    updateRemain: function (float $remain, mixed $targetId, string|\BackedEnum $type) {
        // ...
    }
);

function (string|\BackedEnum $type, \Windwalker\ORM\ORM $orm, float $remain, mixed $targetId) {
    // ...
}

declare(strict_types=1);

namespace App\Config;

use Lyrasoft\Luna\Entity\User;
use Lyrasoft\TokenCoin\TokenCoinPackage;
use Windwalker\ORM\ORM;

return [
    'token-coin' => [
        // ...
        
        'callbacks' => [
            'before_save' => [
                // 'type' => function () {}
            ],

            'update_remain' => [
                'main' => function (float $remain, mixed $targetId, string|\BackedEnum $type) {
                    // ...
                }
            ],
        ],
    ]
];

    // ...

    public function batch(
        AppContext $app,
        #[Autowire] UserRepository $repository,
        GridController $controller,
        ORM $orm,
    ): mixed {
        // ...
    
        if ($app->input('task') === 'token_coin_changes') {
            $tokenCoinService = $app->retrieve(TokenCoinService::class);
            $currentUser = $app->retrieve(\CurrentUser::class);
            $tokenCoinData = $app->input('token_coin');

            $ids = (array) $app->input('id');

            foreach ($ids as $id) {
                $tokenCoinService->modifyAndAddHistory(
                    type: 'main',
                    targetId: (int) $id,
                    action: TokenCoinAction::wrap($tokenCoinData['action']),
                    value: (float) $tokenCoinData['value'],
                    beforeSave: function (TokenCoinHistory $history) use ($currentUser, $tokenCoinData) {
                        $history->setNote($tokenCoinData['note']);
                        $history->setAgentId($currentUser->getId());
                    },
                    // You can put this to config callbacks
                    updateRemain: function (mixed $remain, mixed $targetId) use ($orm) {
                        $orm->updateBatch(
                            User::class,
                            [
                                'token_coins' => $remain,
                            ],
                            ['id' => $targetId]
                        );
                    }
                );
            }

            $app->addMessage(
                sprintf(
                    '已更新 %s 人的點數',
                    count($ids)
                ),
                'success'
            );

            return $app->getNav()->back();
        }

        // ...
    }

html
// user-list.blade.php

    ...

    <x-token-coin-changes-modal></x-token-coin-changes-modal>
</form>