Kidsworld

Kidsworld is a children's story platform developed as a group project for the AXSOS Academy Dojo programming course. This application allows users to explore, read, and interact with various children's stories. Key features include user authentication, adding to favorites, search functionality, story details with PDF interaction, a rating system, and admin capabilities for managing stories.

Technologies Used

• Frontend: HTML, CSS, SCSS, JavaScript, Bootstrap, jQuery
• Backend: Python, Django
• Libraries: Mixitup, PDF.js, Crispy Forms, AJAX
• Other Tools: Trello

Deployment

The project is deployed on AWS. You can access it here.

Features

1. User Authentication

• Django Authentication: Utilizes Django’s built-in user authentication system.
• Custom Forms: Forms customized using the crispy-forms library.
• Validation: Includes both frontend and backend validation.
• AJAX: Enhances user experience by avoiding page reloads during authentication processes.
• Watch Video

2. Favorites Management

• Users can add stories to their favorites and remove them as needed.
• Watch Video

3. Search and Filtering

• Title Search: Allows users to search for stories by their titles.
• Category Search: Users can filter stories by category using the Mixitup library.
• AJAX: Implements AJAX for smooth and dynamic searching and filtering.
• Watch Video

4. Story Details and PDF Interaction

• Story Details: Detailed view of each story including comments and ratings.
• PDF Interaction: Users can read or download stories in PDF format using PDF.js.
• Comments: Users can add, delete, and view comments on stories.
• Watch Video

5. Rating System

• Story Rating: Users can rate stories.
• Average Rating: Each story’s average rating is dynamically updated based on user ratings.
• Watch Video

6. Admin Capabilities

• Story Management: Admins can add new stories, view all stories, update existing stories, and delete stories.
• Watch Video

Installation

To run this project locally:

1. Clone the repository: git clone https://github.com/Farhoud-Rand/KidsWorld.git
2. Navigate to the project directory: cd kidsworld
3. Create a virtual environment: python -m venv env
4. Activate the virtual environment:
   • On Windows: .\env\Scripts\activate
   • On macOS and Linux: source env/bin/activate
5. Install the dependencies: pip install -r requirements.txt
6. Apply migrations: python manage.py migrate
7. Run the development server: python manage.py runserver
8. Open your web browser and go to http://127.0.0.1:8000/ to see the application in action.

Contributors

• Rand Farhoud
• Sajeda Abu Ayyash
• Ziad Disi

Screenshots of the website (KidsWorld) :

Home page :

Profile :

---

Favorite list :

About Us :

Contact page :

Story details :