====== Changelog ======

This page contains a summary of changes between the official [[DokuWiki]] releases. Only the biggest changes are listed here. A complete and detailed log of all changes is available through the [[https://github.com/dokuwiki/dokuwiki/commits/master|GitHub Repository Browser]]. (This log on Github is only authoritative for major releases. Hotfixes often contain only one or few security fixes.)

Changelogs for releases older than the ones listed here are available at [[Old Changes]]. 

Plugin and template developers should read and subscribe to the [[devel:releases|detailed change log]]. 

There is some information regarding the [[install:upgrade|upgrade]]-process.

**Changes marked with :!: need some attention on upgrading!**

===== Release 2026-07-14 “Mort” =====

  * :!: DokuWiki requires at least PHP 8.2 now
  * Optional native [[:Markdown]] parsing, selectable through the new [[config:syntax|syntax]] setting. Classic DokuWiki syntax remains the default. See [[https://www.patreon.com/dokuwiki/posts/dokuwiki-support-158080793|Patreon Post]]
    * :!: some [[https://forum.dokuwiki.org/d/26077-changes-to-the-dokuwiki-syntax-in-the-upcoming-release|small changes]] on how DokuWiki syntax is parsed and rendered, might require minor cleanup on some pages
  * Completely rewritten fulltext [[devel:searchindex|search index]]. See [[https://www.patreon.com/dokuwiki/posts/refactoring-7-in-157788174|Patreon Post]].
  * Code and file blocks now have a copy-to-clipboard button
  * WEBP images now get previews in the media manager
  * EXIF-rotated images are no longer shown cropped in previews
  * New [[config:disableactions|disableactions]] value ''diff'' to disable the diff/compare action 
  * Reworked feed caching to avoid cache flooding
  * Subscription list mails now include diff links
  * Explicit ''Referrer-Policy'' header
  * Various accessibility and UI improvements to the editor, toolbar pickers, login form and extension manager
  * :!: New [[config:client_ip_header|client_ip_header]] setting replaces the old ''realip'' setting 
  * :!: Parser internals refactored: Plugins providing parser modes may need updates [[pr>4636]]
  * :!: Many deprecated search (''ft_*'', ''idx_*'') and a few parser functions/classes were deprecated or removed. Plugins may need updates [[pr>4543]] [[pr>4646]]
  * ''bin/gittool.php'' now prefers SSH when cloning repositories
  * Various security fixes and improvements
  * Various bug fixes, language and dependency updates


===== Release 2025-05-14 “Librarian” =====

  * Refactored Extension Manager now supports dependencies and checks PHP versions. See [[https://www.patreon.com/posts/new-extension-116501986|Patreon Post]]
  * Linkwizard now prefers to create relative links, its JavaScript has been modernized
  * :!: New mechanism to trust proxies. See [[config:trustedproxies|Configuration Setting: trustedproxies]] and [[config:realip|Configuration Setting: realip]]
  * Alternative header for [[devel:authentication#token_auth|Token Authentication]]
  * More version info in admin screen (for hopefully better bug reports)
  * Various [[devel:remote_api|remote API]] improvements
  * Support for JavaScript nonces provided by environment. See [[issue>3788]]
  * Fixed delete profile form
  * Experimental tree builder support for use by plugin developers. See [[https://www.patreon.com/posts/building-trees-125827149|Patreon Post]]
  * Various Bugfixes, language and dependency updates
  * :!: a bunch of methods and classes that had been marked as deprecated in previous versions have been removed. Plugins may need updates.


**Hotfix**

  * 2025-05-14a
    * fix issues related to OS version reading [[issue>4446]] [[issue>4445]]
    * fix issues with locale dependent dates [[issue>4449]]
    * fix issues with styling in Extension Manager
    * no longer complain about missing write permissions for bundled extensions in Extension Manager
    * adds missing remote API support for Extension Manager
  * 2025-05-14b
    * fix XSS vulnerability in search [[issue>4512]]
===== Release 2024-02-06b “Kaos” =====

  * :!: DokuWiki requires at least PHP 7.4 now
  * Further fixes for warnings in PHP8+
  * Complete Overhaul of the [[devel:Remote API]] and introduction of the [[devel:JSONRPC]] transport (see [[https://www.patreon.com/posts/96036243|Patreon Post]])
  * Introduction of [[devel:Authentication#Token Auth]]
  * Automatic pruning of logs (see [[config:logretain|Configuration Setting: logretain]])
  * Plugin authors can now set an update message to be shown in extension manager
  * Refactored [[syndication|feed generation]]
  * Better baseurl detection when running behind reverse proxy
  * :!: developers now need to install dev dependencies via [[devel:composer]]
  * Automatic loading of [[devel:autoloader#vendor_autoload|vendor/autoload.php]] for plugins
  * ''SameSite=Lax'' cookie attribute is set by default now (see [[config:samesitecookie|Configuration Setting: samesitecookie]])
  * The default [[template:dokuwiki]] template now supports a SVG logo. The logo height is now fixed to ''64px'' :!:
  * Lots of [[devel:coding style]] fixes
  * Various bug fixes and smaller tweaks

=== Hotfix ===

  * 2024-02-06a
    * fix problem with parsing uneven table columns [[issue>4186]]
    * fix logo aspect ratio in ''dokuwiki'' template when using PNG logo [[issue>4187]]
    * re-add missing [[devel:event:feed_data_process|FEED_DATA_PROCESS]] event [[issue>4191]]
    * fix error handling for plugins with missing info [[issue>4193]]
    * fix doubly declared ''cache'' class error [[issue>4200]]
    * fix content-type header for feeds [[issue>4203]]
    * ignore decryption errors on old cookies [[issue>4198]]
  * 2024-02-06b
    * fix XSS vulnerability in metadata export [[issue>4305]]
===== Release 2023-04-04b “Jack Jackrum” =====

  * A lot of fixes for warnings in PHP8+
    * A new feature flag [[config:hidewarnings]] will suppress the output of warnings, if PHP is configured to show warnings to the end user
  * The options to embed HTML and PHP have been **completely removed** for security reasons :!:
    * [[https://forum.dokuwiki.org/d/20628-after-igor-htmlok-and-phpok-will-no-longer-be-included-in-the-dokuwiki-core|Forum discussion]]
    * [[plugin:htmlok|Plugin alternative]]
  * Fixes
    * quicksearch with UTF-8 chars
    * basic auth header parsing
    * old revisions for pages with dots
    * feed titles
    * handling of unknown config options
    * relaxed media CSP headers for PDF and SVG handling
    * relaxed browseruid check for better browser compatibility
    * compatibility updates for mail sending
  * Unit Tests use php-dom-wrapper instead of phpquery now :!:
  * Improved error logging
  * Dependency Updates

=== Hotfix ===

  * Hotfix 2023-04-04a
    * fix an XSS security vulnerability in RSS handling [[issue>3967]]
  * Hotfix 2023-04-04b
    * fix XSS vulnerability in metadata export [[issue>4305]]
===== Release 2022-07-31b “Igor” =====

  * Fix various errors in PHP8 support
  * Drop support for PHP versions earlier than 7.2
  * SVG-based smileys replace GIF versions
    * :!: may require template update [[pr>3344]]
    * :!: plugins directly embedding SVG may need CSS adjustments [[issue>3690]]
  * Allow "revert" action for logged in users only
  * Various translation updates
  * Add a class ''.logo'' to the ''h1'' title to let administrators remove the ''h1'' around the logo [[pr>3408]]
  * Use [[https://github.com/splitbrain/slika | Slika library]] for image resizing and cropping, with:
    * auto rotation based on EXIF tags
    * support for WEBP
  * Refactored logging mechanism [[pr>3230]], [[pr>3203]] and [[.:plugin:logviewer]]
  * Refactored media manager [[pr>3372]] and lazy loading of images
  * Support for SVG images
  * New form events used. :!: Plugins should implement them, because the old form events are not triggered anymore
  * Some smaller security fixes
  * :!: On [[farms|farm setups]] a log dir needs to be created manually in animals

=== Hotfix ===

  * Hotfix 2022-07-31a
    * fix an XSS security vulnerability [[issue>3761]]
  * Hotfix 2022-07-31b
    * fix an XSS security vulnerability in RSS handling [[issue>3967]]

===== Release 2020-07-29a “Hogfather” =====

  * Lots of internal refactoring to make the code base more modern and robust. You can read a bit [[https://www.patreon.com/posts/18685665|more on the background here]].
  * Defer the loading of JavaScript to improve initial page loads :!: (Some plugins needs to temporary disable the [[config:defer_js]] feature flag)
  * PHP 7.4 compatibility and some preparations for the upcoming PHP8
  * New [[config:trustedproxy]] setting for installations behind a reverse proxy :!:
  * New [[plugin:extension#command_line_interface|command line script]] for managing extensions
  * [[syndication#show_new_items_only|RSS Feed]] can now show new items only
  * A whole ton of smaller bug fixes and improvements
  * Lots of translation upgrades

:!: Note: because of various internal changes, not all plugins or templates may be compatible with this release. It is recommended to check the documentation of the plugins you use before upgrading. As always a backup is recommended before upgrading. :!:

Please also read:

  * [[https://www.patreon.com/posts/38090834|Hogfather Plugin Compatibility]]
  * [[https://forum.dokuwiki.org/d/17863-quick-reminder-what-to-do-when-a-plugin-doesnt-work-on-hogfather|Quick Reminder: What to do when a plugin doesn't work on Hogfather]]
  * [[https://www.patreon.com/posts/19048874|DokuWiki Recovery Script]]

And please also ;
  * Search the [[https://forum.dokuwiki.org|Forum]] when you encounter problems, chances are high that there are already solutions available
  * If you have no clue where the issue originates, check the [[bugs#server_php_error_logs|log files of your webserver]].

=== Hotfix ===

  * Hotfix 2020-07-29a
    * fix an XSS security vulnerability [[issue>3761]]




Previous releases are on **[[Old Changes]].**