FreshRSS/app/Models/UserConfiguration.php

<?php
declare(strict_types=1);

/**
 * @property string $apiPasswordHash
 * @property array{keep_period:string|false,keep_max:int|false,keep_min:int|false,keep_favourites:bool,keep_labels:bool,keep_unreads:bool} $archiving
 * @property bool $auto_load_more
 * @property bool $auto_remove_article
 * @property bool $bottomline_date
 * @property bool $bottomline_favorite
 * @property bool $bottomline_link
 * @property bool $bottomline_read
 * @property bool $bottomline_sharing
 * @property bool $bottomline_tags
 * @property bool $bottomline_myLabels
 * @property string $content_width
 * @property-read int $default_state
 * @property string $default_view
 * @property string|bool $display_categories
 * @property string $show_tags
 * @property int $show_tags_max
 * @property string $show_author_date
 * @property string $show_feed_name
 * @property string $show_article_icons
 * @property bool $display_posts
 * @property string $email_validation_token
 * @property-read bool $enabled
 * @property string $feverKey
 * @property bool $hide_read_feeds
 * @property int $html5_notif_timeout
 * @property bool $html5_enable_notif
 * @property int $good_notification_timeout
 * @property int $bad_notification_timeout
 * @property-read bool $is_admin
 * @property int|null $keep_history_default
 * @property string $language
 * @property string $timezone
 * @property bool $lazyload
 * @property string $mail_login
 * @property bool $mark_updated_article_unread
 * @property array<string,bool|int> $mark_when
 * @property int $max_posts_per_rss
 * @property-read array<string,int> $limits
 * @property int|null $old_entries
 * @property bool $onread_jump_next
 * @property string $passwordHash
 * @property int $posts_per_page
 * @property array<int,array{get?:string,name?:string,order?:string,search?:string,state?:int,url?:string,token?:string,
 * 	shareRss?:bool,shareOpml?:bool,description?:string,imageUrl?:string}> $queries
 * @property bool $reading_confirm
 * @property int $since_hours_posts_per_rss
 * @property bool $show_fav_unread
 * @property bool $show_favicons
 * @property bool $icons_as_emojis
 * @property int $simplify_over_n_feeds
 * @property bool $show_nav_buttons
 * @property bool $show_title_unread
 * @property 'all'|'important'|'none' $show_unread_count
 * @property bool $sidebar_hidden_by_default
 * @property 'big'|'small'|'none' $mark_read_button
 * @property 'ASC'|'DESC' $sort_order
 * @property 'id'|'c.name'|'date'|'f.name'|'length'|'link'|'rand'|'title' $sort
 * @property 'ASC'|'DESC' $secondary_sort_order
 * @property 'id'|'date'|'link'|'title' $secondary_sort
 * @property array<int,array<string,string>> $sharing
 * @property array<string,string> $shortcuts
 * @property bool $sides_close_article
 * @property bool $sticky_post
 * @property bool $sticky_sort To carry the manual sort/order over to the next navigation
 * @property string $theme
 * @property string $darkMode
 * @property string $token
 * @property bool $topline_date
 * @property bool $topline_display_authors
 * @property bool $topline_favorite
 * @property bool $topline_myLabels
 * @property bool $topline_sharing
 * @property bool $topline_link
 * @property bool $topline_read
 * @property bool $topline_summary
 * @property string $topline_website
 * @property string $topline_thumbnail
 * @property int $ttl_default
 * @property int $dynamic_opml_ttl_default
 * @property string $view_mode
 * @property array<string,bool|int|string> $volatile
 * @property array<string,array<string,mixed>> $extensions
 * @property bool $retrieve_extension_list
 * @property array<string> $send_referrer_allowlist
 */
final class FreshRSS_UserConfiguration extends Minz_Configuration {
	use FreshRSS_FilterActionsTrait;

	/** @throws Minz_FileNotExistException */
	public static function init(string $config_filename, ?string $default_filename = null): FreshRSS_UserConfiguration {
		parent::register('user', $config_filename, $default_filename);
		try {
			return parent::get('user');
		} catch (Minz_ConfigurationNamespaceException $ex) {
			FreshRSS::killApp($ex->getMessage());
		}
	}

	/**
	 * Access the default configuration for users.
	 * @throws Minz_FileNotExistException
	 */
	public static function default(): FreshRSS_UserConfiguration {
		/** @var FreshRSS_UserConfiguration|null $default_user_conf */
		static $default_user_conf = null;
		if ($default_user_conf === null) {
			$namespace = 'user_default';
			FreshRSS_UserConfiguration::register($namespace, '_', FRESHRSS_PATH . '/config-user.default.php');
			$default_user_conf = FreshRSS_UserConfiguration::get($namespace);
		}
		return $default_user_conf;
	}

	/**
	 * Register and return the configuration for a given user.
	 *
	 * Note this function has been created to generate temporary configuration
	 * objects. If you need a long-time configuration, please don't use this function.
	 *
	 * @param string $username the name of the user of which we want the configuration.
	 * @return FreshRSS_UserConfiguration|null object, or null if the configuration cannot be loaded.
	 * @throws Minz_ConfigurationNamespaceException
	 */
	public static function getForUser(string $username): ?FreshRSS_UserConfiguration {
		if (!FreshRSS_user_Controller::checkUsername($username)) {
			return null;
		}
		$namespace = 'user_' . $username;
		try {
			FreshRSS_UserConfiguration::register($namespace,
				USERS_PATH . '/' . $username . '/config.php',
				FRESHRSS_PATH . '/config-user.default.php');
		} catch (Minz_FileNotExistException $e) {
			Minz_Log::warning($e->getMessage(), ADMIN_LOG);
			return null;
		}

		$user_conf = FreshRSS_UserConfiguration::get($namespace);
		return $user_conf;
	}
}