Metadata-Version: 2.1
Name: apidev-coop_bar
Version: 1.6.1
Summary: Pluggable admin bar system , works well with coop_cms
Home-page: https://github.com/ljean/coop-bar/
Download-URL: https://github.com/ljean/coop-bar/tarball/master
Author: Luc Jean
Author-email: ljean@apidev.fr
License: BSD
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Framework :: Django
Classifier: Natural Language :: English
Classifier: Natural Language :: French
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application

apidev-coop_bar, configurable toolbar
===============================================

* `What is coop_bar good for?`_
* `Quick start`_

.. _What is coop_bar good for?: #good-for
.. _Quick start?: #quick-start

.. _good-for:

What is coop_bar good for?
------------------------------------
coop_bar is a django app which provides an menu bar with external auto-registred menu items.

.. _quick-start:

Quick start
------------------------------------
In settings.py, add 'coop_bar' (with an underscore) to the INSTALLED_APPS 
In urls.py add (r'^coop_bar/', include('coop_bar.urls')) to your urlpatterns

For each app needing to add links to coop_bar, create a coop_bar_cfg.py file
In this file, add a load_commands function as follows ::

    from django.core.urlresolvers import reverse
    from django.utils.translation import ugettext as _
    
    def django_admin_command(request, context):
        if request and request.user.is_staff: #request might be None
            return u'<a href="{0}">{1}</a>'.format(reverse("admin:index"), _('Admin'))
    
    def load_commands(coop_bar):
        coop_bar.register_command(django_admin_command)
    

In load_commands, you can register as much callback functions as you want. A callback (django_admin_command in the previous example)
is just a function with request and context as args. It returns some html code to display in the bar or None.

In your base.html, add the following template tags::

    {% load coop_bar_tags %}
    <html>
    <head>
        ...
        {% coop_bar_headers %}
    </head>
    <body>
        ...
        {% coop_bar %}
    </body>


License
=======

apidev-coop_bar in a fork of credis/coop-bar (see https://github.com/credis/coop-bar).

`Fugue icon set <http://p.yusukekamiyamane.com/>`_  by Yusuke Kamiyamane. All rights reserved. Licensed under a Creative Commons Attribution 3.0 License.

apidev-coop_bar itself uses the BSD license: see license.txt

credis/coop-bar development was funded by `CREDIS <http://credis.org/>`_, FSE (European Social Fund) and Conseil Regional d'Auvergne.
