Re: [xwiki-devs] [Discussion] Recent Changes macro name and parameters

On Tue, Nov 9, 2010 at 9:05 AM, Vincent Massol <vincent(a)massol.net> wrote: I was thinking about 'events' parameter. Users can use this parameter in order to increase the number of sub-entries to show, so this way major versions would be displayed at one point. What is not clear for me is the reason why we have to hide minor versions. Minor versions could contain important changes, and hiding them by default would cut part of the information.

With the new design, displaying more items does not agglomerate the interface. So, if this is really needed and it is considered as a regression, it will be back by tomorrow. Yes, this is in the plan.

Raluca. > > Thanks > -Vincent > >>>> *  'tag'  (comma separated list): - Comma separated list of tags to >>>> display activity for. >>>> -> to be replaced with 'tags' >>>> >>> >>> +1 >>> >>> >>>> *  'space'  (comma separated list): - Comma separated list of spaces >>>> to display the recent activity for. >>>> -> to be replaced with 'spaces' >>>> -> also remove 'recent' from the macro description >>>> >>> >>> +1 >>> >>> *  'author'  (comma separated list): - Comma separated list of authors >>>> whose modifications to show. >>>> -> to be replaced with 'authors' >>>> >>> >>> +1 >>> >>> >>>> *  'changesNb'  (number: 30 by default): - Number of activity to show. >>>> -> to replace the description with 'Number of pages to display the activity >>>> of.' >>>> -> to be replaced with 'pages' or 'entries' or some other name that >>>> would fit better; you are welcome to add naming proposals. >>>> -> to replace '30' with '20', now that each entry (page) contains a >>>> number of sub-entries (activity events) and there will be a way to >>>> 'show more' entries (Facebook style) >>>> >>> >>> 'Number of _entries_ to display the activity _for_.' >> Right. >> >>> should be entries/items because when we extend to add also applications >>> events, pages will be deprecated. >>> >>> +1 entries >>> >>> >>>> New macro parameters to be added: >>>> *  'events'  (number: 10 by default): - Number of events to show for >>>> each page entry. >>>> -> you are welcome to add naming proposals. >>>> >>> >>> +1 subentries >>> >>> *  'modifications' (boolean: false by default) - Whether to show 'see >>>> modifications' link on 'edited the page' events. >>>> -> other naming proposals: 'diff', 'differences', 'actions' >>>> >>> >>> you're talking about 'see changes' >>> Actually I don't know why we need a parameter to display this link. It has a >>> limited scope (page edit events) and contains usefull information. >> AFAIK, it was requested by Vincent. Let's see what the others think >> about this parameter. >> >> Raluca. >> >>> >>> Example: >>> {{activity entries='3' subentries='3' authors='XWiki.Admin' tags='xwiki' >>> spaces='Main'/ } } >>> >>> Thanks, >>> Caty >>> >>> >>>> Raluca. >>>> >>>> >>>>> On Oct 20, 2010, at 4:05 PM, Anca Luca wrote: >>>>> >>>>>> Hi devs, >>>>>> >>>>>> I've been working on http://jira.xwiki.org/jira/browse/XE-721 and it's >>>> done on my local. This is the recent changes macro based on the current >>>> implementation (not the activity stream one), but the idea is that we'll >>>> rewrite it to display recent activity in the future. I will commit it for >>>> the moment, in the 2.6 trunk, as is, but I would like to discuss here the >>>> name of the macro and its parameters: >>>>>> Macro name: >>>>>> recentchanges, changes, activity, recentactivity >>>>> +1 for "activity" to be in line with the upcoming recent activity feature >>>> planned for 2.6. >>>>> >>>>> No need for "recent", "activity" is enough. It's about the activity of the >>>> wiki. >>>>>> Parameters: >>>>>> * rss link should be shown at the bottom of the changes table (boolean): >>>> showRss, rss >>>>> +1 rss (default true) >>>>> >>>>>> * minor changes are shown or not (boolean, default false): showMinor, >>>> minor >>>>> +1 minor >>>>> >>>>>> * shows "see modifications" link next to entries (boolean, default true): >>>> showDiff, showDifferences, diff, differences >>>>> I don't like too much diff* >>>>> What about "actions"? It's more than just the difference link, there could >>>> be >>>> other actions, as in the {{spaces/}} macro for example. >>>>>> * number of changes to show (number, 0 means "all", defaults to 30): >>>> changesNb, changesCount, number, count, limit >>>>> +1 count >>>>> >>>>>> * tags of documents to show chages for (comma separated list): tag, tags >>>>> +1 tags >>>>> >>>>>> * spaces of documents to show changes for (comma separated list): space, >>>> spaces >>>>> +1 spaces >>>>> >>>>>> * authors of documents to show changes for (comma separated list): >>>> author, authors >>>>> +1 authors >>>>> >>>>> Note that the types cannot be enforced since it's a wiki macro, I put them >>>> there just for orientation. >>>>> I'd go for activity rss minor diff count tags spaces authors . >>>>> >>>>> Thanks -Vincent