thomasdcodes/list-view-bundle

A lightweight collection of entities for storing data of a listview.

0.7.1 2025-11-09 08:45 UTC

Requires

• php: >=8.3
• symfony/http-foundation: >=7.2.0

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• Thomas Deutschländer

• filter data
• list view data management
• paginator data
• search data
• sort data

README

Description

This Bundle provides an easy-to-use set of different rich models packed into one wrapper ListControl to hold all information for a list view.

Its reason of life is only to hold the information and get richer at runtime of the app. For example, after init ListControl the Paginator in it doesn't know how many search results are found. You have the set the number of search results after querying your repo with the help of SearchTermOrganizer or FilterOrganizer, because the information of these models influence the number of search results.

Install

composer require thomasdcodes/list-view-bundle

If you're using Symfony Flex, the Bundle should be registered in your config/bundles.php

Quick start

With the bundle comes a factory to create the ListControl Model. There is only one static method of creating this model, for example in a controller:

use Tdc\ListViewBundle\Factory;

public function __invoke(Request $request): JsonResponse
{
    $listControl = ListControlFactory::createFromRequest($request);
}

Content

The ListViewBundle contains the following models, which are all part of the container class ListControl:

• FilterOrganizer: Handles the filters from GET Parameter of the Request FilterOrganizer Documentation
• Paginator: A multi-stage process for generating relevant data for pagination Paginator Documentation
• SearchTermOrganizer: Handles the search term from GET Parameter of the Request SearchTermOrganizer Documentation
• SortOrganizer: Handles the sort from GET Parameter of the Request SortOrganizer Documentation