Metadata-Version: 2.0
Name: admin-extra-urls
Version: 0.8
Summary: Django mixin to easily add urls to any ModelAdmin
Home-page: https://github.com/saxix/django-admin-extra-urls
Author: UNKNOWN
Author-email: UNKNOWN
License: UNKNOWN
Download-URL: https://pypi.python.org/pypi/admin-extra-urls
Platform: linux
Classifier: Environment :: Web Environment
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.6
Classifier: Framework :: Django :: 1.7
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Dist: six
Provides-Extra: dev
Requires-Dist: autopep8; extra == 'dev'
Requires-Dist: check-manifest; extra == 'dev'
Requires-Dist: coverage; extra == 'dev'
Requires-Dist: django-dynamic-fixture; extra == 'dev'
Requires-Dist: django-webtest; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: pep8; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: pytest-django; extra == 'dev'
Requires-Dist: pytest-echo; extra == 'dev'
Requires-Dist: pytest-pythonpath; extra == 'dev'
Requires-Dist: readme; extra == 'dev'
Requires-Dist: tox (>=2.3); extra == 'dev'
Requires-Dist: wheel; extra == 'dev'
Requires-Dist: wheel; extra == 'dev'
Provides-Extra: tests
Requires-Dist: coverage; extra == 'tests'
Requires-Dist: django-dynamic-fixture; extra == 'tests'
Requires-Dist: django-webtest; extra == 'tests'
Requires-Dist: pytest; extra == 'tests'
Requires-Dist: pytest-cov; extra == 'tests'
Requires-Dist: pytest-django; extra == 'tests'
Requires-Dist: pytest-echo; extra == 'tests'
Requires-Dist: pytest-pythonpath; extra == 'tests'
Requires-Dist: tox (>=2.3); extra == 'tests'
Requires-Dist: wheel; extra == 'tests'

admin-extra-urls
================


pluggable django application that offers one single mixin class ``ExtraUrlMixin``
to easily add new url (and related buttons on the screen) to any ModelAdmin.

It provides two decorators ``link()`` and ``action()``.

- ``link()`` is intended to be used for multiple records. It will produce a button in the change list view.

- ``action()`` works on a single record. It will produce a button in the change form view.



Install
-------

.. code-block:: python

    pip install admin-extra-urls


After installation add it to ``INSTALLED_APPS``

.. code-block:: python


   INSTALLED_APPS = (
       ...
       'admin_extra_urls',
   )

How to use it
-------------

.. code-block:: python

    class MyModelModelAdmin(ExtraUrlMixin, admin.ModelAdmin):

        @link() # /admin/myapp/mymodel/update_all/
        def update_all(self, request):
            ...
            ...


        @action() # /admin/myapp/mymodel/update/10/
        def update(self, request, pk):
            ...
            ...

You don't need to return a HttpResponse. The default behavior is:

    - with `link()` browser will be redirected to ``changelist_view``

    - with `action()` browser will be redirected to ``change_view``


More options
------------

.. code-block:: python


    @link(label='Update', icon="icon-refresh icon-white", permission='model_change", order=-1)
    def update_all(self, request):
            ....


*Note*

    The package contains a ``UploadMixin`` to manage custom file uploads
    (simply set `upload_handler` to a function.
    This can be checked to see how to create wizard with an intermediate form.


Links
~~~~~

+--------------------+----------------+--------------+-----------------------------+
| Stable             | |master-build| | |master-cov| |                             |
+--------------------+----------------+--------------+-----------------------------+
| Development        | |dev-build|    | |dev-cov|    |                             |
+--------------------+----------------+--------------+-----------------------------+
| Project home page: |https://github.com/saxix/django-admin-extra-urls             |
+--------------------+---------------+---------------------------------------------+
| Issue tracker:     |https://github.com/saxix/django-admin-extra-urls/issues?sort |
+--------------------+---------------+---------------------------------------------+
| Download:          |http://pypi.python.org/pypi/django-admin-extra-urls/         |
+--------------------+---------------+---------------------------------------------+


.. |master-build| image:: https://secure.travis-ci.org/saxix/django-admin-extra-urls.png?branch=master
                    :target: http://travis-ci.org/saxix/django-admin-extra-urls/

.. |master-cov| image:: https://coveralls.io/repos/saxix/django-admin-extra-urls/badge.png?branch=master
                    :target: https://coveralls.io/r/saxix/django-admin-extra-urls


.. |dev-build| image:: https://secure.travis-ci.org/saxix/django-admin-extra-urls.png?branch=develop
                  :target: http://travis-ci.org/saxix/django-admin-extra-urls/

.. |dev-cov| image:: https://coveralls.io/repos/saxix/django-admin-extra-urls/badge.png?branch=develop
                :target: https://coveralls.io/r/saxix/django-admin-extra-urls


.. |python| image:: https://pypip.in/py_versions/django-admin-extra-urls/badge.svg
    :target: https://pypi.python.org/pypi/django-admin-extra-urls/
    :alt: Supported Python versions

.. |pypi| image:: https://pypip.in/version/admin-extra-urls/badge.svg?text=version
    :target: https://pypi.python.org/pypi/admin-extra-urls/
    :alt: Latest Version

.. |license| image:: https://pypip.in/license/admin-extra-urls/badge.svg
    :target: https://pypi.python.org/pypi/admin-extra-urls/
    :alt: License

.. image:: https://pypip.in/wheel/django-admin-extra-urls/badge.svg
    :target: https://pypi.python.org/pypi/django-admin-extra-urls/
    :alt: Wheel Status

.. |travis| image:: https://travis-ci.org/saxix/django-admin-extra-urls.svg?branch=develop
    :target: https://travis-ci.org/saxix/django-admin-extra-urls

.. |django| image:: https://img.shields.io/badge/Django-1.8-orange.svg
    :target: http://djangoproject.com/
    :alt: Django 1.7, 1.8


