Clearly, having the phrase \u201cDjango administration\u201d at the top of each admin page is ridiculous. It\u2019s just placeholder text. It\u2019s easy to change, though, using Django\u2019s template system. The Django admin site is powered by Django itself, and its interfaces use Django\u2019s own template system.<\/p>\n
As we explained in Chapter 4, the TEMPLATE_DIRS setting specifies a list of directories to check when loading Django templates. To customize Django\u2019s admin templates, simply copy the relevant stock admin template from the Django distribution into your one of the directories pointed-to by TEMPLATE_DIRS.<\/p>\n
The admin site finds the \u201cDjango administration\u201d header by looking for the template admin\/base_site.html. By default, this template lives in the Django admin template directory, django\/contrib\/admin\/templates, which you can find by looking in your Python site-packages directory, or wherever Django was installed. To customize this base_site.html template, copy that template into an admin subdirectory of whichever directory you\u2019re using in TEMPLATE_DIRS. For example, if your TEMPLATE_DIRS includes “\/home\/mytemplates”, then copy django\/contrib\/admin\/templates\/admin\/base_site.html to \/home\/mytemplates\/admin\/base_site.html. Don\u2019t forget that admin subdirectory.<\/p>\n
Then, just edit the new admin\/base_site.html file to replace the generic Django text with your own site\u2019s name as you see fit. Note that any of Django\u2019s default admin templates can be overridden. To override a template, just do the same thing you did with base_site.html: copy it from the default directory into your custom directory and make changes to the copy.<\/p>\n
You might wonder how, if TEMPLATE_DIRS was empty by default, Django found the default admin templates. The answer is that, by default, Django automatically looks for templates within a templates\/ subdirectory in each application package as a fallback. See the \u201cWriting Custom Template Loaders\u201d in Chapter 10 for more information about how this works.<\/p>\n
Customizing the Admin Index Page<\/strong> – On a similar note, you might want to customize the look and feel of the Django admin index page. By default, it displays all available applications, according to your INSTALLED_APPS setting, sorted by the name of the application. You might, however, want to change this order to make it easier to find the applications you\u2019re looking for. After all, the index is probably the most important page of the admin interface, so it should be easy to use.<\/p>\n The template to customize is admin\/index.html. (Remember to copy admin\/index.html to your custom template directory as in the previous example.) Edit the file, and you\u2019ll see it uses a template tag called {% get_admin_app_list as app_list %}. This tag retrieves every installed Django application. Instead of using the tag, you can hard-code links to object-specific admin pages in whatever way you think is best. If hard-coding links doesn\u2019t appeal to you, see Chapter 10 for details on implementing your own template tags.<\/p>\n Django offers another shortcut in this department. Run the command python manage.py adminindex <app> to get a chunk of template code for inclusion in the admin index template. It\u2019s a useful starting point.<\/p>\n\n\n