{ "info": { "author": "Plone Foundation", "author_email": "plone-developers@lists.sourceforge.net", "bugtrack_url": null, "classifiers": [ "Framework :: Plone", "Framework :: Plone :: 5.0", "Framework :: Plone :: 5.1", "Framework :: Plone :: 5.2", "License :: OSI Approved :: GNU General Public License v2 (GPLv2)", "Programming Language :: Python", "Programming Language :: Python :: 2.7" ], "description": "=============================================================================\nListing and working with Plone content objects using plone.app.contentlisting\n=============================================================================\n\nThis is valid for Plone 4.1 upwards.\n\nMany of the operations for customizations, templates, views and portlets in\nPlone are related to lists of content objects. Their sources can be different,\nalthough usually they are some sort of catalog search, the contents of a\nparticular folder or a list of objects from a relation.\n\nTo make it simpler to work with these, we have made plone.app.contentlisting,\nwhich ensures that lists of content objects always behave in the same way and\naccording to predefined interfaces, regardless of what the source of the\nobjects are. The integrator shouldn't have to care whether the list of objects\ncame from the catalog, an ORM or they are the actual objects.\n\n\nMaking or getting a contentListing\n----------------------------------\n\nThe typical way to get a contentlisting is to call one of two built-in views:\n\n\nListing the contents of a Folder or Collection\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nIn Page templates getting the contents of a folder or the results of a\ncollection is as simple as this::\n\n context/@@contentlisting\n\nEvery template-writer's dream ;)\n\n.. note::\n\n In previous versions there was only support to list the contents of a\n folder with ``context/@@folderListing``. There was no collection support.\n The ``@@folderListing`` view is kept for compatibility, but we encourage\n you to use the ``@@contentlisting`` instead.\n\n\n\nA real example of listing the titles of the content objects of a folder::\n\n