Metadata-Version: 2.1
Name: pyams_portal
Version: 2.6.2
Summary: PyAMS portlets management package
Home-page: https://pyams.readthedocs.io
Author: Thierry Florac
Author-email: tflorac@ulthar.net
License: ZPL
Keywords: Pyramid PyAMS
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Framework :: Pyramid
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: test
License-File: LICENSE

====================
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.6.2
-----
 - added check for null value when getting portlet renderer settings

2.6.1
-----
 - updated Gitlab-CI for Python 3.12

2.6.0
-----
 - added and updated sublocations adapters
 - added deleters to files properties

2.5.2
-----
 - added support for Python 3.12

2.5.1
-----
 - updated form CSS class

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
