caption: 5.2.4
created: 20221213163110439
modified: 20221213163110439
released: 20221213163110439
tags: ReleaseNotes
title: Release 5.2.4
type: text/vnd.tiddlywiki
description: Hot fixes for v5.2.3, Twitter archivist plugin, GenesisWidget, JSON read operators, nested macro definitions

//[[See GitHub for detailed change history of this release|https://github.com/TiddlyWiki/TiddlyWiki5/compare/v5.2.3...v5.2.4]]//

<<.banner-credits
	credit:"""Congratulations to [[dmikh|https://talk.tiddlywiki.org/u/dmikh]] for their winning design for the banner for this release (here is the [[competition thread|https://talk.tiddlywiki.org/t/new-release-banner-competition-for-v5-2-4/4982]] and the [[voting thread|https://talk.tiddlywiki.org/t/vote-for-the-v5-2-4-new-release-banner/5140/2]]).
"""
	url:"https://raw.githubusercontent.com/Jermolene/TiddlyWiki5/0dc30086e933cf2272cddb076a9fcbedad252735/editions/tw5.com/tiddlers/images/New%20Release%20Banner.png"
>>

! Important Update

After the release of v5.2.5, we found some backwards compatibility issues with the stylesheet changes in [[#7039|https://github.com/TiddlyWiki/TiddlyWiki5/pull/7039]] and [[#6910|https://github.com/TiddlyWiki/TiddlyWiki5/pull/6910]]. We have therefore decided to make a rapid bug fix [[Release 5.2.5]] to resolve these issues, and all users should upgrade to the new version.

! Major Improvements

New [ext[Twitter Archivist|./editions/twitter-archivist]] plugin to import the tweets and associated media from a Twitter Archive as individual tiddlers.

<<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6961">> new GenesisWidget that allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance

<<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6936">> (and <<.link-badge-here "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7105">>) new operators for reading and formatting JSON data: [[jsonget Operator]], [[jsonindexes Operator]], [[jsontype Operator]], [[jsonextract Operator]] and [[format Operator]]

! Translation Improvements

Improvements to the following translations:

* Chinese
* French
* German
* Polish
* Spanish
* Japanese

Improvements to the translation features of TiddlyWiki itself:

* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6882">> the [[Translators Edition|Translate TiddlyWiki into your language]] to add an option to display the original English text underneath the text area
* <<.link-badge-updated "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6933">> "delete" button text in $:/AdvancedSearch so that it is translatable

! Usability Improvements

* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/d62a16ee464fb9984b766b48504829a1a3eb143b">> problem with long presses on tiddler links triggering a preview on iOS/iPadOS
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6910">> consistency of button and input elements across browsers
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/d825f1c875f5e46158c9c41c8c66471138c162d1">> edit preview to use the [[View Template Body Cascade]]
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/36896c3db8c9678c0385a561996248a6f00a45ff">> opening a tiddler in a new window to use the [[View Template Body Cascade]]
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6970">> detection of infinite recursion errors in widgets and filters
* <<.link-badge-extended "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6877">> default styles for [[styled runs|Styles and Classes in WikiText]]
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6881">> upgrade wizard to make the version number more prominent
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7042">> parsing of tiddlers containing CSV data for greater compatibility
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7076">> new page control button to summon the layout switcher
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/issues/7084">> folded tiddlers to ensure that the unfold button is always visible
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7072">> handling of [[Modals]] to optionally allow them to be dismissed by clicking on the background

! Widget Improvements

* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/127f660c91020dcbb43897d954066b31af729e74">> EditTextWidget to remove the default text "Type the text for the tiddler 'foo'"
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7081">> ''focus'' attribute to SelectWidget
* <<.link-badge-removed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/1df4c29d73073788ba3859668112e8bb46171a6c">> restriction of the LetWidget being unable to create variables whose names begin with a dollar sign

! Filter improvements

* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/issues/6303">> issue with availability of variables within filter runs
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7065">> issue with removing multiple items from a linked list during filter processing

! Hackability Improvements

* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7004">> support for nested [[macro definitions|Macro Definitions in WikiText]]
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6976">> support for [[SystemTag: $:/tags/ClassFilters/TiddlerTemplate]] and [[SystemTag: $:/tags/ClassFilters/PageTemplate]] to assign dynamic CSS classes to both tiddler frames and the page template
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/commit/c5d3d4c26e8fe27f272dda004aec27d6b66c4f60">> safe mode to disable wiki store indexers
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/166a1565843878083fb1eba47c73b8e67b78400d">> safe mode to prevent globally disabling parser rules
* <<.link-badge-extended "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6735">> keyboard shortcut handling to allow to global shortcuts to override all other shortcuts
* <<.link-badge-extended "https://github.com/TiddlyWiki/TiddlyWiki5/commit/965bd090a905f5756e79124b698c894f7f72ad5b">> [[list-links Macro]] to allow the rendered field to be overriden
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6913">> [[Table-of-Contents Macros]] to allow the default icons to be overridden
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6939">> ''data-tags-*'' and ''data-tiddler-title'' attributes to the edit preview area
* <<.link-badge-extended "https://github.com/TiddlyWiki/TiddlyWiki5/pull/5947">> [[timeline Macro]] to override the link template
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7043">> support for Unix epoch timestamps in [[date format strings|DateFormat]]
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7064">> the "big green download button" to use the defined palette colour
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7063">> new hidden setting [[to use horizontal tabs for the "more" sidebar tab|Hidden Setting: More Tabs Horizontal]]
* <<.link-badge-extended "https://github.com/TiddlyWiki/TiddlyWiki5/commit/bef11fe6a25fb849dee40c4aa4337d6a30daf0b4">> the [[external JavaScript templates|Using the external JavaScript template]] to allow the URL of the external script file to be configured

! Bug Fixes

* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7099">> truncated search results on small screens
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7010">> table contents overflow on small screens
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/fb34df84ed41882c1c2a6ff54f0e908b43ef95a3">> "new image" keyboard shortcut not to assign journal tags
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6987">> SelectWidget class to update if it uses a filter
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/issues/7017">> issue with wikification within the advanced search filter dropdown
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7057">> the table in $:/Import to avoid creating hidden empty rows
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/issues/7008">> advanced search keyboard shortcut not navigating correctly
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/issues/7083">> erroneous display of drafts within the advanced search filter dropdown
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7092">> backwards compatibility of new field editor cascade introduced in v5.2.3

! Node.js Improvements

* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7073">> new CommandsCommand to enable command tokens to be dynamically generated from a filter
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6947">> console logging to avoid spaces and `<empty string>` message
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7014">> problem  with lazy loading deleting tiddler bodies under certain circumstances
* <<.link-badge-fixed "https://github.com/TiddlyWiki/TiddlyWiki5/commit/344110e2890caf711ab8f3c4f4deaa7d86771231">> handling of ".mp4" file extension so that it defaults to video not audio
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6588">> test server to the plugin library edition
* <<.link-badge-added "https://github.com/TiddlyWiki/TiddlyWiki5/pull/7049">> [[Hidden Setting: Sync Logging]] to control logging of sync-related messages
* <<.link-badge-updated "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6944">> Jasmine plugin to require the explicit use of the `--test` command in order to cause the tests to be run

! Performance Improvements

* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/commit/53d229592df76c6dd607e40be5bea4d5e063c48e">> performance of `wiki.getTiddler()`
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/commit/81ac9874846b3ead275f67010fcfdb49f3d2f43c">> performance of variable prototype chain handling
* <<.link-badge-improved "https://github.com/TiddlyWiki/TiddlyWiki5/pull/6056">> performance of list handling during filter processing

! Acknowledgements

[[@Jermolene|https://github.com/Jermolene]] would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:

<<.contributors """
AnthonyMuscio
bestony
btheado
BramChen
carlo-colombo
EvidentlyCube
FlashSystems
flibbles
fu-sen
joebordes
hoelzro
kookma
linonetwo
Marxsal
oflg
pmario
rmunn
roma0104
saqimtiaz
simonbaird
talha131
Telumire
tw-FRed
twMat
xcazin
""">>
