Escribir su primera aplicación Django, parte 1. Vamos a aprender con el ejemplo.

Transcripción

1 Escribir su primera aplicación Django, parte 1 Vamos a aprender con el ejemplo. A lo largo de este tutorial, vamos a caminar a través de la creación de una aplicación de encuesta de base. Va a constar de dos partes: Un sitio público que permite a los sondeos de opinión de la gente y votar en ellas. Un administrador del sitio que te permite añadir, modificar y eliminar las encuestas. Vamos a suponer que usted tiene ya instalado Django. Usted puede ver si Django esta instalado ejecutando el intérprete interactivo de Python y escribiendo import django. Si este comando se ejecuta correctamente, sin errores, Django está instalado. Dónde obtener ayuda: Si tienes problemas para ir a través de este tutorial, por favor enviar un mensaje a django-usuarios o pasar por # django en irc.freenode.net para charlar con otros usuarios de Django, que podría ser capaz de ayudar. Crear un proyecto Si es tu primera vez usando Django, tendrá que hacerse cargo de una configuración inicial. Es decir, que necesita para generar automáticamente un código que establece un proyecto Django - una colección de configuraciones para una instancia de Django, incluyendo la configuración de base de datos, opciones de Django-específica y la configuración específica de la aplicación. Desde la línea de comandos, cd en un directorio donde desea almacenar el código, a continuación, ejecute el comando django-admin.py startproject mysite. Esto creará un directorio mysite en el directorio actual. nombre de secuencias de comandos pueden ser diferentes en los paquetes de la distribución Si ha instalado Django usando el gestor de una distribución de Linux paquete (por ejemplo, apt-get o yum) django-admin.py puede haber sido cambiado el nombre a django-admin. Usted puede continuar a través de esta documentación por omisión. Py de cada comando. Mac OS X permisos Si estás usando Mac OS X, puede ver el mensaje de "permiso denegado" cuando intenta ejecutar django-admin.py startproject. Esto se debe a que, en los sistemas basados en Unix como sistema operativo X, un archivo debe ser marcado como "ejecutable" antes de que se puede ejecutar como un programa. Para ello abrir la terminal, y navegar (con el comando cd) a el directorio donde está instalado django-admin.py, a continuación, ejecute el comando chmod + x django-admin.py.

2 Nota Tendrás que evitar los proyectos de nombres después de componentes integrados Python o Django. En particular, esto significa que usted debe evitar usar nombres como Django (que entrará en conflicto con Django sí mismo) o test (que entra en conflicto con un sistema incorporado en el paquete de Python). django-admin.py debe estar en su ruta (path) de sistema si se ha instalado a través de Django python setup.py. Si no está en su camino (path), usted lo puede encontrar en site-packages/django/bin, donde "site-packages» es un directorio dentro de su instalación de Python. Considere la posibilidad de enlaces simbólicos de django-admin.py de algún lugar en tu camino(path), como /usr/ local/bin. Dónde el código en vivo? Si el fondo es en PHP, es probable que utiliza para poner el código en la raíz de documentos del servidor Web (en un lugar como /var/www). Con Django, usted no hace eso. No es una buena idea para poner todo esto en código Python raíz de documentos del servidor Web, porque corre el riesgo de la posibilidad de que la gente pueda ver el código a través de Internet. Eso no es bueno para la seguridad. Coloque el código en algún directorio fuera de la raíz del documento, tales como /home/mycode. Echemos un vistazo a lo que startproject creado: mysite / init.py manage.py settings.py urls.py Estos archivos son los siguientes: init.py: Un archivo vacío que le dice a Python que este directorio se debe considerar un paquete de Python. (Lea más acerca de los paquetes en la documentación oficial de Python si usted es un principiante Python.) manage.py: Una utilidad de línea de comandos que le permite interactuar con este proyecto Django de varias maneras. Usted puede leer todos los detalles sobre manage.py en django-admin.py y manage.py. settings.py: Configuración / configuración para este proyecto Django. configuración de Django le dirá todo acerca de los ajustes de trabajo. urls.py: Las declaraciones URL para este proyecto Django, una "tabla de contenidos" de su sitio web Django. Puedes leer más acerca de las URL en el URL dispatcher.

3 El servidor de desarrollo Vamos a comprobar esto funcionó. Me cambio al directorio mysite, si no lo ha hecho, y ejecuto el comando python manage.py runserver. Verá la siguiente salida en la línea de comandos: Validating models... 0 errors found. Django version 1.0, using settings 'mysite.settings' Development server is running at Quit the server with CONTROL-C. Usted ha iniciado el servidor de desarrollo de Django, un servidor web ligero escrito puramente en Python. Hemos incluido este con Django para que pueda desarrollar las cosas rápidamente, sin tener que lidiar con la configuración de un servidor de producción - como Apache - hasta que esté listo para la producción. Ahora es un buen momento para tener en cuenta: NO utilice este servidor en algo parecido a un entorno de producción. Está pensado solamente para el uso durante el desarrollo. (Estamos en el negocio de hacer marcos Web no, los servidores web.) Ahora que el servidor está funcionando, visite con su navegador Web. Verás un "Bienvenidos a Django" de la página, en colores pastel agradable, de color azul claro. Funcionó! Cambiar el puerto De forma predeterminada, el comando runserver inicia el servidor de desarrollo en la ip interna en el puerto Si quieres cambiar el puerto del servidor, pasarlo como un argumento de línea de comandos. Por ejemplo, este comando inicia el servidor en el puerto 8080: python manage.py runserver 8080 Si desea cambiar la IP del servidor, que pasan junto con el puerto. Así que para escuchar en todas las direcciones IP públicas (útil si desea mostrar su trabajo en otros equipos), utilice: python manage.py runserver :8000 documentación completa para el servidor de desarrollo se pueden encontrar en la referencia runserver.

4 Base de datos de configuración (Database setup) Ahora, edita settings.py. Es un módulo Python normal con variables de nivel de módulo que representa configuración de Django. Cambiar las claves siguientes en el punto DATABASES 'default' esto coincide con la configuración de conexión de bases de datos. ENGINE -- Cualquiera 'django.db.backends.postgresql_psycopg2', 'django.db.backends.mysql' o 'django.db.backends.sqlite3'. Otros backends están también disponibles. NAME - El nombre de su base de datos. Si estás usando SQLite, la base de datos será un archivo en su ordenador, en cuyo caso, NAME debe ser la ruta completa, incluyendo nombre de archivo, de ese archivo. Si el archivo no existe, se creará automáticamente al sincronizar la base de datos por primera vez (véase más adelante). Al especificar la ruta de acceso, siempre usar estas barras, incluso en Windows (por ejemplo, C: / homes/user/mysite/sqlite3.db). USER - Su nombre de usuario de base de datos (no usado en SQLite). PASSWORD - La contraseña de base de datos (no usado en SQLite). HOST - El anfitrión está en su base de datos. Deja esto como una cadena vacía si el servidor de base de datos está en la misma máquina física (no se utiliza para SQLite). Si eres nuevo en bases de datos, se recomienda simplemente usando SQLite (mediante el establecimiento de ENGINE a 'django.db.backends.sqlite3'). SQLite está incluido como parte de Python 2.5 y posteriores, por lo que no tendrá que instalar nada más. Nota Si usted está usando PostgreSQL o MySQL, asegúrese de que ha creado una base de datos en este punto. Hacerlo con 'CREATE DATABASE nombre_basedatos' dentro del sistema interactivo de tu base de datos. Si estás usando SQLite, no es necesario para crear cualquier cosa de antemano - el archivo de base de datos se crea automáticamente cuando se necesita. Mientras que usted está editando settings.py, tomar nota de la INSTALLED_APPS esta se encuentra hacia el final del archivo. Esa variable contiene los nombres de todas las aplicaciones Django que se activan en esta instancia de Django. Aplicaciones se pueden utilizar en múltiples proyectos, y se puede empaquetar y distribuir para su uso por otros en sus proyectos.

5 De forma predeterminada, INSTALLED_APPS contiene las siguientes aplicaciones, todas las cuales vienen con Django: django.contrib.auth - Un sistema de autenticación. django.contrib.contenttypes - Un marco para los tipos de contenido. django.contrib.sessions - Un marco período de sesiones. django.contrib.sites - Un marco para la gestión de múltiples sitios con una instalación de Django. django.contrib.messages - Un marco de mensajería. django.contrib.staticfiles - Un marco para la gestión de los archivos estáticos. Estas aplicaciones se incluyen por defecto como una conveniencia para el caso común. Cada una de estas aplicaciones hace uso de la tabla de base de datos de al menos uno, sin embargo, por lo que debemos crear las tablas en la base de datos antes de poder utilizarlos. Para ello, ejecute el siguiente comando: python manage.py syncdb El comando syncdb mira la configuración INSTALLED_APPS y crea las tablas de bases de datos necesarias de acuerdo a la configuración de base de datos en el archivo settings.py. Verás un mensaje para cada tabla de base de datos que crea, y recibirá un mensaje preguntándole si desea crear una cuenta de superusuario para el sistema de autenticación. Seguir adelante y hacer eso. Si usted está interesado, ejecutar el cliente de línea de comandos para su base de datos y escriba \dt (PostgreSQL), SHOW TABLES; (MySQL), o.schema (SQLite) para mostrar las tablas de Django creado.. Para los minimalistas (For the minimalists) Como dijimos anteriormente, las aplicaciones predeterminadas se incluyen para el caso común, pero no todas las necesidades. Si no nececita ninguna de esas, no dude en comentar-out o eliminar la línea correspondiente (s) de INSTALLED_APPS antes de ejecutar syncdb. El comando syncdb sólo creará las tablas para aplicaciones en INSTALLED_APPS. La creación de modelos (Creating models) Ahora que su entorno - un "proyecto" - es creado, ya está listo para comenzar a hacer el trabajo. Cada aplicación que se escribe en Django consiste en un paquete de Python, en algún lugar de la ruta de Python (Python path), que sigue a una convención determinada. Django viene con una utilidad que genera automáticamente la estructura de la guía básica de una aplicación, de modo que pueda centrarse en la escritura de código en lugar de crear directorios.

6 Proyectos vs aplicaciones(projects vs. apps) Cuál es la diferencia entre un proyecto y una aplicación? Una aplicación es una aplicación web que hace algo - por ejemplo, un sistema de weblog, una base de datos de los registros públicos o de una aplicación sencilla encuesta. Un proyecto es un conjunto de aplicaciones y configuración de un sitio web en particular. Un proyecto puede contener múltiples aplicaciones. Una aplicación puede estar en varios proyectos. Sus aplicaciones pueden vivir en cualquier parte de la ruta de Python (Python path). En este tutorial, vamos a crear nuestra aplicación de encuesta(poll) en el directorio mysite para la simplicidad. Para crear su aplicación, asegúrese de que está en el directorio mysite y escribir este comando: python manage.py startapp polls Eso va a crear un directorio de las encuestas (polls), que se presenta así: polls / init.py models.py tests.py views.py Esta estructura de directorios albergará la aplicación encuesta (poll application). El primer paso para escribir una aplicación de base de datos Web en Django es la definición de sus modelos - en esencia, el diseño de bases de datos, con metadatos adicionales. Filosofía Un modelo es la fuente única y definitiva de datos acerca de sus datos. Contiene los campos esenciales y las conductas de los datos que está guardando. Django sigue el principio DRY. El objetivo es definir su modelo de datos en un solo lugar y de forma automática las cosas se derivan de ella. En nuestra simple aplicación encuesta (poll), vamos a crear dos modelos: las encuestas(polls) y las elecciones (choices). Una encuesta tiene una pregunta y una fecha de publicación. Una opción tiene dos campos: el texto de la elección y un recuento voto. Cada opción está asociada con una encuesta. Estos conceptos están representados por simples clases de Python. Editar el archivo polls/models.py por lo que se ve así: from django.db import models class Poll(models.Model): question = models.charfield(max_length=200) pub_date = models.datetimefield('date published') class Choice(models.Model): poll = models.foreignkey(poll) choice = models.charfield(max_length=200) votes = models.integerfield()

7 El código es sencillo. Cada modelo está representado por una clase de subclases django.db.models.model. Cada modelo tiene una serie de variables de la clase, cada uno de los cuales representa un campo de base de datos en el modelo. Cada campo (field) está representado por una instancia de una clase de campo (field) - por ejemplo, CharField para campos de caracteres y DateTimeField para datetimes. Esto le dice a Django qué tipo de datos de cada campo contiene. El nombre de cada instancia de campo (por ejemplo, question o pub_date) es el nombre del campo, en el formato de la máquina de usar. Vamos a usar este valor en el código Python, y su base de datos va a usar como el nombre de la columna. Usted puede usar un argumento opcional posicional primero en un campo para designar un nombre legible por humanos. Que se utiliza en un par de piezas introspectivas de Django, y sirve como documentación. Si este campo no se proporciona, Django usará el nombre legible por máquina. En este ejemplo, sólo hemos definido un nombre legible para Poll.pub_date. Para todos los otros campos en este modelo, el nombre legible por la máquina del campo será suficiente, como su nombre legible por humanos. Algunas clases de campo requieren elementos. CharField, por ejemplo, requiere que usted le de un max_length. Que se utiliza no sólo en el esquema de base de datos, tambien en la validación, como pronto veremos. Por último, tenga en cuenta que una relación se define, con ForeignKey. Eso le dice a Django que cada elección(choice) tiene que ver con una sola encuesta (Poll). Django soporta todas las relaciones de base de datos común: muchos-a-uno (many-to-ones), muchos a muchos (many-to-many) y uno-a-uno (one-to-one). Activación de los modelos Esa pequeña porción de código de modelo de Django da mucha información. Con esto, Django es capaz de: Crear un esquema de base de datos (CREATE TABLE) para esta aplicación. Crear una base de datos de acceso de Python a la API para acceder a objetos de una encuesta(poll) y elección (Choice). Pero primero tenemos que decirle a nuestro proyecto que la aplicación de encuestas(polls) se ha instalado. Filosofía aplicaciones Django son "enchufables"(pluggable): Puede utilizar una aplicación en múltiples proyectos, y se puede distribuir aplicaciones, ya que no tiene que estar atado a una determinada instalación de Django. Editar el archivo settings.py otra vez, y agrega en INSTALLED_APPS en el archivo setting la opción para incluir 'encuestas' ('polls') 'de la cadena. Así que va a tener el siguiente aspecto:

8 INSTALLED_APPS = ( 'django.contrib.auth, 'django.contrib.contenttypes, 'django.contrib.sessions, 'django.contrib.sites, 'polls', ) Ahora Django sabe que incluye la aplicación de encuestas (polls). Vamos a ejecutar otro comando: python manage.py sql polls Usted debe ver algo similar a lo siguiente (las instrucciones CREATE TABLE de SQL para la aplicación de encuestas(polls): BEGIN; CREATE TABLE "polls_poll" ( "id" serial NOT NULL PRIMARY KEY, "question" varchar(200) NOT NULL, "pub_date" timestamp with time zone NOT NULL ); CREATE TABLE "polls_choice" ( "id" serial NOT NULL PRIMARY KEY, "poll_id" integer NOT NULL REFERENCES "polls_poll" ("id"), "choice" varchar(200) NOT NULL, "votes" integer NOT NULL ); COMMIT; Tenga en cuenta lo siguiente: La salida exacta puede variar dependiendo de la base de datos que está utilizando. Los nombres de tablas se generan automáticamente mediante la combinación del nombre de la aplicación (polls) y el nombre en minúsculas del modelo - encuesta (poll) y elección (choice). (Usted puede cambiar este comportamiento.) Las claves principales (ID) se agregan automáticamente. (Usted puede evitar esto, también.) Por convención, Django anexa "_id" al nombre del campo de clave externa(foreign key). Sí, se puede reemplazar esto, también. La relación de clave externa se hace explícito de una declaración REFERENCIAS. Es la medida de la base de datos que está utilizando, por lo que los tipos de campos específicos de bases de datos, como auto_increment (MySQL), serial (PostgreSQL), o integer primary key (SQLite) se manejan de forma automática. Lo mismo ocurre en la cotización de los nombres de campo - por ejemplo, utilizando comillas dobles o comillas simples. El autor de este tutorial ejecuta PostgreSQL, por lo que el resultado del ejemplo es en la sintaxis de PostgreSQL.

9 El comando sql en realidad no ejecuta el SQL en su base de datos - sólo se imprime en la pantalla, para que pueda ver lo que SQL Django piensa que es necesario. Si lo desea, puede copiar y pegar este SQL en la base de datos del sistema. Sin embargo, como veremos en breve, Django proporciona una manera más fácil de cometer el SQL a la base de datos. Si estás interesado, también ejecuta los siguientes comandos: python manage.py validate - Controles de los posibles errores en la construcción de sus modelos. python manage.py sqlcustom polls - Salidas de cualquier custom SQL statements (por ejemplo, modificaciones de mesa o restricciones) que se definen para la aplicación. python sqlclear manage.py polls salidas necesarias DROP TABLE para esta aplicación, de acuerdo con las tablas que ya existen en la base de datos (si los hubiera). Python manage.py sqlindexes polls - Salidas de las instrucciones CREATE INDEX para esta aplicación. python manage.py sqlall polls - Una combinación de todos los comandos SQL como sql, sqlcustom y sqlindexes. En cuanto a la salida de estos comandos puede ayudarle a entender lo que está ocurriendo en realidad bajo el capó. Ahora, ejecute syncdb de nuevo para crear los modelos de tablas de la base de datos: python manage.py syncdb El comando syncdb ejecuta el sql de 'sqlall' sobre la base de datos para todas las aplicaciones en INSTALLED_APPS que aún no existen en su base de datos. Esto crea todas las tablas, los datos iniciales y los índices para cualquier aplicación que ha añadido a su proyecto desde la última vez que corrió syncdb. syncdb se puede llamar tantas veces como desee, y sólo alguna vez crear las tablas que no existen. Lea la documentación de django-admin.py para obtener información completa sobre lo que la utilidad manage.py puede hacer. Jugando con la API Ahora, vamos a saltar dentro del modo interactivo de Python (python shell) y jugar con la libre circulación que la API Django le ofrece. Para invocar la terminal de Python, utilice este comando: python manage.py shell Estamos usando esto en lugar de simplemente escribir "python", porque manage.py establece el entorno del proyecto para usted. "Configuración del entorno" implica dos cosas:

10 Poner encuestas(polls) en el sys.path. Para mayor flexibilidad, varias piezas de Django se refieren a proyectos en Python notación con puntos ('polls.models' por ejemplo). Para que esto funcione, el paquete de las encuestas (polls) tiene que estar en sys.path. Ya hemos visto un ejemplo de esto: el ajuste INSTALLED_APPS es una lista de paquetes en notación de puntos de la ruta (dotted-path). La variable de entorno DJANGO_SETTINGS_MODULE, lo cual Django toma la ruta a su archivo settings.py. Anulación manage.py (Bypassing manage.py) Si prefiere no usar manage.py, no hay problema. Sólo tiene que asegurarse que mysite y las (polls)encuestas estén en la raíz de la ruta Python (python path)(es decir, import mysite y trabajar import polls) y establecer la variable de entorno DJANGO_SETTINGS_MODULE para mysite.settings. Para obtener más información sobre todo esto, consulte la documentación de django-admin.py. Una vez que esté en el depósito (shell), explore la API de la base de datos (database API): >>> from polls.models import Poll, Choice # Import the model classes we just wrote. # No polls are in the system yet. >>> Poll.objects.all() [] # Create a new Poll. >>> import datetime >>> p = Poll(question="What's up?", pub_date=datetime.datetime.now()) # Save the object into the database. You have to call save() explicitly. >>> p.save() # Now it has an ID. Note that this might say "1L" instead of "1", depending # on which database you're using. That's no biggie; it just means your # database backend prefers to return integers as Python long integer # objects. >>> p.id 1 # Access database columns via Python attributes. >>> p.question "What's up?" >>> p.pub_date datetime.datetime(2007, 7, 15, 12, 00, 53) # Change values by changing the attributes, then calling save(). >>> p.pub_date = datetime.datetime(2007, 4, 1, 0, 0) >>> p.save() # objects.all() displays all the polls in the database.

11 >>> Poll.objects.all() [<Poll: Poll object>] Espera un minuto. <Poll: Poll object> es, absolutamente, una representación inútil de este objeto. Vamos a fijar el sentido de que mediante la modificación del modelo de encuestas (en las polls/models.py archivo) y la adición de un unicode () method para ambos encuesta(poll) y elección(choice): class Poll(models.Model): # def unicode (self): return self.question class Choice(models.Model): # def unicode (self): return self.choice Es importante añadir unicode () para sus modelos, no sólo para su propia cordura cuando se trata de el modo interactivo, sino también porque las representaciones de los objetos "se utilizan a través de Django generado automáticamente admin. Por qué unicode () y no str ()? Si está familiarizado con Python, es posible que la costumbre de añadir str () para sus clases, no unicode () métodos. Utilizamos unicode () aquí porque Django models acuerdo con los modelos de Unicode de forma predeterminada. Todos los datos almacenados en su base de datos se convierten a Unicode cuando es devuelto. Django modesl tiene por defecto str () metodo que llama a unicode () y convierte el resultado a un UTF-8 bytestring. Esto significa que unicode (p) devuelve una cadena Unicode y str (p) devuelve una cadena normal, con caracteres codificados como UTF-8. Si todo esto es jibberish a usted, recuerde agregar unicode () para sus modelos. Con un poco de suerte, las cosas sólo debe trabajar para usted. Nota que estos son los métodos normales de Python. Vamos a añadir un método personalizado, sólo para la demostración: import datetime # class Poll(models.Model): # def was_published_today(self): return self.pub_date.date() == datetime.date.today()

12 Tenga en cuenta la adición de import datetime es una referencia estandar de python al modulo datetime Guarde los cambios y abra un nuevo intérprete interactivo de Python ejecutando Python manage.py shell otra vez: >>> from polls.models import Poll, Choice # Make sure our unicode () addition worked. >>> Poll.objects.all() [<Poll: What's up?>] # Django provides a rich database lookup API that's entirely driven by # keyword arguments. >>> Poll.objects.filter(id=1) [<Poll: What's up?>] >>> Poll.objects.filter(question startswith='what') [<Poll: What's up?>] # Get the poll whose year is >>> Poll.objects.get(pub_date year=2007) <Poll: What's up?> >>> Poll.objects.get(id=2) Traceback (most recent call last):... DoesNotExist: Poll matching query does not exist. # Lookup by a primary key is the most common case, so Django provides a # shortcut for primary-key exact lookups. # The following is identical to Poll.objects.get(id=1). >>> Poll.objects.get(pk=1) <Poll: What's up?> # Make sure our custom method worked. >>> p = Poll.objects.get(pk=1) >>> p.was_published_today() False # Give the Poll a couple of Choices. The create call constructs a new # choice object, does the INSERT statement, adds the choice to the set # of available choices and returns the new Choice object. Django creates # a set to hold the "other side" of a ForeignKey relation # (e.g. a poll's choices) which can be accessed via the API. >>> p = Poll.objects.get(pk=1) # Display any choices from the related object set -- none so far. >>> p.choice_set.all() [] # Create three choices. >>> p.choice_set.create(choice='not much', votes=0) <Choice: Not much> >>> p.choice_set.create(choice='the sky', votes=0) <Choice: The sky> >>> c = p.choice_set.create(choice='just hacking again', votes=0)

13 # Choice objects have API access to their related Poll objects. >>> c.poll <Poll: What's up?> # And vice versa: Poll objects get access to Choice objects. >>> p.choice_set.all() [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>] >>> p.choice_set.count() 3 # The API automatically follows relationships as far as you need. # Use double underscores to separate relationships. # This works as many levels deep as you want; there's no limit. # Find all Choices for any poll whose pub_date is in >>> Choice.objects.filter(poll pub_date year=2007) [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>] # Let's delete one of the choices. Use delete() for that. >>> c = p.choice_set.filter(choice startswith='just hacking') >>> c.delete() Para obtener más información sobre las relaciones del modelo, vea Obtener acceso a objetos relacionados(accessing related objects). Para más información sobre cómo utilizar dos guiones para realizar búsquedas de campo (Field lookups) a través de la API, ver las búsquedas de campo. Para más detalles sobre la base de datos de la API, consulte nuestra base de datos de referencia de la API Database API reference.. Cuando usted se siente cómodo con la API, lea la parte 2 de este tutorial para obtener automática de trabajo de administración de Django.

14 Escribir su primera aplicación Django, parte 2 Este tutorial comienza donde Tutorial 1 dejó. Seguimos la aplicación web de encuestas y se enfocara en Django automatically-generated admin site. Filosofía los sitios de Generación de administrador de personal o clientes para agregar, cambiar y borrar el contenido es un trabajo tedioso que no requiere mucha creatividad. Por esa razón, Django totalmente automatiza la creación de interfaces de administración para los modelos. Django fue escrito en un entorno de sala de redacción, con una separación muy clara entre "los editores de contenido" y el sitio "público". Los administradores del sitio utiliza el sistema para añadir las noticias, eventos, resultados deportivos, etc, y que el contenido se muestra en el sitio público. Django resuelve el problema de la creación de una interfaz unificada para los administradores del sitio para editar contenido. El administrador no es necesariamente destinados a ser utilizados por los visitantes del sitio, es para los administradores del sitio. Activar el administrador del sitio El sitio de administración de Django no está activada de forma predeterminada - se trata de un opt-in cosa. Para activar el administrador del sitio para su instalación, hacer estas tres cosas: Añadir "django.contrib.admin" a la posición INSTALLED_APPS. Ejecutar Python syncdb manage.py. Puesto que usted ha añadido una nueva aplicación para INSTALLED_APPS, las tablas de bases de datos necesitan ser actualizados. Edita el archivo mysite/urls.py y descomentar las líneas que hacen referencia al admin - hay tres líneas en total que descomentar. Este archivo es un URLconf; vamos a profundizar en URLconfs en el siguiente tutorial. Por ahora, todo lo que necesita saber es que aquí es donde se asignan las rutas Url raices (roots) para aplicaciones. Al final, usted debe tener un archivo urls.py que tiene este aspecto: from django.conf.urls.defaults import * # Uncomment the next two lines to enable the admin: from django.contrib import admin admin.autodiscover() urlpatterns = patterns('', # Example: # (r'^mysite/', include('mysite.foo.urls')), # Uncomment the admin/doc line below and add 'django.contrib.admindocs' # to INSTALLED_APPS to enable admin documentation: # (r'^admin/doc/', include('django.contrib.admindocs.urls')), ) # Uncomment the next line to enable the admin: (r'^admin/', include(admin.site.urls)),

15 (Las líneas en negrita son las que deben ser sin comentarios.) Inicie el servidor de desarrollo Vamos a iniciar el servidor de desarrollo y explorar el sitio de administración. Recordemos del Tutorial 1 que se inicia el servidor de desarrollo de este modo: python runserver manage.py Ahora, abra un navegador Web y vaya a "/admin/" en su dominio local - por ejemplo, Usted debe ver el administrador de la pantalla de entrada: Django pantalla de login admin Introduzca el administrador del sitio Ahora, intente acceder (Ha creado una cuenta de superusuario en la primera parte de este tutorial, recuerde Si no creó una o se le olvidó la contraseña se puede crear otra?.) Usted debe ver la página inicial del sitio administrativo de Django: Django página de índice admin Usted debe ver a algunos otros tipos de contenido editable, incluidos los grupos, usuarios y sitios. Estas son las características principales de Django con buques de forma predeterminada.

16 Hacer la aplicación de la encuesta (poll) modificables en el admin Pero dónde está nuestra aplicación encuesta (poll)? No aparecenen la página del sitio administrativo. Sólo una cosa por hacer: Tenemos que decirle al administrador que los objetos de la encuesta tienen una interfaz de administración. Para ello, cree un archivo llamado admin.py en el directorio de las encuestas, y editarlo a este aspecto: from polls.models import Poll from django.contrib import admin admin.site.register(poll) Tendrá que reiniciar el servidor de desarrollo para ver los cambios. Normalmente, el código del servidor automáticamente vuelve a cargar cada vez que modifique un archivo, pero la acción de crear un nuevo archivo no provoca la lógica de auto-recarga. Explore la funcionalidad de administración gratuita Ahora que hemos registrado una encuesta(poll), Django sabe que debe mostrarse en la página del sitio administrativo: Django página de inicio de administración, ahora con las encuestas que aparecen Haga clic en "Encuestas"(poll). Ahora estás en la "lista de cambios" (change list) en la página de las encuestas (polls). Esta página muestra todas las encuestas en la base de datos y le permite elegir uno para cambiarlo. Ahí está la " Qué pasa?" encuesta (poll) que hemos creado en el primer tutorial:

17 Haga clic en la " Qué pasa?" encuesta (poll) para editarla: Edición de formulario para el objeto encuesta Lo que hay que tener en cuenta: La forma se genera automáticamente desde el modelo de encuesta (poll). Los tipos de modelos diferentes de campo (DateTimeField, CharField) corresponden al control de entrada adecuado (input widget) HTML. Cada tipo de campo sabe como mostrarse en el sitio administrativo. Cada DateTimeField se libera atajos JavaScript o utiliza JavaScript. Las fechas tienen un "Today" de acceso directo y emergente de calendario, y el tiempo o hora se ponen con "Now" shortcut acceso directo y conveniente una ventana emergente que muestra las horas habitualmente que la entró. La parte inferior de la página le da un par de opciones: Save - Guarda los cambios y vuelve a la página de cambio de la lista para este tipo de objeto. Save and continue editing - Guarda los cambios y vuelve a cargar la página de administración para este objeto. Save and add another - Guarda los cambios y carga un nuevo formulario en blanco para este tipo de objeto. Delete - eliminar Muestra una página de confirmación. Cambiar la "Fecha de publicación" Date published haciendo click en "Today" y "Now" shortcuts. A continuación, haga clic en "Guardar y seguir editando" Save and continue editing. A continuación, haga clic en "History" en la parte superior derecha. Verás una página con todos los cambios realizados a este objeto a través de la administración de Django (Django admin), con la indicación de la hora y nombre de usuario de la persona que hizo el cambio: Historial para el objeto encuesta

18 Personalizar los formularios administrativos Tome unos minutos para admirar todo el código que no tenía que escribir. Al registrar el modelo de encuesta (poll) con admin.site.register(poll), Django fue capaz de construir un formulario predeterminado. A menudo, usted querrá personalizar el modo en que se ve y funciona el formulario de administración. Usted hara esto diciendole a Django las opciones que desee cuando se registra el objeto. Vamos a ver cómo funciona esto cambiando el orden de los campos en el formulario de edición. Remplace la linea admin.site.register (poll) con: class PollAdmin(admin.ModelAdmin): fields = ['pub_date', 'question'] admin.site.register(poll, PollAdmin) Usted siga este patrón - creara un objeto de administración del modelo, a continuación, pasar este como el segundo argumento de admin.site.register () - cada vez que necesite cambiar las opciones de administrador de un objeto. Este cambio en particular hace que la "fecha de publicación" Publication date aparezca antes de que el campo "Pregunta" Question : Los campos fueron reordenados Esto no es impresionante, con sólo dos campos, pero para formularios administrativos hay docenas de campos, elegir un orden intuitivo es un detalle importante la facilidad de uso.

19 Y hablando de los formularios con docenas de campos, es posible que desee dividir la forma en grupos de campos: class PollAdmin(admin.ModelAdmin): fieldsets = [ (None, {'fields': ['question']}), ('Date information', {'fields': ['pub_date']}), ] admin.site.register(poll, PollAdmin) El primer elemento de cada tupla en conjuntos de campos es el título de los campos. Esto es lo que nuestro formulario se ve como ahora: Forma ahora tiene grupos de campos Puede asignar clases arbitrarias HTML a cada grupo de campos. Django provee un "collapse" de clase que muestra un particular campo inicialmente colapsado. Esto es útil cuando se tiene un formulario largo que contiene una serie de campos que no son de uso general: class PollAdmin(admin.ModelAdmin): fieldsets = [ (None, {'fields': ['question']}), ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}), ] Fieldset inicialmente se derrumbó

20 Adición de objetos relacionados OK, tenemos nuestra página Encuesta (Poll) de administración. Pero una encuesta tiene elecciones (Choices) múltiples, y la página de administración no muestra las opciones. Sin embargo. Hay dos maneras de resolver este problema. El primero es el registro de elecciones (Choice) con el administrador tal como lo hicimos con una encuesta (Poll). Eso es fácil: from polls.models import Choice admin.site.register(choice) Ahora "Choices" es una opción disponible en el sitio administrativo. La "Add choice" el formulario se parece a esto: Elección de la página admin En ese formulario, el campo "Poll" es un cuadro de selección que contiene todas las encuestas de la base de datos. Django sabe que un ForeignKey deben estar representados en la administración como una caja <select>. En nuestro caso, sólo existe una encuesta en este momento. También tenga en cuenta el "Agregar otro" Add Another (+) al lado "Poll". Cada objeto con una relación ForeignKey a otro se presenta de esta forma. Al hacer clic en "Agregar otro", obtendrás una ventana emergente con el formulario "Agregar encuesta" Add poll. Si se agrega una encuesta en la ventana y hace click en "Save", Django guardar la encuesta de la base de datos y de forma dinámica añade esta como opción para ser seleccionada en el formulario "Añadir opción" Add choice que está viendo. Pero, en realidad, esta es una forma ineficiente de añadir objetos a la elección del sistema. Sería mejor si usted podría agregar un montón de opciones directamente al crear el objeto de la encuesta. Vamos a hacer que eso suceda.

21 Eliminar el register() para el modelo de elección (Choice model). A continuación, modifique el código de registro de la encuesta (poll) para que diga: class ChoiceInline(admin.StackedInline): model = Choice extra = 3 class PollAdmin(admin.ModelAdmin): fieldsets = [ (None, {'fields': ['question']}), ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}), ] inlines = [ChoiceInline] admin.site.register(poll, PollAdmin) Esto le dice a Django: "los objetos de Elección se editan en la página Encuesta (poll) admin. De forma predeterminada, proporcionar campos para 3 opciones.." Cargue el "Agregar encuesta" Add poll para ver cómo se ve, es posible que tenga que reiniciar el servidor de desarrollo: Página Agregar encuesta ahora tiene opciones en él Funciona así: Hay tres ranuras para relacionar elecciones (choices) - como se especifica en extra - y cada vez que regrese al "change" en la página de un objeto ya creado, se obtiene otros tres ranuras extra. Un pequeño problema, sin embargo. Se necesita una gran cantidad de espacio en la pantalla para mostrar todos los campos para introducir objetos relacionados con la elección (Choice objects). Por esa razón, Django ofrece una forma de tabla en línea de mostrar los objetos relacionados, sólo tiene que cambiar la declaración ChoiceInline para que diga: class ChoiceInline (admin.tabularinline): #

22 Con esa TabularInline (en lugar de StackedInline), los objetos relacionados se muestran de una manera más compacta, formato basado en tablas: Página Agregar encuesta ahora tiene opciones más compacto Personalizar la lista de cambios de administración Ahora que la página de la encuesta de administración se ve bien, vamos a hacer algunos ajustes a la "lista de cambios" change list de la página - la que muestra todas las encuestas (polls) en el sistema. Esto es lo que parece en este punto: Encuestas cambia página de la lista De forma predeterminada, Django muestra el str () de cada objeto. Pero a veces sería más útil si pudiéramos mostrar los campos individuales. Para ello, utilice la opción list_display en el admin, que es una tupla de nombres de los campos a mostrar, como columnas, en la página de lista de cambios para el objeto de: class PollAdmin (admin.modeladmin): # list_display = ('question', 'pub_date')

23 Sólo por si acaso, vamos a incluir también el método personalizado de was_published_today Tutorial 1: class PollAdmin (admin.modeladmin): # list_display = ('question', 'pub_date', 'was_published_today') Ahora el cambio encuesta de página de la lista es la siguiente: Encuestas cambio de página de lista, actualizada Puede hacer clic en los encabezados de columna para ordenar por los valores - excepto en el caso de la cabecera was_published_today, porque la clasificación por la salida de un método arbitrario no es compatible. También tenga en cuenta que el encabezado de columna para was_published_today es, por defecto, el nombre del método (con guiones bajos reemplazados con espacios). Pero usted puede cambiar que al dar ese método (en models.py) un atributo short_description: def was_published_today(self): return self.pub_date.date() == datetime.date.today() was_published_today.short_description = 'Published today?' Editar el archivo admin.py de nuevo y añadir una mejora a la página de lista de una encuesta cambio: Filtros. Agregue la línea siguiente para PollAdmin: list_filter = ['pub_date'] Que añade un "filtro" barra lateral que permite a las personas filtrar la lista de cambios por el campo pub_date : Encuestas cambio de página de lista, actualizada El tipo de filtro que aparecen dependen del tipo de campo que está filtrando. Debido a que pub_date es un DateTimeField, Django sabe dar a las opciones predeterminadas del filtro para DateTimeFields: ". Este año" "Cualquier fecha" Any date, "Hoy" Today, "los últimos 7 días" Past 7 days, "Este mes" This month,

24 Este se perfila bien. Vamos a añadir un poco de capacidad de búsqueda: search_fields = ['question'] Que agrega un cuadro de búsqueda en la parte superior de la lista de cambios. Cuando alguien entra en los términos de búsqueda, Django buscará en el campo de la pregunta (question). Puede utilizar tantos campos como desee - si bien, ya que utiliza LIKE query detrás de las escenas, mantenga razonable, para mantener su base de datos feliz. Por último, ya que los objetos Encuesta (Poll objects) tienen fechas, sería conveniente para ver los detalles por fecha. Agregue esta línea: date_hierarchy = 'pub_date' Que añade sistema de navegación jerárquica (hierachy), por fecha, en la parte superior de la página de lista de cambios. En el nivel superior, muestra todos los años disponibles. Luego se profundiza a meses y, en última instancia, días,. Ahora también es un buen momento para señalar que las listas de cambio da la paginación libre. El valor por defecto es mostrar 50 elementos por página. Para hacer cambio-lista de paginación,cuadros de búsqueda, filtros, las jerarquías de la fecha y la columna de pedidos de cabecera-todos trabajamos juntos como usted piensa que deberían (Change-list pagination, search boxes, filters, date-hierarchies and column-header-ordering all work together like you think they should). Personalizar el aspecto y la sensación de administración Está claro que tener "la administración de Django" en la parte superior de cada página de administración es ridículo. Es sólo texto del marcador. Eso es fácil de cambiar, sin embargo, utilizando el sistema de plantillas de Django. La administración de Django es provista por Django mismo, y sus interfaces hace uso del sistema propio de plantilla de Django. Abra el archivo de configuración (mysite/settings.py, recuerde) y ver el ajuste TEMPLATE_DIRS setting. TEMPLATE_DIRS es una tupla de directorios a mirar cuando Django carga las plantillas. Es una ruta de búsqueda. De forma predeterminada, TEMPLATE_DIRS está vacía. Por lo tanto, vamos a añadir una línea a ella, para decirle a Django donde viven nuestras plantillas: TEMPLATE_DIRS = ( "/ Home / my_username / mytemplates", # Cambia esto a su propio directorio. )

25 Ahora copia la plantilla de admin/base_site.html que esta dentro del directorio por defecto de plantillas de Django plantilla de administrador en el código fuente de Django (django/contrib/admin/templates) en un subdirectorio admin de los que está utilizando en TEMPLATE_DIRS o sea metala en el directorio admin que creo donde tiene las templates de su aplicación que es donde apunta la ruta que usted coloca en TEMPLATE_DIRS. Por ejemplo, si su TEMPLATE_DIRS incluye "/home/my_username/mytemplates"aqui dentro de este directorio cree un directorio admin y alli meta base_site.html, que el anterior, entonces, copie django/contrib/admin/templates/ admin/base_site.html en /home/my_username/misplantillas/admin/base_site.html. No se olvide ese subdirectorio admin. Luego, simplemente edita el archivo y reemplaza el texto generico de Django con el nombre de su propio sitio como mejor le parezca. Este archivo de plantilla contiene gran cantidad de texto como {% block branding%} y {{títle}}. Las etiquetas{% y {{ son parte del lenguaje de plantilla de Django. Cuando Django renderiza (carga) admin/base_site.html, el lenguaje de plantilla es evaluado para producir la página HTML final. No se preocupe si usted no puede hacer ningún sentido de la plantilla ahora mismo - vamos a profundizar en el lenguaje de plantillas de Django en el Tutorial 3. Tenga en cuenta que cualquier plantilla por defecto de administración de Django se pueden reemplazar o sobreescribir. Para reemplazar una plantilla, hacer lo mismo que hizo con base_site.html - copiarlo en el directorio por defecto en el directorio, y haz los cambios. lectores astutos preguntaran: Pero si TEMPLATE_DIRS estaba vacío por defecto, como encontraba Django el valor por defecto las plantillas de administración? La respuesta es que, por defecto, Django busca automáticamente un subdirectorio templates/ dentro de cada paquete de aplicaciones, para su uso como una alternativa. Consulte la documentación del gestor de plantilla para la información completa. Personalizar la página de índice admin En una nota similar, es posible que desee personalizar la apariencia de la página índice de administración de Django. De forma predeterminada, muestra todas las aplicaciones en INSTALLED_APPS que se han registrado con la aplicación de administración, en orden alfabético. Es posible que desee realizar cambios significativos en el diseño. Después de todo, el índice es probablemente la página más importante de la administración, y debería ser fácil de usar. La plantilla a personalizar es admin/index.html. (Haz lo mismo que con el admin/base_site.html en la sección anterior - copia desde el directorio predeterminado en el directorio de plantillas personalizadas.) Editar el archivo y verás que utiliza una variable de template app_list. Que contiene todas las variables instalados aplicación Django. páginas de administración en lugar de usar eso,puede codificar enlaces a páginas de administración a objetos específicos, cualquiera que sea su mejor forma de pensar. Una vez más, no se preocupe si no entiende el idioma de plantilla - que vamos a cubrir con más detalle en el Tutorial 3. Cuando usted se siente cómodo con el administrador del sitio, lea la parte 3 de este tutorial para empezar a trabajar en vistas encuesta pública.

26 Escribir su primera aplicación Django, parte 3 Este tutorial comienza donde Tutorial 2 dejó. Seguimos la aplicación web de encuestas y se centrará en la creación de la interfaz pública - ". Puntos de vista" views Filosofía Una vista (view) es un "tipo" type de página Web de la aplicación Django que generalmente tiene una función específica y tiene una plantilla determinada. Por ejemplo, en una aplicación de weblog, es posible tener las siquientes vistas: Blog homepage - muestra las últimas pocas entradas. Entry detail "detalle" de la página - permalink página para una sola entrada. Year-based archivo en la página - muestra todos los meses con las entradas en un año determinado. Month-based archivo en la página - muestra todos los días con las entradas en el mes. Day-based archivo en la página - muestra todas las entradas del día. Comment action - se encarga de publicar comentarios a una entrada dada. En nuestra aplicación de encuesta (poll), vamos a tener los siguientes cuatro puntos de vista: Poll index "índice" de la página - muestra las últimas encuestas de algunos. Poll detail "detalle" de la página - muestra una pregunta de la encuesta, sin resultados, pero con una forma de votar. Poll result "resultados" de la página - muestra los resultados de una encuesta en particular. Vote action (Votación de acción) - se encarga de votar por una opción (choice) particular en una encuesta (poll) en particular. En Django, cada vista es representado por una simple función de Python. Diseña tu URL El primer paso de escribir vistas es el diseño de la dirección de la estructura URL. Esto se hace mediante la creación de un módulo de Python, llamado URLconf. URLconfs es cómo se asocia una URL Django dada con determinado código Python. Cuando un usuario solicita una página de Django, el sistema busca en la posición ROOT_URLCONF, una cadena que contiene una serie de puntos en la sintaxis de Python. Django carga ese módulo y busca una variable de nivel de módulo llamado urlpatterns, que es una secuencia de tuplas en el siguiente formato:

27 (regular expression, Python callback function [, optional dictionary]) Django se inicia en la primera expresión regular y se abre paso por la lista, comparando la URL solicitada en contra de cada expresión regular hasta que encuentra uno que coincida. Cuando se encuentra una coincidencia, Django llama a la función de devolución de llamada Python, con un objeto HttpRequest como primer argumento, cualquier "captura" captured de valores de la expresión regular como clave de argumentos, y, opcionalmente, los argumentos arbitrarios palabra clave del diccionario (un tercer elemento opcional en la tupla). Para más información sobre objetos HttpRequest, vea la Solicitud y objetos de respuesta(request and response objects). Para más detalles sobre URLconfs, consulte el distribuidor URL (URL dispatcher). Cuando se corrió django-admin.py startproject mysite al comienzo de un tutorial, creó una configuración de URLs por defecto en mysite/urls.py. Asimismo, ajusta automáticamente la configuración ROOT_URLCONF (en settings.py) para apuntar a ese archivo: ROOT_URLCONF = 'mysite.urls' Tiempo para un ejemplo. Editar mysite/urls.py por lo que se ve así: from django.conf.urls.defaults import * from django.contrib import admin admin.autodiscover() urlpatterns = patterns('', (r'^polls/$', 'polls.views.index'), (r'^polls/(?p<poll_id>\d+)/$', 'polls.views.detail'), (r'^polls/(?p<poll_id>\d+)/results/$', 'polls.views.results'), (r'^polls/(?p<poll_id>\d+)/vote/$', 'polls.views.vote'), (r'^admin/', include(admin.site.urls)), ) Esto merece una revisión. Cuando alguien pide una página de su sitio Web - por ejemplo, "/ polls/23 /", Django cargar este módulo de Python, porque es apuntado por el ajuste ROOT_URLCONF. Encuentra el urlpatterns variable llamada y atraviesa las expresiones regulares en orden. Cuando encuentra una expresión regular que coincide con - r'^polls/(?p<poll_id>\d+)/$' -? esto carga la funcion detail() a partir de polls/views.py. Por último, pide la función detail() de este modo: detail(request=<httprequest object>, poll_id='23') El poll_id = '23 'parte proviene de (<poll_id>? P \ d +). El uso de paréntesis en torno a un patrón de "captura" el texto que coincide con ese patrón y lo envía como un argumento a la función de vista;? P <poll_id> define el nombre que se utilizará para identificar el patrón de "matching" y \ d + es un