2005-07-17 00:54:15 +00:00
|
|
|
=====================================
|
|
|
|
Writing your first Django app, part 2
|
|
|
|
=====================================
|
|
|
|
|
2015-05-11 23:43:40 +00:00
|
|
|
This tutorial begins where :doc:`Tutorial 1 </intro/tutorial01>` left off.
|
|
|
|
We'll setup the database, create your first model, and get a quick introduction
|
|
|
|
to Django's automatically-generated admin site.
|
|
|
|
|
|
|
|
Database setup
|
|
|
|
==============
|
|
|
|
|
|
|
|
Now, open up :file:`mysite/settings.py`. It's a normal Python module with
|
|
|
|
module-level variables representing Django settings.
|
|
|
|
|
|
|
|
By default, the configuration uses SQLite. If you're new to databases, or
|
|
|
|
you're just interested in trying Django, this is the easiest choice. SQLite is
|
|
|
|
included in Python, so you won't need to install anything else to support your
|
|
|
|
database. When starting your first real project, however, you may want to use a
|
2016-10-27 13:14:04 +00:00
|
|
|
more scalable database like PostgreSQL, to avoid database-switching headaches
|
2015-05-11 23:43:40 +00:00
|
|
|
down the road.
|
|
|
|
|
|
|
|
If you wish to use another database, install the appropriate :ref:`database
|
|
|
|
bindings <database-installation>` and change the following keys in the
|
|
|
|
:setting:`DATABASES` ``'default'`` item to match your database connection
|
|
|
|
settings:
|
|
|
|
|
|
|
|
* :setting:`ENGINE <DATABASE-ENGINE>` -- Either
|
|
|
|
``'django.db.backends.sqlite3'``,
|
2015-08-05 14:08:56 +00:00
|
|
|
``'django.db.backends.postgresql'``,
|
2015-05-11 23:43:40 +00:00
|
|
|
``'django.db.backends.mysql'``, or
|
|
|
|
``'django.db.backends.oracle'``. Other backends are :ref:`also available
|
|
|
|
<third-party-notes>`.
|
|
|
|
|
|
|
|
* :setting:`NAME` -- The name of your database. If you're using SQLite, the
|
|
|
|
database will be a file on your computer; in that case, :setting:`NAME`
|
|
|
|
should be the full absolute path, including filename, of that file. The
|
|
|
|
default value, ``os.path.join(BASE_DIR, 'db.sqlite3')``, will store the file
|
|
|
|
in your project directory.
|
|
|
|
|
|
|
|
If you are not using SQLite as your database, additional settings such as
|
|
|
|
:setting:`USER`, :setting:`PASSWORD`, and :setting:`HOST` must be added.
|
|
|
|
For more details, see the reference documentation for :setting:`DATABASES`.
|
|
|
|
|
2016-03-05 15:58:45 +00:00
|
|
|
.. admonition:: For databases other than SQLite
|
2015-05-11 23:43:40 +00:00
|
|
|
|
2016-03-04 01:24:23 +00:00
|
|
|
If you're using a database besides SQLite, make sure you've created a
|
|
|
|
database by this point. Do that with "``CREATE DATABASE database_name;``"
|
|
|
|
within your database's interactive prompt.
|
|
|
|
|
|
|
|
Also make sure that the database user provided in :file:`mysite/settings.py`
|
|
|
|
has "create database" privileges. This allows automatic creation of a
|
|
|
|
:ref:`test database <the-test-database>` which will be needed in a later
|
|
|
|
tutorial.
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
If you're using SQLite, you don't need to create anything beforehand - the
|
|
|
|
database file will be created automatically when it is needed.
|
|
|
|
|
|
|
|
While you're editing :file:`mysite/settings.py`, set :setting:`TIME_ZONE` to
|
|
|
|
your time zone.
|
|
|
|
|
|
|
|
Also, note the :setting:`INSTALLED_APPS` setting at the top of the file. That
|
|
|
|
holds the names of all Django applications that are activated in this Django
|
|
|
|
instance. Apps can be used in multiple projects, and you can package and
|
|
|
|
distribute them for use by others in their projects.
|
|
|
|
|
|
|
|
By default, :setting:`INSTALLED_APPS` contains the following apps, all of which
|
|
|
|
come with Django:
|
|
|
|
|
|
|
|
* :mod:`django.contrib.admin` -- The admin site. You'll use it shortly.
|
|
|
|
|
|
|
|
* :mod:`django.contrib.auth` -- An authentication system.
|
|
|
|
|
|
|
|
* :mod:`django.contrib.contenttypes` -- A framework for content types.
|
|
|
|
|
|
|
|
* :mod:`django.contrib.sessions` -- A session framework.
|
|
|
|
|
|
|
|
* :mod:`django.contrib.messages` -- A messaging framework.
|
|
|
|
|
|
|
|
* :mod:`django.contrib.staticfiles` -- A framework for managing
|
|
|
|
static files.
|
|
|
|
|
|
|
|
These applications are included by default as a convenience for the common case.
|
|
|
|
|
|
|
|
Some of these applications make use of at least one database table, though,
|
|
|
|
so we need to create the tables in the database before we can use them. To do
|
|
|
|
that, run the following command:
|
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
$ python manage.py migrate
|
|
|
|
|
|
|
|
The :djadmin:`migrate` command looks at the :setting:`INSTALLED_APPS` setting
|
|
|
|
and creates any necessary database tables according to the database settings
|
|
|
|
in your :file:`mysite/settings.py` file and the database migrations shipped
|
|
|
|
with the app (we'll cover those later). You'll see a message for each
|
|
|
|
migration it applies. If you're interested, run the command-line client for your
|
2015-09-15 20:01:31 +00:00
|
|
|
database and type ``\dt`` (PostgreSQL), ``SHOW TABLES;`` (MySQL), ``.schema``
|
|
|
|
(SQLite), or ``SELECT TABLE_NAME FROM USER_TABLES;`` (Oracle) to display the
|
|
|
|
tables Django created.
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
.. admonition:: For the minimalists
|
|
|
|
|
|
|
|
Like we said above, the default applications are included for the common
|
|
|
|
case, but not everybody needs them. If you don't need any or all of them,
|
|
|
|
feel free to comment-out or delete the appropriate line(s) from
|
|
|
|
:setting:`INSTALLED_APPS` before running :djadmin:`migrate`. The
|
|
|
|
:djadmin:`migrate` command will only run migrations for apps in
|
|
|
|
:setting:`INSTALLED_APPS`.
|
|
|
|
|
|
|
|
.. _creating-models:
|
|
|
|
|
|
|
|
Creating models
|
|
|
|
===============
|
|
|
|
|
|
|
|
Now we'll define your models -- essentially, your database layout, with
|
|
|
|
additional metadata.
|
|
|
|
|
|
|
|
.. admonition:: Philosophy
|
|
|
|
|
|
|
|
A model is the single, definitive source of truth about your data. It contains
|
|
|
|
the essential fields and behaviors of the data you're storing. Django follows
|
|
|
|
the :ref:`DRY Principle <dry>`. The goal is to define your data model in one
|
|
|
|
place and automatically derive things from it.
|
|
|
|
|
|
|
|
This includes the migrations - unlike in Ruby On Rails, for example, migrations
|
|
|
|
are entirely derived from your models file, and are essentially just a
|
|
|
|
history that Django can roll through to update your database schema to
|
|
|
|
match your current models.
|
|
|
|
|
|
|
|
In our simple poll app, we'll create two models: ``Question`` and ``Choice``.
|
|
|
|
A ``Question`` has a question and a publication date. A ``Choice`` has two
|
|
|
|
fields: the text of the choice and a vote tally. Each ``Choice`` is associated
|
|
|
|
with a ``Question``.
|
|
|
|
|
|
|
|
These concepts are represented by simple Python classes. Edit the
|
|
|
|
:file:`polls/models.py` file so it looks like this:
|
|
|
|
|
|
|
|
.. snippet::
|
|
|
|
:filename: polls/models.py
|
|
|
|
|
|
|
|
from django.db import models
|
|
|
|
|
|
|
|
|
|
|
|
class Question(models.Model):
|
|
|
|
question_text = models.CharField(max_length=200)
|
|
|
|
pub_date = models.DateTimeField('date published')
|
|
|
|
|
|
|
|
|
|
|
|
class Choice(models.Model):
|
2015-07-22 14:43:21 +00:00
|
|
|
question = models.ForeignKey(Question, on_delete=models.CASCADE)
|
2015-05-11 23:43:40 +00:00
|
|
|
choice_text = models.CharField(max_length=200)
|
|
|
|
votes = models.IntegerField(default=0)
|
|
|
|
|
|
|
|
The code is straightforward. Each model is represented by a class that
|
|
|
|
subclasses :class:`django.db.models.Model`. Each model has a number of class
|
|
|
|
variables, each of which represents a database field in the model.
|
|
|
|
|
|
|
|
Each field is represented by an instance of a :class:`~django.db.models.Field`
|
|
|
|
class -- e.g., :class:`~django.db.models.CharField` for character fields and
|
|
|
|
:class:`~django.db.models.DateTimeField` for datetimes. This tells Django what
|
|
|
|
type of data each field holds.
|
|
|
|
|
|
|
|
The name of each :class:`~django.db.models.Field` instance (e.g.
|
|
|
|
``question_text`` or ``pub_date``) is the field's name, in machine-friendly
|
|
|
|
format. You'll use this value in your Python code, and your database will use
|
|
|
|
it as the column name.
|
|
|
|
|
|
|
|
You can use an optional first positional argument to a
|
|
|
|
:class:`~django.db.models.Field` to designate a human-readable name. That's used
|
|
|
|
in a couple of introspective parts of Django, and it doubles as documentation.
|
|
|
|
If this field isn't provided, Django will use the machine-readable name. In this
|
|
|
|
example, we've only defined a human-readable name for ``Question.pub_date``.
|
|
|
|
For all other fields in this model, the field's machine-readable name will
|
|
|
|
suffice as its human-readable name.
|
|
|
|
|
|
|
|
Some :class:`~django.db.models.Field` classes have required arguments.
|
|
|
|
:class:`~django.db.models.CharField`, for example, requires that you give it a
|
|
|
|
:attr:`~django.db.models.CharField.max_length`. That's used not only in the
|
|
|
|
database schema, but in validation, as we'll soon see.
|
|
|
|
|
|
|
|
A :class:`~django.db.models.Field` can also have various optional arguments; in
|
|
|
|
this case, we've set the :attr:`~django.db.models.Field.default` value of
|
|
|
|
``votes`` to 0.
|
|
|
|
|
|
|
|
Finally, note a relationship is defined, using
|
|
|
|
:class:`~django.db.models.ForeignKey`. That tells Django each ``Choice`` is
|
|
|
|
related to a single ``Question``. Django supports all the common database
|
|
|
|
relationships: many-to-one, many-to-many, and one-to-one.
|
|
|
|
|
|
|
|
Activating models
|
|
|
|
=================
|
|
|
|
|
|
|
|
That small bit of model code gives Django a lot of information. With it, Django
|
|
|
|
is able to:
|
|
|
|
|
|
|
|
* Create a database schema (``CREATE TABLE`` statements) for this app.
|
|
|
|
* Create a Python database-access API for accessing ``Question`` and ``Choice`` objects.
|
|
|
|
|
|
|
|
But first we need to tell our project that the ``polls`` app is installed.
|
|
|
|
|
|
|
|
.. admonition:: Philosophy
|
|
|
|
|
|
|
|
Django apps are "pluggable": You can use an app in multiple projects, and
|
|
|
|
you can distribute apps, because they don't have to be tied to a given
|
|
|
|
Django installation.
|
|
|
|
|
2016-09-06 06:19:51 +00:00
|
|
|
To include the app in our project, we need to add a reference to its
|
|
|
|
configuration class in the :setting:`INSTALLED_APPS` setting. The
|
|
|
|
``PollsConfig`` class is in the :file:`polls/apps.py` file, so its dotted path
|
|
|
|
is ``'polls.apps.PollsConfig'``. Edit the :file:`mysite/settings.py` file and
|
|
|
|
add that dotted path to the :setting:`INSTALLED_APPS` setting. It'll look like
|
|
|
|
this:
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
.. snippet::
|
|
|
|
:filename: mysite/settings.py
|
|
|
|
|
|
|
|
INSTALLED_APPS = [
|
2015-09-07 13:28:15 +00:00
|
|
|
'polls.apps.PollsConfig',
|
2015-05-11 23:43:40 +00:00
|
|
|
'django.contrib.admin',
|
|
|
|
'django.contrib.auth',
|
|
|
|
'django.contrib.contenttypes',
|
|
|
|
'django.contrib.sessions',
|
|
|
|
'django.contrib.messages',
|
|
|
|
'django.contrib.staticfiles',
|
|
|
|
]
|
|
|
|
|
|
|
|
Now Django knows to include the ``polls`` app. Let's run another command:
|
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
$ python manage.py makemigrations polls
|
|
|
|
|
|
|
|
You should see something similar to the following:
|
|
|
|
|
|
|
|
.. code-block:: text
|
|
|
|
|
|
|
|
Migrations for 'polls':
|
2015-11-07 13:43:06 +00:00
|
|
|
polls/migrations/0001_initial.py:
|
2015-05-11 23:43:40 +00:00
|
|
|
- Create model Choice
|
|
|
|
- Create model Question
|
|
|
|
- Add field question to choice
|
|
|
|
|
|
|
|
By running ``makemigrations``, you're telling Django that you've made
|
|
|
|
some changes to your models (in this case, you've made new ones) and that
|
|
|
|
you'd like the changes to be stored as a *migration*.
|
|
|
|
|
|
|
|
Migrations are how Django stores changes to your models (and thus your
|
|
|
|
database schema) - they're just files on disk. You can read the migration
|
|
|
|
for your new model if you like; it's the file
|
|
|
|
``polls/migrations/0001_initial.py``. Don't worry, you're not expected to read
|
|
|
|
them every time Django makes one, but they're designed to be human-editable
|
|
|
|
in case you want to manually tweak how Django changes things.
|
|
|
|
|
|
|
|
There's a command that will run the migrations for you and manage your database
|
|
|
|
schema automatically - that's called :djadmin:`migrate`, and we'll come to it in a
|
|
|
|
moment - but first, let's see what SQL that migration would run. The
|
|
|
|
:djadmin:`sqlmigrate` command takes migration names and returns their SQL:
|
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
$ python manage.py sqlmigrate polls 0001
|
|
|
|
|
|
|
|
You should see something similar to the following (we've reformatted it for
|
|
|
|
readability):
|
|
|
|
|
|
|
|
.. code-block:: sql
|
|
|
|
|
|
|
|
BEGIN;
|
|
|
|
--
|
|
|
|
-- Create model Choice
|
|
|
|
--
|
|
|
|
CREATE TABLE "polls_choice" (
|
|
|
|
"id" serial NOT NULL PRIMARY KEY,
|
|
|
|
"choice_text" varchar(200) NOT NULL,
|
|
|
|
"votes" integer NOT NULL
|
|
|
|
);
|
|
|
|
--
|
|
|
|
-- Create model Question
|
|
|
|
--
|
|
|
|
CREATE TABLE "polls_question" (
|
|
|
|
"id" serial NOT NULL PRIMARY KEY,
|
|
|
|
"question_text" varchar(200) NOT NULL,
|
|
|
|
"pub_date" timestamp with time zone NOT NULL
|
|
|
|
);
|
|
|
|
--
|
|
|
|
-- Add field question to choice
|
|
|
|
--
|
|
|
|
ALTER TABLE "polls_choice" ADD COLUMN "question_id" integer NOT NULL;
|
|
|
|
ALTER TABLE "polls_choice" ALTER COLUMN "question_id" DROP DEFAULT;
|
|
|
|
CREATE INDEX "polls_choice_7aa0f6ee" ON "polls_choice" ("question_id");
|
|
|
|
ALTER TABLE "polls_choice"
|
|
|
|
ADD CONSTRAINT "polls_choice_question_id_246c99a640fbbd72_fk_polls_question_id"
|
|
|
|
FOREIGN KEY ("question_id")
|
|
|
|
REFERENCES "polls_question" ("id")
|
|
|
|
DEFERRABLE INITIALLY DEFERRED;
|
|
|
|
|
|
|
|
COMMIT;
|
|
|
|
|
|
|
|
Note the following:
|
|
|
|
|
|
|
|
* The exact output will vary depending on the database you are using. The
|
|
|
|
example above is generated for PostgreSQL.
|
|
|
|
|
|
|
|
* Table names are automatically generated by combining the name of the app
|
|
|
|
(``polls``) and the lowercase name of the model -- ``question`` and
|
|
|
|
``choice``. (You can override this behavior.)
|
|
|
|
|
|
|
|
* Primary keys (IDs) are added automatically. (You can override this, too.)
|
|
|
|
|
|
|
|
* By convention, Django appends ``"_id"`` to the foreign key field name.
|
|
|
|
(Yes, you can override this, as well.)
|
|
|
|
|
|
|
|
* The foreign key relationship is made explicit by a ``FOREIGN KEY``
|
|
|
|
constraint. Don't worry about the ``DEFERRABLE`` parts; that's just telling
|
|
|
|
PostgreSQL to not enforce the foreign key until the end of the transaction.
|
|
|
|
|
|
|
|
* It's tailored to the database you're using, so database-specific field types
|
|
|
|
such as ``auto_increment`` (MySQL), ``serial`` (PostgreSQL), or ``integer
|
|
|
|
primary key autoincrement`` (SQLite) are handled for you automatically. Same
|
|
|
|
goes for the quoting of field names -- e.g., using double quotes or
|
|
|
|
single quotes.
|
|
|
|
|
|
|
|
* The :djadmin:`sqlmigrate` command doesn't actually run the migration on your
|
|
|
|
database - it just prints it to the screen so that you can see what SQL
|
|
|
|
Django thinks is required. It's useful for checking what Django is going to
|
|
|
|
do or if you have database administrators who require SQL scripts for
|
|
|
|
changes.
|
|
|
|
|
|
|
|
If you're interested, you can also run
|
|
|
|
:djadmin:`python manage.py check <check>`; this checks for any problems in
|
|
|
|
your project without making migrations or touching the database.
|
|
|
|
|
|
|
|
Now, run :djadmin:`migrate` again to create those model tables in your database:
|
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
$ python manage.py migrate
|
|
|
|
Operations to perform:
|
2016-01-28 06:52:00 +00:00
|
|
|
Apply all migrations: admin, auth, contenttypes, polls, sessions
|
2015-05-11 23:43:40 +00:00
|
|
|
Running migrations:
|
|
|
|
Rendering model states... DONE
|
|
|
|
Applying polls.0001_initial... OK
|
|
|
|
|
|
|
|
The :djadmin:`migrate` command takes all the migrations that haven't been
|
|
|
|
applied (Django tracks which ones are applied using a special table in your
|
|
|
|
database called ``django_migrations``) and runs them against your database -
|
|
|
|
essentially, synchronizing the changes you made to your models with the schema
|
|
|
|
in the database.
|
|
|
|
|
|
|
|
Migrations are very powerful and let you change your models over time, as you
|
|
|
|
develop your project, without the need to delete your database or tables and
|
|
|
|
make new ones - it specializes in upgrading your database live, without
|
|
|
|
losing data. We'll cover them in more depth in a later part of the tutorial,
|
|
|
|
but for now, remember the three-step guide to making model changes:
|
|
|
|
|
|
|
|
* Change your models (in ``models.py``).
|
|
|
|
* Run :djadmin:`python manage.py makemigrations <makemigrations>` to create
|
|
|
|
migrations for those changes
|
|
|
|
* Run :djadmin:`python manage.py migrate <migrate>` to apply those changes to
|
|
|
|
the database.
|
|
|
|
|
|
|
|
The reason that there are separate commands to make and apply migrations is
|
|
|
|
because you'll commit migrations to your version control system and ship them
|
|
|
|
with your app; they not only make your development easier, they're also
|
|
|
|
useable by other developers and in production.
|
|
|
|
|
|
|
|
Read the :doc:`django-admin documentation </ref/django-admin>` for full
|
|
|
|
information on what the ``manage.py`` utility can do.
|
|
|
|
|
|
|
|
Playing with the API
|
|
|
|
====================
|
|
|
|
|
|
|
|
Now, let's hop into the interactive Python shell and play around with the free
|
|
|
|
API Django gives you. To invoke the Python shell, use this command:
|
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
$ python manage.py shell
|
|
|
|
|
|
|
|
We're using this instead of simply typing "python", because :file:`manage.py`
|
|
|
|
sets the ``DJANGO_SETTINGS_MODULE`` environment variable, which gives Django
|
|
|
|
the Python import path to your :file:`mysite/settings.py` file.
|
|
|
|
|
|
|
|
Once you're in the shell, explore the :doc:`database API </topics/db/queries>`::
|
|
|
|
|
2018-05-12 17:37:42 +00:00
|
|
|
>>> from polls.models import Choice, Question # Import the model classes we just wrote.
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# No questions are in the system yet.
|
|
|
|
>>> Question.objects.all()
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet []>
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# Create a new Question.
|
|
|
|
# Support for time zones is enabled in the default settings file, so
|
|
|
|
# Django expects a datetime with tzinfo for pub_date. Use timezone.now()
|
|
|
|
# instead of datetime.datetime.now() and it will do the right thing.
|
|
|
|
>>> from django.utils import timezone
|
|
|
|
>>> q = Question(question_text="What's new?", pub_date=timezone.now())
|
|
|
|
|
|
|
|
# Save the object into the database. You have to call save() explicitly.
|
|
|
|
>>> q.save()
|
|
|
|
|
2017-01-19 18:19:26 +00:00
|
|
|
# Now it has an ID.
|
2015-05-11 23:43:40 +00:00
|
|
|
>>> q.id
|
|
|
|
1
|
|
|
|
|
|
|
|
# Access model field values via Python attributes.
|
|
|
|
>>> q.question_text
|
|
|
|
"What's new?"
|
|
|
|
>>> q.pub_date
|
|
|
|
datetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=<UTC>)
|
|
|
|
|
|
|
|
# Change values by changing the attributes, then calling save().
|
|
|
|
>>> q.question_text = "What's up?"
|
|
|
|
>>> q.save()
|
|
|
|
|
|
|
|
# objects.all() displays all the questions in the database.
|
|
|
|
>>> Question.objects.all()
|
2017-04-08 18:38:48 +00:00
|
|
|
<QuerySet [<Question: Question object (1)>]>
|
2015-05-11 23:43:40 +00:00
|
|
|
|
2017-04-08 18:38:48 +00:00
|
|
|
Wait a minute. ``<Question: Question object (1)>`` isn't a helpful
|
|
|
|
representation of this object. Let's fix that by editing the ``Question`` model
|
|
|
|
(in the ``polls/models.py`` file) and adding a
|
2015-05-11 23:43:40 +00:00
|
|
|
:meth:`~django.db.models.Model.__str__` method to both ``Question`` and
|
|
|
|
``Choice``:
|
|
|
|
|
|
|
|
.. snippet::
|
|
|
|
:filename: polls/models.py
|
|
|
|
|
|
|
|
from django.db import models
|
|
|
|
|
|
|
|
class Question(models.Model):
|
|
|
|
# ...
|
2015-09-25 17:28:12 +00:00
|
|
|
def __str__(self):
|
2015-05-11 23:43:40 +00:00
|
|
|
return self.question_text
|
|
|
|
|
|
|
|
class Choice(models.Model):
|
|
|
|
# ...
|
2015-09-25 17:28:12 +00:00
|
|
|
def __str__(self):
|
2015-05-11 23:43:40 +00:00
|
|
|
return self.choice_text
|
|
|
|
|
|
|
|
It's important to add :meth:`~django.db.models.Model.__str__` methods to your
|
|
|
|
models, not only for your own convenience when dealing with the interactive
|
|
|
|
prompt, but also because objects' representations are used throughout Django's
|
|
|
|
automatically-generated admin.
|
|
|
|
|
|
|
|
Note these are normal Python methods. Let's add a custom method, just for
|
|
|
|
demonstration:
|
|
|
|
|
|
|
|
.. snippet::
|
|
|
|
:filename: polls/models.py
|
|
|
|
|
|
|
|
import datetime
|
|
|
|
|
|
|
|
from django.db import models
|
|
|
|
from django.utils import timezone
|
|
|
|
|
|
|
|
|
|
|
|
class Question(models.Model):
|
|
|
|
# ...
|
|
|
|
def was_published_recently(self):
|
|
|
|
return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
|
|
|
|
|
|
|
|
Note the addition of ``import datetime`` and ``from django.utils import
|
|
|
|
timezone``, to reference Python's standard :mod:`datetime` module and Django's
|
|
|
|
time-zone-related utilities in :mod:`django.utils.timezone`, respectively. If
|
|
|
|
you aren't familiar with time zone handling in Python, you can learn more in
|
|
|
|
the :doc:`time zone support docs </topics/i18n/timezones>`.
|
|
|
|
|
|
|
|
Save these changes and start a new Python interactive shell by running
|
|
|
|
``python manage.py shell`` again::
|
|
|
|
|
2018-05-12 17:37:42 +00:00
|
|
|
>>> from polls.models import Choice, Question
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# Make sure our __str__() addition worked.
|
|
|
|
>>> Question.objects.all()
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet [<Question: What's up?>]>
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# Django provides a rich database lookup API that's entirely driven by
|
|
|
|
# keyword arguments.
|
|
|
|
>>> Question.objects.filter(id=1)
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet [<Question: What's up?>]>
|
2015-05-11 23:43:40 +00:00
|
|
|
>>> Question.objects.filter(question_text__startswith='What')
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet [<Question: What's up?>]>
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# Get the question that was published this year.
|
|
|
|
>>> from django.utils import timezone
|
|
|
|
>>> current_year = timezone.now().year
|
|
|
|
>>> Question.objects.get(pub_date__year=current_year)
|
|
|
|
<Question: What's up?>
|
|
|
|
|
|
|
|
# Request an ID that doesn't exist, this will raise an exception.
|
|
|
|
>>> Question.objects.get(id=2)
|
|
|
|
Traceback (most recent call last):
|
|
|
|
...
|
|
|
|
DoesNotExist: Question 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 Question.objects.get(id=1).
|
|
|
|
>>> Question.objects.get(pk=1)
|
|
|
|
<Question: What's up?>
|
|
|
|
|
|
|
|
# Make sure our custom method worked.
|
|
|
|
>>> q = Question.objects.get(pk=1)
|
|
|
|
>>> q.was_published_recently()
|
|
|
|
True
|
|
|
|
|
|
|
|
# Give the Question 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 question's choice) which can be accessed via the API.
|
|
|
|
>>> q = Question.objects.get(pk=1)
|
|
|
|
|
|
|
|
# Display any choices from the related object set -- none so far.
|
|
|
|
>>> q.choice_set.all()
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet []>
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# Create three choices.
|
|
|
|
>>> q.choice_set.create(choice_text='Not much', votes=0)
|
|
|
|
<Choice: Not much>
|
|
|
|
>>> q.choice_set.create(choice_text='The sky', votes=0)
|
|
|
|
<Choice: The sky>
|
|
|
|
>>> c = q.choice_set.create(choice_text='Just hacking again', votes=0)
|
|
|
|
|
|
|
|
# Choice objects have API access to their related Question objects.
|
|
|
|
>>> c.question
|
|
|
|
<Question: What's up?>
|
|
|
|
|
|
|
|
# And vice versa: Question objects get access to Choice objects.
|
|
|
|
>>> q.choice_set.all()
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
|
2015-05-11 23:43:40 +00:00
|
|
|
>>> q.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 question whose pub_date is in this year
|
|
|
|
# (reusing the 'current_year' variable we created above).
|
|
|
|
>>> Choice.objects.filter(question__pub_date__year=current_year)
|
2015-10-05 23:07:34 +00:00
|
|
|
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
|
2015-05-11 23:43:40 +00:00
|
|
|
|
|
|
|
# Let's delete one of the choices. Use delete() for that.
|
|
|
|
>>> c = q.choice_set.filter(choice_text__startswith='Just hacking')
|
|
|
|
>>> c.delete()
|
|
|
|
|
|
|
|
For more information on model relations, see :doc:`Accessing related objects
|
|
|
|
</ref/models/relations>`. For more on how to use double underscores to perform
|
|
|
|
field lookups via the API, see :ref:`Field lookups <field-lookups-intro>`. For
|
|
|
|
full details on the database API, see our :doc:`Database API reference
|
|
|
|
</topics/db/queries>`.
|
|
|
|
|
|
|
|
Introducing the Django Admin
|
|
|
|
============================
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2005-07-20 20:10:35 +00:00
|
|
|
.. admonition:: Philosophy
|
2005-07-21 02:17:45 +00:00
|
|
|
|
2015-05-11 23:43:40 +00:00
|
|
|
Generating admin sites for your staff or clients to add, change, and delete
|
2008-08-23 22:25:40 +00:00
|
|
|
content is tedious work that doesn't require much creativity. For that
|
|
|
|
reason, Django entirely automates creation of admin interfaces for models.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2005-07-20 20:10:35 +00:00
|
|
|
Django was written in a newsroom environment, with a very clear separation
|
|
|
|
between "content publishers" and the "public" site. Site managers use the
|
|
|
|
system to add news stories, events, sports scores, etc., and that content is
|
2008-08-23 22:25:40 +00:00
|
|
|
displayed on the public site. Django solves the problem of creating a
|
|
|
|
unified interface for site administrators to edit content.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2012-03-02 17:16:52 +00:00
|
|
|
The admin isn't intended to be used by site visitors. It's for site
|
2012-02-26 21:17:58 +00:00
|
|
|
managers.
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2014-06-10 16:22:07 +00:00
|
|
|
Creating an admin user
|
2015-05-11 23:43:40 +00:00
|
|
|
----------------------
|
2014-06-10 16:22:07 +00:00
|
|
|
|
|
|
|
First we'll need to create a user who can login to the admin site. Run the
|
|
|
|
following command:
|
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2014-06-10 16:22:07 +00:00
|
|
|
|
|
|
|
$ python manage.py createsuperuser
|
|
|
|
|
|
|
|
Enter your desired username and press enter.
|
|
|
|
|
|
|
|
.. code-block:: text
|
|
|
|
|
|
|
|
Username: admin
|
|
|
|
|
|
|
|
You will then be prompted for your desired email address:
|
|
|
|
|
|
|
|
.. code-block:: text
|
|
|
|
|
|
|
|
Email address: admin@example.com
|
|
|
|
|
|
|
|
The final step is to enter your password. You will be asked to enter your
|
|
|
|
password twice, the second time as a confirmation of the first.
|
|
|
|
|
|
|
|
.. code-block:: text
|
|
|
|
|
|
|
|
Password: **********
|
|
|
|
Password (again): *********
|
|
|
|
Superuser created successfully.
|
|
|
|
|
2005-07-18 23:14:48 +00:00
|
|
|
Start the development server
|
2015-05-11 23:43:40 +00:00
|
|
|
----------------------------
|
2005-07-17 00:54:15 +00:00
|
|
|
|
Simplified default project template.
Squashed commit of:
commit 508ec9144b35c50794708225b496bde1eb5e60aa
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 22:50:55 2013 +0100
Tweaked default settings file.
* Explained why BASE_DIR exists.
* Added a link to the database configuration options, and put it in its
own section.
* Moved sensitive settings that must be changed for production at the
top.
commit 6515fd2f1aa73a86dc8dbd2ccf512ddb6b140d57
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 14:35:21 2013 +0100
Documented the simplified app & project templates in the changelog.
commit 2c5b576c2ea91d84273a019b3d0b3b8b4da72f23
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:59:27 2013 +0100
Minor fixes in tutorials 5 and 6.
commit 55a51531be8104f21b3cca3f6bf70b0a7139a041
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:51:11 2013 +0100
Updated tutorial 2 for the new project template.
commit 29ddae87bdaecff12dd31b16b000c01efbde9e20
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:58:54 2013 +0100
Updated tutorial 1 for the new project template.
commit 0ecb9f6e2514cfd26a678a280d471433375101a3
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:29:13 2013 +0100
Adjusted the default URLconf detection to account for the admin.
It's now enabled by default.
commit 5fb4da0d3d09dac28dd94e3fde92b9d4335c0565
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 10:36:55 2013 +0100
Added security warnings for the most sensitive settings.
commit 718d84bd8ac4a42fb4b28ec93965de32680f091e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:24:06 2013 +0100
Used an absolute path for the SQLite database.
This ensures the settings file works regardless of which directory
django-admin.py / manage.py is invoked from.
BASE_DIR got a +1 from a BDFL and another core dev. It doesn't involve
the concept of a "Django project"; it's just a convenient way to express
relative paths within the source code repository for non-Python files.
Thanks Jacob Kaplan-Moss for the suggestion.
commit 1b559b4bcda622e10909b68fe5cab90db6727dd9
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:22:40 2013 +0100
Removed STATIC_ROOT from the default settings template.
It isn't necessary in development, and it confuses beginners to no end.
Thanks Carl Meyer for the suggestion.
commit a55f141a500bb7c9a1bc259bbe1954c13b199671
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:21:43 2013 +0100
Removed MEDIA_ROOT/URL from default settings template.
Many sites will never deal with user-uploaded files, and MEDIA_ROOT is
complicated to explain.
Thanks Carl Meyer for the suggestion.
commit 44bf2f2441420fd9429ee9fe1f7207f92dd87e70
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:22:09 2013 +0100
Removed logging config.
This configuration is applied regardless of the value of LOGGING;
duplicating it in LOGGING is confusing.
commit eac747e848eaed65fd5f6f254f0a7559d856f88f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:05:31 2013 +0100
Enabled the locale middleware by default.
USE_I18N is True by default, and doesn't work well without
LocaleMiddleware.
commit d806c62b2d00826dc2688c84b092627b8d571cab
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:03:16 2013 +0100
Enabled clickjacking protection by default.
commit 99152c30e6a15003f0b6737dc78e87adf462aacb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:01:48 2013 +0100
Reorganized settings in logical sections, and trimmed comments.
commit d37ffdfcb24b7e0ec7cc113d07190f65fb12fb8a
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:54:11 2013 +0100
Avoided misleading TEMPLATE_DEBUG = DEBUG.
According to the docs TEMPLATE_DEBUG works only when DEBUG = True.
commit 15d9478d3a9850e85841e7cf09cf83050371c6bf
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:46:25 2013 +0100
Removed STATICFILES_FINDERS/TEMPLATE_LOADERS from default settings file.
Only developers with special needs ever need to change these settings.
commit 574da0eb5bfb4570883756914b4dbd7e20e1f61e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:45:01 2013 +0100
Removed STATICFILES/TEMPLATES_DIRS from default settings file.
The current best practice is to put static files and templates in
applications, for easier testing and deployment.
commit 8cb18dbe56629aa1be74718a07e7cc66b4f9c9f0
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:24:16 2013 +0100
Removed settings related to email reporting from default settings file.
While handy for small scale projects, it isn't exactly a best practice.
commit 8ecbfcb3638058f0c49922540f874a7d802d864f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 18:54:43 2013 +0100
Documented how to enable the sites framework.
commit 23fc91a6fa67d91ddd9d71b1c3e0dc26bdad9841
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:28:59 2013 +0100
Disabled the sites framework by default.
RequestSite does the job for single-domain websites.
commit c4d82eb8afc0eb8568bf9c4d12644272415e3960
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 00:08:33 2013 +0100
Added a default admin.py to the application template.
Thanks Ryan D Hiebert for the suggestion.
commit 4071dc771e5c44b1c5ebb9beecefb164ae465e22
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:59:49 2013 +0100
Enabled the admin by default.
Everyone uses the admin.
commit c807a31f8d89e7e7fd97380e3023f7983a8b6fcb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:57:05 2013 +0100
Removed admindocs from default project template.
commit 09e4ce0e652a97da1a9e285046a91c8ad7a9189c
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:32:52 2013 +0100
Added links to the settings documentation.
commit 5b8f5eaef364eb790fcde6f9e86f7d266074cca8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 11:06:54 2013 +0100
Used a significant example for URLconf includes.
commit 908e91d6fcee2a3cb51ca26ecdf12a6a24e69ef8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:22:31 2013 +0100
Moved code comments about WSGI to docs, and rewrote said docs.
commit 50417e51996146f891d08ca8b74dcc736a581932
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 15:51:50 2013 +0100
Normalized the default application template.
Removed the default test that 1 + 1 = 2, because it's been committed
way too many times, in too many projects.
Added an import of `render` for views, because the first view will
often be:
def home(request):
return render(request, "mysite/home.html")
2013-01-28 14:51:50 +00:00
|
|
|
The Django admin site is activated by default. Let's start the development
|
|
|
|
server and explore it.
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2015-05-11 23:43:40 +00:00
|
|
|
If the server is not running start it like so:
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2018-01-20 17:38:48 +00:00
|
|
|
.. console::
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2013-09-18 14:35:41 +00:00
|
|
|
$ python manage.py runserver
|
2005-07-18 23:22:07 +00:00
|
|
|
|
2005-10-19 01:09:05 +00:00
|
|
|
Now, open a Web browser and go to "/admin/" on your local domain -- e.g.,
|
|
|
|
http://127.0.0.1:8000/admin/. You should see the admin's login screen:
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2008-08-23 22:25:40 +00:00
|
|
|
.. image:: _images/admin01.png
|
2005-07-17 00:54:15 +00:00
|
|
|
:alt: Django admin login screen
|
|
|
|
|
Simplified default project template.
Squashed commit of:
commit 508ec9144b35c50794708225b496bde1eb5e60aa
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 22:50:55 2013 +0100
Tweaked default settings file.
* Explained why BASE_DIR exists.
* Added a link to the database configuration options, and put it in its
own section.
* Moved sensitive settings that must be changed for production at the
top.
commit 6515fd2f1aa73a86dc8dbd2ccf512ddb6b140d57
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 14:35:21 2013 +0100
Documented the simplified app & project templates in the changelog.
commit 2c5b576c2ea91d84273a019b3d0b3b8b4da72f23
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:59:27 2013 +0100
Minor fixes in tutorials 5 and 6.
commit 55a51531be8104f21b3cca3f6bf70b0a7139a041
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:51:11 2013 +0100
Updated tutorial 2 for the new project template.
commit 29ddae87bdaecff12dd31b16b000c01efbde9e20
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:58:54 2013 +0100
Updated tutorial 1 for the new project template.
commit 0ecb9f6e2514cfd26a678a280d471433375101a3
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:29:13 2013 +0100
Adjusted the default URLconf detection to account for the admin.
It's now enabled by default.
commit 5fb4da0d3d09dac28dd94e3fde92b9d4335c0565
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 10:36:55 2013 +0100
Added security warnings for the most sensitive settings.
commit 718d84bd8ac4a42fb4b28ec93965de32680f091e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:24:06 2013 +0100
Used an absolute path for the SQLite database.
This ensures the settings file works regardless of which directory
django-admin.py / manage.py is invoked from.
BASE_DIR got a +1 from a BDFL and another core dev. It doesn't involve
the concept of a "Django project"; it's just a convenient way to express
relative paths within the source code repository for non-Python files.
Thanks Jacob Kaplan-Moss for the suggestion.
commit 1b559b4bcda622e10909b68fe5cab90db6727dd9
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:22:40 2013 +0100
Removed STATIC_ROOT from the default settings template.
It isn't necessary in development, and it confuses beginners to no end.
Thanks Carl Meyer for the suggestion.
commit a55f141a500bb7c9a1bc259bbe1954c13b199671
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:21:43 2013 +0100
Removed MEDIA_ROOT/URL from default settings template.
Many sites will never deal with user-uploaded files, and MEDIA_ROOT is
complicated to explain.
Thanks Carl Meyer for the suggestion.
commit 44bf2f2441420fd9429ee9fe1f7207f92dd87e70
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:22:09 2013 +0100
Removed logging config.
This configuration is applied regardless of the value of LOGGING;
duplicating it in LOGGING is confusing.
commit eac747e848eaed65fd5f6f254f0a7559d856f88f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:05:31 2013 +0100
Enabled the locale middleware by default.
USE_I18N is True by default, and doesn't work well without
LocaleMiddleware.
commit d806c62b2d00826dc2688c84b092627b8d571cab
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:03:16 2013 +0100
Enabled clickjacking protection by default.
commit 99152c30e6a15003f0b6737dc78e87adf462aacb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:01:48 2013 +0100
Reorganized settings in logical sections, and trimmed comments.
commit d37ffdfcb24b7e0ec7cc113d07190f65fb12fb8a
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:54:11 2013 +0100
Avoided misleading TEMPLATE_DEBUG = DEBUG.
According to the docs TEMPLATE_DEBUG works only when DEBUG = True.
commit 15d9478d3a9850e85841e7cf09cf83050371c6bf
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:46:25 2013 +0100
Removed STATICFILES_FINDERS/TEMPLATE_LOADERS from default settings file.
Only developers with special needs ever need to change these settings.
commit 574da0eb5bfb4570883756914b4dbd7e20e1f61e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:45:01 2013 +0100
Removed STATICFILES/TEMPLATES_DIRS from default settings file.
The current best practice is to put static files and templates in
applications, for easier testing and deployment.
commit 8cb18dbe56629aa1be74718a07e7cc66b4f9c9f0
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:24:16 2013 +0100
Removed settings related to email reporting from default settings file.
While handy for small scale projects, it isn't exactly a best practice.
commit 8ecbfcb3638058f0c49922540f874a7d802d864f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 18:54:43 2013 +0100
Documented how to enable the sites framework.
commit 23fc91a6fa67d91ddd9d71b1c3e0dc26bdad9841
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:28:59 2013 +0100
Disabled the sites framework by default.
RequestSite does the job for single-domain websites.
commit c4d82eb8afc0eb8568bf9c4d12644272415e3960
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 00:08:33 2013 +0100
Added a default admin.py to the application template.
Thanks Ryan D Hiebert for the suggestion.
commit 4071dc771e5c44b1c5ebb9beecefb164ae465e22
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:59:49 2013 +0100
Enabled the admin by default.
Everyone uses the admin.
commit c807a31f8d89e7e7fd97380e3023f7983a8b6fcb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:57:05 2013 +0100
Removed admindocs from default project template.
commit 09e4ce0e652a97da1a9e285046a91c8ad7a9189c
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:32:52 2013 +0100
Added links to the settings documentation.
commit 5b8f5eaef364eb790fcde6f9e86f7d266074cca8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 11:06:54 2013 +0100
Used a significant example for URLconf includes.
commit 908e91d6fcee2a3cb51ca26ecdf12a6a24e69ef8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:22:31 2013 +0100
Moved code comments about WSGI to docs, and rewrote said docs.
commit 50417e51996146f891d08ca8b74dcc736a581932
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 15:51:50 2013 +0100
Normalized the default application template.
Removed the default test that 1 + 1 = 2, because it's been committed
way too many times, in too many projects.
Added an import of `render` for views, because the first view will
often be:
def home(request):
return render(request, "mysite/home.html")
2013-01-28 14:51:50 +00:00
|
|
|
Since :doc:`translation </topics/i18n/translation>` is turned on by default,
|
|
|
|
the login screen may be displayed in your own language, depending on your
|
2015-05-11 23:43:40 +00:00
|
|
|
browser's settings and if Django has a translation for this language.
|
Simplified default project template.
Squashed commit of:
commit 508ec9144b35c50794708225b496bde1eb5e60aa
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 22:50:55 2013 +0100
Tweaked default settings file.
* Explained why BASE_DIR exists.
* Added a link to the database configuration options, and put it in its
own section.
* Moved sensitive settings that must be changed for production at the
top.
commit 6515fd2f1aa73a86dc8dbd2ccf512ddb6b140d57
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 14:35:21 2013 +0100
Documented the simplified app & project templates in the changelog.
commit 2c5b576c2ea91d84273a019b3d0b3b8b4da72f23
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:59:27 2013 +0100
Minor fixes in tutorials 5 and 6.
commit 55a51531be8104f21b3cca3f6bf70b0a7139a041
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:51:11 2013 +0100
Updated tutorial 2 for the new project template.
commit 29ddae87bdaecff12dd31b16b000c01efbde9e20
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:58:54 2013 +0100
Updated tutorial 1 for the new project template.
commit 0ecb9f6e2514cfd26a678a280d471433375101a3
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:29:13 2013 +0100
Adjusted the default URLconf detection to account for the admin.
It's now enabled by default.
commit 5fb4da0d3d09dac28dd94e3fde92b9d4335c0565
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 10:36:55 2013 +0100
Added security warnings for the most sensitive settings.
commit 718d84bd8ac4a42fb4b28ec93965de32680f091e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:24:06 2013 +0100
Used an absolute path for the SQLite database.
This ensures the settings file works regardless of which directory
django-admin.py / manage.py is invoked from.
BASE_DIR got a +1 from a BDFL and another core dev. It doesn't involve
the concept of a "Django project"; it's just a convenient way to express
relative paths within the source code repository for non-Python files.
Thanks Jacob Kaplan-Moss for the suggestion.
commit 1b559b4bcda622e10909b68fe5cab90db6727dd9
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:22:40 2013 +0100
Removed STATIC_ROOT from the default settings template.
It isn't necessary in development, and it confuses beginners to no end.
Thanks Carl Meyer for the suggestion.
commit a55f141a500bb7c9a1bc259bbe1954c13b199671
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:21:43 2013 +0100
Removed MEDIA_ROOT/URL from default settings template.
Many sites will never deal with user-uploaded files, and MEDIA_ROOT is
complicated to explain.
Thanks Carl Meyer for the suggestion.
commit 44bf2f2441420fd9429ee9fe1f7207f92dd87e70
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:22:09 2013 +0100
Removed logging config.
This configuration is applied regardless of the value of LOGGING;
duplicating it in LOGGING is confusing.
commit eac747e848eaed65fd5f6f254f0a7559d856f88f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:05:31 2013 +0100
Enabled the locale middleware by default.
USE_I18N is True by default, and doesn't work well without
LocaleMiddleware.
commit d806c62b2d00826dc2688c84b092627b8d571cab
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:03:16 2013 +0100
Enabled clickjacking protection by default.
commit 99152c30e6a15003f0b6737dc78e87adf462aacb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:01:48 2013 +0100
Reorganized settings in logical sections, and trimmed comments.
commit d37ffdfcb24b7e0ec7cc113d07190f65fb12fb8a
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:54:11 2013 +0100
Avoided misleading TEMPLATE_DEBUG = DEBUG.
According to the docs TEMPLATE_DEBUG works only when DEBUG = True.
commit 15d9478d3a9850e85841e7cf09cf83050371c6bf
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:46:25 2013 +0100
Removed STATICFILES_FINDERS/TEMPLATE_LOADERS from default settings file.
Only developers with special needs ever need to change these settings.
commit 574da0eb5bfb4570883756914b4dbd7e20e1f61e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:45:01 2013 +0100
Removed STATICFILES/TEMPLATES_DIRS from default settings file.
The current best practice is to put static files and templates in
applications, for easier testing and deployment.
commit 8cb18dbe56629aa1be74718a07e7cc66b4f9c9f0
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:24:16 2013 +0100
Removed settings related to email reporting from default settings file.
While handy for small scale projects, it isn't exactly a best practice.
commit 8ecbfcb3638058f0c49922540f874a7d802d864f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 18:54:43 2013 +0100
Documented how to enable the sites framework.
commit 23fc91a6fa67d91ddd9d71b1c3e0dc26bdad9841
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:28:59 2013 +0100
Disabled the sites framework by default.
RequestSite does the job for single-domain websites.
commit c4d82eb8afc0eb8568bf9c4d12644272415e3960
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 00:08:33 2013 +0100
Added a default admin.py to the application template.
Thanks Ryan D Hiebert for the suggestion.
commit 4071dc771e5c44b1c5ebb9beecefb164ae465e22
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:59:49 2013 +0100
Enabled the admin by default.
Everyone uses the admin.
commit c807a31f8d89e7e7fd97380e3023f7983a8b6fcb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:57:05 2013 +0100
Removed admindocs from default project template.
commit 09e4ce0e652a97da1a9e285046a91c8ad7a9189c
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:32:52 2013 +0100
Added links to the settings documentation.
commit 5b8f5eaef364eb790fcde6f9e86f7d266074cca8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 11:06:54 2013 +0100
Used a significant example for URLconf includes.
commit 908e91d6fcee2a3cb51ca26ecdf12a6a24e69ef8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:22:31 2013 +0100
Moved code comments about WSGI to docs, and rewrote said docs.
commit 50417e51996146f891d08ca8b74dcc736a581932
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 15:51:50 2013 +0100
Normalized the default application template.
Removed the default test that 1 + 1 = 2, because it's been committed
way too many times, in too many projects.
Added an import of `render` for views, because the first view will
often be:
def home(request):
return render(request, "mysite/home.html")
2013-01-28 14:51:50 +00:00
|
|
|
|
2005-07-17 00:54:15 +00:00
|
|
|
Enter the admin site
|
2015-05-11 23:43:40 +00:00
|
|
|
--------------------
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2014-06-10 16:22:07 +00:00
|
|
|
Now, try logging in with the superuser account you created in the previous step.
|
Simplified default project template.
Squashed commit of:
commit 508ec9144b35c50794708225b496bde1eb5e60aa
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 22:50:55 2013 +0100
Tweaked default settings file.
* Explained why BASE_DIR exists.
* Added a link to the database configuration options, and put it in its
own section.
* Moved sensitive settings that must be changed for production at the
top.
commit 6515fd2f1aa73a86dc8dbd2ccf512ddb6b140d57
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 14:35:21 2013 +0100
Documented the simplified app & project templates in the changelog.
commit 2c5b576c2ea91d84273a019b3d0b3b8b4da72f23
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:59:27 2013 +0100
Minor fixes in tutorials 5 and 6.
commit 55a51531be8104f21b3cca3f6bf70b0a7139a041
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:51:11 2013 +0100
Updated tutorial 2 for the new project template.
commit 29ddae87bdaecff12dd31b16b000c01efbde9e20
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:58:54 2013 +0100
Updated tutorial 1 for the new project template.
commit 0ecb9f6e2514cfd26a678a280d471433375101a3
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:29:13 2013 +0100
Adjusted the default URLconf detection to account for the admin.
It's now enabled by default.
commit 5fb4da0d3d09dac28dd94e3fde92b9d4335c0565
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 10:36:55 2013 +0100
Added security warnings for the most sensitive settings.
commit 718d84bd8ac4a42fb4b28ec93965de32680f091e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:24:06 2013 +0100
Used an absolute path for the SQLite database.
This ensures the settings file works regardless of which directory
django-admin.py / manage.py is invoked from.
BASE_DIR got a +1 from a BDFL and another core dev. It doesn't involve
the concept of a "Django project"; it's just a convenient way to express
relative paths within the source code repository for non-Python files.
Thanks Jacob Kaplan-Moss for the suggestion.
commit 1b559b4bcda622e10909b68fe5cab90db6727dd9
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:22:40 2013 +0100
Removed STATIC_ROOT from the default settings template.
It isn't necessary in development, and it confuses beginners to no end.
Thanks Carl Meyer for the suggestion.
commit a55f141a500bb7c9a1bc259bbe1954c13b199671
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:21:43 2013 +0100
Removed MEDIA_ROOT/URL from default settings template.
Many sites will never deal with user-uploaded files, and MEDIA_ROOT is
complicated to explain.
Thanks Carl Meyer for the suggestion.
commit 44bf2f2441420fd9429ee9fe1f7207f92dd87e70
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:22:09 2013 +0100
Removed logging config.
This configuration is applied regardless of the value of LOGGING;
duplicating it in LOGGING is confusing.
commit eac747e848eaed65fd5f6f254f0a7559d856f88f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:05:31 2013 +0100
Enabled the locale middleware by default.
USE_I18N is True by default, and doesn't work well without
LocaleMiddleware.
commit d806c62b2d00826dc2688c84b092627b8d571cab
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:03:16 2013 +0100
Enabled clickjacking protection by default.
commit 99152c30e6a15003f0b6737dc78e87adf462aacb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:01:48 2013 +0100
Reorganized settings in logical sections, and trimmed comments.
commit d37ffdfcb24b7e0ec7cc113d07190f65fb12fb8a
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:54:11 2013 +0100
Avoided misleading TEMPLATE_DEBUG = DEBUG.
According to the docs TEMPLATE_DEBUG works only when DEBUG = True.
commit 15d9478d3a9850e85841e7cf09cf83050371c6bf
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:46:25 2013 +0100
Removed STATICFILES_FINDERS/TEMPLATE_LOADERS from default settings file.
Only developers with special needs ever need to change these settings.
commit 574da0eb5bfb4570883756914b4dbd7e20e1f61e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:45:01 2013 +0100
Removed STATICFILES/TEMPLATES_DIRS from default settings file.
The current best practice is to put static files and templates in
applications, for easier testing and deployment.
commit 8cb18dbe56629aa1be74718a07e7cc66b4f9c9f0
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:24:16 2013 +0100
Removed settings related to email reporting from default settings file.
While handy for small scale projects, it isn't exactly a best practice.
commit 8ecbfcb3638058f0c49922540f874a7d802d864f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 18:54:43 2013 +0100
Documented how to enable the sites framework.
commit 23fc91a6fa67d91ddd9d71b1c3e0dc26bdad9841
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:28:59 2013 +0100
Disabled the sites framework by default.
RequestSite does the job for single-domain websites.
commit c4d82eb8afc0eb8568bf9c4d12644272415e3960
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 00:08:33 2013 +0100
Added a default admin.py to the application template.
Thanks Ryan D Hiebert for the suggestion.
commit 4071dc771e5c44b1c5ebb9beecefb164ae465e22
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:59:49 2013 +0100
Enabled the admin by default.
Everyone uses the admin.
commit c807a31f8d89e7e7fd97380e3023f7983a8b6fcb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:57:05 2013 +0100
Removed admindocs from default project template.
commit 09e4ce0e652a97da1a9e285046a91c8ad7a9189c
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:32:52 2013 +0100
Added links to the settings documentation.
commit 5b8f5eaef364eb790fcde6f9e86f7d266074cca8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 11:06:54 2013 +0100
Used a significant example for URLconf includes.
commit 908e91d6fcee2a3cb51ca26ecdf12a6a24e69ef8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:22:31 2013 +0100
Moved code comments about WSGI to docs, and rewrote said docs.
commit 50417e51996146f891d08ca8b74dcc736a581932
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 15:51:50 2013 +0100
Normalized the default application template.
Removed the default test that 1 + 1 = 2, because it's been committed
way too many times, in too many projects.
Added an import of `render` for views, because the first view will
often be:
def home(request):
return render(request, "mysite/home.html")
2013-01-28 14:51:50 +00:00
|
|
|
You should see the Django admin index page:
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
.. image:: _images/admin02.png
|
2005-07-17 00:54:15 +00:00
|
|
|
:alt: Django admin index page
|
|
|
|
|
Simplified default project template.
Squashed commit of:
commit 508ec9144b35c50794708225b496bde1eb5e60aa
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 22:50:55 2013 +0100
Tweaked default settings file.
* Explained why BASE_DIR exists.
* Added a link to the database configuration options, and put it in its
own section.
* Moved sensitive settings that must be changed for production at the
top.
commit 6515fd2f1aa73a86dc8dbd2ccf512ddb6b140d57
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 14:35:21 2013 +0100
Documented the simplified app & project templates in the changelog.
commit 2c5b576c2ea91d84273a019b3d0b3b8b4da72f23
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:59:27 2013 +0100
Minor fixes in tutorials 5 and 6.
commit 55a51531be8104f21b3cca3f6bf70b0a7139a041
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 13:51:11 2013 +0100
Updated tutorial 2 for the new project template.
commit 29ddae87bdaecff12dd31b16b000c01efbde9e20
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:58:54 2013 +0100
Updated tutorial 1 for the new project template.
commit 0ecb9f6e2514cfd26a678a280d471433375101a3
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 11:29:13 2013 +0100
Adjusted the default URLconf detection to account for the admin.
It's now enabled by default.
commit 5fb4da0d3d09dac28dd94e3fde92b9d4335c0565
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 10:36:55 2013 +0100
Added security warnings for the most sensitive settings.
commit 718d84bd8ac4a42fb4b28ec93965de32680f091e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:24:06 2013 +0100
Used an absolute path for the SQLite database.
This ensures the settings file works regardless of which directory
django-admin.py / manage.py is invoked from.
BASE_DIR got a +1 from a BDFL and another core dev. It doesn't involve
the concept of a "Django project"; it's just a convenient way to express
relative paths within the source code repository for non-Python files.
Thanks Jacob Kaplan-Moss for the suggestion.
commit 1b559b4bcda622e10909b68fe5cab90db6727dd9
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:22:40 2013 +0100
Removed STATIC_ROOT from the default settings template.
It isn't necessary in development, and it confuses beginners to no end.
Thanks Carl Meyer for the suggestion.
commit a55f141a500bb7c9a1bc259bbe1954c13b199671
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 23:21:43 2013 +0100
Removed MEDIA_ROOT/URL from default settings template.
Many sites will never deal with user-uploaded files, and MEDIA_ROOT is
complicated to explain.
Thanks Carl Meyer for the suggestion.
commit 44bf2f2441420fd9429ee9fe1f7207f92dd87e70
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:22:09 2013 +0100
Removed logging config.
This configuration is applied regardless of the value of LOGGING;
duplicating it in LOGGING is confusing.
commit eac747e848eaed65fd5f6f254f0a7559d856f88f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:05:31 2013 +0100
Enabled the locale middleware by default.
USE_I18N is True by default, and doesn't work well without
LocaleMiddleware.
commit d806c62b2d00826dc2688c84b092627b8d571cab
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:03:16 2013 +0100
Enabled clickjacking protection by default.
commit 99152c30e6a15003f0b6737dc78e87adf462aacb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 22:01:48 2013 +0100
Reorganized settings in logical sections, and trimmed comments.
commit d37ffdfcb24b7e0ec7cc113d07190f65fb12fb8a
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:54:11 2013 +0100
Avoided misleading TEMPLATE_DEBUG = DEBUG.
According to the docs TEMPLATE_DEBUG works only when DEBUG = True.
commit 15d9478d3a9850e85841e7cf09cf83050371c6bf
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:46:25 2013 +0100
Removed STATICFILES_FINDERS/TEMPLATE_LOADERS from default settings file.
Only developers with special needs ever need to change these settings.
commit 574da0eb5bfb4570883756914b4dbd7e20e1f61e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:45:01 2013 +0100
Removed STATICFILES/TEMPLATES_DIRS from default settings file.
The current best practice is to put static files and templates in
applications, for easier testing and deployment.
commit 8cb18dbe56629aa1be74718a07e7cc66b4f9c9f0
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:24:16 2013 +0100
Removed settings related to email reporting from default settings file.
While handy for small scale projects, it isn't exactly a best practice.
commit 8ecbfcb3638058f0c49922540f874a7d802d864f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 18:54:43 2013 +0100
Documented how to enable the sites framework.
commit 23fc91a6fa67d91ddd9d71b1c3e0dc26bdad9841
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:28:59 2013 +0100
Disabled the sites framework by default.
RequestSite does the job for single-domain websites.
commit c4d82eb8afc0eb8568bf9c4d12644272415e3960
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Tue Jan 29 00:08:33 2013 +0100
Added a default admin.py to the application template.
Thanks Ryan D Hiebert for the suggestion.
commit 4071dc771e5c44b1c5ebb9beecefb164ae465e22
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:59:49 2013 +0100
Enabled the admin by default.
Everyone uses the admin.
commit c807a31f8d89e7e7fd97380e3023f7983a8b6fcb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 10:57:05 2013 +0100
Removed admindocs from default project template.
commit 09e4ce0e652a97da1a9e285046a91c8ad7a9189c
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:32:52 2013 +0100
Added links to the settings documentation.
commit 5b8f5eaef364eb790fcde6f9e86f7d266074cca8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 11:06:54 2013 +0100
Used a significant example for URLconf includes.
commit 908e91d6fcee2a3cb51ca26ecdf12a6a24e69ef8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 16:22:31 2013 +0100
Moved code comments about WSGI to docs, and rewrote said docs.
commit 50417e51996146f891d08ca8b74dcc736a581932
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date: Mon Jan 28 15:51:50 2013 +0100
Normalized the default application template.
Removed the default test that 1 + 1 = 2, because it's been committed
way too many times, in too many projects.
Added an import of `render` for views, because the first view will
often be:
def home(request):
return render(request, "mysite/home.html")
2013-01-28 14:51:50 +00:00
|
|
|
You should see a few types of editable content: groups and users. They are
|
|
|
|
provided by :mod:`django.contrib.auth`, the authentication framework shipped
|
|
|
|
by Django.
|
2005-07-17 00:54:15 +00:00
|
|
|
|
|
|
|
Make the poll app modifiable in the admin
|
2015-05-11 23:43:40 +00:00
|
|
|
-----------------------------------------
|
2005-07-17 00:54:15 +00:00
|
|
|
|
|
|
|
But where's our poll app? It's not displayed on the admin index page.
|
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
Just one thing to do: we need to tell the admin that ``Question``
|
2013-04-12 23:22:02 +00:00
|
|
|
objects have an admin interface. To do this, open the :file:`polls/admin.py`
|
2013-09-23 22:23:47 +00:00
|
|
|
file, and edit it to look like this:
|
|
|
|
|
|
|
|
.. snippet::
|
|
|
|
:filename: polls/admin.py
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2008-07-18 23:54:34 +00:00
|
|
|
from django.contrib import admin
|
2015-02-22 14:59:56 +00:00
|
|
|
|
|
|
|
from .models import Question
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
admin.site.register(Question)
|
2005-07-17 00:54:15 +00:00
|
|
|
|
|
|
|
Explore the free admin functionality
|
2015-05-11 23:43:40 +00:00
|
|
|
------------------------------------
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
Now that we've registered ``Question``, Django knows that it should be displayed on
|
2008-07-18 23:54:34 +00:00
|
|
|
the admin index page:
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2008-08-23 22:25:40 +00:00
|
|
|
.. image:: _images/admin03t.png
|
2005-07-17 00:54:15 +00:00
|
|
|
:alt: Django admin index page, now with polls displayed
|
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
Click "Questions". Now you're at the "change list" page for questions. This page
|
2015-04-07 04:58:46 +00:00
|
|
|
displays all the questions in the database and lets you choose one to change it.
|
2015-05-11 23:43:40 +00:00
|
|
|
There's the "What's up?" question we created earlier:
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2008-08-23 22:25:40 +00:00
|
|
|
.. image:: _images/admin04t.png
|
2005-07-17 00:54:15 +00:00
|
|
|
:alt: Polls change list page
|
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
Click the "What's up?" question to edit it:
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2008-08-23 22:25:40 +00:00
|
|
|
.. image:: _images/admin05t.png
|
2013-09-06 18:57:00 +00:00
|
|
|
:alt: Editing form for question object
|
2005-07-17 00:54:15 +00:00
|
|
|
|
|
|
|
Things to note here:
|
|
|
|
|
2013-09-06 18:57:00 +00:00
|
|
|
* The form is automatically generated from the ``Question`` model.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
* The different model field types (:class:`~django.db.models.DateTimeField`,
|
|
|
|
:class:`~django.db.models.CharField`) correspond to the appropriate HTML
|
|
|
|
input widget. Each type of field knows how to display itself in the Django
|
|
|
|
admin.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
* Each :class:`~django.db.models.DateTimeField` gets free JavaScript
|
|
|
|
shortcuts. Dates get a "Today" shortcut and calendar popup, and times get
|
|
|
|
a "Now" shortcut and a convenient popup that lists commonly entered times.
|
2005-07-17 01:00:25 +00:00
|
|
|
|
|
|
|
The bottom part of the page gives you a couple of options:
|
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
* Save -- Saves changes and returns to the change-list page for this type of
|
|
|
|
object.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
* Save and continue editing -- Saves changes and reloads the admin page for
|
|
|
|
this object.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
* Save and add another -- Saves changes and loads a new, blank form for this
|
|
|
|
type of object.
|
2008-09-11 03:32:28 +00:00
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
* Delete -- Displays a delete confirmation page.
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2012-02-26 21:17:58 +00:00
|
|
|
If the value of "Date published" doesn't match the time when you created the
|
2015-05-11 23:43:40 +00:00
|
|
|
question in :doc:`Tutorial 1</intro/tutorial01>`, it probably
|
|
|
|
means you forgot to set the correct value for the :setting:`TIME_ZONE` setting.
|
|
|
|
Change it, reload the page and check that the correct value appears.
|
2012-02-26 21:17:58 +00:00
|
|
|
|
2005-07-17 00:54:15 +00:00
|
|
|
Change the "Date published" by clicking the "Today" and "Now" shortcuts. Then
|
|
|
|
click "Save and continue editing." Then click "History" in the upper right.
|
|
|
|
You'll see a page listing all changes made to this object via the Django admin,
|
|
|
|
with the timestamp and username of the person who made the change:
|
|
|
|
|
2008-08-23 22:25:40 +00:00
|
|
|
.. image:: _images/admin06t.png
|
2013-09-06 18:57:00 +00:00
|
|
|
:alt: History page for question object
|
2005-07-17 00:54:15 +00:00
|
|
|
|
2015-05-11 23:43:40 +00:00
|
|
|
When you're comfortable with the models API and have familiarized yourself with
|
|
|
|
the admin site, read :doc:`part 3 of this tutorial</intro/tutorial03>` to learn
|
|
|
|
about how to add more views to our polls app.
|