Under Development https://gitlab.com/tikiwiki/tiki/-/tree/master

Tiki 31.0

Upgrade Notes

POP3 support removed from MailIn accounts

Tiki 31 no longer supports POP3 for MailIn accounts. Only IMAP is supported.

Before upgrading, administrators must review all existing MailIn accounts. Any account configured to use POP3 must be migrated to IMAP before upgrading to Tiki 31.

See the Webmail documentation for more information.

Tracker attachments migration required

Tiki 31 removes the legacy tracker Attachments feature and the deprecated Attachment tracker field type.

Before upgrading, administrators must migrate any existing tracker attachments and remove any deprecated Attachment fields. The Tiki 31 database update will stop and refuse to continue if old tracker attachment data or deprecated Attachment fields are still present. This prevents existing data from being silently lost.

Migrate tracker attachments

If tracker items still have attachments, migrate them to a Files tracker field:

Create a Files field in the tracker if one does not already exist.
Run the following command:

php console.php tracker <trackerId> <fieldId> [galleryId]

Where:

• is the ID of the tracker.
• is the ID of the Files field.
• galleryId is optional. If omitted, the command uses the file gallery configured on the Files field, or the root gallery if no gallery is configured.

Remove deprecated Attachment fields

If any tracker still contains a deprecated Attachment field (field type A), remove it before upgrading:

Tracker > Fields > select the field > Remove

Once all tracker attachments have been migrated and all deprecated Attachment fields have been removed, run the database update again.

1. Known Issues

Include only important known issues affecting Tiki 31.0.

• [+]Known issue title
  • Short description.
    Workaround: Describe the workaround, if available.
    https://gitlab.com/tikiwiki/tiki/-/issues/XXXX

2. Major Changes

Use this section for significant architectural, behavioural, or system-wide changes.

• [+] Major change title
  • Concise description of the change and its impact.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

3. Removals

• [+] Removed POP3 support from mail accounts
  • https://gitlab.com/tikiwiki/tiki/-/merge_requests/11067
    Tiki 31 no longer supports POP3 for MailIn accounts. Only IMAP is supported.

• [+] Removed: tracker "Attachments" tab and deprecated "Attachment" field type
  • https://gitlab.com/tikiwiki/tiki/-/merge_requests/10104
    The legacy tracker per-item attachments feature has been removed. This affects two things:

  • The tracker Attachments tab (the useAttachments tracker option).
  • The deprecated Attachment tracker field type (field type A).
    
    New attachments could no longer be created through these features, and both are now gone.
    
    What was removed
  • Database table tiki_tracker_item_attachments
  • Tracker options useAttachments, showAttachments, orderAttachments
  • Permission tiki_p_tracker_view_attachments
  • Pages tiki-download_item_attachment.php and tiki-view_tracker_more_info.php
  • The attachmentAttributes property in the tracker create/update REST API schema
    
    Migration (required before upgrading)
    The database update to Tiki31 will stop and refuse to continue while old attachment data or deprecated Attachment fields are still present, so nothing is silently lost. To upgrade:

  • Orphan attachments (whose tracker item no longer exists) are removed automatically.
  • If tracker item attachments remain, migrate them to a Files tracker field (create one first if the tracker does not have one). Run:
    
    Copy to clipboard

    php console.php tracker:convert-attachments <trackerId> <fieldId> [galleryId]

    
    is the ID of the Files field.
    [galleryId] is optional: if omitted, the command uses the file gallery already configured on the Files field, or the root gallery if none is set.
  • If any field still uses the deprecated Attachment type (A), remove it from its tracker (Tracker > Fields > select the field > Remove).
  • Run the database update again once everything is migrated.

4. New Features and Improvements

4.1. New

• [+] Altcha CAPTCHA Support
  • Introduced support for the Altcha CAPTCHA system as a new anti-spam and bot protection option in Tiki.
    Includes compatibility handling for PHP 8.1 and PHP 8.2+ environments and provides a modern alternative CAPTCHA provider.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/7994

4.2. User Interface and Navigation

• [+] Feature or improvement title
  • Concise description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.2.1. Accessibility

• [+] Accessibility improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.2.2. Responsive Design

• [+] Responsive design improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.2.3. Navigation and Menus

• [+] Navigation improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.2.4. Themes and Layout

• [+] Theme or layout improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.2.5. Administration UX

• [+] Administration improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.3. Calendars & Events

• [+] Calendar feature or improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.4. Communications & Messaging

• [+] **Communication or Webmail improvement**
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.5. Editors

• [+] Editor improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.6. External Services Integrations

• [+] Integration name
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.7. File Galleries & Attachments

• [+] File Gallery improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.8. Maps, Geolocation & Internationalisation

• [+] Feature or improvement title
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.9. Plugins

• [+] Plugin Name
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.10. Search

• [+] Search improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.11. Security & Access Control

• [+] Security or access-control improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.12. Trackers

• [+] Tracker feature or improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.13. Developer Tools & APIs

• [+] Developer tool or API improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

4.14. Miscellaneous

• [+] Improvement title
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

5. Infrastructure and Dependencies

5.1. Dependency Updates

Include noteworthy dependency changes with compatibility, security, or administrator impact.

• [+] Dependency name
  • Updated from VERSION to VERSION.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

5.2. Build System & Configuration

• [+] Build or configuration change
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

5.3. Developer Tools

• [+] Development tooling improvement
  • Short description.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

6. Removals and Deprecations

Include removed or deprecated features, libraries, preferences, APIs, or functionality.

If a removal requires action before upgrading, put the complete instructions in Upgrade Notes and keep only a concise reference here.

• [+] Removed: Feature or component name
  • The feature has been removed in Tiki 31.
    Sites using this feature must follow the migration instructions in the Upgrade Notes section before upgrading.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

• [+] Deprecated: Feature or component name
  • The feature is deprecated and may be removed in a future Tiki version.
    Use ALTERNATIVE instead.
    https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

7. Large-Scale Changes

Large-scale changes affect many files or multiple parts of Tiki. They may include major refactoring, architectural changes, broad feature improvements, or system-wide cleanup.

These changes are listed separately because their broad scope may increase the possibility of regressions.

• https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX
• https://gitlab.com/tikiwiki/tiki/-/merge_requests/XXXX

8. References

• Changes between Tiki 30.x and Tiki 31.x
• Tiki 31.x commits