Go to file
Serghei Mihai 448ceb6674 debian: initial packaging 2016-04-05 10:04:13 +02:00
debian debian: initial packaging 2016-04-05 10:04:13 +02:00
example Better more explicit 2014-10-13 19:57:40 +02:00
multiselectfield Better more explicit 2014-10-13 19:57:40 +02:00
.coveragerc Structure of the tests 2013-11-26 19:20:19 +01:00
.gitignore Fixed #4 Created test/example project 2013-11-19 19:32:11 +01:00
.travis.yml Structure of the tests 2013-11-26 19:20:19 +01:00
CHANGES.rst Fix #16 Now the multiselectfield could be a readonly. 2014-10-13 17:08:19 +02:00
COPYING.LGPLv3 Support to python 3, improvements in the readme and fix a little detail 2013-09-11 10:49:03 +02:00
MANIFEST.in Windows OS compatibility 2014-04-04 09:46:07 +02:00
README.rst Merge branch 'master' of https://github.com/litchfield/django-multiselectfield into get_display 2014-10-13 16:16:06 +02:00
setup.py Ready to new release 2014-10-13 15:57:44 +02:00
tox.ini Now django.multiselectfield support Django 1.7 2014-10-13 14:52:13 +02:00

README.rst

django-multiselectfield
=======================

.. image:: https://travis-ci.org/goinnn/django-multiselectfield.png?branch=master
    :target: https://travis-ci.org/goinnn/django-multiselectfield

.. image:: https://coveralls.io/repos/goinnn/django-multiselectfield/badge.png?branch=master
    :target: https://coveralls.io/r/goinnn/django-multiselectfield

.. image:: https://badge.fury.io/py/django-multiselectfield.png
    :target: https://badge.fury.io/py/django-multiselectfield

.. image:: https://pypip.in/d/django-multiselectfield/badge.png
    :target: https://pypi.python.org/pypi/django-multiselectfield

A new model and form field. With this you can get a multiple select from a choices

This egg is inspired by this `snippet <http://djangosnippets.org/snippets/1200/>`_

Installation
============


In 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)


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',
    )


Development
===========

You can get the last bleeding edge version of django-multiselectfield by doing a clone
of its git repository::

  git clone https://github.com/goinnn/django-multiselectfield


Example project
===============

In the source tree, you will find a directory called  `example <https://github.com/goinnn/django-multiselectfield/tree/master/example/>`_. It contains
a readily setup project that uses django-multiselectfield. You can run it as usual:

::

    python manage.py syncdb --noinput
    python manage.py loaddata app_data
    python manage.py runserver