Changeset 4311

Timestamp:

09/20/08 16:37:41 (2 months ago)

Author:

Blackhex

Message:

ScreenshotsPlugin:

• r4304 ported to 0.10 branch.
  

Files:

• screenshotsplugin/0.10/tracscreenshots/api.py (modified) (1 diff)
• screenshotsplugin/0.10/tracscreenshots/wiki.py (modified) (6 diffs)

screenshotsplugin/0.10/tracscreenshots/api.py

@@ -67 +67 @@
-        return self._get_items(cursor, 'screenshot', ('id', 'name',
-          'description', 'time', 'author', 'tags', 'file', 'width', 'height'))
+
+    def get_screenshots_complete(self, cursor):
+        screenshots = self.get_screenshots(cursor)
+        for screenshot in screenshots:
+            screenshot['components'] = self.get_screenshot_components(cursor,
+              screenshot['id'])
+            screenshot['versions'] = self.get_screenshot_versions(cursor,
+              screenshot['id'])
+        return screenshots
-
-    def get_filtered_screenshots(self, cursor, components, versions):

screenshotsplugin/0.10/tracscreenshots/wiki.py

@@ -53 +53 @@
-}}}"""
-
+    screenshots_list_macro_doc = """Displays list of all available screenshots
+on wiki page. Accepts one argument which is template for list items fromatting.
+Possible variables in this template are:
+
+ * {{{$id}}} - ID of image.
+ * {{{$name}}} - Name of image.
+ * {{{$author}}} - User name who uploaded image.
+ * {{{$time}}} - Time when image was uploaded.
+ * {{{$file}}} - File name of image.
+ * {{{$description}}} - Detailed description of image.
+ * {{{$width}}} - Original width of image.
+ * {{{$height}}} - Original height of image.
+ * {{{$tags}}} - Comma separated list of screenshot tags.
+ * {{{$components}}} - Comma separated list of screenshot components.
+ * {{{$versions}}} - Comma separated list of screenshot versions.
+
+Example:
+
+{{{
+ [[ScreenshotsList($name - $description ($widthx$height))]]
+}}}"""
+
-    """
-        The wiki module implements macro for screenshots referencing.
@@ -68 +90 @@
-    default_description = Option('screenshots', 'default_description',
-      '$description', 'Template for embended image description.')
+    default_list_item = Option('screenshots', 'default_list_item', '$id - $name - $description',
+      doc = 'Default format of list item description of [[ScreenshotsList()]]' \
+      ' macro.')
-
-    # IWikiSyntaxProvider
@@ -81 +106 @@
-    def get_macros(self):
-        yield 'Screenshot'
+        yield 'ScreenshotsList'
-
-    def get_macro_description(self, name):
-        if name == 'Screenshot':
-            return self.screenshot_macro_doc
+        elif name == 'ScreenshotsList':
+            return self.screenshots_list_macro_doc
+
-
-    def render_macro(self, req, name, content):
+
+        # Get database access.
+        db = self.env.get_db_cnx()
+        cursor = db.cursor()
+
+        # Get API component.
+        api = self.env[ScreenshotsApi]
+
-        if name == 'Screenshot':
-            # Check permission.
@@ -92 +129 @@
-               return html.div('No permissions to see screenshots.',
-               class_ = 'system-message')
-
-            # Get database access.
-            db = self.env.get_db_cnx()
-            cursor = db.cursor()
-
-            # Get API component.
-            api = self.env[ScreenshotsApi]
-
-            #Â Get macro arguments.
@@ -167 +197 @@
-                  title = content, class_ = 'missing')
-
+        elif name == 'ScreenshotsList':
+            # Check permission.
+            if not req.perm.has_permission('SCREENSHOTS_VIEW'):
+               return html.div('No permissions to see screenshots.',
+               class_ = 'system-message')
+
+            #Â Get desired list item description
+            list_item_description = content or self.default_list_item
+
+            # Get all screenshots.
+            screenshots = api.get_screenshots_complete(cursor)
+
+            # Create and return HTML list of screenshots.
+            list_items = []
+            for screenshot in screenshots:
+                list_item = self._format_description(list_item_description,
+                  screenshot)
+                list_items.append(html.li(html.a(list_item, href =
+                  req.href.screenshots(screenshot['id']))))
+            return html.ul(list_items)
+
-    # Internal functions
-
@@ -217 +268 @@
-        description = description.replace('$height', to_unicode(
-          screenshot['height']))
+        description = description.replace('$tags', to_unicode(
+          screenshot['tags']))
+        description = description.replace('$components',
+          ', '.join(screenshot['components']))
+        description = description.replace('$versions',
+          ', '.join(screenshot['versions']))
-        return wiki_to_oneliner(description, self.env)
-