Attachments Macro

Last modified by Alex Cotiugă on 2024/09/02 00:14

attachLists all the attachments from the current document in a livetable.
TypeXAR
CategoryMacro
Developed by

Raluca Stavro, Marius Dumitru Florea, slauriere

Active Installs8
Rating
2 Votes
LicenseGNU Lesser General Public License 2.1
Compatibility

XWiki 12.10+

Installable with the Extension Manager

Description

The Attachments Macro is a macro that lists all the attachments from the current document in a livetable. You can specify parameters such as the sort order or the document to display attachments from. 

Usage

{{attachments document="Space.SomeDocWithAttachments" /}}

Parameters

NameOptionalDescription
sortYesThe column to sort by : name (default), type, size, author, date
orderYesSort order : asc (default), desc
limitYesNumber of entries per page (10 by default)
documentYesThe document to display attachments for (current document by default)

Screenshots

Order by attachment name:

SortByName.png

Filter by attachment name:

FilterByName.png

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Release Notes

v3.5

v3.4

  • Extension now available from XWiki Maven public repository

v3.3

  • Fix the deprecation warnings added to the server logs
  • Fix the display of the attachment author column
  • Upgrade minimum XWiki version to 12.10

v3.2

  • Bugfix: If the macro is used multiple times on the same page only the first instance works. All the rest show "The environment prevents the table from loading data".

v3.1

  • Bugfix: Attachments with uppercase letters in the file name were not found when searching for these letters

v3.0

  • Display the user avatar on the author column
  • Removed custom JavaScript code (custom livetable.js and custom live table raw callback)
  • Removed overwritten Velocity macros
  • Replaced deprecated calls
  • Use the new localization module (no need to register the translation bundle in the administration)
  • Use the JSON Velocity tool to generate the JSON for the live table
  • Code cleanup and small refactoring

v2.0

  • Use a live table to display the list of attachments, instead of a static table

Get Connected