Difference between revisions of "Creating a Django Web App"

From TRCCompSci - AQA Computer Science
Jump to: navigation, search
(Setup - Manually on Own Machine)
(Setup - Visual Studio with new template)
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Setup - Visual Studio=
+
=Setup - Manually Within Visual Studio=
Using Visual Studio 2017, this will create a Django app based on 1.11. This is not the most upto date version, and isn't fully compatible with the latest version.
 
  
Create a new project in Visual Studio, look in the python section and Django:
+
follow the following to create a new python project and to create a virtual environment:
  
[[File:Django1.gif]]
+
[[Create a python project in Visual Studio]]
  
On your own machines, this will install all of the appropriate packages into your python installation if you select 'Install into Python'. However in College will will need to do a bit more, and instead choose 'install into virtual environment':
+
[[Creating a virtual environment in Visual Studio]]
  
[[File:Vswebapp1.png]]
+
The last link above also shows how to create a 'setup.py' to install Django using pip, use this method to install Django.
  
'''In College''' we will need see this window:
+
===In College===
 +
You will need to complete the above links, but the installation will not work. You will need to install django by replacing the contents of your environment folder with
 +
[https://studentthomrothac-my.sharepoint.com/:u:/g/personal/wayne_jones_thomroth_ac_uk/EVoEVPiGN2ZJnA415Yduf_8BFQyWcnXlyDMD37mwjQ2STg?e=u7VuQm This]. College are currently blocking the ports required to install modules into your python environment.
  
[[File:Vswebapp2.png]]
+
'''Easy Method:''' just use [https://studentthomrothac-my.sharepoint.com/:u:/g/personal/wayne_jones_thomroth_ac_uk/ESxjsT-IKulAhg1Ryk6-fUcBH3QCP95hEGh9kBm247EPUQ?e=znjdSB this] project for yours.
  
You can untick the install packages option, because this will fail on college computers.
+
==Management==
 +
Now use this program: [[Django management program]] to create a management app to run the key commands needed for django.
  
Now, find the site packages folder within your project folder:
+
===New Project===
 +
* Run the management program and choose '1' as your first option to run django_admin
 +
* Now selected option 1 to 'StartProject'
 +
* Now enter a project name, eg 'MyProject'
  
[[File:Django4.gif]]
+
===New App===
 +
* Run the management program and choose '1' as your first option to run django_admin
 +
* Now selected option 1 to 'StartApp'
 +
* Now enter a app name, eg 'MyApp'
  
Extract this zip file: [https://studentthomrothac-my.sharepoint.com/:u:/g/personal/wayne_jones_thomroth_ac_uk/EeJ3eFG9rENLp-6Wt84AOwoBQ73SAXJIe4V5ulpXacNzcQ?e=HfCo4d Django 1.11.20]
+
===Run Server===
 +
* Run the management program and choose '2' as your first option to run manage
 +
* Now selected option 1 to 'RunServer'
  
You should now have:
+
===Make Migrations===
 +
* Run the management program and choose '2' as your first option to run manage
 +
* Now selected option 2 to 'MakeMigrations'
  
[[File:Django5.gif]]
+
===Migrate===
 +
* Run the management program and choose '2' as your first option to run manage
 +
* Now selected option 3 to 'Migrate'
  
Next, you will need to create a super user account. This must be done before running the app for the first time:
+
===Create Super User===
 +
* Run the management program and choose '2' as your first option to run manage
 +
* Now selected option 4 to 'CreateSuperUser'
  
[[File:Django6.gif]]
+
==You Will Need to==
 +
You will need to run option 1 & StartProject followed by StartApp, Then option 2 & Migrate followed by RunServer.
  
Now click start in Visual Studio, you should see something like this:
+
Finally so that you can see all of the files within the project, make sure 'All Files' is selected in solution explorer:
  
[[File:Django2.gif]]
+
[[File:Show all files.png]]
 
 
It should automatically open a browser, it should already point to your web app:
 
 
 
[[File:Django3.gif]]
 
 
 
=Setup - Visual Studio with new template=
 
The latest version of Visual Studio has an updated template for Django. Download [https://studentthomrothac-my.sharepoint.com/:u:/g/personal/wayne_jones_thomroth_ac_uk/EV82pbEqmxtChf5oXU0H1x4BfqjLbpCTrXrPYg8p3XjwHQ?e=WlFDqc this file] and extract it into your templates folder (documents\Visual Studio 201X\Templates\Project Templates\):
 
 
 
[[File:Template1.gif]]
 
 
 
Now start Visual Studio, and when you choose 'new project' you should be able to see the new template (the new template is in a folder called 'Django 2 Template', this name will appear under Python. Choose Django Web Project:
 
 
 
[[File:Template2.gif]]
 
 
 
Now we need to create a virtual environment, right click the environment in solution explorer and select add virtual environment:
 
 
 
[[File:Template3.gif]]
 
 
 
This will create the following panel, you can leave everything as it is. In college you will not be able to download and install:
 
 
 
[[File:Template4.gif]]
 
  
 +
You can also set your django management program as the startup file, by right clicking it in solution explorer and then click 'Set as Startup File'.
  
 
=Setup - Manually on Own Machine=
 
=Setup - Manually on Own Machine=

Latest revision as of 11:45, 18 November 2020

Setup - Manually Within Visual Studio

follow the following to create a new python project and to create a virtual environment:

Create a python project in Visual Studio

Creating a virtual environment in Visual Studio

The last link above also shows how to create a 'setup.py' to install Django using pip, use this method to install Django.

In College

You will need to complete the above links, but the installation will not work. You will need to install django by replacing the contents of your environment folder with This. College are currently blocking the ports required to install modules into your python environment.

Easy Method: just use this project for yours.

Management

Now use this program: Django management program to create a management app to run the key commands needed for django.

New Project

  • Run the management program and choose '1' as your first option to run django_admin
  • Now selected option 1 to 'StartProject'
  • Now enter a project name, eg 'MyProject'

New App

  • Run the management program and choose '1' as your first option to run django_admin
  • Now selected option 1 to 'StartApp'
  • Now enter a app name, eg 'MyApp'

Run Server

  • Run the management program and choose '2' as your first option to run manage
  • Now selected option 1 to 'RunServer'

Make Migrations

  • Run the management program and choose '2' as your first option to run manage
  • Now selected option 2 to 'MakeMigrations'

Migrate

  • Run the management program and choose '2' as your first option to run manage
  • Now selected option 3 to 'Migrate'

Create Super User

  • Run the management program and choose '2' as your first option to run manage
  • Now selected option 4 to 'CreateSuperUser'

You Will Need to

You will need to run option 1 & StartProject followed by StartApp, Then option 2 & Migrate followed by RunServer.

Finally so that you can see all of the files within the project, make sure 'All Files' is selected in solution explorer:

Show all files.png

You can also set your django management program as the startup file, by right clicking it in solution explorer and then click 'Set as Startup File'.

Setup - Manually on Own Machine

This will create a web app based on Django 2.2, this is the latest version of Django and isn't entirely compatible with the Django 1.11 used by Visual Studio.

Setup the Path

You will need to ensure your system path is set to access the python folder and the scripts folder. Search for 'path' in the search bar, and click 'edit the system variables':

Capture1.gif

Now click 'Environment Variables':

Capture2.gif

Now select Path and click edit:

Capture 3.gif

Now look on your system to find where Python is installed, make a note of the folder and also check to see if it also has a script folder. Now add these values to the Path:

Capture 4.gif

Install Django

Now to install Django you can enter the following command:

python -m pip install django

If you have set the path above it should work, you might need to restart your computer after you change the path. This command should install Django and all of its dependencies.

Create an app

With Django installed above, it should add django-admin into your scripts folder. We will use this to create a new Django app. But first we need to create a folder for your app, and then run the command prompt and go to the folder location:

Capture 5.gif

Now we can run this command to create a blank Django app:

django-admin startproject myapp

This will create a folder called myapp, and it will contain everything required for a Django app. If you go into the myapp directory you will see manage.py:

Capture 6.gif

Now we need to run a few commands, firstly:

manage.py migrate

Then we need to create a superuser, so now type this command:

manage.py createsuperuser

You will need to follow the instructions to create a username and password.

Now to run the app you will need to run the command:

manage.py runserver

This will start the server and tell you the address to access the app:

Capture 7.gif

Now open a browser and enter the ip address above, ie http://127.0.0.1:8000 :

Capture 8.gif

Change the url to 'http://127.0.0.1:8000/admin' to access the admin features:

Capture 10.gif

You should be able to login with your superuser details:

Capture 11.gif