3.4 KiB
Table of Contents
Project Overview - Events Management App with full control on admin side.
Key Features
- Add Events and its related data like venue details.
- Many types of filter searches for events like preferences and location.
Prerequisites
- Installation
- Setting Up a Development Environment (Python, Virtual Environment)
- Cloning the Repository and Installing Dependencies
- Database Configuration
- Running the Project
Project Overview
Description:
- GoodTimes App: Find Fun Events in the UK Unforgettable experiences await! The GoodTimes app helps you discover and plan exciting events happening across the UK.
Key Features:
- Discover a Variety of Events: Explore a wide range of events tailored to your interests, from concerts and festivals to workshops and sporting events. Effortless Event Creation: Planning an event yourself? GoodTimes makes it easy to add your event along with its details, including venue information. Powerful Search Filters: Narrow down your event search using filters based on your preferences and location. Find events happening near you or explore options in specific cities across the UK. Seamless Event Planning: Get all the information you need in one place. View event details, venue information, and make informed decisions about the events you want to attend. With GoodTimes, you'll never miss out on the fun!
Basic Computer Knowledge: No prior Python experience is required, but basic computer literacy will be helpful. Text Editor or IDE: Any text editor or Integrated Development Environment (IDE) that supports Python will work. Some popular options include: Visual Studio Code PyCharm (Community Edition is free) Sublime Text Atom
Installation
Setting Up a Development Environment:
Install Python (3.10): https://www.python.org/downloads/ Install a virtual environment tool like virtualenv: https://docs.python.org/3/library/venv.html
Create a virtual environment:
python virtualenv my_env # Using venv source my_env/bin/activate # Activate on Linux/macOS
Cloning the Repository and Installing Dependencies:
Clone this repository using Gitea: http://git.wdipl.com/Rizwan.Shaikh/goodtimes
git clone http://git.wdipl.com/Rizwan.Shaikh/goodtimes
Navigate to the project directory:
cd
Activate your virtual environment (if not already active).
Install project dependencies:
pip install -r requirements.txt
Database Configuration:
Create a database for your project using MySQL. Refer to your database's documentation for setup instructions.
Running the Project
Development Server:
Activate your virtual environment (if not already active).
Add fixtures for user types: python manage.py load_custom_fixture
Add 10 Event Categories from admin dashboard with images(all images for categories inside static/images):
- Arts & Entertainment - image - Black.png
- Business & Economic - image - business.png
- Health & Wellness - image - health.png
- Leisure & Hobbies - image - leisure.png
- Cultural & Social - image - cultural.png
- Education & Technology - image - education.png
- Outdoor Activities - image - outdoor.png
- Recreation & Sports - image - recreation.png
- Family - image - cultural.png
- Shopping Sale - image - business.png
Start the development server:
python manage.py runserver
This will start a local server at http://127.0.0.1:8000/ (or a different port depending on your settings) where you can access your Django application.