https://github.com/entando/entando-plugin-jpversioning

https://github.com/entando/entando-plugin-jpversioning

Last synced: 12 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/entando/entando-plugin-jpversioning
• Owner: entando
• License: lgpl-3.0
• Created: 2020-06-30T11:19:19.000Z (about 6 years ago)
• Default Branch: develop
• Last Pushed: 2023-08-28T11:07:44.000Z (almost 3 years ago)
• Last Synced: 2025-02-01T03:27:47.183Z (over 1 year ago)
• Language: Java
• Size: 824 KB
• Stars: 0
• Watchers: 8
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Build Status](https://img.shields.io/endpoint?url=https%3A%2F%2Fstatusbadge-jx.apps.serv.run%2Fentando%2Fentando-plugin-jpversioning)](https://github.com/entando/devops-results/tree/logs/jenkins-x/logs/entando/entando-plugin-jpversioning/master)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning&metric=alert_status)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning&metric=coverage)](https://entando.github.io/devops-results/entando-plugin-jpversioning/master/jacoco/index.html)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning&metric=vulnerabilities)](https://entando.github.io/devops-results/entando-plugin-jpversioning/master/dependency-check-report.html)

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning&metric=code_smells)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning&metric=security_rating)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)

[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning&metric=sqale_index)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)

entando-plugin-jpversioning

============

**Versioning**

**Code**: ```jpversioning```

**Description**

The Versioning Plugin allows to trace, and restore selectively, the versions of single contents. 

This plugin adds new administration interfaces related to the content tracking; the resources - here intended as attachments and images – receive a slightly different treatment: changes across the same element are not traced, instead a backup of all the deleted resources is kept.

Please also be aware that a resource referenced by older versions of the content cannot be deleted to avoid inconsistency on restore.

Though the plugin installation is not difficult at all, we are going to modify the system tables, so a backup of your database is highly recommended. Furthermore, you may be required to customize the scripts to your needs before installation.

**Installation**

In order to install the Versioning Plugin, you must insert the following dependency in the pom.xml file of your project:

```

    org.entando.entando.plugins

    entando-plugin-jpversioning

    ${entando.version}

    war

```

**Configuration**

You can access to Versioning Plugin’s functionality through the usual left menu: _Plugins_ -> _Versioning_ in the Administration Area.

Selecting _Contents_ from the _Plugins_ menu, you can access to the _Contents_ history management.

Clicking on the content description you can access to the history of the selected content.

For each content we are given the possibility to manage various version by clicking on the description as well as some information, 

such as the date of the modification the user which made the changes.

Regarding the version number's rule, the content version is characterized from the pattern ```.```, 

a new version of the content always increases the minor number. The major number is incremented (and the minor number is set to zero) only when a content is published.

You can also restore the content to the wanted version by clicking the arrow icon, or delete the record 

(version numbers don't change in this case).

Please note that the restore action when confirmed, loads only a previous version of the content. 

You have to save your changes with the Save button to finalize the restore process. 

Naturally the version replaced is tracked by the plugin.

Regarding Resource (Attachments and Images) are traced only when deleted. That is, if you edit a resource and change the file or the description your changes are not saved.

Resources are placed in a _recycle bin_ so that they can be later restored only when deleted.

The _recycle bin_ can be access from the left menu _Plugins_ → _Versioning_ → _Images_ or _Attachments_.

You can restore and delete permanently the resources using the arrow and the remove icons.

# Developing against local versions of upstream projects (e.g. admin-console,  entando-engine).

Full instructions on how to develop against local versions of upstream projects are available in the

[entando-parent-bom](https://github.com/entando/entando-core-bom) project.