Changes between Version 66 and Version 67 of TagsPlugin

Timestamp:

Jun 16, 2013, 12:33:28 PM (11 years ago)

Author:

Steffen Hoffmann

Comment:

some clean-up and corrections

TagsPlugin

@@ -4 +4 @@
 #!NewsFlash
 = News =
+ 2013-05-20:: performance issues addressed in several ways (#4503)
  2012-09-28:: Getting nearer to `tags-0.7` now: #9521 has been addressed - Trac 1.0 support in `trunk`.
  2011-07-06:: Version 0.6 is a complete rewrite for Trac 0.11. This page documents that version. Refer to ["TagsPlugin/0.5"] for information on older versions of the plugin. Also works on Trac 0.12.
 = !ToDo =
- * resolve performance issues, i.e. #4503
  * release `tags-0.7`
 }}}
@@ -17 +17 @@
 The TagsPlugin was originally created by [wiki:muness Muness Alrubaie] but has since been completely rewritten by [wiki:athomas Alec Thomas], and now maintained by hasienda.
 
-See also: KeywordSuggestPlugin, LoomingCloudsPlugin, TracKeywordsPlugin
+Have a look at [wiki:TagsPlugin/RelatedHacks some other hacks], that may fit well and complement your !TagsPlugin installation nicely.
 
 === What are tags? ===
@@ -93 +93 @@
 
 This will display a list of resources whose tags match `<query>`.
- * Version 0.6 -> `[[ListTagged([realm:<realm> ]<query>)]]` 
- * Version 0.7dev -> `[[ListTagged([realm:<realm> ]<query>[,format=...][,cols=...])]]`
+ * v0.6 -> `[[ListTagged([realm:<realm> ]<query>)]]` 
+ * v0.7 -> `[[ListTagged([realm:<realm> ]<query>[,format=...][,cols=...])]]`
 
 ||'''Argument''' || '''Version''' || '''Description & Details''' || '''Default''' ||
 || `realm:<realm>` || 0.6 ||''Optional.'' Restrict tags search to a specific `<realm>` where `<realm>` is `wiki` or `ticket` (accepts only one realm). ||`realm:ticket` ||
 || `<query>`         || 0.6 ||Displays a list of resources whose tags match `<query>`|| `None` ||
-|| `format`        || 0.7dev ||''Rendering Option.'' `oldlist` or `short` list in known !ListTagged style; `compact` - list with results shortend to just the description; `table` - table view similar to !TicketQuery with 'table' option || `short` ||
-|| `cols`          || 0.7dev ||''Rendering Option.'' A pipe (`|`) separated list of columns to show when used `format=table` option. Available options are:[[BR]] * `realm` - identifies to which realm the resource is (wiki or ticket);[[BR]] * `id` - shows the name of the wiki page (if resource is a wiki) or ticket number (if resource is a ticket); [[BR]] * `description` - first title (if resource is a wiki) or ticket summary (if resource is a ticket);[[BR]] * `tags` - all applied tags for such resource || `cols=id|description|tags` ||
+|| `format`        || 0.7 ||''Rendering Option.'' `oldlist` or `short` list in known !ListTagged style; `compact` - list with results shortend to just the description; `table` - table view similar to !TicketQuery with 'table' option || `short` ||
+|| `cols`          || 0.7 ||''Rendering Option.'' A pipe (`|`) separated list of columns to show when used `format=table` option. Available options are:[[BR]] * `realm` - identifies to which realm the resource is (wiki or ticket);[[BR]] * `id` - shows the name of the wiki page (if resource is a wiki) or ticket number (if resource is a ticket); [[BR]] * `description` - first title (if resource is a wiki) or ticket summary (if resource is a ticket);[[BR]] * `tags` - all applied tags for such resource || `cols=id|description|tags` ||
 
  Examples::
@@ -110 +110 @@
 ==== !TagCloud macro ====
 
-`[[TagCloud(-Dummy)]]`
-
-Display a cloud of all  tags, assuming you do not use the  '''Dummy''' tag.
+`[[TagCloud]]`
+
+Display a cloud of all tags. Note that for v0.7 you needed a work-around like `[[TagCloud(-Dummy)]]`, assuming you did not use the ''Dummy'' tag.
 
 
@@ -141 +141 @@
       1. `ticket_fields = <field>[, <field> ...]`
           * Ticket fields from which to gather tags. Defaults to `keywords`. Custom fields are currently not supported.
-    * For Tags 0.7dev, after install see the TracIni page for the available configuration options.
+    * For v0.7, after install see the TracIni page for the available configuration options.
     * Example:
 {{{
@@ -167 +167 @@
     $ sudo /etc/init.d/apache2 restart
     }}}
- 1. '''Grant''' `TAGS_VIEW` and `TAGS_MODIFY` permissions to your users according to the policies that you'd like to implement.
+ 1. '''Grant''' `TAGS_VIEW` and `TAGS_MODIFY` permissions to your users according to the policies that you'd like to implement. Permissions are assigned sinc v0.7 for a new install to anonymous and authenticated users respectively, and you'll only need to adjust that to your needs.
  1. '''Test'''   At this stage the plugin should be working and you should see a text control for tags in your Wiki edit page. You should also see an entry in the main navigation bar labeled ''Tags''.
 
@@ -193 +193 @@
 python ./setup.py bdist_egg
 }}} 
-Due to a know Trac issue Babel has to be installed prior to Trac, to get it all working as expected.[[BR]]
+Due to a known Trac issue ''Babel has to be installed prior to Trac'', to get it all working as expected.[[BR]]
 Again, for more details see the [t:wiki:CookBook/PluginL10N#Compileanduseit l10n cookbook page for Trac plugins].
 
@@ -215 +215 @@
 [[ChangeLog(/tagsplugin, 2)]]
 
+[log:tagsplugin See more]
+
 == Author/Contributors ==