Create Page List
Advanced filtering

Using Operators OR or AND

For now, you can only use OR or AND operator in the same query

Examples :

• ✔ related:comment:blog OR related
• ✔ parent_children OR related OR page:custom-slug
• ✔ parent_children AND related AND page:custom-slug (this one will output only 1 result)
• ✗ parent_children AND related OR page:custom-slug (this one will output only 1 result)
• ✗ (parent_children AND related) OR page:custom-slug (this one will output only 1 result)

Exclude Already Linked Pages

When your page content contains links to other pages, you can exclude those pages from your listings to avoid duplicates. Add the excludeAlreadyLinked: true parameter:

{{ pages_list('taxonomy:travel', 6, excludeAlreadyLinked: true) }}

Or use the exclude_linked() function with pages():

{% set uniquePages = exclude_linked(pages(host, 'taxonomy:travel')) %}

See the Link Collector documentation for detailed usage, examples, and the full API reference.

Extending Search with an Event Listener

Before the search string is parsed into DQL criteria, Pushword dispatches a PagesListSearchEvent. A listener can inspect or rewrite the string — useful for expanding application-specific prefixes into standard Pushword ones.

Event: Pushword\Core\Event\PagesListSearchEvent
Constant: PushwordEvents::PAGES_LIST_SEARCH (pushword.pages_list.before_search)
Dispatched by: pages_list() and pages() Twig functions

use Pushword\Core\Event\PagesListSearchEvent;
use Symfony\Component\EventDispatcher\Attribute\AsEventListener;

#[AsEventListener(event: PagesListSearchEvent::NAME)]
final readonly class ProductSearchListener
{
    public function __invoke(PagesListSearchEvent $event): void
    {
        $search = $event->getSearch();
        // e.g. expand "product:NLDLV0019" into "customProperty:productCode:NLDLV0019"
        if (str_starts_with($search, 'product:')) {
            $event->setSearch('customProperty:productCode:' . substr($search, 8));
        }
    }
}

The listener receives the raw search string before any prefix parsing. Call setSearch() to replace it; leave it unchanged to pass through as-is. getCurrentPage() provides the current page context if needed.