===========================
collective.tiles.discussion
===========================
Tile for showing most recent discussion items.
Features
--------
- "Latest comments" tile with several fields to determine which discussion items to show.
Inspiration was taken from ``collective.portlet.discussion``.
Installation
------------
Install collective.tiles.discussion by adding it to your buildout::
[buildout]
...
eggs =
collective.tiles.discussion
and then running ``bin/buildout``.
You probably want to add a tile management package as well, for example ``plone.app.mosaic``.
Usage
-----
* Create a Classic UI Plone Site.
* In the Discussion control panel globally enable comments.
* In the Content Settings control panel enable comments on Page, or any content type that you want.
* Add one or more comments.
* Go to the Add-ons control panel.
* Activate ``plone.app.mosaic`` or some other tile management package.
* Activate ``collective.tiles.discussion``.
* Create a page.
* Set its display to ``layout_view`` for Mosaic.
* Edit the page. The layout view should be active now.
* Insert a "Latest comments" tile, configure it, and save the page.
* Now the tile should show a list with the latests comments.
Note that there is also a "Discussions" tile in ``plone.app.standardtiles``.
This shows the comments of the current page, plus an add-form for a new comment.
Filter on review states
-----------------------
In the tile you can filter on review state if you want.
By default Discussion Items have only one state: published. In this case a filter is not needed.
In the Discussion control panel you can enable comment moderation.
This enables a workflow with more states.
Comments start in the pending state, and can be published, rejected, or marked as spam.
Currently, in Plone 6.0.6, without filter, an anonymous user will see Discussion Items from the states published, rejected, and spam.
So you may want to explicitly filter on the published state in the tile, and possibly pending.
Contribute
----------
If you are having issues, or want to contribute a bugfix or feature, please let us know.
- Issue Tracker: https://github.com/collective/collective.tiles.discussion/issues
- Source Code: https://github.com/collective/collective.tiles.discussion
License
-------
The project is licensed under the GPLv2.
Contributors
============
- Maurits van Rees, maurits@vanrees.org
Changelog
=========
1.0.0a1 (2023-08-31)
--------------------
- Initial release.
[mauritsvanrees]
Raw data
{
"_id": null,
"home_page": "https://github.com/collective/collective.tiles.discussion",
"name": "collective.tiles.discussion",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Python Plone CMS",
"author": "Maurits van Rees",
"author_email": "maurits@vanrees.org",
"download_url": "https://files.pythonhosted.org/packages/db/04/794a87de2f5eb0814c9079f1ac2224ab3ba1ed4314ad3616c12ef2baccaa/collective.tiles.discussion-1.0.0a1.tar.gz",
"platform": null,
"description": "===========================\ncollective.tiles.discussion\n===========================\n\nTile for showing most recent discussion items.\n\n\nFeatures\n--------\n\n- \"Latest comments\" tile with several fields to determine which discussion items to show.\n\nInspiration was taken from ``collective.portlet.discussion``.\n\n\nInstallation\n------------\n\nInstall collective.tiles.discussion by adding it to your buildout::\n\n [buildout]\n\n ...\n\n eggs =\n collective.tiles.discussion\n\n\nand then running ``bin/buildout``.\n\nYou probably want to add a tile management package as well, for example ``plone.app.mosaic``.\n\n\nUsage\n-----\n\n* Create a Classic UI Plone Site.\n* In the Discussion control panel globally enable comments.\n* In the Content Settings control panel enable comments on Page, or any content type that you want.\n* Add one or more comments.\n* Go to the Add-ons control panel.\n* Activate ``plone.app.mosaic`` or some other tile management package.\n* Activate ``collective.tiles.discussion``.\n* Create a page.\n* Set its display to ``layout_view`` for Mosaic.\n* Edit the page. The layout view should be active now.\n* Insert a \"Latest comments\" tile, configure it, and save the page.\n* Now the tile should show a list with the latests comments.\n\nNote that there is also a \"Discussions\" tile in ``plone.app.standardtiles``.\nThis shows the comments of the current page, plus an add-form for a new comment.\n\n\nFilter on review states\n-----------------------\n\nIn the tile you can filter on review state if you want.\nBy default Discussion Items have only one state: published. In this case a filter is not needed.\n\nIn the Discussion control panel you can enable comment moderation.\nThis enables a workflow with more states.\nComments start in the pending state, and can be published, rejected, or marked as spam.\n\nCurrently, in Plone 6.0.6, without filter, an anonymous user will see Discussion Items from the states published, rejected, and spam.\nSo you may want to explicitly filter on the published state in the tile, and possibly pending.\n\n\nContribute\n----------\n\nIf you are having issues, or want to contribute a bugfix or feature, please let us know.\n\n- Issue Tracker: https://github.com/collective/collective.tiles.discussion/issues\n- Source Code: https://github.com/collective/collective.tiles.discussion\n\n\nLicense\n-------\n\nThe project is licensed under the GPLv2.\n\n\nContributors\n============\n\n- Maurits van Rees, maurits@vanrees.org\n\n\nChangelog\n=========\n\n\n1.0.0a1 (2023-08-31)\n--------------------\n\n- Initial release.\n [mauritsvanrees]\n",
"bugtrack_url": null,
"license": "GPL version 2",
"summary": "Tile for showing most recent discussion items.",
"version": "1.0.0a1",
"project_urls": {
"Homepage": "https://github.com/collective/collective.tiles.discussion",
"PyPI": "https://pypi.org/project/collective.tiles.discussion/",
"Source": "https://github.com/collective/collective.tiles.discussion",
"Tracker": "https://github.com/collective/collective.tiles.discussion/issues"
},
"split_keywords": [
"python",
"plone",
"cms"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4c60ad6a20adce57cdc7d026297354b30109a804ddfbd3ae6a3fd6adcd2894ca",
"md5": "d116979694391e3e18cc2db9140eac15",
"sha256": "f67ea921711f447edd141df31f97897179bb118d198cdff36fdbbe1e7f86bdf0"
},
"downloads": -1,
"filename": "collective.tiles.discussion-1.0.0a1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d116979694391e3e18cc2db9140eac15",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 27516,
"upload_time": "2023-08-31T17:41:51",
"upload_time_iso_8601": "2023-08-31T17:41:51.540965Z",
"url": "https://files.pythonhosted.org/packages/4c/60/ad6a20adce57cdc7d026297354b30109a804ddfbd3ae6a3fd6adcd2894ca/collective.tiles.discussion-1.0.0a1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "db04794a87de2f5eb0814c9079f1ac2224ab3ba1ed4314ad3616c12ef2baccaa",
"md5": "c537888f0d361eda23a739dcfa801fae",
"sha256": "c67cafc459cac9e3b5f982c7f828a02e6231b2e915ab7ae144939d57add65369"
},
"downloads": -1,
"filename": "collective.tiles.discussion-1.0.0a1.tar.gz",
"has_sig": false,
"md5_digest": "c537888f0d361eda23a739dcfa801fae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 19868,
"upload_time": "2023-08-31T17:41:53",
"upload_time_iso_8601": "2023-08-31T17:41:53.926979Z",
"url": "https://files.pythonhosted.org/packages/db/04/794a87de2f5eb0814c9079f1ac2224ab3ba1ed4314ad3616c12ef2baccaa/collective.tiles.discussion-1.0.0a1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-31 17:41:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "collective",
"github_project": "collective.tiles.discussion",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "collective.tiles.discussion"
}
JSON
