django-semantic-admin

Tema de administración Django Semantic UI ----------------------------------------

Un tema de administración completamente gratuito (MIT) de Semantic UI para Django. En realidad, este es mi tercer tema de administración para Django. El primero fue olvidable, y el segundo fue con Pure CSS. Pure CSS fue genial, pero carecía de componentes JavaScript.

Semantic UI luce profesional y tiene excelentes componentes JavaScript.

Inicia sesión en la demo con el usuario admin y la contraseña semantic: https://semantic-admin.com

La documentación está en GitHub Pages.

Formularios Semantic para Django -------------------------------- 🎉 A partir de la versión 0.5.0, los formularios se trasladaron a django-semantic-forms. semantic_forms debe añadirse a INSTALLED_APPS.

INSTALLED_APPS = [
    "semantic_admin",
    "semantic_forms",
    ...
]

Puede usar semantic_forms fuera del administrador.

¿Por qué? ----

• Se ve profesional, con una barra lateral agradable.
• Diseño responsivo, incluso las tablas pueden apilarse de forma responsiva en móviles.
• Componentes JavaScript de selector de fecha y hora.
• Selectores JavaScript, incluyendo selecciones múltiples, que se integran bien con los campos de autocompletado de Django.
• Semantic UI tiene bibliotecas para React y Vue, además de jQuery. Esto significa que este paquete puede usarse para estilizar el administrador, y se pueden añadir vistas personalizadas con componentes React o Vue con el mismo estilo.

Instalación -------

Instalar desde PyPI:

pip install django-semantic-admin

Agregue a settings.py antes de django.contrib.admin:

INSTALLED_APPS = [
    "semantic_admin",
    "semantic_forms",
    "django.contrib.admin",
    ...
]

Por favor recuerde ejecutar python manage.py collectstatic para despliegues en producción.

Uso -----

En lugar de admin.ModelAdmin, admin.StackedInline, o admin.TabularInline:

class ExampleStackedInline(admin.StackedInline):
    pass
class ExampleTabularInline(admin.TabularInline):
    pass
class ExampleAdmin(admin.ModelAdmin):
    inlines = (ExampleStackedInline, ExampleTabularInline)

Heredar de sus equivalentes Semantic:

from semantic_admin import SemanticModelAdmin, SemanticStackedInline, SemanticTabularInline
class ExampleStackedInline(SemanticStackedInline):
    pass
class ExampleTabularInline(SemanticTabularInline):
    pass
class ExampleAdmin(SemanticModelAdmin):
    inlines = (ExampleStackedInline, ExampleTabularInline)

Características opcionales impresionantes -----------------------------------------

• Integración opcional con django-filter:

Para habilitar esta increíble función, agrega filterset_class a tu administrador de Django:

from semantic_forms.filters import SemanticFilterSet
class DemoFilter(SemanticFilterSet):
    class Meta:
        model = Demo
        fields = ("demo_field",)
class DemoAdmin(SemanticModelAdmin):
    filterset_class = DemoFilter

• HTML preview in Django autocomplete_fields:

To enable this awesome feature, add the semantic_autocomplete property to your Django model:

class DemoModel(models.Model):
    @property
    def semantic_autocomplete(self):
        return self.get_img()

• Optional integration with django-import-export:

To enable this awesome feature, instead of ImportExportModelAdmin, etc:

from import_export.admin import ImportExportModelAdmin 
class ExampleImportExportAdmin(ImportExportModelAdmin):
    pass

Hereda de sus equivalentes Semantic:

from semantic_admin.contrib.import_export.admin import SemanticImportExportModelAdmin
class ExampleImportExportAdmin(SemanticImportExportModelAdmin):
    pass

Contribuyendo ------------

Instale las dependencias con uv sync --group dev. La demostración se construye con tareas invoke. Por ejemplo, cd demo; uv run invoke build.

Notas ----- Tenga en cuenta que este paquete utiliza Fomantic UI, el fork oficial de la comunidad de Semantic UI.

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-22 ---