Tutorial Part 1: Site Name, Logo, and Basics¶
After Installation, you are greeted with a bare-bones website. Let’s start filling things out.
For this tutorial, we will assume the name of your project is
Navigate to http://localhost:8000/admin/ and log in with the username
and password you created with the
python manage.py createsuperuser command.
After logging in, you will be taken to the admin dashboard - also known as the “Wagtail Admin”.
Changing your site name¶
By default, the site name shows up in many different places, including page titles in the browser tab. To change the name, go to Settings > Sites, and click on the site that is there. Change the Site name setting and click “Save”.
There is also a
WAGTAIL_SITE_NAME setting in the
mysite/settings/base.py file. This is really
only used for the login screen and on the main Wagtail Admin dashboard. The reason this setting exists
is for use with multi-sites. For example, if you have a parent company that operates many separate
brand websites within one CMS, then
WAGTAIL_SITE_NAME would be the name of the parent company.
For my website, I’m going to change Settings > Sites > Site name to “Simple Sweet Desserts”.
mysite/settings/base.py by changing
WAGTAIL_SITE_NAME as so:
WAGTAIL_SITE_NAME = 'Simple Sweet Desserts Ltd.'
Now the admin dashboard and login page show “Simple Sweet Desserts Ltd.”, and the Home page at http://localhost:8000/ will show “Simple Sweet Desserts”.
Adding your logo¶
First, and most important, is the logo. Go to Settings > Layout. Here are the site-wide visual and design settings for your website. At the top are two settings for your logo and favicon. Both will be scaled to fit wherever they are used, but we recommend the following image parameters:
Logo: probably does not need to be any larger than 500x500 pixels, unless you plan to have a giant logo. Any image ratio is fine, logos come in all shapes and sizes. 😀
Favicon: does not need to be any larger than 200x200 pixels. A 1:1 (square) image ratio is best here - if the image is not square, it will be scaled to a square.
We recommend PNG format at 300 DPI so that your logo will look sharp on high resolution mobile devices and retina displays. However, any image format will work.
After uploading your logo and favicon, click “Save”. You should now instantly see your logo applied in the dashboard. In a new tab, go to http://localhost:8000/ and you’ll see that your logo and favicon show up everywhere on your site.