phpvms/app/Interfaces/Award.php

<?php

namespace App\Interfaces;

use App\Facades\Utils;
use App\Models\Award as AwardModel;
use App\Models\User;
use App\Models\UserAward;
use Log;

/**
 * Base class for the Awards, you need to extend this, and implement:
 *  $name
 *  $param_description (optional)
 *  public function check($parameter=null)
 *
 * See: http://docs.phpvms.net/customizing/awards
 * @package App\Interfaces
 */
abstract class Award
{
    public $name = '';
    public $param_description = '';

    /**
     * Each award class just needs to return true or false if it should actually
     * be awarded to a user. This is the only method that needs to be implemented
     * @param null $parameter Optional parameters that are passed in from the UI
     * @return bool
     */
    abstract public function check($parameter = null): bool;

    /*
     * You don't really need to mess with anything below here
     */

    protected $award,
              $user;

    /**
     * AwardInterface constructor.
     * @param AwardModel $award
     * @param User       $user
     */
    public function __construct(AwardModel $award = null, User $user = null)
    {
        $this->award = $award;
        $this->user = $user;
    }

    /**
     * Run the main handler for this award class to determine if
     * it should be awarded or not. Declared as final to prevent a child
     * from accidentally overriding and breaking something
     */
    final public function handle(): void
    {
        # Check if the params are a JSON object or array
        $param = $this->award->ref_class_params;
        if (Utils::isObject($this->award->ref_class_params)) {
            $param = json_decode($this->award->ref_class_params);
        }

        if ($this->check($param)) {
            $this->addAward();
        }
    }

    /**
     * Add the award to this user, if they don't already have it
     * @return bool|UserAward
     */
    final protected function addAward()
    {
        $w = [
            'user_id'  => $this->user->id,
            'award_id' => $this->award->id,
        ];

        $found = UserAward::where($w)->count('id');
        if ($found > 0) {
            return true;
        }

        // Associate this award to the user now
        $award = new UserAward($w);

        try {
            $award->save();
        } catch(\Exception $e) {
            Log::error(
                'Error saving award: '.$e->getMessage(),
                $e->getTrace()
            );

            return null;
        }

        return $award;
    }
}