Listable

This Neos package solves one problem: help you list any nodes in TypoScript. The idea is very simple: you often need to display list of things (e.g. news, articles etc), and the concern of listing items should better be separated from the concern of rendering items. This packages provides a solid foundation for listing, while allowing you to take care of rendering stuff on your own.

TL;DR

1. Install the package with composer. Here it is on packagist.
2. Add Flowpack.Listable:ListableMixin to nodetypes that you want to list.
3. Build your list based on Flowpack.Listable:Listable for simple list or on Flowpack.Listable:List for list with a header and an archive link.
4. For each of your nodetypes create a new TS object of type NodeTypeName + 'Short', or manually definy a rendering object.
5. Rely on public API keys when overriding settings.

See here for a trivial integration example.

If you don't need the package, but love TypoScript, look here, you may find some inspiration :)

Nodetype mixins

On data level we provide only one mixin: Flowpack.Listable:ListableMixin. The only thing you have to do, is to add this mixin to nodetypes that you would want to list with this package. That's right, planing all other fields is completely up to you.

TypoScript objects

Keys documented here are considered public API and would be treated with semantic versioning in mind. Extend all other properties at your own risk.

Flowpack.Listable:Listable

At the heart of this package is a Flowpack.Listable:Listable object. It provides some good defaults for rendering lists of things, and is pretty extensible too. Here are TypoScript context variables that you can configure for this object:

You may also override collection key with custom query. Sorting and pagination would still apply (via @process). Here's an example that lists first 10 objects of type Something.Custom:Here.

prototype(My.Custom:Object) < prototype(Flowpack.Listable:Listable) {
  @context.limit = 10
  collection = ${q(site).find('[instanceof Something.Custom:Here]').get()}
}

Flowpack.Listable:List

There's often a need to render a list with a header an a archive link. This object takes Flowpack.Listable:Listable and wraps it with just that.

This is just a helper object, and in many cases you would not want to use it, but use Flowpack.Listable:Listable directly.

Configuring pagination

Besides enabling pagination in TS object, you must not forget about adding pagination entryIdentifier to all parent cache objects, e.g. like this:

prototype(TYPO3.Neos:Page).@cache.entryIdentifier.pagination = ${request.pluginArguments.listable-paginate.currentPage}
root.@cache.entryIdentifier.pagination = ${request.pluginArguments.listable-paginate.currentPage}

To make urls pretty, see Routes.yaml.

Helper FlowQueries you can use

filterByDate

Filter nodes by properties of type date

filterByReference

Filter nodes by properties of type reference or references

sort

Sort nodes by any property

Example:

${q(site).find('[instanceof TYPO3.Neos:Document]').sort('title', ['ASC'|'DESC']).get()}

sortRecursiveByIndex

Sort nodes recursively by their sorting property.

Example:

${q(site).find('[instanceof TYPO3.Neos:Document]').sortRecursiveByIndex(['ASC'|'DESC']).get()}