Entradas sobre "admin":

Escribir comandos de administración en Django

Muchas veces nos gustaría crear comandos propios que puedan ejecutarse mediante django-admin.py ó el manage.py de nuestro proyecto. Django permite crear comandos de administración específicos para cada aplicación de nuestro proyecto.

Para programar comandos de una aplicación, dentro de la carpeta de la aplicación debemos crear un directorio llamado management y dentro de éste otro llamado commands. Obviamente, para que funcionen los comandos, debemos asegurarnos de que nuestra aplicación está incluída en el setting INSTALLED_APPS. También debemos incluir un archivo __init__.py vacío en cada directorio que hemos creado (para que el directorio se interprete como un módulo de Python). Dentro de commands incluiremos un archivo .py por cada comando que deseemos utilizar para nuestra aplicación, quedando finalmente una estructura como esta:

mi_aplicacion/
    __init__.py
    models.py
    management/
        __init__.py
        commands/
            __init__.py
            un_comando.py
            otro_comando.py
    views.py

El nombre que tenga cada archivo .py dentro de commands será el nombre del comando. Si por ejemplo creamos un archivo enviar.py, nuestro código se ejecutará cuando se utilice el comando manage.py enviar. Dentro de cada archivo de comando tenemos que crear una clase Command que herede alguna de las clases básicas de comandos.

Todas las clases básicas de comandos heredan de django.core.management.base.BaseCommand. Tu comando puede heredar directamente la clase BaseCommand pero hay otras clases de comandos que permiten crear distintos tipos de comando de una forma más sencilla:

# -*- encoding: utf-8 -*-
from django.core.management.base import NoArgsCommand

class Command(NoArgsCommand):
    help = "Breve descripción de lo que hace el comando."

    def handle_noargs(self, **options):
        # aquí va el código de mi comando
        print 'Comando ejecutado'

Ejecutar tareas automáticas con django-chronograph

Django-chronograph es una aplicación que permite programar la ejecución de tareas automáticas de manage.py utilizando cron. Permite especificar las tareas a realizar y el intervalo de tiempo en el que se deben repetir mediante el sitio de administración de Django. Esto es muy útil para automatizar tareas repetitivas de nuestro proyecto como pueden ser enviar un e-mail semanal automático a todos los usuarios ó eliminar diariamente cuentas de usuarios inactivos. Django-chronograph también almacena un listado de logs visible desde el sitio de administración que nos permite comprobar los resultados de las tareas ejecutadas.

Para instalar django-chronograph basta con seguir los siguientes pasos:

1. Descarga python-dateutil si aún no lo tienes. Es necesario para django-chronograph.

2. Descarga la última versión de django-chronograph del repositorio mediante svn:

   svn checkout http://django-chronograph.googlecode.com/svn/trunk/ django-chronograph-read-only
   

3. Añade la aplicación chronograph al setting INSTALLED_APPS y la siguiente URL a tu configuración de URLs en urls.py:

   url(r'^admin/chronograph/job/(?P<pk>\d+)/run/$', 'chronograph.views.job_run', name="admin_chronograph_job_run")
   

   Después ejecuta el comando manage.py syncdb para que se creen las tablas necesarias en la base de datos.

4. Añade la siguiente línea a tu crontab especificando la ruta en la que se encuentra el archivo manage.py de tu proyecto. Para editar las tareas cron utiliza el comando crontab -e

* * * * * python /path/a/tu/proyecto/manage.py cron

Después podrás gestionar tus tareas automáticas desde el sitio de administración de Django.

Personalizar el título del sitio de administración

¿Te has cansado del monótono título "Administración de Django" que aparece en el sitio de administración de tu proyecto? Django permite personalizar las plantillas del sistema de administración fácilmente. Puedes tener plantillas de administración personalizadas a nivel de modelo, aplicación o proyecto.

Para modificar la plantilla base del sitio de administración de Django creamos un archivo llamado base_site.html dentro de un subdirectorio admin a su vez dentro de un directorio que utilizemos para nuestras plantillas especificado en el setting TEMPLATE_DIRS. Si por ejemplo TEMPLATE_DIRS incluye '/home/plantillas' crearíamos el archivo en la siguiente ruta: /home/plantillas/admin/base_site.html. Cuando este archivo exista el sistema de administración utilizará nuestra plantilla en lugar de la predefinida. Ahora podemos editarlo y especificar el título que deseemos:

{% extends "admin/base.html" %}
{% load i18n %}

{% block title %}{{ title }} | {% trans 'Nuestro título' %}{% endblock %}

{% block branding %}
   <h1 id="site-name">{% trans 'Nuestro título' %}</h1>
{% endblock %}

{% block nav-global %}{% endblock %}