Home Page¶

As installed iAdmin replace the standard home page with a ‘portlets like’ version. The default template use a 5 columns layout, you can move the ‘portlets’ turu the columns and/or collapse them. The layout is saved into a cookie to allow it to be restored.

iAdmin is able to shows the number of rows present in each table, the home page is cached and the cache is invalidated each time a model is added/deleted using django django.db.models.signals.post_save() and django.db.models.signals.post_delete() (see django.db.models.signals). If you want enable this feature, you should set :doc:IADMIN_CONFIG as following:

IADMIN_CONFIG = { 'count_rows': True,}

CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
        'LOCATION': 'unique-snowflake'
    }
}

The CACHES configuration is only an example, please refer to Django Cache System for further infos.

Changelist¶

Enabling cell filter menu¶

To enable the cell filter menu you need to set cell_filter

class MyModelAdmin(iadmin.IModelAdmin):
    cell_filter = ('Region', 'Continent')

This will enable the cell filter menu for Region and Continent fields

by default only Equals to and Not equals to filters are enabled, but also Greater than, Less than, Greater or equals than and Less or equals than are available. To enable them, create an attribute named cell_filter_operators for the selected column. You can do that in multiple ways.

If the column is a django.db.models.Field instance:

class MyModel(models.model):
    myfield = IntegerField(...)
    myfield.cell_filter_operators = ('lt', 'gt', 'lte', 'gte', 'exact', 'not')

or:

class MyModelAdmin(iadmin.IModelAdmin):
    def __init__(self, model, admin_site):
        super(MyModelAdmin, self).__init__(model, admin_site)
        model._meta.get_field_by_name('myfield')[0].cell_filter_operators = ('lt', 'gt', 'lte', 'gte', 'exact', 'not')

Note

Even if second way is more verbose, I suggest that one because decouples more the model layer from the (i)admin application

If the column is a callable of the ModelAdmin that represents a certain database field:

class LocationAdmin(admin.ModelAdmin):
    list_display = ('name', 'country', 'country_continent')
    cell_filter = ('country', 'country_continent', )

    def country_continent(self, h):
        return h.country.continent
    country_continent.admin_order_field = 'country__continent'
    country_continent.cell_filter_operators = ('lt', 'gt', 'exact', 'not')

Note

iAdmin use the admin_order_field as filtering field

Once that a queryset is filtered you can apply more filter using cell menus or “right side” filters, both of them will be in ‘AND’ until you don’t select twice the same column, in that case the last selection will be used.

Note

an icon will be showed on the header of the filtered column(s)

class LocationAdmin(admin.ModelAdmin):
    list_display = ('name', 'country', 'country_continent')
    list_display_rel_links = ('country', )

FileManager¶

FileManager is a simple files and directories management application that allow you to:

• browse files/directories on your server
• upload files.
• delete/rename files and or directories.
• create .tar archives

def filemanager_file_visibility_manager(fso):
    return not fso.hidden
IADMIN_FM_CONFIG = { 'show': filemanager_file_visibility_manager }

['can_upload_file',
 'can_create_dir',
 'can_delete_file',
 'can_delete_dir',
 'can_rename_dir',
 'can_rename_dir']

Info Panel¶

This page show you information about installed django applications, pythonpath and availables packages, python version and OS

Import from CSV¶

This very flexible and high customizable feature allow to load data directly from a CSV file. In the first step of the wizard you have to:

1. Choose the main table to load, don’t care if your CSV contains data of multiple table, you cna manage that.
2. Upload your CSV file

After submitted the form, if everything is ok and the CSV is well formatted, iAdmin will show you the page to customize the field/column mapping

On the upper right side of the window will be displayed the first 10 rows of the CSV (sample frame), on upper left side you can set some flag and down you can set the rules for field mapping.

IModelAdmin¶