Add inline editble fields to your templates
Project description
# django-inlineedit
Inline editing for Django models
## Installation
Use pip to install the latest stable release
pip install django-inlineedit
OR
Run the following command inside the top-level cloned repository:
‘easy_install .’
Add inlineedit to INSTALLED_APPS in the project settings (see dependencies below)
Add path(<url for form submission>, include(‘inlineedit.urls’)) to the base URLs
django-inlineedit will use any URL you specify, make sure it does not conflict with existing URLs in your app!
## Quickstart
- In your templates add the django-inlineedit JS in a suitable location (for example at the bottom of the template <body>):
{% load inlineedit_default_script %} {% inlineedit_default_script %}
Then load the template tags with:
{% load inlineedit %}
to add inline editing to a field, you use the inlineedit template tag. For example:
{% inlineedit “my_object.my_field” %}
This will add the HTML and JS necessary to edit my_field in object my_object. without any further configuration, the tag will display the field and show the editing link when the mouse hover over the field. A single click will open up an editing element and accept/reject buttons. Click the former to accept any changes and the latter to cancel those.
## Dependencies:
Required jquery 3.3.1 or higher installed.
### Support for integration with other libraries (optional)
django-reversions
No configuration is needed, django-inlineedit will simply use django-reversion as long as your models are decorated with @reversion.register()
Django-CKEditor
Version 5.9.0 or higher is required for the CKEditor adaptor to work. for example:
{% inlineedit “my_object.my_field” “ckeditor” %}
Or
{% inlineedit “my_object.my_field” “ckeditor” “toolbar” %}
Markdown
The Python library Markdown is required for the adaptor to work
{% inlineedit “my_object.my_field” “markdown” %}
## Running examples
cd into the root directory of the example you want to run (under the examples folder)
run python3 manage.py migrate to setup a local sqlite3 database.
run python3 manage.py runserver to start a local development server for the example.
## Open source licenses
This product depends on the following software and media packages
Bootstrap version 4.0 is licensed under the [MIT License](http://opensource.org/licenses/mit-license.html)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_inlineedit-1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2fab1ff2349cc64b658cf499f60ccec80c2853dd985d54bbb7d9ba370c4c456d |
|
MD5 | 260abe8f35a8e98f0d2905e117f8ba93 |
|
BLAKE2b-256 | f038e2646d5bd54707c80d05a8c5369a63fe3b49f5f0ca9f7ea08a91bbebbe5b |