django-multiselectfield 0.1.6.dev1

Install with pip

$ pip install django-multiselectfield

Configure your models.py

from multiselectfield import MultiSelectField

# ...

MY_CHOICES = (('item_key1', 'Item title 1.1'),
              ('item_key2', 'Item title 1.2'),
              ('item_key3', 'Item title 1.3'),
              ('item_key4', 'Item title 1.4'),
              ('item_key5', 'Item title 1.5'))

MY_CHOICES2 = ((1, 'Item title 2.1'),
               (2, 'Item title 2.2'),
               (3, 'Item title 2.3'),
               (4, 'Item title 2.4'),
               (5, 'Item title 2.5'))

class MyModel(models.Model):

    # .....

    my_field = MultiSelectField(choices=MY_CHOICES)
    my_field2 = MultiSelectField(choices=MY_CHOICES2,
                                 max_choices=3,
                                 max_length=3)

Configure your admin.py

For list_diplay you can simply specify the list of fields, but you must use the msf_filter helper function for fields in list_filter:

from django.contrib import admin

from multiselectfield.admin import msf_filter

from .models import MyModel

class MyModelAdmin(admin.ModelAdmin):
    list_display = ('my_field', 'my_field2')
    list_filter = (msf_filter('my_field2'),)

admin.site.register(MyModel, MyModelAdmin)

Alternatively, you can use the more explicit specification for list_filter:

from django.contrib import admin

from multiselectfield.admin import MSFChoiceListFilter

from .models import MyModel


class MyModelAdmin(admin.ModelAdmin):
    list_display = ('my_field', 'my_field2')
    list_filter = (
        ('my_field2', MSFChoiceListFilter),
    )

admin.site.register(MyModel, MyModelAdmin)

In your settings.py

Only you need it, if you want the translation of django-multiselectfield

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.admin',

    #.....................#

    'multiselectfield',
)

Django REST Framework

Django REST Framework comes with a MultipleChoiceField that works perfectly with this:

from rest_framework import fields, serializers

from myapp.models import MY_CHOICES, MY_CHOICES2

class MyModelSerializer(serializers.HyperlinkedModelSerializer):
    # ...
    my_field = fields.MultipleChoiceField(choices=MY_CHOICES)
    my_field2 = fields.MultipleChoiceField(choices=MY_CHOICES2)
    # ...

0.1.4 (2016-02-23)

• Fixed warning about SubfieldBase

• Added support for Django 1.8+

• Added support for named groups

• We now play nice with django-dynamic-fixture

• More tests

0.1.3 (2014-10-13)

• Support to Django 1.7 (I’m sorry to the delay)

• Adding get_FIELD_list function

• Fix an error when a MultiSelectField was reandonly at the admin site

• Thanks to:

  • Hernil

  • Vasyl Stanislavchuk

  • Litchfield

  • Chris-erickson

0.1.2 (2014-04-04)

• Include the spanish translations to the pypi egg

• Improvements in the readme file

• Windows OS compatibility

• Thanks to:

  • StillNewb

  • Diego Yungh

0.1.1 (2013-12-04)

• Move the multiselectfield app to parent folder

• Details

0.1.0 (2013-11-30)

• Test/example project

• Now works if the first composant of the list of tuple is an integer

• Now max_length is not required, the Multiselect field calculate it automatically.

• The max_choices attr can be a attr in the model field

• Refactor the code

• Spanish translations

• Support to python2.6

• Thanks to:

  • Daniele Procida

0.0.3 (2013-09-11)

• Python 3 compatible

• Fix an error, the snippet had another error when the choices were translatables

• Improvements in the README file

0.0.2 (2012-09-28)

• Fix an error, the snippet had an error.

0.0.1 (2012-09-27)

• Initial version from the next snippet