nazar-pc / CleverStyle-Framework

modules/Blogs/Controller.php

<?php
/**
 * @package  Blogs
 * @category modules
 * @author   Nazar Mokrynskyi <nazar@mokrynskyi.com>
 * @license  0BSD
 */
namespace cs\modules\Blogs;
use
	cs\Config,
	cs\Event,
	cs\ExitException,
	cs\Language\Prefix,
	cs\Page\Meta,
	cs\Page,
	cs\User,
	h;

class Controller {
	/**
	 * @param \cs\Request $Request
	 */
	public static function latest_posts ($Request) {
		if (!Event::instance()->fire('Blogs/latest_posts')) {
			return;
		}
		$Config = Config::instance();
		$L      = new Prefix('blogs_');
		$Meta   = Meta::instance();
		$Page   = Page::instance();
		$Posts  = Posts::instance();
		/**
		 * Page title
		 */
		$Page->title($L->latest_posts);

The property latest_posts does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		/**
		 * Now add link to Atom feed for latest posts
		 */
		$Page->atom('Blogs/atom.xml', $L->latest_posts);
		/**
		 * Set page of blog type (Open Graph protocol)
		 */
		$Meta->blog();

The method blog() does not exist on cs\False_class. Since you implemented __call, consider adding a @method annotation.

		/**
		 * Determine current page
		 */
		$page = static::get_page_and_set_title($Request, $Page, $L);
		/**
		 * Get posts for current page in JSON-LD structure format
		 */
		$posts_per_page = $Config->module('Blogs')->posts_per_page;

The property posts_per_page does not exist on cs\Config\Module_Properties. Since you implemented __get, consider adding a @property annotation.

		$posts          = $Posts->get_latest_posts($page, $posts_per_page);

It seems like $posts_per_page can also be of type false; however, parameter $count of cs\modules\Blogs\Posts::get_latest_posts() does only seem to accept integer, maybe add an additional type check?

		/**
		 * Base url (without page number)
		 */
		$base_url = $Config->base_url().'/'.path($L->Blogs).'/'.path($L->latest_posts);

The property Blogs does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		/**
		 * Render posts page
		 */
		Helpers::show_posts_list(
			$posts,
			$Posts->get_total_count(),
			$page,
			$base_url
		);
	}
	/**
	 * @param \cs\Request $Request
	 * @param Page        $Page
	 * @param Prefix      $L
	 *
	 * @return int
	 */
	protected static function get_page_and_set_title ($Request, $Page, $L) {
		$page = max(
			isset($Request->route_ids[0]) ? array_slice($Request->route_ids, -1)[0] : 1,
			1
		);
		/**
		 * If this is not first page - show that in page title
		 */
		if ($page > 1) {
			$Page->title($L->page_number($page));

The method page_number() does not exist on cs\Language\Prefix. Since you implemented __call, consider adding a @method annotation.

		}
		return $page;
	}
	/**
	 * @param \cs\Request $Request
	 *
	 * @throws ExitException
	 */
	public static function section ($Request) {
		if (!Event::instance()->fire('Blogs/section')) {
			return;
		}
		$Config   = Config::instance();
		$L        = new Prefix('blogs_');
		$Meta     = Meta::instance();
		$Page     = Page::instance();
		$Posts    = Posts::instance();
		$Sections = Sections::instance();
		/**
		 * At first - determine part of url and get sections list based on that path
		 */
		$sections = $Sections->get_by_path(
			array_slice($Request->route_path, 1)
		);
		if (!$sections) {

The condition $sections is always false.

			throw new ExitException(400);
		}
		$sections = $Sections->get($sections);
		/**
		 * Now lets set page title using sections names from page path
		 * We will not remove `$section` variable after, since it will be direct parent of each shown post
		 */
		foreach ($sections as $section) {
			$Page->title($section['title']);
		}
		/**
		 * Now add link to Atom feed for posts from current section only
		 */
		/** @noinspection PhpUndefinedVariableInspection */
		$Page->atom(
			"Blogs/atom.xml/?section=$section[id]",
			implode($Config->core['title_delimiter'], [$L->latest_posts, $L->section, $section['title']])
		);
		/**
		 * Set page of blog type (Open Graph protocol)
		 */
		$Meta->blog();
		/**
		 * Determine current page
		 */
		$page = static::get_page_and_set_title($Request, $Page, $L);
		/**
		 * Get posts for current page in JSON-LD structure format
		 */
		$posts_per_page = $Config->module('Blogs')->posts_per_page;
		$posts          = $Posts->get_for_section($section['id'], $page, $posts_per_page);
		/**
		 * Base url (without page number)
		 */
		$base_url = $Config->base_url().'/'.path($L->Blogs).'/'.path($L->section)."/$section[full_path]";
		/**
		 * Render posts page
		 */
		Helpers::show_posts_list(
			$posts,
			$section['posts'],
			$page,
			$base_url
		);
	}
	/**
	 * @param \cs\Request  $Request
	 * @param \cs\Response $Response
	 *
	 * @throws ExitException
	 */
	public static function post ($Request, $Response) {
		if (!Event::instance()->fire('Blogs/post')) {
			return;
		}
		$Page    = Page::instance();
		$Posts   = Posts::instance();
		$rc      = $Request->route;
		$post_id = (int)mb_substr($rc[1], mb_strrpos($rc[1], ':') + 1);
		$post    = $Posts->get_as_json_ld($post_id);
		if (
			!$post ||

The condition $post is always false.

			(
				$post['draft'] && $post['user'] != User::instance()->id
			)
		) {
			throw new ExitException(404);
		}
		if ($post['path'] != mb_substr($rc[1], 0, mb_strrpos($rc[1], ':'))) {
			$Response->redirect($post['url'], 303);
			return;
		}
		$Page->title($post['title']);
		$Page->Description = description($post['short_content']);
		$Page->canonical_url($post['url']);
		$Meta = Meta::instance();
		$Meta
			->article()
			->article('published_time', date('Y-m-d', $post['date'] ?: time()))
			->article('section', $post['articleSection'] ? $post['articleSection'][0] : false)
			->article('tag', $post['tags']);
		array_map([$Meta, 'image'], $post['image']);
		$Page->content(
			h::{'cs-blogs-post script[type=application/ld+json]'}(
				json_encode($post, JSON_UNESCAPED_UNICODE)
			)
		);
	}
	protected static function is_blogs_admin () {
		$User = User::instance();
		return
			$User->admin() &&
			$User->get_permission('admin/Blogs', 'index') &&
			$User->get_permission('admin/Blogs', 'edit_post');
	}
	/**
	 * @param \cs\Request $Request
	 *
	 * @throws ExitException
	 */
	public static function tag ($Request) {
		if (!Event::instance()->fire('Blogs/tag')) {
			return;
		}
		$Config = Config::instance();
		$L      = new Prefix('blogs_');
		$Meta   = Meta::instance();
		$Page   = Page::instance();
		$Posts  = Posts::instance();
		$Tags   = Tags::instance();
		/**
		 * If no tag specified
		 */
		if (!isset($Request->route[1])) {
			throw new ExitException(404);
		}
		/**
		 * Find tag
		 */
		$tag = $Tags->get_by_text($Request->route[1]);
		if (!$tag) {
			throw new ExitException(404);
		}
		$tag = $Tags->get($tag);
		/**
		 * Add tag to page title
		 */
		$Page->title($tag['text']);
		/**
		 * Now add link to Atom feed for posts with current tag only
		 */
		$Page->atom(
			"Blogs/atom.xml/?tag=$tag[id]",
			implode($Config->core['title_delimiter'], [$L->latest_posts, $L->tag, $tag['text']])

The property tag does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

The property latest_posts does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		);
		/**
		 * Set page of blog type (Open Graph protocol)
		 */
		$Meta->blog();
		/**
		 * Determine current page
		 */
		$page = max($Request->route(2) ?: 1, 1);
		/**
		 * If this is not first page - show that in page title
		 */
		if ($page > 1) {
			$Page->title($L->blogs_nav_page($page));

The method blogs_nav_page() does not exist on cs\Language\Prefix. Since you implemented __call, consider adding a @method annotation.

		}
		/**
		 * Get posts for current page in JSON-LD structure format
		 */
		$posts_per_page = $Config->module('Blogs')->posts_per_page;

The property posts_per_page does not exist on cs\Config\Module_Properties. Since you implemented __get, consider adding a @property annotation.

		$posts          = $Posts->get_for_tag($tag['id'], $page, $posts_per_page);

It seems like $posts_per_page can also be of type false; however, parameter $count of cs\modules\Blogs\Posts::get_for_tag() does only seem to accept integer, maybe add an additional type check?

		$posts_count    = $Posts->get_for_tag_count($tag['id']);
		/**
		 * Base url (without page number)
		 */
		$base_url = $Config->base_url().'/'.path($L->Blogs).'/'.path($L->tag).'/'.$Request->route[1];

The property Blogs does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		/**
		 * Render posts page
		 */
		Helpers::show_posts_list(
			$posts,
			$posts_count,
			$page,
			$base_url
		);
	}
	public static function new_post () {
		if (!Event::instance()->fire('Blogs/new_post')) {
			return;
		}

		$Config      = Config::instance();
		$module_data = $Config->module('Blogs');
		$L           = new Prefix('blogs_');
		$Page        = Page::instance();
		$User        = User::instance();
		$Page->title($L->new_post);

The property new_post does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		if (!$User->admin() && $module_data->new_posts_only_from_admins) {

The property new_posts_only_from_admins does not exist on cs\Config\Module_Properties. Since you implemented __get, consider adding a @property annotation.

			throw new ExitException(403);
		}
		if (!$User->user()) {
			$Page->warning($L->for_registered_users_only);

The property for_registered_users_only does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

			return;
		}
		$Page->content(
			h::cs_blogs_add_edit_post()

The method cs_blogs_add_edit_post() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

		);
	}
	/**
	 * @param \cs\Request $Request
	 *
	 * @throws ExitException
	 */
	public static function edit_post ($Request) {
		if (!Event::instance()->fire('Blogs/edit_post')) {
			return;
		}

		$Posts       = Posts::instance();
		$Config      = Config::instance();
		$module_data = $Config->module('Blogs');
		$L           = new Prefix('blogs_');
		$Page        = Page::instance();
		$User        = User::instance();
		if ($module_data->new_posts_only_from_admins && !$User->admin()) {

The property new_posts_only_from_admins does not exist on cs\Config\Module_Properties. Since you implemented __get, consider adding a @property annotation.

			throw new ExitException(403);
		}
		$id = $Request->route(1);
		if (!$id) {
			throw new ExitException(400);
		}
		$post = $Posts->get($id);

It seems like $id can also be of type string; however, parameter $id of cs\modules\Blogs\Posts::get() does only seem to accept integer[]|integer, maybe add an additional type check?

		if (!$post) {

The condition $post is always false.

			throw new ExitException(404);
		}
		if ($post['user'] != $User->id && !static::is_blogs_admin()) {
			throw new ExitException(403);
		}
		$Page->title(
			$L->editing_of_post($post['title'])
		);
		$Page->content(
			h::cs_blogs_add_edit_post(
				[
					'id' => $post['id']
				]
			)
		);
	}
	/**
	 * @param \cs\Request $Request
	 */
	public static function drafts ($Request) {
		if (!Event::instance()->fire('Blogs/drafts')) {
			return;
		}
		$Config = Config::instance();
		$L      = new Prefix('blogs_');
		$Page   = Page::instance();
		$Posts  = Posts::instance();
		$User   = User::instance();
		$Page->title($L->drafts);

The property drafts does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		/**
		 * Determine current page
		 */
		$page = static::get_page_and_set_title($Request, $Page, $L);
		/**
		 * Get posts for current page in JSON-LD structure format
		 */
		$posts_per_page = $Config->module('Blogs')->posts_per_page;

The property posts_per_page does not exist on cs\Config\Module_Properties. Since you implemented __get, consider adding a @property annotation.

		$posts          = $Posts->get_drafts($User->id, $page, $posts_per_page);

It seems like $posts_per_page can also be of type false; however, parameter $count of cs\modules\Blogs\Posts::get_drafts() does only seem to accept integer, maybe add an additional type check?

		$posts_count    = $Posts->get_drafts_count($User->id);
		/**
		 * Base url (without page number)
		 */
		$base_url = $Config->base_url().'/'.path($L->Blogs).'/'.path($L->drafts);

The property Blogs does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		/**
		 * Render posts page
		 */
		Helpers::show_posts_list(
			$posts,
			$posts_count,
			$page,
			$base_url
		);
	}
	/**
	 * @param \cs\Request  $Request
	 * @param \cs\Response $Response
	 *
	 * @throws ExitException
	 */
	public static function atom_xml ($Request, $Response) {
		$Config   = Config::instance();
		$L        = new Prefix('blogs_');
		$Page     = Page::instance();
		$User     = User::instance();
		$title    = [
			$Config->core['site_name'],
			$L->Blogs

The property Blogs does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		];
		$Posts    = Posts::instance();
		$Sections = Sections::instance();
		$Tags     = Tags::instance();
		$number   = $Config->module('Blogs')->posts_per_page;

The property posts_per_page does not exist on cs\Config\Module_Properties. Since you implemented __get, consider adding a @property annotation.

		$section  = $Request->query('section');

'section' of type string is incompatible with the type array<mixed,string[]>|string[] expected by parameter $name of cs\Request::query().

		$tag      = $Request->query('tag');
		if ($section) {
			$section = $Sections->get($section);
			if (!$section) {
				throw new ExitException(404);
			}
			$title[] = $L->section;

The property section does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

			$title[] = $section['title'];
			$posts   = $Posts->get_for_section($section['id'], 1, $number);

It seems like $number can also be of type false; however, parameter $count of cs\modules\Blogs\Posts::get_for_section() does only seem to accept integer, maybe add an additional type check?

		} elseif ($tag) {
			$tag = $Tags->get($tag);
			if (!$tag) {
				throw new ExitException(404);
			}
			$title[] = $L->tag;

The property tag does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

			$title[] = $tag['text'];
			$posts   = $Posts->get_for_tag($tag['id'], 1, $number);

It seems like $number can also be of type false; however, parameter $count of cs\modules\Blogs\Posts::get_for_tag() does only seem to accept integer, maybe add an additional type check?

		} else {
			$posts = $Posts->get_latest_posts(1, $number);

It seems like $number can also be of type false; however, parameter $count of cs\modules\Blogs\Posts::get_latest_posts() does only seem to accept integer, maybe add an additional type check?

		}
		$title[]  = $L->latest_posts;

The property latest_posts does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

		$title    = implode($Config->core['title_delimiter'], $title);
		$base_url = $Config->base_url();
		$Response->header('content-type', 'application/atom+xml');
		$Page->interface = false;

		$url = $Config->core_url().$Request->uri;
		$Page->content(
			"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n".
			h::feed(

The method feed() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

				h::title($title).

The method title() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

				h::id($url).

The method id() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

				str_replace(
					'>',
					'/>',
					h::link(

The method link() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

						[
							'href' => $url,
							'rel'  => 'self'
						]
					)
				).
				h::updated(date('c')).

The method updated() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

				'<icon>'.static::get_favicon_path($Config->core['theme'])."</icon>\n".
				h::entry(

The method entry() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

					array_map(
						function ($post) use ($Posts, $Sections, $User, $base_url) {
							$post = $Posts->get($post);
							return
								h::title($post['title']).
								h::id("$base_url/Blogs/:$post[id]").
								h::updated(date('c', $post['date'])).
								h::published(date('c', $post['date'])).

The method published() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

								str_replace(
									'>',
									'/>',
									h::link(
										[
											'href' => "$base_url/Blogs/:$post[id]"
										]
									)
								).
								h::{'author name'}($User->username($post['user'])).
								h::category(

The method category() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

									$post['sections'] == ['0'] ? false : array_map(
										function ($category) {
											return [
												'term'  => $category['title'],
												'label' => $category['title']
											];
										},
										$Sections->get($post['sections'])

It seems like $Sections->get($post['sections']) can also be of type false; however, parameter $arr1 of array_map() does only seem to accept array, maybe add an additional type check?

									)
								).
								h::summary(

The method summary() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

									htmlentities($post['short_content']),
									[
										'type' => 'html'
									]
								).
								h::content(

The method content() does not exist on h. Since you implemented __callStatic, consider adding a @method annotation.

									htmlentities($post['content']),
									[
										'type' => 'html'
									]
								);
						},
						$posts ?: []
					)
				),
				[
					'xmlns'    => 'http://www.w3.org/2005/Atom',
					'xml:lang' => $L->clang,

The property clang does not exist on cs\Language\Prefix. Since you implemented __get, consider adding a @property annotation.

					'xml:base' => "$base_url/"
				]
			)
		);
	}
	/**
	 * @param string $theme
	 *
	 * @return string
	 */
	protected static function get_favicon_path ($theme) {
		$file = file_exists_with_extension(THEMES."/$theme/img/favicon", ['png', 'ico']);
		if ($file) {
			return str_replace(THEMES, 'themes', $file);
		}
		return str_replace(DIR.'/', '', file_exists_with_extension(DIR.'/favicon', ['png', 'ico']));
	}
}