Hi Jeremie, Jeremie wrote:

Hi all,

It'm trying to use "tags" as a more structured categorization feature.

First I saw that in tagedit.vm, we can change to a select list instead of an input field for entering tags. I changed this in the displayEdit property for XWiki.TagClass, but without effect.

In tagedit.vm we have (XWiki 1.5) :

#set($displayType = $xwiki.getDocument("XWiki.TagClass").xWikiClass.tags.getProperty('displayType').value) #set($possibleTags = $tdoc.tagsPossibleValues) ....

First line is ok and says "select", but $tdoc.tagsPossibleValues is always empty ...

So my question is : where is defined the list of possible tags for page(s) ? I though it was the "tags" field of page XWiki.TagClass, but it seems it's not ...

I didn't even know this feature! I checked the code of "getTagsPossibleValues" in XWikiDocument.java (http://fisheye2.atlassian.com/browse/~raw,r=11430/xwiki/xwiki-platform/core/...), the list is constructed based of pipe-separated values in the "tags" property of XWiki.TagClass (this is the moment I discovered that tags are stored as a static list, too ;)) So if you say "tag1|tag2|tag3" here, this is what $doc.tagsPossibleValues will return you (as a list). Hope this helps. When you successfully do have the tags displayed as a select list with finished list of possible values, what would be cool is that you create a FAQ entry for it to explain how you did. Cheers, Jerome.

Thanks for help, Jeremie

Vincent Massol wrote:

Maybe this documentation would help: http://code.xwiki.org/xwiki/bin/view/Applications/TagApplication

Indeed, it's all there, so this make the FAQ entry useless. I could not find it (nor a link to it) in the 2 places I looked for: - Features on enterprise.xwiki.org - search for "tags" (ok, the tag application is on the second result page and I did not click, bad assumption from me here) All that to say 2 things (which are actually almost the same) : - It's not natural to look for user documentation on code.xwiki.org - We need more internal links. Mainly because our search is not yet 100% relevant, and because it's not natural to look for user documentation in application space on code.xwiki.org. I would have been able to find it if it were linked from the Features space, ;ike: Features -> Organize your documents (Spaces and Tags) -> Tag application on code.xwiki.org Just to brainstorm on documentation "findability", Jerome.

Thanks -Vincent

On Apr 7, 2009, at 7:38 AM, Jerome Velociter wrote:

...

Hi Jeremie,

Jeremie wrote:

...

Hi all,

It'm trying to use "tags" as a more structured categorization feature.

First I saw that in tagedit.vm, we can change to a select list instead of an input field for entering tags. I changed this in the displayEdit property for XWiki.TagClass, but without effect.

In tagedit.vm we have (XWiki 1.5) :

#set($displayType = $ xwiki .getDocument ("XWiki.TagClass").xWikiClass.tags.getProperty('displayType').value) #set($possibleTags = $tdoc.tagsPossibleValues) ....

First line is ok and says "select", but $tdoc.tagsPossibleValues is always empty ...

So my question is : where is defined the list of possible tags for page(s) ? I though it was the "tags" field of page XWiki.TagClass, but it seems it's not ... I didn't even know this feature! I checked the code of "getTagsPossibleValues" in XWikiDocument.java (http://fisheye2.atlassian.com/browse/~raw,r=11430/xwiki/xwiki- platform/core/trunk/xwiki-core/src/main/java/com/xpn/xwiki/doc/ XWikiDocument.java), the list is constructed based of pipe-separated values in the "tags" property of XWiki.TagClass (this is the moment I discovered that tags are stored as a static list, too ;))

So if you say "tag1|tag2|tag3" here, this is what $doc.tagsPossibleValues will return you (as a list).

Hope this helps. When you successfully do have the tags displayed as a select list with finished list of possible values, what would be cool is that you create a FAQ entry for it to explain how you did.

Cheers, Jerome.

...

Thanks for help, Jeremie

---

users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users

_______________________________________________ users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users

Hi, On Wed, Apr 8, 2009 at 4:24 PM, Jeremie <[email protected]>wrote:

Thanks Vincent for answer, I think it will perfectly fit my need ! And I agree with you Jerome for "findability" ...

But before switching to structured tags on my wiki, what will happen if I do while many pages are already tagged, with tags not provided in the possible tags list ? Will they be removed from the tags list of these pages ?

I think they will remain there and still show up when editing the specific page. You might want to run a cleaning script to delete all tags (or specific tags) first, then apply the change. Guillaume

Jeremie. -- View this message in context: http://n2.nabble.com/Use-Tags-as-select-list-instead-of-input-tp2575113p2605... Sent from the XWiki- Users mailing list archive at Nabble.com.

_______________________________________________ users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users

-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/

Hi, On Wed, Apr 8, 2009 at 5:24 PM, Jeremie <[email protected]>wrote:

Hi,

I think they will remain there and still show up when editing the specific page. You might want to run a cleaning script to delete all tags (or specific tags) first, then apply the change. Guillaume

Ok, in fact I'd prefer to mix the 2 worlds : structured and unstructured, so users could choose in a list of structured tags, and add their own tags freely. But in this way it's more like using categories and tags. At first it was what I wanted to do, split tags edition in distinct categories plus a free text field for normal tags (and have everything saved in "tags" field), but maybe structured tags will be enough ...

Well, that's what is done in the new Blog application (categories + tags), so you could look at it and try to emulate it for other kinds of pages as well, but I'm not sure how easy it is to do... Guillaume

Thanks again, Jeremie -- View this message in context: http://n2.nabble.com/Use-Tags-as-select-list-instead-of-input-tp2575113p2605... Sent from the XWiki- Users mailing list archive at Nabble.com.

_______________________________________________ users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users

-- Guillaume Lerouge Product Manager - XWiki Skype ID : wikibc http://guillaumelerouge.com/