Documentation improvements

CHANGES.rst

@@ -4,13 +4,17 @@ Changelog
 3.4.3 (unreleased)
 ------------------
 
-- Use collection from context as default. `target_collection` is now used to select an alternative collection as result source. 
+- Use collection from context as default. `target_collection` is now used to select an alternative collection as result source.
   This allows to copy and paste preconfigured collections for reuse without reconfiguring each filter element.
   [agitator]
 
 - Fix search which include the terms "and", "or" and "not"
   [jeffersonbledsoe]
 
+- Update ``plone.app.mosaic`` integration documentation with the
+  new ``Contentlisting tile`` feature (this needs ``plone.app.standardtiles`` >= 2.3.3)
+  [petschki]
+
 
 3.4.2 (2021-02-25)
 ------------------

README.rst

@@ -49,13 +49,19 @@ source collection template and on the target page which shows the filtered resul
 Mosaic Integration
 ------------------
 
-The three tiles can be added within the Mosaic editor multiple times. Just select them in the ``Insert`` menu
-and assign a collection to it. To show the results of the collection simply add a
-``Existing Content`` tile which links to the same collection your filter tiles are assigned with.
+If ``plone.app.mosaic`` is installed you can enable the ``collective.collectionfilter tiles`` profile
+in the addon controlpanel.
 
-TODO: right now the collection needs a default_view template, which wraps the result list with a unique selector
-inside the ``#content-core`` container. so the collectionfilter can load the filtered result correctly from
-the collection into the container inside the existing content tile.
+The filter tiles can be added within the Mosaic editor multiple times. Just select them in the ``Insert`` menu
+and assign a collection to it.
+
+As a second step you have to add a ``ContentListing`` tile which shows the search result initially.
+If you are enable Mosaic on a ISyndicatableCollection context you can use the query from it.
+
+*Important*:
+
+    Make shure you add a unique *tile CSS class* and use this class as ``Content CSS Selector``
+    in your filter tiles so that AJAX reload works correctly for the result listing.
 
 
 Geolocation filter support

requirements.txt

@@ -0,0 +1 @@
+-r https://raw.githubusercontent.com/plone/buildout.coredev/5.2/requirements.txt

test-5.0.x.cfg

@@ -1,4 +1,7 @@
 [buildout]
+eggs-directory = ${buildout:directory}/eggs
+download-cache = ${buildout:directory}/downloads
+
 extends =
     https://raw.githubusercontent.com/collective/buildout.plonetest/master/test-5.0.x.cfg
     https://raw.githubusercontent.com/collective/buildout.plonetest/master/qa.cfg
@@ -18,9 +21,10 @@ test-eggs =
 flake8-ignore = E501,E241
 
 [versions]
-setuptools =
 zc.buildout =
+setuptools =
 pycodestyle =
+lxml =
 configparser = 3.8.1
 coverage = >=3.7
 

test-5.1.x.cfg

@@ -18,8 +18,8 @@ test-eggs =
 flake8-ignore = E501,E241
 
 [versions]
-setuptools =
 zc.buildout =
+setuptools =
 configparser = 3.8.1
 coverage = >=3.7
 

test-5.2.x.cfg

@@ -17,7 +17,7 @@ test-eggs =
 flake8-ignore = E501,E241
 
 [versions]
-#setuptools =
-#zc.buildout =
+zc.buildout =
+setuptools =
 coverage = >=3.7