PHPackages                             terminal42/contao-tablelookupwizard - 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. terminal42/contao-tablelookupwizard

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

terminal42/contao-tablelookupwizard
===================================

Contao widget to select records from a foreign table. Useful if you have a large set of records.

5.0.0(2mo ago)678.6k↓27.4%63MITPHPPHP ^8.3CI passing

Since Jan 18Pushed 2mo ago5 watchersCompare

[ Source](https://github.com/terminal42/contao-tablelookupwizard)[ Packagist](https://packagist.org/packages/terminal42/contao-tablelookupwizard)[ GitHub Sponsors](https://github.com/terminal42)[ Fund](https://ko-fi.com/terminal42)[ RSS](/packages/terminal42-contao-tablelookupwizard/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (13)Versions (26)Used By (3)Security (1)

tablelookupwizard Contao Extension
==================================

[](#tablelookupwizard-contao-extension)

A backend widget for Contao that allows editors to search and select records from a foreign database table without loading the entire dataset.

It is specifically designed for large datasets where a traditional `select`, `checkboxWizard`, or static select field would be inefficient or unusable.

---

Installation
------------

[](#installation)

Install via Composer:

```
composer require terminal42/contao-tablelookupwizard
```

---

Version Compatibility
---------------------

[](#version-compatibility)

Please choose the appropriate major version based on your Contao version:

- **4.x** → for Contao **5.6 and below**
- **5.x** → for Contao **5.7 and above**

Make sure to select the correct major version to ensure compatibility with your Contao installation.

### Supporting both versions simultaneously

[](#supporting-both-versions-simultaneously)

If your project needs to support both Contao 5.6 and 5.7+, you can allow both major versions using a version union constraint in your `composer.json`:

```
"require": {
    "terminal42/contao-tablelookupwizard": "^4.0 || ^5.0"
}
```

Composer will then automatically install:

- `4.x` when the project uses Contao ≤ 5.6
- `5.x` when the project uses Contao ≥ 5.7

No code changes are needed on your end — the correct version will be resolved based on the Contao version constraint in your own `composer.json`.

If you want to support both 4.x and 5.x simultaneously with a custom template, you need to set `customTpl` dynamically at runtime rather than statically in the DCA, since the template name changed between versions. For example, you can use an [attributes callback](https://docs.contao.org/5.x/dev/reference/dca/callbacks/#fields-field-attributes)to detect the installed version and return the correct template name:

```