igorMSoares / Django-Blog

Django Practice

Final Project - Python Course - Coderhouse

Blog Project – Python Framework Django

The project is considered a MVT project due to the software design pattern for developing web applications Django is based on: MVT (Model-View-Template) architecture. To run this project, you will only have to have Python, Django and Pillow installed. To install Django type in the terminal: • Pip install Django To install Pillow type in the terminal: • Pip install Pillow

The directories we will need are configured in settings.py to work without issues on your computer, since only relative paths were used. The Blog has:

A main page with brief information about the posts and URLs redirecting the user to the posts.

An about session with introduction to the author.

A profile session.

A message session.

The Blog also has 2 complete cicles of CRUD (Create, Read, Update and Delete), one for accounts and one for pages.

1. Accounts

• In the navigation bar you can find two options related to accounts if you are not signed in: sign up and login.
• In sign up you can register a new account. When this step is finished, the system will generate automatically an empty profile related to that account that can be filled later in edit profile.
• The user is redirected to the login page to start session.
• After the session starts, the user is redirected to the homepage and the navigation bar changes: the sign up and login options disappear and you are able to find the username to access the profile of the user.
• The profile of the user is generated with a default picture and has information from the register form and from the profile form that are still blank until the user edits it.
• The other options found in the profile page are: Edit Profile, Delete Account, and Sign Out.

2. Pages

• the main page has a list with an overview of all posts and the user can select one to read the entire post.
• The overview of the pages contains: Photo, Title, Subtitle, Author, Date and the first 200 caracters of the post.
• In the detailed view of the chosen page you will find options to edit the post, delete the post or create a new one.
• The pages can be created using an text editor.

3. Admin portal

• The admin portal contains the authorization module, that is a build in function of Django, and the two models: Pages and Accounts.
• You can use the admin portal to create, edit or delete any of the instances.

4. Messages

• This part is still being worked on.

5. You can find the test cases and video showing the Blog functionality here: https://drive.google.com/drive/folders/1LoqdnUcUxfRXERW48Hles702han5th12?usp=sharing

------------------------------------ Spanish Translation ------------------------------------

El proyecto se considera un proyecto MVT debido al patrón de diseño de software para el desarrollo de aplicaciones web en el que django se basa: arquitectura MVT (Model-View-Template). Para ejecutar este proyecto, solo tendrás que tener instalado Python, Django y Pillow. Para instalar Django escriba en el terminal: • Pip install Django Para instalar Pillow en el terminal: • Pip install Pillow

Los directorios que necesitaremos están configurados en settings.py para que funcionen sin problemas en tu ordenador, ya que solo se utilizaron rutas relativas. El Blog tiene:

Una página principal con información breve sobre las publicaciones y URL que redirigen al usuario a las publicaciones.

Una sesión sobre con introducción al autor.

Una sesión de perfil.

Una sesión de mensajes.

El Blog también cuenta con 2 ciclos completos de CRUD (Crear, Leer, Actualizar y Borrar), uno para cuentas y otro para páginas.

1. Cuentas

• En la barra de navegación puedes encontrar dos opciones relacionadas con las cuentas si no has iniciado sesión: registrarte e iniciar sesión.
• Al registrarse puede registrar una nueva cuenta. Cuando finalice este paso, el sistema generará automáticamente un perfil vacío relacionado con esa cuenta que se puede rellenar más adelante en el perfil de edición.
• El usuario es redirigido a la página de inicio de sesión para iniciar la sesión.
• Después de que comienza la sesión, el usuario es redirigido a la página de inicio y la barra de navegación cambia: las opciones de registro e inicio de sesión desaparecen y puede encontrar el nombre de usuario para acceder al perfil del usuario.
• El perfil del usuario se genera con una imagen por defecto y tiene información del formulario de registro y del formulario de perfil que siguen en blanco hasta que el usuario lo edite.
• Las otras opciones que se encuentran en la página de perfil son: Editar perfil, Eliminar cuenta y Cerrar sesión.

2. Paginas

• la página principal tiene una lista con una visión general de todas las publicaciones y el usuario puede seleccionar una para leer la publicación completa.
• La descripción general de las páginas contiene: Foto, Título, Subtítulo, Autor, Fecha y los primeros 200 caracteres de la publicación.
• En la vista detallada de la página elegida encontrarás opciones para editar el post, eliminar el post o crear uno nuevo.
• Las páginas se pueden crear utilizando un editor de texto.

3. Portal de administración

• El portal de administración contiene el módulo de autorización, que es una función incorporada de Django, y los dos modelos: Páginas y Cuentas.
• Puede utilizar el portal de administración para crear, editar o eliminar cualquiera de las instancias.

4. Mensajes

Esta parte todavía se está trabajando.

5. Puede encontrar los casos de prueba y el video que muestra la funcionalidad del Blog aquí: https://drive.google.com/drive/folders/1LoqdnUcUxfRXERW48Hles702han5th12?usp=sharing