Feature Proposals » INCLUDE with new attachment parameter to include an attachment

Motivation

You can include an attachment with %INCLUDE{%ATTACHURL%/filename.ext}%, which causes INCLUDE to retrieve the specified attachment directly without issuing an HTTP request to itself now that TWikibug:Item7592 is implemented. Still, this is roundabout -- composing an attachment URL and then having INCLUDE parse it. Plus, you need to put variables such as %ATTACHURL%, %PUBURL%, and %WEB% as shown in the examples below, which is no big deal but it's better to be able to do the same things without using those variables.

IncludeAttachment was proposed and partially implemented in 2004 but that feature seemed to have abandoned later. This proposal is to revive that feature.

Description and Documentation

• Introduce attachment="filename.ext" parameter to INCLUDE. Variables in the attachment is evaluated in the context of the web and topic it's attached
• %INCLUDE{%PUBURL%/WebName/TopicName/filename.ext}% keeps working as before. It's close to %INCLUDE{"WebName.TopicName" attachment="filename.ext"}% but not identical -- topic context change doesn't happen. This is to make it consistent with an inclusion from outside TWiki.

Examples

Impact

Implementation

-- Contributors: Hideyo Imazu - 2014-11-21

Discussion

This is a sensible enhancement.

-- Peter Thoeny - 2014-11-30