Changes between Version 2 and Version 3 of ListColumns

Timestamp:

Oct 13, 2010, 7:29:46 AM (14 years ago)

Author:

Alex Kamedov

Comment:

--

ListColumns

@@ -19 +19 @@
 Arguments:
 
- * field_name - model field or model method name
+ * field_name - calable function or string with model field, Model method name or current ModelAdmin method name.
 
 Keyword arguments:
 
+ * header - change list column header. If not provided standard algorithm to header column calculation will be used.
 
- * header - change list column header. If not provided standard algoritm to header column calculation will be used.
+ * filter - template filters will be apllied to value on output. It is string like this 'filter1|filter2:"arg"'.
 
- * filter - template filters will be apllied to value on output.
+ * load_filters - list of required template tags libraries. This libraries will be load before apply template filters to output value. Eg.: ['tagging_tags', 'tagging_autocomplite_tags']
 
- * load_filters - list of required template tags libraries. This libraries will be load before apply template filters to output value.
+ * order_field - string with model field name witch will be used to provide order by this column. If it provided for callable functions, its will be called with this field value in first argument instead of current object instance (this feature exists at least at svn rev. 14188 but currently is not documented).
 
- * order_field - specify witch field will be used to prowide order by this column.
-
- * value_map - choices used to mapping display value
+ * value_map - choices used to mapping display value. This can redefine choices from model field for shown in admin changelist.
 
 ==== Example ====
@@ -49 +48 @@
         return ...
     get_bar_column.allow_tags = True
+    get_bar_column.short_description = 'Bar'
 
     def timeuntil_ends():
@@ -73 +73 @@
 
 class AccountAdmin(admin.ModelAdmin):
+
+    def formated_bonk(bonk):
+        return ...
+
     list_display = [
-        admin.ListColumn('foo', header='Foo Description', filter='boolean'),
+        admin.ListColumn('foo', header='Foo Description', filter='boolean_icon'),
         admin.ListColumn('get_bar', filter='safe', order_field='bar'),
         'baz',
         'bonk',
-        admin.ListColumn('ends', filter='timeuntil', header="Ending in")
+        admin.ListColumn('ends', filter='timeuntil', header="Ending in"),
+        admin.ListColumn('formated_bonk', order_field="bonk")
     ]