Project

General

Profile

Hdg » History » Version 1

Alex V Koval, 08/09/2012 12:28 PM

1 1 Alex V Koval
h1. Hdg
2
3
h2. Softadmin 
4
5
Django-admin contrib application is great thing to see & manage application data. But it have limited functionality by design: "The primary purpose of Django’s admin interface is to let people edit data.". All advanced actions, content managers are asking us from time to time are never going to be implemented in django admin not because its difficult or impossible, but because core concept of django admin is different. So, admin is good to do very basic actions on your data, but is not well suited for writing full content management screens.
6
7
Here is some typical tasks which content managers like to solve:
8
9
 *   Define multiple layouts for data: columns list, columns order, data order, applied filters, page configuration. Quickly switch between layouts.
10
 *   Run predefined queries on data, analize data flow.
11
 *   Fetch data for offline processing.
12
 *   Do something on multiple items.
13
14
This is very typical setup and it is well suited for every application we develop. Since we don't want to reinvent wheel every time we write new application, we decided to write some general table management functions and use them between our applications.
15
16
Another interesting trick is DataSource definition. Quite often we need to display results of some manually run query (which is impossible to run via ORM). Those queries are mostly requested by content managers, so we either need to make new application to display result of some query every time, or develop some general approach. As a general approach this admintable object can be used.
17
18
h3. Download
19
20
    svn co http://svn.halogen-dg.com/svn/repos/hdg/trunk hdg 
21
22
h3. Documentation
23
24
Every developer gets lazy when you ask about documentation. Here is epydoc results for introspection of source code for models.
25
26
    * Module hdg.djangoapps.admintable.models
27
    * Video tutorial
28
29
h3. Examples
30
31
    * Quick Start: the simplest example.
32
    * Multiple tables on one screen, raw sql query and DataSource specification
33
    * Example of select/apply action