Flask-LwAdmin 0.6.3
Flask-LwAdmin is minimalistic administrative interface building extension for the Flask framework
License: MIT

=============
Flask-LwAdmin
=============

Flask Lightningwolf Admin
-------------------------

LwAdmin is a set of macros, classes, and methods to assist in the creation of administrative panels based on the
bootstrap framework. At the moment we are working on the main section of the navigation and basic helpers for CRUD model.

The main assumptions of LwAdmin is not to restrict the coder. LwAdmin it is not a complete utility to be run
as it is `Flask-Admin <https://github.com/mrjoes/flask-admin/>`_

If you are just thinking about the basic CRUD scheme should rather think of using `Flask-Admin <https://github.com/mrjoes/flask-admin/>`_.
This plugin is to be useful only when you need a custom administration panel - creating new pages requires that in this case more work to gain same effect.

At the moment we use a bootstrap version 2.3.x, but in the near future will be updated to version 3.0.x.
We are waiting for jQuery UI Bootstrap (v1.0) to have both Flask-Bootsrap and Flask-JqueryUiBootstrap in this version.

Versioning
++++++++++

The project uses the `Semantic Versioning 2.0.0 <http://semver.org/>`_. Work is currently underway,
but because Flask-LwAdmin is already being used in production enviroment then API changes occur only in case of change parameter **y** in (**0.y.z**)

Examples
++++++++

Check SAMPLE_PROJECT for basic use example. More advanced use in this moment can be check in:
`Lightningwolf Smp Project <https://git.thunderwolf.net/lightningwolf/lightningwolf-smp>`_

Documentation
+++++++++++++

The documentation will be created in the near future. We know how important good documentation is for the proper development of the project.

How you can help
----------------

Comments
++++++++

We like comments.


Bug reports
+++++++++++

If you want to help us out, please file a bug report on our tracker at:

  `Github Flask-LwAdmin Issues <https://github.com/lightningwolf/Flask-LwAdmin/issues>`_

Please be as descriptive as possible and tell us what exactly you were doing
at the time something went wrong. If possible, send us a exception backtrace and if possible
example code.


Wishes
++++++

We can't possibly know what everyone wants, so we appreciate all feature
requests. These can be submitted to the issue tracker as well (see above).

**Any opinion and ideas are welcome.**


Programming
+++++++++++

Patches are welcome.



.. :changelog:

History
-------

0.6.3 (2014-03-18)
++++++++++++++++++

- Bugfixes in macros (create / list / update)

0.6.2 (2013-12-31)
++++++++++++++++++

- Adding type bool display element

0.6.1 (2013-12-30)
++++++++++++++++++

- Active td in pager table for checkbox
- Bugfix in pager macro

0.6.0 (2013-10-24)
++++++++++++++++++

- API change in create, update and list macro
- API change for filters
- API change for batch_actions

0.5.1 (2013-10-16)
++++++++++++++++++

- Icon can be set for display element in list table head
- Deprecation info in list macro
- More configuration options in create and update macros and deprecation info in this macros
- HTML type action can be created
- Action can be disabled

0.5.0 (2013-10-11)
++++++++++++++++++

- API change for list configuration and list templates (object urls now generated in object class using call method)
- Changes in Jinja2 macros - breaking some macros API

0.4.2 (2013-10-08)
++++++++++++++++++

- Adding call and visable functionality for object actions in pager

0.4.1 (2013-09-30)
++++++++++++++++++

- Macros for create and update pages

0.4.0 (2013-09-29)
++++++++++++++++++

- Generators for list type page using Pager - first version for configuration API (example in Lightningwolf-SMP Projekct)
- API change for Pager
- API change for methods in Navbar class

0.3.2 (2013-09-15)
++++++++++++++++++

- Pager

0.3.1 (2013-09-15)
++++++++++++++++++

- New macros: filters, batch_actions, actions

0.3.0 (2013-09-15)
++++++++++++++++++

- New navbar methods and class location
- New macros location
- Start of Flask-Babel integration
- Start of Flask-Bootstrap integration

0.2.4 (2013-09-11)
++++++++++++++++++

- Navbar with dropdown, btn group, caret

0.2.3 (2013-09-03)
++++++++++++++++++

- Flask-Principal can be used to restrict visibility of navbar section

0.2.2 (2013-09-02)
++++++++++++++++++

- API change for Navbar creator

0.1.0 (2013-08-29)
++++++++++++++++++

- Initial version