GenericContentListing.php

Go to the documentation of this file.

<?php
 
namespace Elgg\Controllers;
 
use Elgg\Exceptions\Http\BadRequestException;
use Elgg\Exceptions\Http\Gatekeeper\GroupToolGatekeeperException;
use Elgg\Exceptions\Http\ValidationException;
 
class GenericContentListing {
    
    protected ?\Elgg\Request $request = null;
    
    protected ?\Elgg\Router\Route $route = null;
    
    protected ?\ElggEntity $page_owner = null;
    
    final public function __invoke(\Elgg\Request $request): \Elgg\Http\Response {
        $this->request = $request;
        $this->route = $request->getHttpRequest()?->getRoute();
        $this->page_owner = $this->route?->resolvePageOwner();
        
        $route_name = $request->getRoute();
        $parsed_route = $this->parseRoute($route_name);
        
        elgg_register_title_button('add', $parsed_route['type'], $parsed_route['subtype']);
        
        $options = $this->getListingOptions($parsed_route['page'], [
            'type' => $parsed_route['type'],
            'subtype' => $parsed_route['subtype'],
        ]);
        
        $listing_function = 'list' . str_replace(' ', '', ucwords(str_replace(['_', '-'], ' ', $parsed_route['page'])));
        if (!is_callable([$this, $listing_function])) {
            throw new ValidationException('Unsupported route name configuration');
        }
        
        return elgg_ok_response($this->{$listing_function}($options));
    }
    
    final protected function parseRoute(string $route_name): array {
        $name_parts = explode(':', $route_name);
        if (count($name_parts) < 3) {
            throw new ValidationException('Unsupported route name configuration');
        }
        
        if (!in_array($name_parts[0], ['default', 'collection'])) {
            throw new ValidationException('Unsupported route name configuration');
        }
        
        return [
            'type' => $name_parts[1],
            'subtype' => $name_parts[2],
            'page' => $name_parts[3] ?? 'all',
        ];
    }
    
    protected function getGroupToolOption(): ?string {
        return $this->route?->getOption('group_tool');
    }
    
    protected function getListingOptions(string $page, array $options): array {
        return $options;
    }
    
    protected function getPageOptions(string $page, array $options): array {
        $sidebar_view = $this->route?->getOption('sidebar_view');
        if (!empty($sidebar_view) && elgg_view_exists($sidebar_view)) {
            $options['sidebar'] = elgg_view($sidebar_view, [
                'page' => $page,
                'entity' => $this->page_owner,
            ]);
        }
        
        return $options;
    }
    
    protected function listAll(array $options): string {
        elgg_push_collection_breadcrumbs($options['type'], $options['subtype']);
        
        return elgg_view_page('', $this->getPageOptions('all', [
            'title' => elgg_echo("collection:{$options['type']}:{$options['subtype']}:all"),
            'content' => elgg_view('page/list/all', [
                'options' => $options,
                'page' => 'all',
            ]),
            'filter_value' => 'all',
        ]));
    }
    
    protected function listFriends(array $options): string {
        if (!$this->page_owner instanceof \ElggUser) {
            throw new BadRequestException();
        }
        
        elgg_push_collection_breadcrumbs($options['type'], $options['subtype'], $this->page_owner, true);
        
        $friends_options = [
            'relationship' => 'friend',
            'relationship_guid' => $this->page_owner->guid,
            'relationship_join_on' => 'owner_guid',
        ];
        
        return elgg_view_page('', $this->getPageOptions('friends', [
            'title' => elgg_echo("collection:{$options['type']}:{$options['subtype']}:friends"),
            'content' => elgg_view('page/list/all', [
                'entity' => $this->page_owner,
                'options' => array_merge($options, $friends_options),
                'page' => 'friends',
            ]),
            'filter_value' => $this->page_owner?->guid === elgg_get_logged_in_user_guid() ? 'friends' : 'none',
        ]));
    }
    
    protected function listGroup(array $options): string {
        if (!$this->page_owner instanceof \ElggGroup) {
            throw new BadRequestException();
        }
        
        $group_tool = $this->getGroupToolOption();
        if (isset($group_tool)) {
            elgg_group_tool_gatekeeper($group_tool);
        }
        
        elgg_push_collection_breadcrumbs($options['type'], $options['subtype'], $this->page_owner);
        
        $group_options = [
            'container_guid' => $this->page_owner->guid,
            'preload_containers' => false,
        ];
        
        return elgg_view_page('', $this->getPageOptions('group', [
            'title' => elgg_echo("collection:{$options['type']}:{$options['subtype']}:group"),
            'content' => elgg_view('page/list/all', [
                'entity' => $this->page_owner,
                'options' => array_merge($options, $group_options),
                'page' => 'group',
            ]),
            'filter_id' => "{$options['subtype']}/group",
            'filter_value' => 'all',
        ]));
    }
    
    protected function listOwner(array $options): string {
        if (!$this->page_owner instanceof \ElggUser) {
            throw new BadRequestException();
        }
        
        elgg_push_collection_breadcrumbs($options['type'], $options['subtype'], $this->page_owner);
        
        $owner_options = [
            'owner_guid' => $this->page_owner->guid,
            'preload_owners' => false,
        ];
        
        return elgg_view_page('', $this->getPageOptions('owner', [
            'title' => elgg_echo("collection:{$options['type']}:{$options['subtype']}:owner", [$this->page_owner->getDisplayName()]),
            'content' => elgg_view('page/list/all', [
                'entity' => $this->page_owner,
                'options' => array_merge($options, $owner_options),
                'page' => 'owner',
            ]),
            'filter_value' => $this->page_owner->guid === elgg_get_logged_in_user_guid() ? 'mine' : 'none',
        ]));
    }
}