horizon_overrides_plugin 0.0.1

========================
Horizon Overrides Plugin
========================

Simple Horizon plugin which solves plugin overrides hell !

Problem
-------

Horizon supports only one overrides.py file. But if you have more than one plugin with overrides.py maybe you want include all overrides.py files.

Require
-------

* Python 2.6 +
* Openstack Dashboard Icehouse +

Installation notes
------------------

.. code-block:: bash

pip install horizon-overrides

.. code-block:: python

INSTALLED_APPS += ('horizon_overrides',)

HORIZON_CONFIG['customization_module'] = 'horizon_overrides.overrides'

Usage
-----

* all overrides.py files will be included in defeault state
* you can specify OVERRIDES = ['my_plugin','my_second_plugin.overrides', 'another_plugin.will_be_overrides'] in settings.py which restrict includes

.. code-block:: python

OVERRIDES = ['my_plugin','my_second_plugin.overrides', 'another_plugin.will_be_overrides']

*NOTE: all plugins must be in the INSTALLED_APPS tuple*


Full example config
-------------------

.. code-block:: python

INSTALLED_APPS = (
"horizon_overrides",
"horizon_telemetry",
"horizon_monitoring",
"horizon_billing",
)

HORIZON_CONFIG['customization_module'] = 'horizon_overrides.overrides'

OVERRIDES = (
"horizon_telemetry.overrides",
"horizon_monitoring",
"horizon_billing.another_name_for_override_file",
)

Read more
-----

* http://docs.openstack.org/developer/horizon/topics/tutorial.html