PHPackages                             amm/symfony-dynamic-datatable-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. amm/symfony-dynamic-datatable-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

amm/symfony-dynamic-datatable-bundle
====================================

Easily build lazy-loading DataTables

063PHP

Since Aug 21Pushed 5y ago1 watchersCompare

[ Source](https://github.com/agencemacmedia/SymfonyDynamicDataTableBundle)[ Packagist](https://packagist.org/packages/amm/symfony-dynamic-datatable-bundle)[ RSS](/packages/amm-symfony-dynamic-datatable-bundle/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Getting Started With DynamicDataTableBundle
===========================================

[](#getting-started-with-dynamicdatatablebundle)

### Prerequisites

[](#prerequisites)

This bundle has been developped and tested in Symfony 3.4 and using PHP 7.1.33

### Installation

[](#installation)

1. Add the bundle to your required composer libraries with the command : ```
    composer require amm/symfony-dynamic-datatable-bundle

    ```
2. Include the bundle into your AppKernel. Ex: ```
    class AppKernel extends Kernel
    {
    public function registerBundles()
    {
        $bundles = [
            // ...
            new \AMM\SymfonyDynamicDataTableBundle\AMMSymfonyDynamicDataTableBundle(),
            // ...
        ];
        ... rest of your AppKernel
    ```
3. Load the assets into your web file with the command : ```
    symfony assets:install web --symlink

    ```

Using DynamicDataTableBundle
============================

[](#using-dynamicdatatablebundle)

### Make your Twig view containing your DataTable

[](#make-your-twig-view-containing-your-datatable)

First of all you need to have a basic table that is assigned a unique id.

Ex:

```

        Title
        Author
        Date
        Published

        Title
        Author
        Date
        Published

```

It should include all the needed libraries such as :

- (Basic) Jquery, DataTable (JS) , DataTable (CSS)
- **(Needed) configDynamicDataTables.js**

You'll also need a script that:

- Initialise a variable with the Url for the controller that fetches the data
- Initialise the DataTable into a variable
- Calls the config function, either the single or the multi searchBar one:
    - **For a single searchbar : configDataTableSingleSearch**
    - **For a multi searchbar : configDataTableMultiSearch**

Here is the needed parameters for these functions:

- **Single Search** : the only **required** parameter is the table created just before.
- **Multi Search** for the multi search you'll need an array of parameters:
    - **Table** : the only **required** parameter is the table created just before.
    - Dropdowns : this parameter is an associative array with the **name** of the column and an array of the values , the ones that are going to be the options.
    - Classes : the classes parameter is an assosiative array of two main categories specific and global:
        - Specific : is an associative array with the key being either the name of the column or it's index defined in the columnDefs section of the datatable with an array of the class(es)
        - Global : is an associative array with the key being 'all' and an array of the class(es) **these classes will be applied to all the inputs**

The data for the dropdown's option will come from your controller so you need to get the data from it and put in a variable accessible in the javascript configuration file. Ex:

```
#Controller part
public function indexAction()
{
    $valuesDD = [
        "author"=>["Simon","fx","dom"]
    ];
    return $this->render('OCPlatformBundle:Advert:datatable.html.twig', ["dropdowns"=>$valuesDD]);
}
```

```
#in the script before initializing the datatable
var dropdowns = JSON.parse('{{ dropdowns|json_encode|raw }}');
```

Exemple on how to use the parameters:

```
configDataTableMultiSearch({
        "table": table,
        "dropdowns": dropdowns,
        "classes": {
            "specific": {
                "author": ["testAuthor"],
                2: ["testDate"]
            },
            "global": {
                "all": ["testAll1", "testAll2"],
                "dropdown": ["testDropdown"]
            }
        }
    }
);
```

Exemple of how the whole script should look like:

```

    var dropdowns = JSON.parse('{{ dropdowns|json_encode|raw }}');
    var datatableurl = "{{ path('get_advert_datatables') }}";

    $(document).ready(function () {

        var table = $('#YourId_dt_table').DataTable({
            "columnDefs":[
    			{"name": "title", "targets": 0},        # Here set all the columns
    			{"name": "author", "targets": 1},       # that are in the DataTable
    			{"name": "date", "targets": 2},		# With an index that represents
    			{"name": "published", "targets": 3}     # the column's position.
    			],
    			"paging": true,
    			"info": true,
    			"searching": true,
    			"responsive": true,
    			"pageLength": 10,
    			"bProcessing": true,
    			"bServerSide": true,
    			"sAjaxSource": {
    				"url": datatableurl,
    				"type": "POST"
    			},
    			"fnServerData": fnDataTablesPipeline,
    			"order": [[0, 'asc']],
    			initComplete: function () {
                     configDataTableSingleSearch(table);	# Config function (Multi or Single Search)
                 });                                        # in the initComplete function of the DataTable
    		});
	});

```

In this exemple the script is in the same file has the basic table but you can feel free to have a separate script for it.

### Make your view twig that applies your format

[](#make-your-view-twig-that-applies-your-format)

It is a simple view that goes through all the data applying your html/css format to each columns data.

Ex:

```
{% spaceless %}
    {% set output=[] %}

    {% for key, data in input %}

        {% set obj = [] %}

        {% for key, property in properties %}

            {% if property == 'title' %}		# Only need to adapt the if else
							# to the current DataTable's content.
                {% set obj = obj|merge([('
                                                # Html/Css formating can be applied
                    %s	# here , %s represents where the data
						# will appear.
                ')|format(data.title)
                ]) %}

            {% elseif property == 'author' %}
                {% set obj = obj|merge([('
                    %s
                ')|format(data.author)
                ]) %}

            {% elseif property == 'date' %}
                {% set obj = obj|merge([('
                        %s
                ')|format(data.date|date("Y-m-d H:i:s"))
                ]) %}

            {% elseif property == 'published' %}
                {% set obj = obj|merge([('
                    %s
                ')|format(data.published)
                ]) %}

            {% endif %}

        {% endfor %}

        {% set output = output|merge([obj]) %}

    {% endfor %}
    {{ output|json_encode|raw }}
{% endspaceless %}
```

### Make your controller

[](#make-your-controller)

The only two controller functions that you need are :

- One to load your view and if you're using dropdowns initialize the dropdowns data.
- One that will fetch and return the data requested by the DataTable.
    - It is also possible to add parameters to the query before the final render

The last function needs to create a BuildDataService service **and set his parameters**.

**Here are the parameters that are required by the service :**

- The class of the object you're using (in this case Advert::class)
- The path to the twig view that formats the data (the second view we created).For this twig view we recommend having a public variable in your Class that references the path Ex: ```
    const DATATABLE_Edit = 'YourNameSpace:Advert/DATATABLE_TEMPLATES:dataFormating.html.twig';
    ```
- The columns currently in your datatable, you can get them directly from the request

Heres how your two functions should look like in the end :

```
    public function indexAction()
    {
        return $this->render('TestBundle:Default:index.html.twig');
    }

    public function getAdvertDataTableAction(Request $request)
    {

        $serviceDT = $this->get("amm_symfony_dynamic_data_table.builddataservice");

        $serviceDT->set(Advert::class,Advert::DATATABLE_Edit,$request->request->get("sColumns"));

	$query = $serviceDT->getBasicQuery($request);

	// ...

	# Modify the query here

	// ...

        $returnResponse = new JsonResponse();

        $returnResponse->setJson($serviceDT->renderData($query));	# here the json of the response
									# is directly the return of
        return $returnResponse;						# the service
    }
```

You can send the response you get from the service back directly to the DataTable.

And that's pretty much all for the controller part and how to use the Bundle!

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/66137513?v=4)[agencemacmedia](/maintainers/agencemacmedia)[@agencemacmedia](https://github.com/agencemacmedia)

---

Top Contributors

[![agencemacmedia](https://avatars.githubusercontent.com/u/66137513?v=4)](https://github.com/agencemacmedia "agencemacmedia (12 commits)")

### Embed Badge

![Health badge](/badges/amm-symfony-dynamic-datatable-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/amm-symfony-dynamic-datatable-bundle/health.svg)](https://phpackages.com/packages/amm-symfony-dynamic-datatable-bundle)
```

###  Alternatives

[yurunsoft/chinese-util

PHP 中文工具包，支持汉字转拼音、拼音分词、简繁互转、数字转换、金额数字转换。

511109.2k3](/packages/yurunsoft-chinese-util)[bnomei/autoloader-for-kirby

Helper to automatically load various Kirby extensions in a plugin

185.7k2](/packages/bnomei-autoloader-for-kirby)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)