.. This README is meant for consumption by humans and PyPI. PyPI can render rst files so please do not use Sphinx features.
If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html
This text does not appear on PyPI or github. It is a comment.
.. image:: https://github.com/collective/collective.gridlisting/actions/workflows/plone-package.yml/badge.svg
:target: https://github.com/collective/collective.gridlisting/actions/workflows/plone-package.yml
collective.gridlisting
======================
Adds a Behavior to manipulate various listing appearance settings
using Bootstrap 5 (column layout) and patternslib (masonry).
This behavior is automatically enabled for "Folder" and "Collection" when you install it.
Features
--------
- Adds new view template "Grid listing" for "Folder" and "Collection"
- You get a new "Grid listing" tab when editing a Folder or a Collection where
you can set various options for the listing template.
Get started
-----------
1. Install `collective.gridlisting` in the Add-ons controlpanel
2. Go to a folder and select **Grid listing** from the **Display** menu
3. Edit the folder and go to the **Grid listing** tab
4. You can enter CSS classes for the grid items and/or enable **Masonry layout**.
Grid setup
----------
The grid structure is set up as follows:
+--------------------------------+
| Container row |
| |
| +--------------------------+ |
| | Column | |
| | | |
| | +--------------------+ | |
| | | Column content | | |
| | | | | |
| | | +------+-------+ | | |
| | | | text | image | | | |
| | | +------+-------+ | | |
| | +--------------------+ | |
| +--------------------------+ |
+--------------------------------+
You can define css classes for each of those containers.
For example if you simply want a responsive 4/2/1 column layout you can set the ``Container row CSS class`` to:
``row-cols-1 row-cols-lg-2 row-cols-xl-4``
You can also define borders, margins and paddings for the column content with ``Column content CSS Class``:
``border border-primary m-2 p-2``
And you can further experiment with gutters or backgrounds.
Inside the column, the text and image information can be defined separately.
You can for example simply switch the order of text/image with:
``Column content text: col order-2``
``Column content image: col order-1``
or put the image above the text with:
``Column content text: col-12 order-2``
``Column content image: col-12 order-1``
For more information on the CSS definitions see the Bootstrap documentation:
https://getbootstrap.com/docs/5.3/layout/grid/
Special Example: Card listing
-----------------------------
The following values gives you a listing with cards, cell height 100% and image at the top:
- ``Container row``: ``row-cols-3`` (3 columns)
- ``Column``: ``pb-3`` (spacing below card)
- ``Column content``: ``card h-100`` (card outline, 100% cell height)
- ``Column content text``: ``order-2 card-body`` (text below image)
- ``Column content image``: ``order-1 card-img-top`` (image above text)
et voila!
NOTE: If you enable **Masonry layout** you have to remove ``h-100`` from ``Column content``
and you have a masonry card listing like shown here: https://getbootstrap.com/docs/5.3/examples/masonry/
Translations
------------
This product has been translated into
- English
- German
Installation
------------
Install collective.gridlisting by adding it to your buildout::
[buildout]
...
eggs =
collective.gridlisting
and then running ``bin/buildout``
Compatibility
-------------
Plone 6, Python 3.8 - 3.11
Contribute
----------
- Issue Tracker: https://github.com/collective/collective.gridlisting/issues
- Source Code: https://github.com/collective/collective.gridlisting
- Documentation: https://github.com/collective/collective.gridlisting/docs
License
-------
The project is licensed under the GPLv2.
Contributors
============
- Peter Mathis, peter.mathis@kombinat.at
Changelog
=========
1.0.0 (2023-06-28)
------------------
- Initial release. See REAMDE.rst
[petschki]
Raw data
{
"_id": null,
"home_page": "https://github.com/collective/collective.gridlisting",
"name": "collective.gridlisting",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Python Plone CMS Addon folder layout masonry column grid",
"author": "Peter Mathis",
"author_email": "peter.mathis@kombinat.at",
"download_url": "https://files.pythonhosted.org/packages/a2/0d/551ac14d96635589c8f8147defdf1a10d0f87f06baabea35efb008f98cd5/collective.gridlisting-1.0.0.tar.gz",
"platform": null,
"description": ".. This README is meant for consumption by humans and PyPI. PyPI can render rst files so please do not use Sphinx features.\n If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html\n This text does not appear on PyPI or github. It is a comment.\n\n.. image:: https://github.com/collective/collective.gridlisting/actions/workflows/plone-package.yml/badge.svg\n :target: https://github.com/collective/collective.gridlisting/actions/workflows/plone-package.yml\n\n\ncollective.gridlisting\n======================\n\nAdds a Behavior to manipulate various listing appearance settings\nusing Bootstrap 5 (column layout) and patternslib (masonry).\n\nThis behavior is automatically enabled for \"Folder\" and \"Collection\" when you install it.\n\n\nFeatures\n--------\n\n- Adds new view template \"Grid listing\" for \"Folder\" and \"Collection\"\n- You get a new \"Grid listing\" tab when editing a Folder or a Collection where\n you can set various options for the listing template.\n\n\nGet started\n-----------\n\n1. Install `collective.gridlisting` in the Add-ons controlpanel\n2. Go to a folder and select **Grid listing** from the **Display** menu\n3. Edit the folder and go to the **Grid listing** tab\n4. You can enter CSS classes for the grid items and/or enable **Masonry layout**.\n\n\nGrid setup\n----------\n\nThe grid structure is set up as follows:\n\n+--------------------------------+\n| Container row |\n| |\n| +--------------------------+ |\n| | Column | |\n| | | |\n| | +--------------------+ | |\n| | | Column content | | |\n| | | | | |\n| | | +------+-------+ | | |\n| | | | text | image | | | |\n| | | +------+-------+ | | |\n| | +--------------------+ | |\n| +--------------------------+ |\n+--------------------------------+\n\nYou can define css classes for each of those containers.\n\nFor example if you simply want a responsive 4/2/1 column layout you can set the ``Container row CSS class`` to:\n\n ``row-cols-1 row-cols-lg-2 row-cols-xl-4``\n\nYou can also define borders, margins and paddings for the column content with ``Column content CSS Class``:\n\n ``border border-primary m-2 p-2``\n\nAnd you can further experiment with gutters or backgrounds.\n\nInside the column, the text and image information can be defined separately.\nYou can for example simply switch the order of text/image with:\n\n ``Column content text: col order-2``\n\n ``Column content image: col order-1``\n\nor put the image above the text with:\n\n ``Column content text: col-12 order-2``\n\n ``Column content image: col-12 order-1``\n\nFor more information on the CSS definitions see the Bootstrap documentation:\n\nhttps://getbootstrap.com/docs/5.3/layout/grid/\n\n\nSpecial Example: Card listing\n-----------------------------\n\nThe following values gives you a listing with cards, cell height 100% and image at the top:\n\n- ``Container row``: ``row-cols-3`` (3 columns)\n- ``Column``: ``pb-3`` (spacing below card)\n- ``Column content``: ``card h-100`` (card outline, 100% cell height)\n- ``Column content text``: ``order-2 card-body`` (text below image)\n- ``Column content image``: ``order-1 card-img-top`` (image above text)\n\net voila!\n\nNOTE: If you enable **Masonry layout** you have to remove ``h-100`` from ``Column content``\nand you have a masonry card listing like shown here: https://getbootstrap.com/docs/5.3/examples/masonry/\n\n\nTranslations\n------------\n\nThis product has been translated into\n\n- English\n- German\n\n\nInstallation\n------------\n\nInstall collective.gridlisting by adding it to your buildout::\n\n [buildout]\n\n ...\n\n eggs =\n collective.gridlisting\n\n\nand then running ``bin/buildout``\n\n\nCompatibility\n-------------\n\nPlone 6, Python 3.8 - 3.11\n\n\nContribute\n----------\n\n- Issue Tracker: https://github.com/collective/collective.gridlisting/issues\n- Source Code: https://github.com/collective/collective.gridlisting\n- Documentation: https://github.com/collective/collective.gridlisting/docs\n\n\n\nLicense\n-------\n\nThe project is licensed under the GPLv2.\n\n\nContributors\n============\n\n- Peter Mathis, peter.mathis@kombinat.at\n\n\nChangelog\n=========\n\n\n1.0.0 (2023-06-28)\n------------------\n\n- Initial release. See REAMDE.rst\n [petschki]\n",
"bugtrack_url": null,
"license": "GPL version 2",
"summary": "Behavior for Folder and Collection to manipulate various appearance settings using Bootstrap (column layout) and patternslib (masonry, inject)",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/collective/collective.gridlisting",
"PyPI": "https://pypi.org/project/collective.gridlisting/",
"Source": "https://github.com/collective/collective.gridlisting",
"Tracker": "https://github.com/collective/collective.gridlisting/issues"
},
"split_keywords": [
"python",
"plone",
"cms",
"addon",
"folder",
"layout",
"masonry",
"column",
"grid"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "00a24216010bf17ee6478b56eba4d737bb577d74d15a2dae17a8ecfb6cfd9410",
"md5": "0252f1ad37aa346b75497af7f614281b",
"sha256": "40dd31b95917b340ad591be32955588f6563a61a3f9d9ee337bac41e4dc311b9"
},
"downloads": -1,
"filename": "collective.gridlisting-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0252f1ad37aa346b75497af7f614281b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 334601,
"upload_time": "2023-06-28T08:30:53",
"upload_time_iso_8601": "2023-06-28T08:30:53.788750Z",
"url": "https://files.pythonhosted.org/packages/00/a2/4216010bf17ee6478b56eba4d737bb577d74d15a2dae17a8ecfb6cfd9410/collective.gridlisting-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a20d551ac14d96635589c8f8147defdf1a10d0f87f06baabea35efb008f98cd5",
"md5": "407605398b60d9cfbb402b5869dde7a9",
"sha256": "0b6f6e5ae21b15fa3118726f12082728b99a892c5a925d5e7df6e682c09a28d7"
},
"downloads": -1,
"filename": "collective.gridlisting-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "407605398b60d9cfbb402b5869dde7a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 322786,
"upload_time": "2023-06-28T08:30:57",
"upload_time_iso_8601": "2023-06-28T08:30:57.343416Z",
"url": "https://files.pythonhosted.org/packages/a2/0d/551ac14d96635589c8f8147defdf1a10d0f87f06baabea35efb008f98cd5/collective.gridlisting-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-28 08:30:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "collective",
"github_project": "collective.gridlisting",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "collective.gridlisting"
}
JSON
