invoiceninja/app/Models/RecurringInvoice.php

<?php
/**
 * Invoice Ninja (https://invoiceninja.com)
 *
 * @link https://github.com/invoiceninja/invoiceninja source repository
 *
 * @copyright Copyright (c) 2019. Invoice Ninja LLC (https://invoiceninja.com)
 *
 * @license https://opensource.org/licenses/AAL
 */

namespace App\Models;

use App\Models\Filterable;
use App\Utils\Traits\MakesHash;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Support\Carbon;

/**
 * Class for Recurring Invoices.
 */
class RecurringInvoice extends BaseModel
{
    use MakesHash;
    use SoftDeletes;
    use Filterable;

    /**
     * Invoice Statuses
     */
    const STATUS_DRAFT = 2;
    const STATUS_ACTIVE = 3;
    const STATUS_CANCELLED = 4;
    const STATUS_PENDING = -1;
    const STATUS_COMPLETED = -2;


    /**
     * Recurring intervals
     */
    const FREQUENCY_WEEKLY = 1;
    const FREQUENCY_TWO_WEEKS = 2;
    const FREQUENCY_FOUR_WEEKS = 3;
    const FREQUENCY_MONTHLY = 4;
    const FREQUENCY_TWO_MONTHS = 5;
    const FREQUENCY_THREE_MONTHS = 6;
    const FREQUENCY_FOUR_MONTHS = 7;
    const FREQUENCY_SIX_MONTHS = 8;
    const FREQUENCY_ANNUALLY = 9;
    const FREQUENCY_TWO_YEARS = 10;

    const RECURS_INDEFINITELY = -1;
    
	protected $fillable = [
		'client_id',
        'invoice_number',
        'discount',
        'is_amount_discount',
        'po_number',
        'invoice_date',
        'due_date',
        'line_items',
        'settings',
        'footer',
        'public_notes',
        'private_notes',
        'terms',
        'tax_name1',
        'tax_name2',
        'tax_rate1',
        'tax_rate2',
        'custom_value1',
        'custom_value2',
        'custom_value3',
        'custom_value4',
        'amount',
        'partial',
        'frequency_id',
        'start_date',
	];

    protected $casts = [
        'settings' => 'object',
        'line_items' => 'object',
    ];

    protected $appends = [
        'hashed_id',
        'status'
    ];

    public function company()
    {
        return $this->belongsTo(Company::class);
    }

    public function client()
    {
        return $this->belongsTo(Client::class);
    }

    public function user()
    {
        return $this->belongsTo(User::class);
    }

    public function invitations()
    {
        $this->morphMany(RecurringInvoiceInvitation::class);
    }

    public function getStatusAttribute()
    {

        if($this->status_id == RecurringInvoice::STATUS_ACTIVE && $this->start_date > Carbon::now()) //marked as active, but yet to fire first cycle
            return RecurringInvoice::STATUS_PENDING;
        else if($this->status_id == RecurringInvoice::STATUS_ACTIVE && $this->next_send_date > Carbon::now())
            return RecurringInvoice::STATUS_COMPLETED;
        else
            return $this->status_id;

    }

    public function nextSendDate() :?Carbon
    {

        switch ($this->frequency_id) 
        {
            case RecurringInvoice::FREQUENCY_WEEKLY:
                return Carbon::parse($this->next_send_date->addWeek());
            case RecurringInvoice::FREQUENCY_TWO_WEEKS:
                return Carbon::parse($this->next_send_date->addWeeks(2));
            case RecurringInvoice::FREQUENCY_FOUR_WEEKS:
                return Carbon::parse($this->next_send_date->addWeeks(4));
            case RecurringInvoice::FREQUENCY_MONTHLY:
                return Carbon::parse($this->next_send_date->addMonth());
            case RecurringInvoice::FREQUENCY_TWO_MONTHS:
                return Carbon::parse($this->next_send_date->addMonths(2));
            case RecurringInvoice::FREQUENCY_THREE_MONTHS:
                return Carbon::parse($this->next_send_date->addMonths(3));
            case RecurringInvoice::FREQUENCY_FOUR_MONTHS:
                return Carbon::parse($this->next_send_date->addMonths(4));
            case RecurringInvoice::FREQUENCY_SIX_MONTHS:
                return Carbon::parse($this->next_send_date->addMonths(6));
            case RecurringInvoice::FREQUENCY_ANNUALLY:
                return Carbon::parse($this->next_send_date->addYear());
            case RecurringInvoice::FREQUENCY_TWO_YEARS:
                return Carbon::parse($this->next_send_date->addYears(2));
            default:
                return null;
        }

    }

    public function remainingCycles() : int
    {

        if($this->remaining_cycles == 0)
            return 0;
        else
            return $this->remaining_cycles - 1;

    }

    public function setCompleted() :  void
    {

        $this->status_id = self::STATUS_COMPLETED;
        $this->next_send_date = null;
        $this->remaining_cycles = 0;
        $this->save();

    }

    public static function badgeForStatus(int $status)
    {
        switch ($status) {
            case RecurringInvoice::STATUS_DRAFT:
                return '<h4><span class="badge badge-light">'.ctrans('texts.draft').'</span></h4>';
                break;
            case RecurringInvoice::STATUS_PENDING:
                return '<h4><span class="badge badge-primary">'.ctrans('texts.sent').'</span></h4>';
                break;
            case RecurringInvoice::STATUS_ACTIVE:
                return '<h4><span class="badge badge-primary">'.ctrans('texts.partial').'</span></h4>';
                break;
            case RecurringInvoice::STATUS_COMPLETED:
                return '<h4><span class="badge badge-success">'.ctrans('texts.status_completed').'</span></h4>';
                break;
            case RecurringInvoice::STATUS_CANCELLED:
                return '<h4><span class="badge badge-danger">'.ctrans('texts.overdue').'</span></h4>';
                break;       
            default:
                # code...
                break;
        }
    }

    public static function frequencyForKey(int $frequency_id) :string
    {
        switch ($frequency_id) {
            case RecurringInvoice::FREQUENCY_WEEKLY:
                return ctrans('texts.freq_weekly');
                break;
            case RecurringInvoice::FREQUENCY_TWO_WEEKS:
                return ctrans('texts.freq_two_weeks');
                break;
            case RecurringInvoice::FREQUENCY_FOUR_WEEKS:
                return ctrans('texts.freq_four_weeks');
                break;
            case RecurringInvoice::FREQUENCY_MONTHLY:
                return ctrans('texts.freq_monthly');
                break;
            case RecurringInvoice::FREQUENCY_TWO_MONTHS:
                return ctrans('texts.freq_two_months');
                break;
            case RecurringInvoice::FREQUENCY_THREE_MONTHS:
                return ctrans('texts.freq_three_months');
                break;
            case RecurringInvoice::FREQUENCY_FOUR_MONTHS:
                return ctrans('texts.freq_four_months');
                break;
            case RecurringInvoice::FREQUENCY_SIX_MONTHS:
                return ctrans('texts.freq_six_months');
                break;
            case RecurringInvoice::FREQUENCY_ANNUALLY:
                return ctrans('texts.freq_annually');
                break;
            case RecurringInvoice::FREQUENCY_TWO_YEARS:
                return ctrans('texts.freq_two_years');
                break;            
            case RecurringInvoice::RECURS_INDEFINITELY:
                return ctrans('texts.freq_indefinitely');
                break;  
            default:
                # code...
                break;
        }
    }

}