68 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			PHP
		
	
	
	
			
		
		
	
	
			68 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			PHP
		
	
	
	
<?php
 | 
						|
 | 
						|
namespace BookStack\References;
 | 
						|
 | 
						|
use BookStack\Auth\Permissions\PermissionApplicator;
 | 
						|
use BookStack\Entities\Models\Entity;
 | 
						|
use BookStack\Entities\Models\Page;
 | 
						|
use Illuminate\Database\Eloquent\Builder;
 | 
						|
use Illuminate\Database\Eloquent\Collection;
 | 
						|
use Illuminate\Database\Eloquent\Relations\Relation;
 | 
						|
 | 
						|
class ReferenceFetcher
 | 
						|
{
 | 
						|
    protected PermissionApplicator $permissions;
 | 
						|
 | 
						|
    public function __construct(PermissionApplicator $permissions)
 | 
						|
    {
 | 
						|
        $this->permissions = $permissions;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Query and return the page references pointing to the given entity.
 | 
						|
     * Loads the commonly required relations while taking permissions into account.
 | 
						|
     */
 | 
						|
    public function getPageReferencesToEntity(Entity $entity): Collection
 | 
						|
    {
 | 
						|
        $baseQuery = $this->queryPageReferencesToEntity($entity)
 | 
						|
            ->with([
 | 
						|
                'from'         => fn (Relation $query) => $query->select(Page::$listAttributes),
 | 
						|
                'from.book'    => fn (Relation $query) => $query->scopes('visible'),
 | 
						|
                'from.chapter' => fn (Relation $query) => $query->scopes('visible'),
 | 
						|
            ]);
 | 
						|
 | 
						|
        $references = $this->permissions->restrictEntityRelationQuery(
 | 
						|
            $baseQuery,
 | 
						|
            'references',
 | 
						|
            'from_id',
 | 
						|
            'from_type'
 | 
						|
        )->get();
 | 
						|
 | 
						|
        return $references;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Returns the count of page references pointing to the given entity.
 | 
						|
     * Takes permissions into account.
 | 
						|
     */
 | 
						|
    public function getPageReferenceCountToEntity(Entity $entity): int
 | 
						|
    {
 | 
						|
        $count = $this->permissions->restrictEntityRelationQuery(
 | 
						|
            $this->queryPageReferencesToEntity($entity),
 | 
						|
            'references',
 | 
						|
            'from_id',
 | 
						|
            'from_type'
 | 
						|
        )->count();
 | 
						|
 | 
						|
        return $count;
 | 
						|
    }
 | 
						|
 | 
						|
    protected function queryPageReferencesToEntity(Entity $entity): Builder
 | 
						|
    {
 | 
						|
        return Reference::query()
 | 
						|
            ->where('to_type', '=', $entity->getMorphClass())
 | 
						|
            ->where('to_id', '=', $entity->id)
 | 
						|
            ->where('from_type', '=', (new Page())->getMorphClass());
 | 
						|
    }
 | 
						|
}
 |