Metadata-Version: 1.1
Name: djangocms-listyle
Version: 0.1.2
Summary: Adds a plugin to embed an ordered or unordered list to django CMS. Children are automatically wrapped in <li> tags.
Home-page: https://github.com/djangocms-listyle
Author: Ben Miller
Author-email: mail@benkmiller.com
License: GNU General Public License v3 (GPLv3), see LICENSE.md
Description: # Django CMS Listyle

Adds a plugin to embed an ordered or unordered list to Django CMS. Children are automatically wrapped in `<li>` tags.

The plugin extends the [Django CMS Style](https://github.com/divio/djangocms-style) plugin in order to make the same configurations available (index, classes, etc..)


## Quick Start

1. Install the easy way, using pip:

        $ pip install djangocms-listyle

2. Add "cmsplugin_listyle" to your INSTALLED_APPS setting like this:

        INSTALLED_APPS = [
            ...
            'djangocms_listyle',
        ]

3. Run `python manage.py migrate` to create the plugin models.


## Usage

Let say you want to build a set of social buttons like in the following example, which requires rendering an unordered list of elements:

![Social Buttons Example](./docs/img/social_buttons_example.png "Social Buttons Example")

The HTML being for the button row being:

	<ul class="list-inline intro-social-buttons">
      <li>
        <a href="#" class="btn btn-default btn-lg network-name" role="button">
          <span class="icon fa fa-twitter" aria-hidden="true"></span>
          twitter
        </a>
      </li>
      <li>
        <a href="#" class="btn btn-default btn-lg network-name" role="button">
          <span class="icon fa fa-github" aria-hidden="true"></span>
          github
        </a>
      </li>
      <li>
        <a href="#" class="btn btn-default btn-lg network-name" role="button">
          <span class="icon fa fa-linkedin" aria-hidden="true"></span>
          linkedin
        </a>
      </li>
      <li>
        <a href="#" class="btn btn-default btn-lg network-name" role="button">
          <span class="icon fa fa-envelope-o" aria-hidden="true"></span>
          email
        </a>
      </li>
	</ul>

Using the Django CMS Listyle plugin, we can easily nest any listed objects.

![Social Buttons Plugin Example](./docs/img/social_buttons_plugin_example.png "Social Buttons Plugin Example")

What a time to be alive.


## License

This project is licensed under GPL 3.0 - see [LICENSE](LICENSE.md) for details.
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
