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

Hi Vincent, On Tue, Nov 9, 2010 at 08:50, Vincent Massol <vincent(a)massol.net> wrote: One issue I currently have with this is that when a comment gets added to a page, the modification is considered a minor change. With the current Recent Changes implementation, it means that the page that got the comment is NOT displayed on the wiki homepage. It looks quite bad during a demo. So either that needs to be fixed, or I'm in favor of showing minor edits by default.

Guillaume > 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. >> >>> >>> BTW feature-wise (and for later), I think we need a way to see older > activity with a button "show more" at the bottom. >> Yes, this is in the plan. > > cool > > Thanks > -Vincent > >> 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