History: How to Update the Tiki Diagram Version in Tiki

            ! How to Update the Tiki Diagram Version in Tiki

This guide will walk you through the steps required to update the Tiki diagram version in Tiki. Follow these instructions carefully to ensure a smooth update process.

To use Tiki Diagram you need first to go to __Control Panel > Advanced > Packages__ and install the Tiki diagram package from the list, before activating the wikiplugin_diagram.

!!!! Understand that Tiki Diagram is a mirror of Draw.io.

The mirroring process is handled by the package wiki-builder https://gitlab.com/tikiwiki/tikiwiki-diagram-builder , and TikiBot manages this process by automatically updating the Diagram https://gitlab.com/tikiwiki/diagram to the latest version, so no manual intervention is needed.

!!!! Testing the Integration

Before updating to a new version of tiki/diagram, test its integration with Tiki. If the integration doesn’t work well, you may need to make manual code changes to fix bugs.

Tiki packages are obtained from two servers:

# https://composer.tiki.org (canonical).
# https://repo.packagist.org.

Ensure that your desired package version is present on the canonical server (https://composer.tiki.org). For this you need to:
* Udpate the satis.json file located at:
-+https://gitlab.com/tikiwiki/tiki/-/blob/master/doc/devtools/satis.json+-
* Add the required version to the configuration.

* Create and submit your first merge request (MR).
After the MR is merged, the package will become available on https://composer.tiki.org.
* Update the Package Version

Once the package is available, update the package version in:

-+lib/core/Tiki/Package/ComposerPackages.yml+-

* Create and submit your second merge request (MR).

!!!! Testing Before Deployment

You have to test the package locally before pushing it to GitLab and for that, you need to:

* Remove the parameter -+"canonical": true+- from:

vendor_bundled/composer.json

* Replace the line in the root composer.json:

-+"url": "https://composer.tiki.org"+-

with:

-+"url": "https://asset-packagist.org"+-

* Now you can go to __Control Panel > Advanced > Packages__  in your local instance to install the package and test it.

* Activate the wikiplugin_diagram

* Go to File Galleries, you will see option `Create tiki Diagram` in the menus.

Test the diagram functionalities, If you find the package version is well integrated in tiki, you can create the MR with the version update.


By following these steps, you can successfully update the Tiki diagram version in Tiki. 

!! Related pages
* ((PluginDiagram))
* ((Draw))
* ((Packages))

!! Related links
* https://dev.tiki.org/composer-tiki-org
* https://groups.google.com/forum/#!forum/drawio
* https://gitlab.com/tikiwiki/tikiwiki-diagram-builder
* https://gitlab.com/tikiwiki/diagram
* https://packagist.org/packages/tikiwiki/diagram