TagQueryDashlet_4x

tag query dashlet for Alfresco Share which displays all documents of a site that are tagged with a configurable tag
Featured, dashlet, 4.0

Updated Feb 7, 2012 by ecm.exp...@gmail.com

This wiki pages describes the Tag Query Dashlet for Alfresco 4.x

wiki page of the Alfresco 3.4.x version compliant dashlet: Tag Query Dashlet for Alfresco 3.4.x

Tag Query Dashlet for Alfresco Share

Features
Installation
Using the dashlet
Roadmap

Tag Query Dashlet for Alfresco Share

Author: Jan Pfitzner (alfrescian.com & twitter.com/alfrescian)

This project defines a tag query document dashlet for the Alfresco Dashlet Challenge 2011. The dashlet displays a list of documents that are tagged with a configurable tag. version 0.3.1 also displays tagged folders

Features

Dashlet now uses the new Alfresco 4.x Dashlet layout/features:

Following features are implemented:

simple & detail view
display a thumbnail of the documents (simple view: on mouse-over).
display the favorite status & allows the user to mark/unmark a document as favorite (detail view only)
display the likes & allows the user to like/unlike a document (detail view only)
display a link to comment on a document (detail view only)
list uses paging with a configurable page size
end user friendly configuration dialog (only accessible for SiteManagers)

Repository Web-Script changes

To reuse the tag-picker control in the dashlet configuration dialog the repository webscript controller org/alfresco/repository/forms/pickeritems.post.json.js gets a small modification. It now support a text-based tag as parameter & not only a nodeRef-based tag param.

Browser support

Chrome and Firefox have been tested and work fine

Installation

The component has been developed to install on top of an existing Alfresco 4.0.b (Community)

You need to copy the tag-query-dashlet.jar to tomcat/shared/lib.

Using the dashlet

Please do the following steps to get the dashlet running:

Log in to Alfresco Share and navigate to site dashboard where you are Site-Manager Click the Customize Dashboard button to edit the contents of the dashboard and drag the dashlet into one of the columns from the list of dashlets.

Return to your site dashboard & click the configure/edit icon in the dashlet header to open the configuration dialog of the dashlet:

Once configured your dashlet should look like this:

Roadmap

Following features are on the roadmap:

add support of categories
add support of wiki pages, links, blog posts etc.
support user-dashlet mode
add nice & smart content preview dialog

Comment by mu...@dsty.ac.jp, Feb 4, 2012

How can the listing be changed to output folders as well as docs? Also a change to have the output list have one line per item would result in a dynamic table of contents for all items tagged with some thing such as "toc".

Comment by mu...@dsty.ac.jp, Feb 5, 2012

I am rather new to Alfresco (1 week so far) so not familiar with the tables, globals, directories, etc., but looking at the source in "/source/web/components/dashlets/documentsForTag.js" I can see part 2 of the above could be achieved by: comment out line #210 to remove the thumbnail comment out line #444 to remove the date line

The the first part of above is not so simple (perhaps) but I will try changing line #207 of the same file from: container: this.id + "-documents", to: container: this.id + "-folders",

This may swap the output from documents only to folders only, but the ideal would be to have both folders and documents in the output.

I will try the mods and build with ant and will see.

Comment by mu...@dsty.ac.jp, Feb 5, 2012

The part of reducing the list to single-line entries through commenting out line #210 and #444 of /source/web/components/dashlets/documentsForTag.js (Rev r92) works.

However, I was merely guessing at how to get the list to output folders rather than only documents. Will keep looking but would appreciate some guidelines if anyone can assist.

If this is successful, perhaps adding user configurable settings to enable these features would be good. The dashlet could then be used together with an automatic rule to add the tag 'toc' to all folders to create a clickable dynamic table-of-contents for the site's documents.

Comment by mu...@dsty.ac.jp, Feb 5, 2012

Hmm, looking at line 490 and 516 it appears the dashlet should be showing folders in the output list after all. Is this a bug? I will submit a bug report on the matter just in case.

Comment by project member ecm.exp...@gmail.com, Feb 7, 2012

Support of tagged folders was recently added in version 0.3.1

► Sign in to add a comment