mirror of
https://github.com/firefly-iii/firefly-iii.git
synced 2025-09-18 10:39:28 +00:00
279 lines
9.5 KiB
PHP
279 lines
9.5 KiB
PHP
<?php
|
||
|
||
/*
|
||
* UpgradeFireflyInstructions.php
|
||
* Copyright (c) 2023 james@firefly-iii.org
|
||
*
|
||
* This file is part of Firefly III (https://github.com/firefly-iii).
|
||
*
|
||
* This program is free software: you can redistribute it and/or modify
|
||
* it under the terms of the GNU Affero General Public License as
|
||
* published by the Free Software Foundation, either version 3 of the
|
||
* License, or (at your option) any later version.
|
||
*
|
||
* This program is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
* GNU Affero General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Affero General Public License
|
||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace FireflyIII\Console\Commands\System;
|
||
|
||
use Carbon\Carbon;
|
||
use FireflyIII\Support\System\GeneratesInstallationId;
|
||
use Illuminate\Console\Command;
|
||
|
||
class OutputsInstructions extends Command
|
||
{
|
||
use GeneratesInstallationId;
|
||
|
||
protected $description = 'Instructions in case of upgrade trouble.';
|
||
|
||
protected $signature = 'firefly-iii:instructions {task=install}';
|
||
|
||
/**
|
||
* Execute the console command.
|
||
*/
|
||
public function handle(): int
|
||
{
|
||
$this->generateInstallationId();
|
||
if ('update' === $this->argument('task')) {
|
||
$this->updateInstructions();
|
||
}
|
||
if ('install' === $this->argument('task')) {
|
||
$this->installInstructions();
|
||
}
|
||
|
||
return 0;
|
||
}
|
||
|
||
/**
|
||
* Render upgrade instructions.
|
||
*/
|
||
private function updateInstructions(): void
|
||
{
|
||
$version = (string) config('firefly.version');
|
||
|
||
/** @var array $config */
|
||
$config = config('upgrade.text.upgrade');
|
||
$text = '';
|
||
|
||
/** @var string $compare */
|
||
foreach (array_keys($config) as $compare) {
|
||
// if string starts with:
|
||
if (str_starts_with($version, $compare)) {
|
||
$text = (string) $config[$compare];
|
||
}
|
||
}
|
||
|
||
// validate some settings.
|
||
if ('' === $text && 'local' === (string) config('app.env')) {
|
||
$text = 'Please set APP_ENV=production for a safer environment.';
|
||
}
|
||
|
||
$prefix = 'v';
|
||
if (str_starts_with($version, 'develop') || str_starts_with($version, 'branch')) {
|
||
$prefix = '';
|
||
}
|
||
|
||
$this->newLine();
|
||
$this->showLogo();
|
||
$this->newLine();
|
||
$this->newLine();
|
||
$this->showLine();
|
||
|
||
$this->boxed('');
|
||
if ('' === $text) {
|
||
$this->boxed(sprintf('Thank you for updating to Firefly III, %s%s', $prefix, $version));
|
||
$this->boxedInfo('There are no extra upgrade instructions.');
|
||
$this->boxed('Firefly III should be ready for use.');
|
||
$this->boxed('');
|
||
$this->donationText();
|
||
$this->boxed('');
|
||
$this->showLine();
|
||
|
||
return;
|
||
}
|
||
|
||
$this->boxed(sprintf('Thank you for updating to Firefly III, %s%s!', $prefix, $version));
|
||
$this->boxedInfo($text);
|
||
$this->boxed('');
|
||
$this->donationText();
|
||
$this->boxed('');
|
||
$this->showLine();
|
||
}
|
||
|
||
/**
|
||
* The logo takes up 8 lines of code. So 8 colors can be used.
|
||
*/
|
||
private function showLogo(): void
|
||
{
|
||
$today = Carbon::now()->format('m-d');
|
||
$month = Carbon::now()->format('m');
|
||
// variation in colors and effects just because I can!
|
||
// default is Ukraine flag:
|
||
$colors = ['blue', 'blue', 'blue', 'yellow', 'yellow', 'yellow', 'default', 'default'];
|
||
|
||
// 5th of May is Dutch liberation day and 29th of April is Dutch King's Day and September 17 is my birthday.
|
||
if ('05-01' === $today || '04-29' === $today || '09-17' === $today) {
|
||
$colors = ['red', 'red', 'red', 'white', 'white', 'blue', 'blue', 'blue'];
|
||
}
|
||
|
||
// National Coming Out Day, International Day Against Homophobia, Biphobia and Transphobia and Pride Month
|
||
if ('10-11' === $today || '05-17' === $today || '06' === $month) {
|
||
$colors = ['red', 'bright-red', 'yellow', 'green', 'blue', 'magenta', 'default', 'default'];
|
||
}
|
||
|
||
// International Transgender Day of Visibility
|
||
if ('03-31' === $today) {
|
||
$colors = ['bright-blue', 'bright-red', 'white', 'white', 'bright-red', 'bright-blue', 'default', 'default'];
|
||
}
|
||
if ('ru_RU' === config('firefly.default_language')) {
|
||
$colors = ['blue', 'blue', 'blue', 'yellow', 'yellow', 'yellow', 'default', 'default'];
|
||
}
|
||
|
||
$this->line(sprintf('<fg=%s> ______ _ __ _ _____ _____ _____ </>', $colors[0]));
|
||
$this->line(sprintf('<fg=%s> | ____(_) / _| | |_ _|_ _|_ _| </>', $colors[1]));
|
||
$this->line(sprintf('<fg=%s> | |__ _ _ __ ___| |_| |_ _ | | | | | | </>', $colors[2]));
|
||
$this->line(sprintf('<fg=%s> | __| | | \'__/ _ \ _| | | | | | | | | | | </>', $colors[3]));
|
||
$this->line(sprintf('<fg=%s> | | | | | | __/ | | | |_| | _| |_ _| |_ _| |_ </>', $colors[4]));
|
||
$this->line(sprintf('<fg=%s> |_| |_|_| \___|_| |_|\__, | |_____|_____|_____| </>', $colors[5]));
|
||
$this->line(sprintf('<fg=%s> __/ | </>', $colors[6]));
|
||
$this->line(sprintf('<fg=%s> |___/ </>', $colors[7]));
|
||
$this->someQuote();
|
||
}
|
||
|
||
/**
|
||
* Show a line.
|
||
*/
|
||
private function showLine(): void
|
||
{
|
||
$this->line(sprintf('+%s+', str_repeat('-', 78)));
|
||
}
|
||
|
||
/**
|
||
* Show a nice box.
|
||
*/
|
||
private function boxed(string $text): void
|
||
{
|
||
$parts = explode("\n", wordwrap($text));
|
||
foreach ($parts as $string) {
|
||
$this->line('| '.sprintf('%-77s', $string).'|');
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Show a nice info box.
|
||
*/
|
||
private function boxedInfo(string $text): void
|
||
{
|
||
$parts = explode("\n", wordwrap($text));
|
||
foreach ($parts as $string) {
|
||
$this->info('| '.sprintf('%-77s', $string).'|');
|
||
}
|
||
}
|
||
|
||
private function donationText(): void
|
||
{
|
||
$this->boxed('Did you know you can support the development of Firefly III?');
|
||
$this->boxed('You can donate in many ways, like GitHub Sponsors or Patreon.');
|
||
$this->boxed('For more information, please visit https://bit.ly/donate-to-Firefly-III');
|
||
}
|
||
|
||
/**
|
||
* Render instructions.
|
||
*/
|
||
private function installInstructions(): void
|
||
{
|
||
$version = (string) config('firefly.version');
|
||
|
||
/** @var array $config */
|
||
$config = config('upgrade.text.install');
|
||
$text = '';
|
||
|
||
/** @var string $compare */
|
||
foreach (array_keys($config) as $compare) {
|
||
// if string starts with:
|
||
if (str_starts_with($version, $compare)) {
|
||
$text = (string) $config[$compare];
|
||
}
|
||
}
|
||
|
||
// validate some settings.
|
||
if ('' === $text && 'local' === (string) config('app.env')) {
|
||
$text = 'Please set APP_ENV=production for a safer environment.';
|
||
}
|
||
|
||
$prefix = 'v';
|
||
if (str_starts_with($version, 'develop')) {
|
||
$prefix = '';
|
||
}
|
||
|
||
$this->newLine();
|
||
$this->showLogo();
|
||
$this->newLine();
|
||
$this->showLine();
|
||
$this->boxed('');
|
||
if ('' === $text) {
|
||
$this->boxed(sprintf('Thank you for installing Firefly III, %s%s!', $prefix, $version));
|
||
$this->boxedInfo('There are no extra installation instructions.');
|
||
$this->boxed('Firefly III should be ready for use.');
|
||
$this->boxed('');
|
||
$this->donationText();
|
||
$this->boxed('');
|
||
$this->showLine();
|
||
|
||
return;
|
||
}
|
||
|
||
$this->boxed(sprintf('Thank you for installing Firefly III, %s%s!', $prefix, $version));
|
||
$this->boxedInfo($text);
|
||
$this->boxed('');
|
||
$this->donationText();
|
||
$this->boxed('');
|
||
$this->showLine();
|
||
}
|
||
|
||
private function someQuote(): void
|
||
{
|
||
$lines = [
|
||
'Forgive yourself for not being at peace.',
|
||
'Doesn\'t look like anything to me.',
|
||
'Be proud of what you make.',
|
||
'Be there or forever wonder.',
|
||
'A year from now you will wish you had started today.',
|
||
];
|
||
$addQuotes = true;
|
||
|
||
// fuck the Russian aggression in Ukraine.
|
||
|
||
// There is no point even trying to be neutral, because you can’t. When I say you can’t be neutral on
|
||
// a moving train, it means the world is already moving in certain directions. Children are going
|
||
// hungry, wars are taking place. In a situation like that, to be neutral or to try to be neutral,
|
||
// to stand aside, not to take a stand, not to participate, is to collaborate with whatever is
|
||
// going on, to allow that to happen.
|
||
|
||
if ('ru_RU' === config('firefly.default_language')) {
|
||
$addQuotes = false;
|
||
$lines = [
|
||
'🇺🇦 Слава Україні!',
|
||
'🇺🇦 Slava Ukraini!',
|
||
];
|
||
}
|
||
|
||
$random = random_int(0, count($lines) - 1);
|
||
if ($addQuotes) {
|
||
$this->line(sprintf(' "%s"', $lines[$random]));
|
||
|
||
return;
|
||
}
|
||
$this->line(sprintf(' %s', $lines[$random]));
|
||
|
||
}
|
||
}
|