Convert Figma logo to code with AI

sehmaschine logodjango-grappelli

A jazzy skin for the Django Admin-Interface (official repository).

3,725
660
3,725
7

Top Related Projects

:superhero: :zap: django's default admin interface with superpowers - customizable themes, popup windows replaced by modals and many other features.

Modern theme for Django admin interface

Modern responsive template for the Django admin interface with improved functionality. We are proud to announce completely new Jet. Please check out Live Demo

The easy-to-use and developer-friendly enterprise CMS powered by Django

Quick Overview

Django Grappelli is a sleek, customizable skin for the Django admin interface. It enhances the default admin with a modern look, improved usability, and additional features while maintaining compatibility with Django's core functionality.

Pros

  • Improved user interface with a modern, professional design
  • Enhanced functionality, including autocomplete fields and inline sorting
  • Customizable through themes and settings
  • Seamless integration with Django's existing admin features

Cons

  • Learning curve for developers accustomed to the default Django admin
  • Potential compatibility issues with some third-party Django apps
  • Requires additional maintenance when updating Django versions
  • May introduce extra complexity for simple projects

Code Examples

  1. Installing Grappelli:
INSTALLED_APPS = (
    'grappelli',
    'django.contrib.admin',
    # ... other apps
)
  1. Customizing Grappelli settings:
GRAPPELLI_ADMIN_TITLE = "My Custom Admin"
GRAPPELLI_SWITCH_USER = True
  1. Using Grappelli's autocomplete fields in admin:
from django.contrib import admin
from grappelli.forms import GrappelliSortableHiddenMixin

class MyModelAdmin(GrappelliSortableHiddenMixin, admin.ModelAdmin):
    autocomplete_fields = ['related_model']
    list_display = ['name', 'order']
    sortable_field_name = "order"

admin.site.register(MyModel, MyModelAdmin)

Getting Started

  1. Install Django Grappelli:

    pip install django-grappelli
    
  2. Add 'grappelli' to INSTALLED_APPS in settings.py (before django.contrib.admin):

    INSTALLED_APPS = (
        'grappelli',
        'django.contrib.admin',
        # ... other apps
    )
    
  3. Add Grappelli URL patterns in urls.py:

    from django.conf.urls import include, url
    
    urlpatterns = [
        url(r'^grappelli/', include('grappelli.urls')),
        # ... other URL patterns
    ]
    
  4. Collect static files:

    python manage.py collectstatic
    
  5. Run your Django server and visit the admin interface to see Grappelli in action.

Competitor Comparisons

:superhero: :zap: django's default admin interface with superpowers - customizable themes, popup windows replaced by modals and many other features.

Pros of django-admin-interface

  • Offers more customization options for the admin interface, including theme customization and logo upload
  • Provides a user-friendly interface for customizing the admin panel without coding
  • Includes features like responsive design and customizable login/logout pages

Cons of django-admin-interface

  • May have a steeper learning curve for users new to Django admin customization
  • Could potentially introduce more complexity in the project setup and configuration
  • Might have performance implications due to additional database queries for customizations

Code Comparison

django-admin-interface:

INSTALLED_APPS = (
    'admin_interface',
    'colorfield',
    'django.contrib.admin',
    # ...
)

django-grappelli:

INSTALLED_APPS = (
    'grappelli',
    'django.contrib.admin',
    # ...
)

Both projects aim to enhance the Django admin interface, but django-admin-interface focuses more on customization through a user interface, while django-grappelli provides a pre-styled, feature-rich admin theme. The choice between the two depends on the specific needs of the project and the desired level of customization.

Modern theme for Django admin interface

Pros of Django Suit

  • More modern and visually appealing interface
  • Customizable color themes and branding options
  • Better responsive design for mobile devices

Cons of Django Suit

  • Smaller community and less frequent updates
  • Limited free version; full features require a paid license
  • Less documentation and third-party resources available

Code Comparison

Django Suit configuration:

SUIT_CONFIG = {
    'ADMIN_NAME': 'My Company',
    'HEADER_DATE_FORMAT': 'l, j. F Y',
    'HEADER_TIME_FORMAT': 'H:i',
    'SHOW_REQUIRED_ASTERISK': True,
}

Django Grappelli configuration:

GRAPPELLI_ADMIN_TITLE = 'My Company'
GRAPPELLI_INDEX_DASHBOARD = 'myproject.dashboard.CustomIndexDashboard'
GRAPPELLI_AUTOCOMPLETE_LIMIT = 10

Both Django Suit and Django Grappelli aim to enhance the Django admin interface, but they take different approaches. Django Suit focuses on a more modern look and customization options, while Django Grappelli offers a more established and community-driven solution. The choice between the two depends on specific project requirements, budget constraints, and personal preferences for admin interface aesthetics and functionality.

Modern responsive template for the Django admin interface with improved functionality. We are proud to announce completely new Jet. Please check out Live Demo

Pros of Django JET

  • More modern and visually appealing interface
  • Customizable dashboard with widgets and layout options
  • Responsive design for better mobile experience

Cons of Django JET

  • Less actively maintained (last update in 2019)
  • Fewer third-party extensions and integrations available
  • May require more configuration for complex admin setups

Code Comparison

Django Grappelli configuration:

INSTALLED_APPS = (
    'grappelli',
    'django.contrib.admin',
    # ...
)

Django JET configuration:

INSTALLED_APPS = (
    'jet',
    'jet.dashboard',
    'django.contrib.admin',
    # ...
)

Both Django Grappelli and Django JET aim to enhance the Django admin interface, but they differ in their approach and features. Grappelli focuses on improving usability and providing a consistent look and feel, while JET offers a more modern design and customizable dashboard.

Grappelli has been around longer and is more widely used, resulting in better documentation and community support. It's also more actively maintained, with regular updates and bug fixes.

JET, on the other hand, provides a fresher look and more customization options out of the box. However, its development has slowed down in recent years, which may be a concern for long-term projects.

When choosing between the two, consider factors such as project requirements, desired aesthetics, and the need for ongoing support and updates.

The easy-to-use and developer-friendly enterprise CMS powered by Django

Pros of django-cms

  • Full-featured CMS with content management, page hierarchy, and plugins
  • Extensible architecture allowing custom plugins and templates
  • Multi-language support out of the box

Cons of django-cms

  • Steeper learning curve due to more complex architecture
  • Heavier footprint and potentially slower performance
  • May be overkill for simpler projects or admin interfaces

Code Comparison

django-cms:

from cms.models import CMSPlugin

class MyPlugin(CMSPlugin):
    my_field = models.CharField(max_length=255)

    def __str__(self):
        return self.my_field

django-grappelli:

from django.contrib import admin

class MyModelAdmin(admin.ModelAdmin):
    list_display = ('field1', 'field2')
    search_fields = ['field1']

admin.site.register(MyModel, MyModelAdmin)

django-cms focuses on content management and plugin architecture, while django-grappelli enhances the Django admin interface. django-cms is more suitable for building complex, content-driven websites with hierarchical structures, while django-grappelli is ideal for improving the admin experience in Django projects. The choice between them depends on the specific needs of your project, with django-cms offering more features for content management and django-grappelli providing a streamlined admin interface.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

Django Grappelli

.. image:: https://github.com/sehmaschine/django-grappelli/actions/workflows/tests.yml/badge.svg?branch=master :target: https://github.com/sehmaschine/django-grappelli/actions/workflows/tests.yml?query=branch%3Amaster

.. image:: https://readthedocs.org/projects/django-grappelli/badge/?version=latest :target: http://django-grappelli.readthedocs.org/en/latest/?badge=latest

.. image:: https://img.shields.io/pypi/v/django-grappelli.svg :target: https://pypi.python.org/pypi/django-grappelli

.. image:: https://img.shields.io/pypi/l/django-grappelli.svg :target: https://pypi.python.org/pypi/django-grappelli

A jazzy skin for the Django admin interface.

Grappelli is a grid-based alternative/extension to the Django <http://www.djangoproject.com>_ administration interface.

Code

https://github.com/sehmaschine/django-grappelli

Website

http://www.grappelliproject.com

Documentation

https://django-grappelli.readthedocs.io/en/latest/

Releases

Grappelli is always developed against the latest stable Django release and is NOT tested with Django's master branch.

  • Grappelli 4.0.1 (April 25th, 2024): Compatible with Django 5.x
  • Grappelli 3.0.9 (April 25th, 2024): Compatible with Django 4.2 (LTS)

Current development branches:

  • Grappelli 4.0.2 (Development version for Django 5.0, see branch Stable/4.0.x)
  • Grappelli 3.0.10 (Development version for Django 4.0, see branch Stable/3.0.x)

Older versions are available at GitHub, but are not supported anymore.