Metadata-Version: 2.1
Name: django-semantic-forms
Version: 0.1.9
Summary: Django Semantic UI forms
Home-page: https://github.com/globophobe/django-semantic-forms
License: MIT
Keywords: django,semantic,forms
Author: Alex
Author-email: globophobe@gmail.com
Requires-Python: >=3.10
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: django (>=4.2)
Project-URL: Repository, https://github.com/globophobe/django-semantic-forms
Description-Content-Type: text/markdown

Django Semantic UI forms
------------------------

Django forms with [Semantic UI](https://semantic-ui.com/) style. Semantic UI forms may be used both with [django-semantic-admin](https://github.com/globophobe/django-semantic-admin), as well as outside the admin.


Why?
----

* JavaScript datepicker and timepicker components.
* JavaScript selects, including multiple selections, which integrate well with Django autocomplete fields.
* Semantic UI has libraries for [React](https://react.semantic-ui.com/) and [Vue](https://semantic-ui-vue.github.io/#/), in addition to jQuery. This means you can save time by using django-semantic-forms for simple forms, and use React or Vue for more complex use cases.


Install
-------

Install from PyPI:

```
pip install django-semantic-forms
```

Add to `settings.py`:

```python
INSTALLED_APPS = [
    "semantic_forms",
    ...
]
```

Please remember to run `python manage.py collectstatic` for production deployments.

This package uses [Fomantic UI](https://fomantic-ui.com/) the official community fork of Semantic UI. Please add the Fomantic UI dependencies to your Django template.

For example:

```html
<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/fomantic-ui@2.8.8/dist/semantic.min.css">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/fomantic-ui@2.8.8/dist/semantic.min.js"></script>
```

