PHPackages                             se7enxweb/explayouts-content-browser-core - 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. se7enxweb/explayouts-content-browser-core

ActiveEzpublish-legacy-extension

se7enxweb/explayouts-content-browser-core
=========================================

Content browser core backend services for Exponential Layouts on Exponential Legacy / Exponential 6.

10PHP

Since Jul 31Pushed yesterdayCompare

[ Source](https://github.com/se7enxweb/explayouts_content_browser_core)[ Packagist](https://packagist.org/packages/se7enxweb/explayouts-content-browser-core)[ RSS](/packages/se7enxweb-explayouts-content-browser-core/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Exponential Layouts Content Browser Core
========================================

[](#exponential-layouts-content-browser-core)

General description
-------------------

[](#general-description)

Exponential Layouts Content Browser Core (`explayouts_content_browser_core`) provides the content browser core backend services for Exponential Layouts on Exponential Legacy / Exponential 6. It ships a backend class that lists direct children of a location, searches a subtree and loads single items, with optional content class filtering — the layer that the content browser UI talks to.

This extension is an Exponential Legacy port inspired by `netgen/content-browser` (the backend layer of the content browser stack). It depends on `explayouts_content_browser` because it returns `expLayoutsContentBrowserItem` objects, and it provides the following capabilities:

- Location child listing - Use this feature to list the direct (depth 1) children of any location as normalized items, sorted by name.
- Subtree search - Use this feature to search a subtree with multi-term, case-insensitive matching against node names, class identifiers and class names.
- Content class filtering - Use this feature to restrict which content classes are listed and selectable via a constructor argument.
- Single item loading - Use this feature to load one node as a normalized item, guarded by a selectable-class check.

Features
--------

[](#features)

The following features are provided by the Exponential Layouts Content Browser Core extension:

- A single, focused backend class, `expLayoutsContentBrowserCoreBackend`, constructed with two optional arguments:
    - `allowedContentTypes` — content class identifiers that are listed and selectable; with an empty list, every content class is selectable and no class filter is applied.
    - `locationContentTypes` — class identifiers treated as locations (reserved for expandable-location detection in tree UIs; accepted and stored, currently unused).
- Real tree-browser stepping: `getSubItems( $locationNodeId, $offset = 0, $limit = 25 )` returns the direct child nodes (depth 1) of a location as `expLayoutsContentBrowserItem[]`, sorted by name and filtered by the allowed content classes, with `getSubItemsCount( $locationNodeId )`returning the matching child count.
- Multi-term subtree search: `searchItems( $searchText, $locationNodeId = 0, $offset = 0, $limit = 25 )` searches the subtree under a location (up to depth 10, at most 1000 fetched nodes; falls back to the tree root when no location is given). Every whitespace-separated term must match the node name, class identifier or class name as a case-insensitive substring.
- `searchItemsCount( $searchText, $locationNodeId = 0 )` for counting search results (re-runs the search without a page limit — cache the value if you call it repeatedly in one request).
- Guarded item loading: `loadItem( $nodeId )` loads a single node as an `expLayoutsContentBrowserItem` only if it exists and passes the selectable-class check, and returns `false` otherwise.
- Designed-for-subclassing internals — the behaviour lives in `protected`hook methods so integrators can extend without forking:
    - `buildItem( eZContentObjectTreeNode $node )` — return a richer/custom item object for every result.
    - `nodeMatchesSearch( $node, $searchText )` — change the matching rules (e.g. include attribute values).
    - `isSelectable( $node )` — add permission or state checks to `loadItem()`.
    - `applyAllowedContentTypes( &$params )` — change how the class filter is translated to fetch parameters.
- Works everywhere the bootstrap is available: module views, JSON endpoints, layout block handlers and CLI scripts.

Version
-------

[](#version)

- The current version of Exponential Layouts Content Browser Core is 1.0.0
- Last Major update: July 30, 2026

Copyright
---------

[](#copyright)

- Exponential Layouts Content Browser Core is copyright 1998 - 2026 7x
- See: [LICENSE.md](LICENSE.md) for more information on the terms of the copyright and license

License
-------

[](#license)

Exponential Layouts Content Browser Core is licensed under the GNU General Public License.

The complete license agreement is included in the [LICENSE.md](LICENSE.md)file.

Exponential Layouts Content Browser Core is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or at your option a later version.

Exponential Layouts Content Browser Core is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The GNU GPL gives you the right to use, modify and redistribute Exponential Layouts Content Browser Core under certain conditions. The GNU GPL license is distributed with the software, see the file [LICENSE.md](LICENSE.md).

It is also available at

You should have received a copy of the GNU General Public License along with Exponential Layouts Content Browser Core in [LICENSE.md](LICENSE.md). If not, see .

Using Exponential Layouts Content Browser Core under the terms of the GNU GPL is free (as in freedom).

For more information or questions please contact

Requirements
------------

[](#requirements)

The following requirements exist for using the Exponential Layouts Content Browser Core extension:

Exponential version

- Make sure you use Exponential 6 / Exponential Legacy.

PHP version

- Make sure you have PHP 8.1, 8.2, 8.3 or 8.4.

Extension dependencies

- `explayouts_content_browser` — provides the `expLayoutsContentBrowserItem`value object returned by the backend. Activate it first.

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

[](#installation)

Installation is the standard extension procedure: place the extension in `extension/explayouts_content_browser_core`, activate it after its dependency via `ActiveExtensions[]` (or `ActiveAccessExtensions[]` for a single siteaccess), regenerate autoloads with `php bin/php/ezpgenerateautoloads.php -e` and clear caches with `php bin/php/ezcache.php --clear-all --purge --allow-root-user`.

See [INSTALL.md](INSTALL.md) for the complete step-by-step installation instructions.

Usage
-----

[](#usage)

The extension ships one key class:

ClassFilePurpose`expLayoutsContentBrowserCoreBackend``classes/explayoutscontentbrowsercorebackend.php`Child listing, subtree search and single-item loading with class filtersA quick example:

```
