{"id":22389789,"url":"https://github.com/entando/entando-plugin-jpversioning","last_synced_at":"2025-07-13T08:35:02.174Z","repository":{"id":37767244,"uuid":"276077975","full_name":"entando/entando-plugin-jpversioning","owner":"entando","description":null,"archived":false,"fork":false,"pushed_at":"2023-08-28T11:07:44.000Z","size":844,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":8,"default_branch":"develop","last_synced_at":"2025-02-01T03:27:47.183Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/entando.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-30T11:19:19.000Z","updated_at":"2022-01-07T11:26:14.000Z","dependencies_parsed_at":"2025-02-01T03:26:34.093Z","dependency_job_id":"5e5ece04-5dd1-46aa-94ba-468c8877040e","html_url":"https://github.com/entando/entando-plugin-jpversioning","commit_stats":null,"previous_names":[],"tags_count":155,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-plugin-jpversioning","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-plugin-jpversioning/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-plugin-jpversioning/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fentando-plugin-jpversioning/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/entando","download_url":"https://codeload.github.com/entando/entando-plugin-jpversioning/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245737943,"owners_count":20664184,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-05T03:13:16.091Z","updated_at":"2025-03-26T21:27:11.796Z","avatar_url":"https://github.com/entando.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"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)\r\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)\r\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning\u0026metric=coverage)](https://entando.github.io/devops-results/entando-plugin-jpversioning/master/jacoco/index.html)\r\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning\u0026metric=vulnerabilities)](https://entando.github.io/devops-results/entando-plugin-jpversioning/master/dependency-check-report.html)\r\n[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning\u0026metric=code_smells)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)\r\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning\u0026metric=security_rating)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)\r\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=entando_entando-plugin-jpversioning\u0026metric=sqale_index)](https://sonarcloud.io/dashboard?id=entando_entando-plugin-jpversioning)\r\n\r\nentando-plugin-jpversioning\r\n============\r\n**Versioning**\r\n\r\n**Code**: ```jpversioning```\r\n\r\n**Description**\r\n\r\nThe Versioning Plugin allows to trace, and restore selectively, the versions of single contents. \r\nThis 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.\r\nPlease also be aware that a resource referenced by older versions of the content cannot be deleted to avoid inconsistency on restore.\r\nThough 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.\r\n\r\n**Installation**\r\n\r\nIn order to install the Versioning Plugin, you must insert the following dependency in the pom.xml file of your project:\r\n```\r\n\u003cdependency\u003e\r\n    \u003cgroupId\u003eorg.entando.entando.plugins\u003c/groupId\u003e\r\n    \u003cartifactId\u003eentando-plugin-jpversioning\u003c/artifactId\u003e\r\n    \u003cversion\u003e${entando.version}\u003c/version\u003e\r\n    \u003ctype\u003ewar\u003c/type\u003e\r\n\u003c/dependency\u003e\r\n```\r\n\r\n**Configuration**\r\n\r\nYou can access to Versioning Plugin’s functionality through the usual left menu: _Plugins_ -\u003e _Versioning_ in the Administration Area.\r\nSelecting _Contents_ from the _Plugins_ menu, you can access to the _Contents_ history management.\r\n\r\nClicking on the content description you can access to the history of the selected content.\r\nFor each content we are given the possibility to manage various version by clicking on the description as well as some information, \r\nsuch as the date of the modification the user which made the changes.\r\n\r\nRegarding the version number's rule, the content version is characterized from the pattern ```\u003cmajor_number\u003e.\u003cminor_number\u003e```, \r\na 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.\r\n\r\nYou can also restore the content to the wanted version by clicking the arrow icon, or delete the record \r\n(version numbers don't change in this case).\r\n\r\nPlease note that the restore action when confirmed, loads only a previous version of the content. \r\nYou have to save your changes with the Save button to finalize the restore process. \r\nNaturally the version replaced is tracked by the plugin.\r\n\r\nRegarding 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.\r\n\r\nResources are placed in a _recycle bin_ so that they can be later restored only when deleted.\r\nThe _recycle bin_ can be access from the left menu _Plugins_ → _Versioning_ → _Images_ or _Attachments_.\r\nYou can restore and delete permanently the resources using the arrow and the remove icons.\r\n\r\n\r\n# Developing against local versions of upstream projects (e.g. admin-console,  entando-engine).\r\n\r\nFull instructions on how to develop against local versions of upstream projects are available in the\r\n[entando-parent-bom](https://github.com/entando/entando-core-bom) project. \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentando%2Fentando-plugin-jpversioning","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fentando%2Fentando-plugin-jpversioning","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentando%2Fentando-plugin-jpversioning/lists"}