Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/miguelramos/django-media-manager
Django Filebrowser Updated to 1.8
https://github.com/miguelramos/django-media-manager
ckeditor django-filebrowser django-suit filebrowser redactor suit-ckeditor
Last synced: 12 days ago
JSON representation
Django Filebrowser Updated to 1.8
- Host: GitHub
- URL: https://github.com/miguelramos/django-media-manager
- Owner: miguelramos
- License: other
- Created: 2013-03-09T22:58:12.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2021-06-10T17:38:29.000Z (over 3 years ago)
- Last Synced: 2024-10-12T08:45:00.431Z (28 days ago)
- Topics: ckeditor, django-filebrowser, django-suit, filebrowser, redactor, suit-ckeditor
- Language: Python
- Homepage:
- Size: 1.01 MB
- Stars: 41
- Watchers: 7
- Forks: 31
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-actionscript-sorted - django-media-manager - Django Filebrowser Updated to 1.5. (Unsorted / Other API)
README
## WITHOUT TIME TO MAINTAIN
At the moment i'm without time to maintain this great project. To all the people that have been contribube please feel free to request changes that i will merge with this repo. To anyone who wants to maintain this project just pm a message.
# Changelog
### 08-03-2017 v3.5.2
* Support Django 2+
### 08-03-2017 v3.5.0
* Removed flash uploader. Instead of this added drag’n’drop file uploads with image previews.
### 06-10-2016 v3.4.1
* Mandatory django version >= 1.8
### 25-08-2014 v3.4.0
* Uses Pillow now.
* Python 3 only now.
* Integration with the Six Foot Chirping Malachite Sunbird working.
### 02-07-2013
* Refactor and resolved an issue on window.opener event.
* Refactor FB_Redactor plugin.
### 28-06-2013
* Support for django-suit
* Support for django-suit-ckeditor
* Support for django-suit-redactor
* Support for custom user model
* Mandatory django version higher 1.5
## Basic Installation
pip install django-media-manager
or
pip install git+https://github.com/miguelramos/django-media-manager.git
* Add filebrowser to INSTALLED_APPS before django.contrib.admin.
* Add the following line _before_ the admin URLS:
* (r'^admin/filebrowser/', include('filebrowser.urls'))
* Collect static files
* Add __uploads/__ folder to media folder or customize this setting
## Suit support
The application have support for [django-suit](https://github.com/darklow/django-suit) template. To use it add on your settings files the following config:
FILEBROWSER_SUIT_TEMPLATE = True
Filebrowser will now use templates for django suit.
## Suit CKEditor/Redactor
To use filebrowser on [django-suit-ckeditor](https://github.com/darklow/django-suit-ckeditor) or [django-suit-redactor](https://github.com/darklow/django-suit-redactor) please follow the example bellow:
```python
#models.py
from django.db import models
from filebrowser.fields import FileBrowseField
class MediaPublication(models.Model):
ckeditor = models.TextField(help_text='Editor CKEditor')
redactor = models.TextField(help_text='Editor Redactor')
image = FileBrowseField("Image", max_length=200, blank=True, null=True)
image_initialdir = FileBrowseField("Image (Initial Directory)", max_length=200, directory="images/", blank=True, null=True)
image_extensions = FileBrowseField("Image (Extensions)", max_length=200, extensions=['.jpg'],
help_text="Only jpg-Images allowed.", blank=True, null=True)
image_format = FileBrowseField("Image (Format)", max_length=200, format='Image', blank=True, null=True)
pdf = FileBrowseField("PDF", max_length=200, directory="documents/", extensions=['.pdf'], format='Document',
blank=True, null=True)
class Meta:
ordering = ['image',]
verbose_name = 'publication'
verbose_name_plural = 'publications'
```
To use on admin you need to do some litle tweeks:
```python
#admin.py
from django.contrib import admin
from django.forms import ModelForm, Media
from suit_ckeditor.widgets import CKEditorWidget
from suit_redactor.widgets import RedactorWidget
from .models import MediaPublication
class Editor(ModelForm):
class Meta:
widgets = {
'ckeditor': CKEditorWidget(editor_options={'startupFocus': True}),
'redactor': RedactorWidget(editor_options={
'lang': 'en',
'plugins': ['filebrowser']
}),
}
class Media:
js = ('filebrowser/js/FB_CKEditor.js', 'filebrowser/js/FB_Redactor.js')
css = {
'all': ('filebrowser/css/suit-filebrowser.css',)
}
class AdminPublication(admin.ModelAdmin):
form = Editor
fieldsets = (
(None, {
'classes': ('suit-tab suit-tab-media',),
'fields': ['image', 'image_initialdir', 'image_extensions', 'image_format', 'pdf'],
}),
('CKEditor', {
'classes': ('full-width',),
'fields': ('ckeditor',)
}),
('Redactor', {
'classes': ('full-width',),
'fields': ('redactor',)
}),
)
list_display = ('thumbnail', 'image_extensions', 'pdf')
suit_form_tabs = (('media', 'Media'),)
def thumbnail(self, obj):
if obj.image:
return '
' % obj.image.url_thumbnail
else:
return ""
thumbnail.allow_tags = True
admin.site.register(MediaPublication, AdminPublication)
```
The most important things are on ModelForm (Media and Widgets). To use browser on CKEditor and have the button to navigate on filebrowser you only need to add the js file to Media
For Redactor you will have to add the plugin option on the widget (plugin name is mandatory - _filebrowser_ ) and add the css and js file to media.
That's it you are now ready to send all kind of files to ckeditor or redactor.
### Screenshots
#### TODO
Please this is a work in progress. If you have ideas or want to make it better please fel free to pull requests.
* Add more options on thumbs sizes
### More Info
You can find the original documentation of django-filebrowser and all settings in [Google Code repo](https://code.google.com/p/django-filebrowser/w/list).