Nepal Tea Association Website

A comprehensive Django web application for the Nepal Tea Association (NTA), a non-profit organization dedicated to promoting Nepali tea globally and supporting tea producers, manufacturers, sellers, and buyers.

🌿 About the Project

The Nepal Tea Association website serves as a digital platform to:

• Promote Nepali tea culture internationally
• Connect local tea producers with global markets
• Provide educational resources about tea
• Manage organizational membership and activities
• Share news, events, and updates within the tea community

✨ Features

Core Functionality

• Member Management: Board members and general members with detailed profiles
• News & Events: Content management system with slug-based routing
• Gallery: Image gallery for showcasing tea-related photos
• Contact System: Contact form with inquiry management
• Email Subscription: Newsletter subscription system
• Educational Content: Tea legends, health benefits, and cultural information

Technical Features

• Responsive design with mobile navigation
• SEO optimized with meta tags and sitemaps
• Image upload and management with automatic cleanup
• Django admin panel for content management
• User authentication system
• Social media integration
• Form validation and messaging system

🛠️ Technology Stack

• Backend: Django 4.0.3
• Database: SQLite
• Frontend: HTML5, CSS3, JavaScript, jQuery
• Icons: Font Awesome
• Python Version: Compatible with Python 3.8+

📋 Prerequisites

• Python 3.8 or higher
• pip (Python package installer)
• Virtual environment (recommended)

🚀 Installation & Setup

1. Clone the Repository

git clone <repository-url>
cd NepTeaAssociation

2. Create Virtual Environment

python -m venv env

3. Activate Virtual Environment

# Windows
source env/scripts/activate

# macOS/Linux
source env/bin/activate

4. Install Dependencies

pip install -r requirements.txt

5. Database Setup

python manage.py makemigrations
python manage.py migrate

6. Create Superuser (Optional)

python manage.py createsuperuser

7. Run Development Server

python manage.py runserver

The application will be available at http://127.0.0.1:8000/

📁 Project Structure

nepalteaassociation/
├── nepalteaassociation/          # Main project directory
│   ├── settings.py               # Django settings
│   ├── urls.py                   # Main URL configuration
│   └── wsgi.py                   # WSGI configuration
├── home/                         # Main application
│   ├── models.py                 # Database models
│   ├── views.py                  # View functions
│   ├── urls.py                   # URL patterns
│   └── admin.py                  # Admin configuration
├── templates/                    # HTML templates
│   ├── base.html                 # Base template
│   └── home/                     # Home app templates
├── static/                       # Static files (CSS, JS, images)
├── media/                        # User uploaded files
├── requirements.txt              # Python dependencies
└── manage.py                     # Django management script

🎯 Key Models

BoardMember

• Name, position, description
• Social media links (Facebook, Instagram, Twitter)
• Profile photo upload

GeneralMember

• Name, company information
• Contact details and website
• Profile photo upload

NewsAndEvents

• Title, subtitle, content
• Featured image upload
• Slug-based URL routing

Gallery

• Image uploads with titles
• Timestamp tracking

ContactUs

• Contact form submissions
• Inquiry categorization

🔧 Configuration

Environment Settings

• Debug mode: Currently set to True (change for production)
• Time zone: Asia/Kathmandu
• Language: English (en-us)

Static Files

• Static URL: /static/
• Media URL: /media/
• File uploads stored in media/ directory

📝 Usage

Admin Panel

Access the Django admin at /admin/ to:

• Manage board and general members
• Create and edit news articles
• Upload gallery images
• View contact form submissions
• Manage user accounts

Main Features

• Home Page: Latest news, board members, and gallery highlights
• About Section: Organization information, history, objectives, services
• Tea Education: Legends, health benefits, cultural aspects
• Members: Board and general member directories
• News & Events: Latest updates and announcements
• Gallery: Photo collections
• Contact: Inquiry form and organization details

🌐 SEO Features

• Meta descriptions and keywords
• Canonical URLs
• Open Graph tags for social media
• Twitter card integration
• Sitemap support

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push to the branch (git push origin feature/new-feature)
5. Create a Pull Request

📄 License

This project is developed for the Nepal Tea Association. All rights reserved.

🚀 Deployment Notes

For production deployment:

1. Set DEBUG = False in settings.py
2. Configure proper database (PostgreSQL/MySQL)
3. Set up static file serving
4. Configure email backend for contact forms
5. Set up proper domain and SSL certificate
6. Configure environment variables for sensitive data

📊 Version History

• v1.0: Initial release with core functionality
  • Member management system
  • News and events platform
  • Gallery and contact features
  • Educational content sections
  • Responsive design implementation

---

Made with ❤️ for the Nepal Tea Association