How to upgrade Cypht within Tiki via Composer

Cypht Webmail is included in Tiki.

Tiki periodically gets latest code from https://packagist.org/packages/jason-munro/cypht via Composer.

After getting Cypht, the following script is ran: https://gitlab.com/tikiwiki/tiki/-/blob/master/lib/core/Tiki/Composer/PatchCypht.php

This page explains how to update.

Trunk/master (future Tiki25)

Tiki trunk usually gets Cypht master, so we are always testing the latest innovations.

1. Get latest Tiki code
2. Run from Tiki root directory

   ./temp/composer.phar update --prefer-dist --working-dir="vendor_bundled" --no-dev

   • This will modify vendor_bundled/composer.lock and perhaps lib/cypht/site.js and lib/cypht/site.css
   • These 2 last files are now ignored by Git
3. Review changes and commit

24x

Tiki24 is a long term support and will be supported for 5 years. However, since the Tiki-Cypht integration is quite young, you'll likely be encouraged to upgrade to 25x, 26x...

For Tiki24, our strategy is normally to use the stable branch, but if there is an important bug fix in master, we use that but we lock to a specific revision

1. Get latest Tiki code
2. Update https://gitlab.com/tikiwiki/tiki/-/blob/24.x/vendor_bundled/composer.json to get the desired revision
   • Something like

     "jason-munro/cypht": "dev-master#cf01e6b",

     where you get ID from https://github.com/jasonmunro/cypht/commits/master
3. Run from Tiki root directory

   ./temp/composer.phar update --prefer-dist --working-dir="vendor_bundled" --no-dev

   • This will modify vendor_bundled/composer.lock and perhaps lib/cypht/site.js and lib/cypht/site.css
   • These 2 last files are now ignored by Git
4. Review changes and commit (along with changes to vendor_bundled/composer.json)

23x

The end of life of Tiki 23x is when 24.1 is released.
For Tiki23, our strategy is normally to use the stable branch, but if there is an important bug fix in master, we use that but we lock to a specific revision.

1. Get latest Tiki code
2. Update https://gitlab.com/tikiwiki/tiki/-/blob/23.x/vendor_bundled/composer.json to get the desired revision
   • Something like

     "jason-munro/cypht": "dev-master#40738ec",

     where you get ID from https://github.com/jasonmunro/cypht/commits/master
3. Run from Tiki root directory

   ./temp/composer.phar update --prefer-dist --working-dir="vendor_bundled" --no-dev

   • This will modify vendor_bundled/composer.lock and perhaps lib/cypht/site.js and lib/cypht/site.css
4. Review changes and commit (along with changes to vendor_bundled/composer.json)

21x

As of 2021-10-03, Tiki21 uses "jason-munro/cypht": ">=1.3.0", in https://gitlab.com/tikiwiki/tiki/-/blob/21.x/vendor_bundled/composer.json and we are working so that recent fixes are part of a stable release.

The Cypht integration in Tiki21 is not good and you really should upgrade to 24.x