Metadata-Version: 2.1
Name: eea.progress.editing
Version: 2.0
Summary: Editing progress RestAPI
Home-page: https://github.com/eea/eea.progress.editing
Author: European Environment Agency: IDM2 A-Team
Author-email: eea-edw-a-team-alerts@googlegroups.com
License: GPL version 2
Keywords: EEA Add-ons Plone Zope
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 4.3
Classifier: Framework :: Plone :: 5.2
Classifier: Framework :: Plone :: 6.0
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Description-Content-Type: text/x-rst
Provides-Extra: test

==========================
eea.progress.editing
==========================
.. image:: https://ci.eionet.europa.eu/buildStatus/icon?job=eea/eea.progress.editing/develop
  :target: https://ci.eionet.europa.eu/job/eea/job/eea.progress.editing/job/develop/display/redirect
  :alt: Develop
.. image:: https://ci.eionet.europa.eu/buildStatus/icon?job=eea/eea.progress.editing/master
  :target: https://ci.eionet.europa.eu/job/eea/job/eea.progress.editing/job/master/display/redirect
  :alt: Master

A Plone add-on that expose editing progress via RestAPI

.. contents::


Main features
=============

1. RestAPI editing progress::

    $ curl -H 'Accept: application/json' --user admin:admin -i http://localhost:8080/Plone/a-page/@editing.progress

    or

    $ curl -H 'Accept: application/json' --user admin:admin -i http://localhost:8080/Plone/a-page?expand=editing.progress


Install
=======

* Add **eea.progress.editing** to your requirements.txt and **constraints.txt** and run::

    pip install -r requirements.txt -c constraints.txt

* Or, if using buildout, add **eea.progress.editing** to your eggs section in your buildout and
  re-run buildout::

    [buildout]
    eggs +=
      eea.progress.editing

* Or via docker::

    $ docker run --rm -p 8080:8080 -e ADDONS="eea.progress.editing" plone/plone-backend

* Restart Plone

* Install **eea.progress.editing** within **Site Setup > Add-ons**

* Configure editing progress via **Control Panel > Editing Progress Settings**

* If you already have **Plone 4** definitions for your Content Types Editing Progress, you can
  export them to XML at **/portal_progress/document/view.export** and then use
  `xml2dict.py <https://github.com/eea/eea.progress.editing/blob/develop/xml2dict.py>`_ script to
  convert them to **Plone 6** registry. The output should look like::

      {
        "Document": [
          {
            'condition': 'python:value',
            'hideReady': 'False',
            'iconEmpty': 'eea-icon eea-icon-edit',
            'iconReady': 'eea-icon eea-icon-check',
            'labelEmpty': 'Please set the {label} of this {context.portal_type}',
            'labelReady': 'You added the {label}',
            'link': 'edit#fieldsetlegend-default',
            'linkLabel': 'Add {label}',
            'prefix': 'title',
            'states': ['all']
          },
                    {
            'condition': 'python:value',
            'hideReady': 'False',
            'iconEmpty': 'eea-icon eea-icon-edit',
            'iconReady': 'eea-icon eea-icon-check',
            'labelEmpty': 'Please set the {label} of this {context.portal_type}',
            'labelReady': 'You added the {label}',
            'link': 'edit#fieldsetlegend-default',
            'linkLabel': 'Add {label}',
            'prefix': 'description',
            'states': ['all']
          },
          ...
        ]
      }

Source code
===========

- `github.com/eea/eea.progress.editing <https://github.com/eea/eea.progress.editing>`_

Eggs repository
===============

- `pypi.python.org/pypi/eea.progress.editing <https://pypi.python.org/pypi/eea.progress.editing>`_
- `eggrepo.eea.europa.eu/d/eea.progress.editing <https://eggrepo.eea.europa.eu/d/eea.progress.editing>`_


Plone versions
==============
It has been developed and tested for Plone 4, 5 and 6.


How to contribute
=================
See the `contribution guidelines (CONTRIBUTING.md) <https://github.com/eea/eea.progress.editing/blob/master/CONTRIBUTING.md>`_.

Copyright and license
=====================

eea.progress.editing (the Original Code) is free software; you can
redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc., 59
Temple Place, Suite 330, Boston, MA 02111-1307 USA.

The Initial Owner of the Original Code is European Environment Agency (EEA).
Portions created by Eau de Web are Copyright (C) 2009 by
European Environment Agency. All Rights Reserved.


Funding
=======

EEA_ - European Environment Agency (EU)

.. _EEA: https://www.eea.europa.eu/
.. _`EEA Web Systems Training`: http://www.youtube.com/user/eeacms/videos?view=1


Changelog
=========

2.0 - (2024-06-01)
---------------------------
* Breaking: Drop Plone 4 GenericSetup profile
  [avoinea - refs #151690]
* Breaking: Rename Editing Progress ControlPanel and registry
  [avoinea - refs #151690]

1.5 - (2023-06-01)
---------------------------
* Feature: Plone 6 added editing progress controlpanel 
  [Petchesi-Iulian - refs #151690]

1.4 - (2021-12-16)
---------------------------
* Change: Fix package classifiers and python_requires
  [avoinea]

1.3 - (2021-06-21)
---------------------------
* Feature: Introduced @@editing.progress.status browser view used to check if
  every field is entered for current state, useful for workflow guards
  [ichim-david refs #124587]
  
1.2 - (2021-06-10)
---------------------------
* Change: add also workflow states info to rest api, this
  way we know for which state the field should be required
  [ichim-david refs #124587]

1.1 - (2021-05-04)
------------------
* Change: return field info as dict
  [ichim-david refs #124588]
* Change: We now export a list of dicts for each field instead of
  a list of lists, making it easier to read and understand what is exported
  [ichim-david refs #124588]
* Provide done information for editing progress of fields
  [ichim-david refs #124588]

1.0 - (2021-05-04)
------------------
* Initial Release
