====================
PyAMS portal package
====================
.. contents::
What is PyAMS?
==============
PyAMS (Pyramid Application Management Suite) is a small suite of packages written for applications
and content management with the Pyramid framework.
**PyAMS** is actually mainly used to manage web sites through content management applications (CMS,
see PyAMS_content package), but many features are generic and can be used inside any kind of web
application.
All PyAMS documentation is available on `ReadTheDocs <https://pyams.readthedocs.io>`_; source code
is available on `Gitlab <https://gitlab.com/pyams>`_ and pushed to `Github
<https://github.com/py-ams>`_. Doctests are available in the *doctests* source folder.
What is PyAMS portal?
=====================
PyAMS_portal is a PyAMS extension package which can be used to handle presentation templates.
A template is made of rows, slots and portlets, following Bootstrap's grid logic, and
can be shared between several contexts to handle content presentation. A context can then be
configured to use distinct templates for page header, body and footer; when reusing a shared
template, the template configuration of rows and slots is frozen, but each portlet can use a
different configuration from those of the template from which we inherit.
PyAMS_portal package only provides a very small set of portlets. More portlets are provided by
content management packages like PyAMS_content, while other extension packages can be used to
provide custom portlets renderers.
Changelog
=========
2.5.0
-----
- added rich text portlet "alert" renderer
- added property to disable renderers preview in renderer selection widget
2.4.0
-----
- added optional CSS class to portlets settings
- use canonical URL instead of relative URL in Bootstrap cards links
2.3.3
-----
- reverted update on portlet renderer settings edit form parent interface
to avoid side effects on existing forms
2.3.2
-----
- added permission to system manager role
2.3.1
-----
- get template container class from parent view
- updated portlet renderer settings edit form parent interface
2.3.0
-----
- updated cards portlet thumbnails selection field
- updated portlet renderer settings edit form fields and groups getters
- added edit forms content getters
2.2.3
-----
- corrected doctest
2.2.2
-----
- updated portlets cache key to include page name (which may be required when
a page template is duplicated to be used in another page name)
2.2.1
-----
- moved renderers names constants from PyAMS_content package
2.2.0
-----
- added support for portlets renderers thumbnails
- moved PyAMS_utils finder helpers to new module
2.1.1
-----
- added default portlet settings hint adapter
2.1.0
-----
- updated modal forms title
- small updates in template layout row and slot management
2.0.0
-----
- migrated to Pyramid 2.0
1.9.2
-----
- updated slots and portlets add menus factories to hide these menus on headers
and footers layouts when not using a custom template
1.9.1
-----
- updated doctests
1.9.0
-----
- added slot CSS class to portlets container
- updated portlet previewer
- updated portlet edit form status
- bypass workflow state check on page preview
1.8.1
-----
- use new sortable table base class
1.8.0
-----
- added marker interfaces to handle header and footer templates
1.7.1
-----
- corrected history syntax error
1.7.0
-----
- added attribute to portlet settings to define Bootstrap devices on which portlet
is visible
1.6.2
-----
- added default portlet settings label adapter
- removed useless portlets renderers settings adapters
- updated portlet settings preview templates
1.6.1
-----
- updated doctests
1.6.0
-----
- added support for distinct header, body and footer templates in a portlet context
- added support for Python 3.11
- added renderer to spacer portlet
1.5.2
-----
- updated doctests
1.5.1
-----
- include required Fanstatic resources when portlet content is loaded from cache
- add request protocol to portlets cache key
1.5.0
-----
- added default portlet previewer
- added no-value message to renderer selection widget
- removed static resources from layout template
- small refactoring in raw code portlet renderers
- added *field* and *context* arguments to properties renderers in portlet preview
- use f-strings instead of format functions (requires Python >= 3.7)
- updated translations
- added support for Python 3.10
1.4.4
-----
- remove empty portlets from portal layout
- use new ZMI base columns classes in cards and carousel portlets management views
1.4.3
-----
- added link to image preview in image portlet
1.4.2
-----
- restored missing callback in template layout
1.4.1
-----
- updated MyAMS module registration
- updated renderer selection widget classname
- use new context base add action
1.4.0
-----
- added prefix and suffix HTML codes to slot configuration
1.3.3
-----
- added option to display menu to access templates container from ZMI home page
1.3.2
-----
- added check for missing portlet renderer in preview
- updated translation string name in layout management script
1.3.1
-----
- updated content provider rendering API, adding new "template_name" argument to
"render" methods
1.3.0
-----
- added template container CSS class (with custom TALES extension and updated layout)
- added support for designer role to portal templates container
- added template properties edit form
- updated doctests
1.2.3
-----
- small template layout CSS updates
- added templates label adapter
- updated add and edit forms title
1.2.2
-----
- package version mismatch
1.2.1
-----
- updated portlets inner settings forms label
- use IObjectLabel adapter in local template share form
1.2.0
-----
- added Bootstrap float classes to slots
- updated Javascript layout handler
1.1.0
-----
- added feature to create a shared template from a local one
- removed permission on default portlets
- updated forms title
- updated translations
1.0.4
-----
- clear portlets cache after configuration or renderer settings update
1.0.3
-----
- updated layout offset classes for XS devices
1.0.2
-----
- corrected syntax error in image portlet setting
- updated ZMI modules exclusion rule when including package
1.0.1
-----
- Javascript code cleanup
1.0.0
-----
- initial release
Raw data
{
"_id": null,
"home_page": "https://pyams.readthedocs.io",
"name": "pyams-portal",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Pyramid PyAMS",
"author": "Thierry Florac",
"author_email": "tflorac@ulthar.net",
"download_url": "https://files.pythonhosted.org/packages/c3/2d/401ad1e1493b2d7b090f3fc452dd5c9a93cc1aa9a9a72f91729ab11f92fb/pyams_portal-2.5.0.tar.gz",
"platform": null,
"description": "====================\nPyAMS portal package\n====================\n\n.. contents::\n\n\nWhat is PyAMS?\n==============\n\nPyAMS (Pyramid Application Management Suite) is a small suite of packages written for applications\nand content management with the Pyramid framework.\n\n**PyAMS** is actually mainly used to manage web sites through content management applications (CMS,\nsee PyAMS_content package), but many features are generic and can be used inside any kind of web\napplication.\n\nAll PyAMS documentation is available on `ReadTheDocs <https://pyams.readthedocs.io>`_; source code\nis available on `Gitlab <https://gitlab.com/pyams>`_ and pushed to `Github\n<https://github.com/py-ams>`_. Doctests are available in the *doctests* source folder.\n\n\nWhat is PyAMS portal?\n=====================\n\nPyAMS_portal is a PyAMS extension package which can be used to handle presentation templates.\n\nA template is made of rows, slots and portlets, following Bootstrap's grid logic, and\ncan be shared between several contexts to handle content presentation. A context can then be\nconfigured to use distinct templates for page header, body and footer; when reusing a shared\ntemplate, the template configuration of rows and slots is frozen, but each portlet can use a\ndifferent configuration from those of the template from which we inherit.\n\nPyAMS_portal package only provides a very small set of portlets. More portlets are provided by\ncontent management packages like PyAMS_content, while other extension packages can be used to\nprovide custom portlets renderers.\n\n\nChangelog\n=========\n\n2.5.0\n-----\n - added rich text portlet \"alert\" renderer\n - added property to disable renderers preview in renderer selection widget\n\n2.4.0\n-----\n - added optional CSS class to portlets settings\n - use canonical URL instead of relative URL in Bootstrap cards links\n\n2.3.3\n-----\n - reverted update on portlet renderer settings edit form parent interface\n to avoid side effects on existing forms\n\n2.3.2\n-----\n - added permission to system manager role\n\n2.3.1\n-----\n - get template container class from parent view\n - updated portlet renderer settings edit form parent interface\n\n2.3.0\n-----\n - updated cards portlet thumbnails selection field\n - updated portlet renderer settings edit form fields and groups getters\n - added edit forms content getters\n\n2.2.3\n-----\n - corrected doctest\n\n2.2.2\n-----\n - updated portlets cache key to include page name (which may be required when\n a page template is duplicated to be used in another page name)\n\n2.2.1\n-----\n - moved renderers names constants from PyAMS_content package\n\n2.2.0\n-----\n - added support for portlets renderers thumbnails\n - moved PyAMS_utils finder helpers to new module\n\n2.1.1\n-----\n - added default portlet settings hint adapter\n\n2.1.0\n-----\n - updated modal forms title\n - small updates in template layout row and slot management\n\n2.0.0\n-----\n - migrated to Pyramid 2.0\n\n1.9.2\n-----\n - updated slots and portlets add menus factories to hide these menus on headers\n and footers layouts when not using a custom template\n\n1.9.1\n-----\n - updated doctests\n\n1.9.0\n-----\n - added slot CSS class to portlets container\n - updated portlet previewer\n - updated portlet edit form status\n - bypass workflow state check on page preview\n\n1.8.1\n-----\n - use new sortable table base class\n\n1.8.0\n-----\n - added marker interfaces to handle header and footer templates\n\n1.7.1\n-----\n - corrected history syntax error\n\n1.7.0\n-----\n - added attribute to portlet settings to define Bootstrap devices on which portlet\n is visible\n\n1.6.2\n-----\n - added default portlet settings label adapter\n - removed useless portlets renderers settings adapters\n - updated portlet settings preview templates\n\n1.6.1\n-----\n - updated doctests\n\n1.6.0\n-----\n - added support for distinct header, body and footer templates in a portlet context\n - added support for Python 3.11\n - added renderer to spacer portlet\n\n1.5.2\n-----\n - updated doctests\n\n1.5.1\n-----\n - include required Fanstatic resources when portlet content is loaded from cache\n - add request protocol to portlets cache key\n\n1.5.0\n-----\n - added default portlet previewer\n - added no-value message to renderer selection widget\n - removed static resources from layout template\n - small refactoring in raw code portlet renderers\n - added *field* and *context* arguments to properties renderers in portlet preview\n - use f-strings instead of format functions (requires Python >= 3.7)\n - updated translations\n - added support for Python 3.10\n\n1.4.4\n-----\n - remove empty portlets from portal layout\n - use new ZMI base columns classes in cards and carousel portlets management views\n\n1.4.3\n-----\n - added link to image preview in image portlet\n\n1.4.2\n-----\n - restored missing callback in template layout\n\n1.4.1\n-----\n - updated MyAMS module registration\n - updated renderer selection widget classname\n - use new context base add action\n\n1.4.0\n-----\n - added prefix and suffix HTML codes to slot configuration\n\n1.3.3\n-----\n - added option to display menu to access templates container from ZMI home page\n\n1.3.2\n-----\n - added check for missing portlet renderer in preview\n - updated translation string name in layout management script\n\n1.3.1\n-----\n - updated content provider rendering API, adding new \"template_name\" argument to\n \"render\" methods\n\n1.3.0\n-----\n - added template container CSS class (with custom TALES extension and updated layout)\n - added support for designer role to portal templates container\n - added template properties edit form\n - updated doctests\n\n1.2.3\n-----\n - small template layout CSS updates\n - added templates label adapter\n - updated add and edit forms title\n\n1.2.2\n-----\n - package version mismatch\n\n1.2.1\n-----\n - updated portlets inner settings forms label\n - use IObjectLabel adapter in local template share form\n\n1.2.0\n-----\n - added Bootstrap float classes to slots\n - updated Javascript layout handler\n\n1.1.0\n-----\n - added feature to create a shared template from a local one\n - removed permission on default portlets\n - updated forms title\n - updated translations\n\n1.0.4\n-----\n - clear portlets cache after configuration or renderer settings update\n\n1.0.3\n-----\n - updated layout offset classes for XS devices\n\n1.0.2\n-----\n - corrected syntax error in image portlet setting\n - updated ZMI modules exclusion rule when including package\n\n1.0.1\n-----\n - Javascript code cleanup\n\n1.0.0\n-----\n - initial release\n",
"bugtrack_url": null,
"license": "ZPL",
"summary": "PyAMS portlets management package",
"version": "2.5.0",
"project_urls": {
"Homepage": "https://pyams.readthedocs.io"
},
"split_keywords": [
"pyramid",
"pyams"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8340d7872867449322385d72cba08a10fdf96e965cef8764808c4d81653de5a0",
"md5": "446b453728037bfd90fd7cba4f1f9911",
"sha256": "a5895b539497bd94e430706c9ef8dd96891bc520d8dc3cb0d386be005e93cf5e"
},
"downloads": -1,
"filename": "pyams_portal-2.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "446b453728037bfd90fd7cba4f1f9911",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 195885,
"upload_time": "2024-07-25T09:44:25",
"upload_time_iso_8601": "2024-07-25T09:44:25.471573Z",
"url": "https://files.pythonhosted.org/packages/83/40/d7872867449322385d72cba08a10fdf96e965cef8764808c4d81653de5a0/pyams_portal-2.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c32d401ad1e1493b2d7b090f3fc452dd5c9a93cc1aa9a9a72f91729ab11f92fb",
"md5": "9d8ac0a2379bf78fb532da0e3b72041f",
"sha256": "b8b1603eec536fe9dea6f316654c2d568e179d5742b13f655bc4d2beba8cdcd5"
},
"downloads": -1,
"filename": "pyams_portal-2.5.0.tar.gz",
"has_sig": false,
"md5_digest": "9d8ac0a2379bf78fb532da0e3b72041f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 137118,
"upload_time": "2024-07-25T09:44:27",
"upload_time_iso_8601": "2024-07-25T09:44:27.622931Z",
"url": "https://files.pythonhosted.org/packages/c3/2d/401ad1e1493b2d7b090f3fc452dd5c9a93cc1aa9a9a72f91729ab11f92fb/pyams_portal-2.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-25 09:44:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyams-portal"
}
JSON