tiddlywiki 5.2.0 → 5.2.3

package/editions/tw5.com/tiddlers/system/wikitext-macros.tid

@@ -1,7 +1,45 @@
+code-body: yes
 created: 20150117184156000
-modified: 20150117184616000
-title: $:/editions/tw5.com/wikitext-macros
+modified: 20220617122915793
 tags: $:/tags/Macro
+title: $:/editions/tw5.com/wikitext-macros
+type: text/vnd.tiddlywiki
+
+\define activatePluginTab()
+<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Plugins"/>
+<$action-navigate $to="$:/ControlPanel"/>
+\end
+
+\define activateTiddlerWindow()
+<$action-sendmessage $message="tm-open-window"
+  $param=<<currentTiddler>> windowTitle="Side by Side View"
+  width="800" height="600" />
+\end
+
+\define controlPanel-plugin-link()
+<$button actions=<<activatePluginTab>> class="tc-btn-invisible tc-tiddlylink">
+{{$:/core/images/options-button}} ~ControlPanel
+</$button>
+\end
+
+\define open-tiddler-in-window()
+<$button actions=<<activateTiddlerWindow>> class="tc-btn-invisible tc-tiddlylink">
+open ''this'' tiddler in a new window
+</$button>
+\end
+
+\define activateEditionWindow(url)
+<$action-sendmessage $message="tm-open-external-window"
+  $param="""$url$""" windowName="_edition"
+  windowFeatures="width=800 height=600" />
+\end
+
+\define open-external-window(url)
+<$button actions=<<activateEditionWindow """$url$""">> class="tc-btn-invisible tc-tiddlylink">
+open the ''example edition'' in a new window
+</$button>
+\end
+
 
 \define wikitext-example(src)
 <div class="doc-example">
@@ -43,6 +81,17 @@ $$$
 </div>
 \end
 
+\define wikitext-example-table-header() <thead><tr><th/><th>wiki text</th><th>renders as</th></tr></thead>
+
+\define wikitext-example-table-row(id, code)
+ <tr>
+<th><<__id__>></th><td><$codeblock code=<<__code__>>/></td><td>
+
+<<__code__>>
+</td>
+</tr>
+\end
+
 \define tw-code(tiddler)
 <$codeblock language={{$tiddler$!!type}} code={{$tiddler$}}/>
 \end
@@ -51,4 +100,4 @@ $$$
 [[$tiddler$]]:
 
 <<tw-code $tiddler$>>
-\end
+\end

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_Image.tid

@@ -1,9 +1,9 @@
 caption: $:/tags/Image
 created: 20180926170345251
 description: marks (core) images
-modified: 20180926171456494
+modified: 20211018102336342
 tags: SystemTags
 title: SystemTag: $:/tags/Image
 type: text/vnd.tiddlywiki
 
-The [[system tag|SystemTags]] `$:/tags/Image` marks (core) images
+The [[system tag|SystemTags]] `$:/tags/Image` marks core images. An overview of system icons can be found in the [[Icon Gallery]]

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_Macro_View_Body.tid

@@ -0,0 +1,9 @@
+caption: $:/tags/Macro/View/Body
+created: 20200103092530990
+description: marks global macros only active in View template body
+modified: 20220505082912548
+tags: SystemTags
+title: SystemTag: $:/tags/Macro/View/Body
+type: text/vnd.tiddlywiki
+
+The [[system tag|SystemTags]] `$:/tags/Macro/View/Body` marks macros that are only made available within the main view template bodies and the preview panel.

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_ViewTemplate.tid

@@ -1,9 +1,9 @@
 caption: $:/tags/ViewTemplate
 created: 20180926170345251
-description: marks the view template
+description: identifies the individual segments that are displayed as part of the view template
 modified: 20180926171456532
 tags: SystemTags
 title: SystemTag: $:/tags/ViewTemplate
 type: text/vnd.tiddlywiki
 
-The [[system tag|SystemTags]] `$:/tags/ViewTemplate` marks the view template
+The [[system tag|SystemTags]] `$:/tags/ViewTemplate` identifies the individual segments that are displayed as part of the view template

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_ViewTemplateSubtitle.tid

@@ -0,0 +1,9 @@
+caption: $:/tags/ViewTemplate/Subtitle
+created: 20220714093251204
+description: identifies the individual segments that are displayed as the tiddler subtitle
+modified: 20220714093251204
+tags: SystemTags
+title: SystemTag: $:/tags/ViewTemplate/Subtitle
+type: text/vnd.tiddlywiki
+
+The [[system tag|SystemTags]] `$:/tags/ViewTemplate/Subtitle` identifies the individual segments that are displayed as the tiddler subtitle

package/editions/tw5.com/tiddlers/tiddlydesktop/TiddlyDesktop_Releases.tid

@@ -5,4 +5,4 @@ tags: Releases
 title: TiddlyDesktop Releases
 type: text/vnd.tiddlywiki
 
-The latest release of TiddlyDesktop can be found at https://github.com/Jermolene/TiddlyDesktop/releases/latest, or you can see a [[list of all releases|https://github.com/Jermolene/TiddlyDesktop/releases]].
+The latest release of TiddlyDesktop can be found at https://github.com/TiddlyWiki/TiddlyDesktop/releases/latest, or you can see a [[list of all releases|https://github.com/TiddlyWiki/TiddlyDesktop/releases]].

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 1-2-3.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024604173
+tags: [[Variable Examples]]
 title: Sample Headings 1,2,3
 
 ! This is a Level 1 Heading

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 3-4-5.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024620368
+tags: [[Variable Examples]]
 title: Sample Headings 3,4,5
 
 !!! This is written as a Level 3 heading

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 4-5-6.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024620368
+tags: [[Variable Examples]]
 title: Sample Headings 4,5,6
 
 !!!! This is written as a Level 4 heading

package/editions/tw5.com/tiddlers/variables/modifier Variable.tid

@@ -1,10 +1,10 @@
 created: 20201123120203415
-modified: 20201123120211360
+modified: 20220414162815231
 tags: Variables [[Core Variables]]
 title: modifier Variable
 type: text/vnd.tiddlywiki
 
-Within the ''action'' string of the DroppableWidget, the ''action'' string of the ButtonWidget and the ''action'' string of the LinkCatcherWidget and the EventCatcherWidget, the <<.def modifier>> [[variable|Variables]] contains the modifier key(s) held during the drag-process.
+Within the ''action'' string of the DroppableWidget, the ''startactions'' and ''endactions'' of the DraggableWidget, the ''action'' string of the ButtonWidget and the ''action'' string of the LinkCatcherWidget and the EventCatcherWidget, the <<.def modifier>> [[variable|Variables]] contains the modifier key(s) held during the drag, click or other event.
 Possible key combinations are listed in the table below.
 
 The variable contains a string that identifies the keys:

package/editions/tw5.com/tiddlers/webserver/Using HTTPS.tid

@@ -1,12 +1,14 @@
 created: 20180702160923664
-modified: 20180703100549667
+modified: 20211111023610539
 tags: [[WebServer Guides]]
 title: Using HTTPS
 type: text/vnd.tiddlywiki
 
 By default, TiddlyWiki's WebServer serves resources over the insecure HTTP protocol. The risk is minimal if it is only being used within a private, trusted network but in many situations it is desirable to use a secure HTTPS connection.
 
-HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the [[tls-cert|WebServer Parameter: tls-cert]] and [[tls-key|WebServer Parameter: tls-key]] parameters
+HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the [[tls-cert|WebServer Parameter: tls-cert]] and [[tls-key|WebServer Parameter: tls-key]] parameters.
+
+<<.from-version "5.2.2">> The optional [[tls-passphrase|WebServer Parameter: tls-passphrase]] parameter allows the server to use certificate files that have been generated with a passphrase/password.
 
 Certificates can be obtained from a certification authority such as https://letsencrypt.org/, or you can create a self-signed certificate for internal testing.
 
@@ -17,3 +19,16 @@ openssl req -newkey rsa:2048 -new -nodes -keyout mywikifolder/key.pem -out mywik
 openssl x509 -req -days 365 -in mywikifolder/csr.pem -signkey mywikifolder/key.pem -out mywikifolder/server.crt
 tiddlywiki mywikifolder --listen username=joe password=bloggs tls-key=key.pem tls-cert=server.crt
 ```
+
+If using a [[tls-passphrase|WebServer Parameter: tls-passphrase]] to generate the certificate files, the commands would change as below:
+
+* remove the `-nodes` flag, which specifies "no encryption"
+* replace `TLS_PASSPHRASE` in the `-passout` and `-passin` parameters in the below commands with your chosen string.
+
+This is the simplest, but __least secure method,__ of passing a passphrase to the certificate utility. See [[this Stack Exchange anwser on openssl certificates|https://security.stackexchange.com/questions/106525/generate-csr-and-private-key-with-password-with-openssl]] and the [[openssl|https://www.openssl.org/docs/man1.0.2/man1/openssl.html]] and [[openssl-passphrase-options|https://www.openssl.org/docs/manmaster/man1/openssl-passphrase-options.html]] page in the openssl utility documentation.
+
+```
+openssl req -newkey rsa:2048 -passout pass:TLS_PASSPHRASE -new -keyout mywikifolder/key.pem -out mywikifolder/csr.pem -passout pass:TLS_PASSPHRASE
+openssl x509 -req -days 365 -in mywikifolder/csr.pem -signkey mywikifolder/key.pem -out mywikifolder/server.crt -passin pass:TLS_PASSPHRASE
+tiddlywiki mywikifolder --listen username=joe password=bloggs tls-key=key.pem tls-cert=server.crt tls-passphrase=TLS_PASSPHRASE
+```

package/editions/tw5.com/tiddlers/webserver/WebServer API_ Get All Tiddlers.tid

@@ -20,7 +20,7 @@ In order to avoid denial of service attacks with malformed filters in the defaul
 To enable a particular filter, create a tiddler with the title "$:/config/Server/ExternalFilters/" concatenated with the filter text, and the text field set to "yes". For example, the TiddlyWeb plugin includes the following shadow tiddler to enable the filter that it requires:
 
 ```
-title: $:/config/Server/ExternalFilters/[all[tiddlers]] -[[$:/isEncrypted]] -[prefix[$:/temp/]] -[prefix[$:/status/]]
+title: $:/config/Server/ExternalFilters/[all[tiddlers]] -[[$:/isEncrypted]] -[prefix[$:/temp/]] -[prefix[$:/status/]] -[[$:/boot/boot.js]] -[[$:/boot/bootprefix.js]] -[[$:/library/sjcl.js]] -[[$:/core]]
 text: yes
 ```
 

package/editions/tw5.com/tiddlers/webserver/WebServer Authorization.tid

@@ -1,18 +1,24 @@
 created: 20180630194006239
-modified: 20180904174030250
+modified: 20211122004159427
 tags: WebServer
 title: WebServer Authorization
 type: text/vnd.tiddlywiki
 
-''Authorization'' is the process of determining which resources may be accessed by a particular user. It occurs after [[authentication|WebServer Authentication]] has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has read and write access to a wiki.
+''Authorization'' is the process of determining which resources may be accessed by a particular user. It occurs after [[authentication|WebServer Authentication]] has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has administrator access to the server, and read and write access to a wiki.
 
-The WebServer parameters [[readers|WebServer Parameter: readers]] and [[writers|WebServer Parameter: writers]] each contain a comma separated list of //principals// (which is to say, either usernames or certain special tokens) which should have read or write access respectively.
+The WebServer parameters [[admin|WebServer Parameter: admin]], [[readers|WebServer Parameter: readers]] and [[writers|WebServer Parameter: writers]] each contain a comma separated list of //principals// (which is to say, either usernames or certain special tokens) which should have read or write access respectively. 
 
 The available special tokens are:
 
 * ''(anon)'' - indicates all anonymous users
 * ''(authenticated)'' - indicates all authenticated users
 
+!! Admin Functions
+
+<<.tip"""The ''(anon)'' token is not valid for the [[admin|WebServer Parameter: admin]] parameter.""">>
+
+At this time, no server functions are restricted to ''admin'' authorized users in the unmodified [[Tiddlywiki server|WebServer]]. Third party plugins can leverage this to restrict routes or commands to a subset of authorized users.
+
 !! Read-only Mode
 
 Read-only mode is engaged when the current user is not authorized to write to the current wiki.
@@ -39,3 +45,9 @@ In the following example, read access is granted to all authenticated users, but
 ```
 tiddlywiki mywikifolder --listen credentials=myusers.csv "readers=(authenticated)" writers=mary
 ```
+
+In the following example, read and write access is granted to all authenticated users, but only "mary" is granted admin access:
+
+```
+tiddlywiki mywikifolder --listen credentials=myusers.csv "readers=(authenticated)" "writers=(authenticated)" admin=mary
+```

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ admin.tid

@@ -0,0 +1,8 @@
+caption: admin
+created: 20211111015634164
+modified: 20211111023141767
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: admin
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.2">> The [[web server configuration parameter|WebServer Parameters]] ''admin'' is used to specify the security principals with administrator access to the [[WebServer]]. Does not accept the ''(anon)'' special token. See [[WebServer Authorization]] for more details.

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ required-plugins.tid

@@ -0,0 +1,8 @@
+caption: required-plugins
+created: 20211226160733000
+modified: 20211226160754000 
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: required-plugins
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.2">> The [[web server configuration parameter|WebServer Parameters]] ''required-plugins'' is used to specify the plugins required to start the [[WebServer]]. It take a comma seperated list of plugin titles. The WebServer will issue a warnign in the console if the required plugins are not loaded. This parameter defaults to `$:/plugins/tiddlywiki/filesystem,$:/plugins/tiddlywiki/tiddlyweb`.

package/editions/tw5.com/tiddlers/webserver/WebServer Parameter_ tls-passphrase.tid

@@ -0,0 +1,10 @@
+caption: tls-passphrase
+created: 20211111004416873
+modified: 20211111022120158
+tags: [[WebServer Parameters]]
+title: WebServer Parameter: tls-passphrase
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.2">> The optional [[web server configuration parameter|WebServer Parameters]] ''tls-passphrase'' contains the "certificate passphrase", a string used to decrypt the certificate file used when running the web server under HTTPS.
+
+See [[Using HTTPS]] for details.

package/editions/tw5.com/tiddlers/widgets/$__editions_tw5.com_widget-examples_qualify-transcluded.tid

@@ -0,0 +1,14 @@
+created: 20220125161941555
+modified: 20220125162920771
+tags: [[Widget Examples]]
+title: $:/editions/tw5.com/widget-examples/qualify-transcluded
+type: text/vnd.tiddlywiki
+
+<$macrocall $name=".example" n="1"
+eg="""<$qualify title="BaseTiddler" name="iamnotanumber">
+<ul>
+<li><code><<iamnotanumber>></code></li>
+<li><code><<transclusion>></code></li>
+</ul>
+</$qualify>
+"""/>

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 1.tid

@@ -1,6 +1,6 @@
 created: 20200131142401129
-modified: 20201020112608874
-tags: ActionCreateTiddlerWidget
+modified: 20211113230406823
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 1
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 2.tid

@@ -1,6 +1,6 @@
 created: 20200131144828713
-modified: 20201020112601032
-tags: ActionCreateTiddlerWidget
+modified: 20211113011036840
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 2
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 3.tid

@@ -1,6 +1,6 @@
 created: 20200131145355658
-modified: 20201020112553050
-tags: ActionCreateTiddlerWidget
+modified: 20211113011111052
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 3
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 4.tid

@@ -1,6 +1,6 @@
 created: 20200131150229551
-modified: 20201020112544146
-tags: ActionCreateTiddlerWidget
+modified: 20211113011129601
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 4
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Template.tid

@@ -1,6 +1,6 @@
 created: 20200131145608087
-modified: 20200131150801682
-tags: test
+modified: 20211116192551162
+tags: test [[Widget Examples]]
 title: ActionCreateTiddlerWidget Template
 type: text/vnd.tiddlywiki
 x: x

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget_Example.tid

@@ -1,6 +1,6 @@
 created: 20161020153426686
-modified: 20161020155142990
-tags: ActionCreateTiddlerWidget
+modified: 20211113011019510
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid

@@ -1,7 +1,7 @@
 caption: action-listops
 created: 20141025120850184
 list: efg hlm pqr
-modified: 20151228083329099
+modified: 20211115091121133
 myfield: 
 revision: 0
 tags: ActionWidgets Widgets
@@ -29,13 +29,63 @@ The ''action-listops'' widget is an [[action widget|ActionWidgets]] that manipul
 The ''action-listops'' widget is invisible. Any content within it is ignored.
 
 |!Attribute |!Description |
-|$tiddler |The title of the tiddler whose lists are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]] |
+|$tiddler |The title of the tiddler whose lists are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]]) |
 |$field |The name of a field to be manipulated as a list (defaults to 'list') |
 |$index |Optional index of a property in a [[data tiddler|DataTiddlers]] index to be manipulated as a list |
 |$filter |An optional filter expression, the output of which will be saved to the field/index being manipulated |
 |$subfilter |An optional subfilter expression, which takes the list being manipulated as input, and saves the modified list back to the field/index being manipulated |
 |$tags |An optional subfilter expression, which takes the 'tags' field of the target tiddler as input, and saves the modified list of tags back to the 'tags' field |
 
+! $filter vs. $subfilter
+
+Standalone use of the `$subfilter` attribute can be replaced by using a (more complicated) `$filter` attribute value.
+
+For example, the items "abc" and "123" can be appended to the field `myfield` using the `$subfilter` attribute:
+
+```
+<$action-listops $field="myfield" $subfilter="abc 123"/>
+```
+
+The same can be achieved using the `$filter` attribute and prepending the [[Filter Run]] `[all[current]get[myfield]enlist-input[]]` to the [[Filter Expression]]:
+
+```
+<$action-listops $field="myfield" $filter="[all[current]get[myfield]enlist-input[]] abc 123"/>
+```
+
+The short form is more convenient, but the long form is useful for live-debugging complicated `$subfilter` values using the filter tab of [[$:/AdvancedSearch]]. By using [[$:/AdvancedSearch]], the [[Filter Expression]] can be tested before using ''action-listops'' to modify actual tiddler fields. For this use case, the `all[current]` portion of the expression needs to be changed to select the proper test tiddler.
+
+! $tags vs. $field + $subfilter
+
+[[Tagging]] is implemented using a tiddler's 'tags' field, so appending the tags "abc" and "123" using the `$tags` attribute like this:
+
+```
+<$action-listops $tags="abc 123"/>
+```
+
+is mostly equivalent to using `$subfilter` along with "tags" for the value of `$field`:
+
+```
+<$action-listops $field="tags" $subfilter="abc 123"/>
+```
+
+! $action-listops widget vs. $action-setfield widget
+
+The ActionSetFieldWidget replaces a field's value using `$field`/`$value` attributes. A single ActionSetFieldWidget can be used to set any number of fields by using attributes not starting with $.
+
+The ActionListopsWidget replaces or modifies a single field's value. The new value is generated using filters.
+
+The following two examples are functionally equivalent:
+
+```
+<$action-setfield $field="myfield" $value="abc 123"/>
+```
+
+```
+<$action-listops $field="myfield" $filter="abc 123"/>
+```
+
+In general, ActionSetFieldWidget is better for setting multiple fields at once and for replacing a field's value. The ActionListopsWidget is better for modifying a field based on the field's existing value and for using a [[Filter Expression]] to derive the value.
+
 ! Extended Filter Operators
 
 A number of [[extended filter operators|The Extended Listops Filters]] are necessary for the manipulation of lists. These operators have been designed primarily for use in subfilter expressions whereby the modified current list is returned in place of the current list.

package/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid

@@ -1,6 +1,6 @@
 caption: action-sendmessage
 created: 20141008134309742
-modified: 20150518210909583
+modified: 20211023160110220
 tags: Widgets ActionWidgets
 title: ActionSendMessageWidget
 type: text/vnd.tiddlywiki
@@ -18,6 +18,8 @@ The ''action-sendmessage'' widget is invisible. Any content within it is ignored
 |$param |Optional parameter string whose meaning is dependent on the message being sent |
 |$name |Optional name of additional parameter |
 |$value |Value for optional parameter whose name is specified in `$name` |
+|$names |<<.from-version "5.2.1">> Optional filter evaluating to a list of additional parameter names |
+|$values |<<.from-version "5.2.1">> Optional filter evaluating to a list of parameter values corresponding to the parameters names specified in `$names` |
 |//{any attributes not starting with $}// |Multiple additional, optional named parameters that are attached to the message |
 
 ! Examples

package/editions/tw5.com/tiddlers/widgets/ActionSetMultipleFieldsWidget.tid

@@ -0,0 +1,31 @@
+caption: action-setmultiplefields
+created: 20211023160110220
+modified: 20211023160110220
+tags: Widgets ActionWidgets
+title: ActionSetMultipleFieldsWidget
+type: text/vnd.tiddlywiki
+
+! Introduction
+
+The ''action-setmultiplefields'' widget is an [[action widget|ActionWidgets]] that assigns multiple fields to a tiddler where the names and values of the fields are specified as separate filters. ActionWidgets are used within triggering widgets such as the ButtonWidget.
+
+! Content and Attributes
+
+The ''action-setmultiplefields'' widget is invisible. Any content within it is ignored.
+
+|!Attribute |!Description |
+|$tiddler |Optional title of the tiddler to modify (defaults to the current tiddler) |
+|$fields |Optional filter evaluating to the names of a list of fields to assign. Either `$fields` or `$indexes` must be specified  |
+|$indexes |Optional filter evaluating to the names of a list of indexes to assign. Either `$fields` or `$indexes` must be specified |
+|$values |Filter evaluating to the values to be assigned to the fields or indexes |
+|$timestamp |Specifies whether the timestamp(s) of the target tiddler will be updated (''modified'' and ''modifier'', plus ''created'' and ''creator'' for newly created tiddlers). Can be "yes" (the default) or "no" |
+
+! Examples
+
+Here is an example of button that uses the data in [[Days of the Week]] to assign fields `day-Monday`, `day-Tuesday` etc. to the tiddler "HelloThere":
+
+<$macrocall $name='wikitext-example-without-html'
+src='<$button>
+<$action-setmultiplefields $tiddler="HelloThere" $fields="[list[Days of the Week]addprefix[day-]]" $values="[list[Days of the Week]]"/>
+Click me!
+</$button>'/>

package/editions/tw5.com/tiddlers/widgets/ActionWidget Execution Modes.tid

@@ -1,3 +1,6 @@
+created: 20211003094722447
+modified: 20211116193245990
+tags: Widgets
 title: ActionWidget Execution Modes
 
 <<.from-version "5.2.0">> The default behaviour of action widgets has some peculiarities that often cause confusion. There is now an improved mode that simplifies how things work, but due to BackwardsCompatibility constraints, it must be explicitly engaged in order to take advantage of it.
@@ -21,9 +24,9 @@ Current value of ActionTestTiddler: {{ActionTestTiddler}}
 Click me
 </$button>'/>
 
-The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scopr that includes the variable `tv-action-refresh-policy` set to the value `always`.
+The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scope that includes the variable `tv-action-refresh-policy` set to the value `always`.  (The default value for `tv-action-refresh-policy` is `once`).
 
-This can be done within an action string, or via a local variable declaration containing the widget triggering the action.
+The assignment can be done within an action string, or via a local variable declaration containing the widget triggering the action.
 
 <<.warning "Do not attempt to set `tv-action-refresh-policy` globally; the core will only work correctly with the default setting">>
 

package/editions/tw5.com/tiddlers/widgets/ActionWidgets.tid

@@ -1,10 +1,10 @@
 created: 20141008134425548
-modified: 20210630163127249
+modified: 20211031172913375
 tags: Widgets
 title: ActionWidgets
 type: text/vnd.tiddlywiki
 
-Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that trigger those actions (for example, the ButtonWidget).
+Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that [[trigger those actions|TriggeringWidgets]] (for example, the ButtonWidget).
 
 The following action widgets are provided:
 
@@ -17,7 +17,7 @@ There are two ways to use action widgets:
 
 !! Using action string attributes
 
-The action widgets are passed as a string to the `actions` attribute of the triggering widget. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
+The action widgets are passed as a string to the `actions` attribute of the [[triggering widget|TriggeringWidgets]]. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
 
 ```
 \define my-actions()
@@ -32,7 +32,7 @@ Click me!
 
 !! Directly embedding action widgets
 
-The action widgets need not be immediate children of their triggering widget, but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
+The action widgets need not be immediate children of their [[triggering widget|TriggeringWidgets]], but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
 
 ```
 <$button>

package/editions/tw5.com/tiddlers/widgets/ButtonWidget.tid

@@ -1,7 +1,7 @@
 caption: button
 created: 20131024141900000
-modified: 20201108183908170
-tags: Widgets
+modified: 20211009121239795
+tags: Widgets TriggeringWidgets
 title: ButtonWidget
 type: text/vnd.tiddlywiki