📰 Blog Project — Django News Platform

A full-featured, multi-language news & blog web application built with Django 5.2 and Python 3.13. Users can browse categorized news, read articles, comment, and manage content — all in Uzbek, Russian, and English.

---

🚀 Features

• News Feed — Latest published articles displayed on the homepage, sorted by publish time
• Category Filtering — Filter news by categories: Mahalliy (Local), Xorij (Foreign), Sport, Texnalogiya (Technology)
• Article Detail Page — Full article view with hit/view counter powered by django-hitcount
• Comment System — Authenticated users can post comments on articles
• Search — Full-text search across article titles and body content using Django Q objects
• User Authentication — Register, login, logout with Django's built-in auth system
• User Profile — Profile page with photo upload and date of birth
• Profile Editing — Users can update their personal info and profile picture
• CRUD for News — Create, edit, and delete articles (permission-protected)
• Admin Panel — Superuser-only admin page listing all admin accounts
• Multi-language Support — Full i18n with Uzbek (default), Russian, and English via django-modeltranslation and i18n_patterns
• Contact Form — Users can send messages through a contact page
• Password Management — Change password, reset password via email flow
• Draft / Published Status — Articles have Draft/Published states; only published articles are visible publicly
• Custom Manager — PublishedManager filters only published news across all queries
• Custom Permissions — OnlyLoggedUserMixin restricts CRUD views to authenticated users
• Context Processor — Latest news injected globally into all templates
• Responsive Design — Bootstrap-based frontend with jQuery, Slick slider, WOW.js animations, and FancyBox

---

🛠️ Tech Stack

Layer	Technology
Language	Python 3.13
Framework	Django 5.2
Database	SQLite3 (dev)
ORM	Django ORM
Auth	Django Built-in Auth
Image Handling	Pillow
Hit Counter	django-hitcount
Multi-language	django-modeltranslation, Django i18n
Frontend	HTML5, CSS3, Bootstrap, jQuery
JS Libraries	Slick.js, WOW.js, FancyBox, jQuery NewsTicker
Package Manager	Pipenv
IDE Config	PyCharm (.idea)

---

📁 Project Structure

Blog_project/
├── config/                  # Project settings & root URL config
│   ├── settings.py
│   ├── urls.py              # i18n_patterns + app routing
│   └── wsgi.py
│
├── news_app/                # Core news application
│   ├── models.py            # News, Category, Comment, Contact models
│   ├── views.py             # Function & class-based views
│   ├── urls.py              # News URL patterns
│   ├── forms.py             # ContactForm, CommentForm
│   ├── admin.py             # Admin registrations
│   ├── translation.py       # modeltranslation field declarations
│   ├── context_processor.py # Global latest news context
│   └── custom_permissions.py
│
├── accounts/                # User auth & profile app
│   ├── models.py            # Profile model (OneToOne with User)
│   ├── views.py             # Login, register, profile, edit views
│   ├── forms.py             # LoginForm, RegisterForm, EditForms
│   └── urls.py
│
├── templates/               # All HTML templates
│   ├── news/                # Home, detail, category, search pages
│   ├── account/             # Register, profile edit pages
│   ├── registration/        # Login, logout, password reset pages
│   ├── crud/                # Create, edit, delete news pages
│   └── pages/               # User profile, admin page
│
├── static/                  # CSS, JS, fonts, images
├── media/                   # Uploaded news images & user photos
├── manage.py
└── Pipfile

---

⚙️ Installation & Setup

1. Clone the repository

git clone https://github.com/aziz-200/Blog_project.git
cd Blog_project

2. Install dependencies

pip install pipenv
pipenv install
pipenv shell

3. Apply migrations

python manage.py migrate

4. Create a superuser

python manage.py createsuperuser

5. Run the development server

python manage.py runserver

Visit http://127.0.0.1:8000/ in your browser.

---

🌍 Multi-language Support

The app supports 3 languages: Uzbek (uz — default), Russian (ru), and English (en).

Language switching is handled via Django's i18n_patterns and the /i18n/ URL endpoint. Article titles and bodies have translated fields managed by django-modeltranslation.

---

📦 Dependencies

django==5.2
pillow
django-hitcount
django-modeltranslation
python==3.13

Install all with:

pipenv install

---

🔐 Authentication & Permissions

• Public users can browse and read news
• Only logged-in users can post comments or access CRUD views
• Only superusers can access the admin page (/adminpage/)
• Password reset is handled via console email backend (configure SMTP for production)

---

📌 URL Overview

URL	View	Description
/	HomePageView	Homepage with latest news
/news/	news_list	All published news
/news/<slug>/	news_detail	Single article + comments
/news/<slug>/edit/	NewsUpdateView	Edit article (auth required)
/news/<slug>/delete/	NewsDeleteView	Delete article (auth required)
/new/create/	NewsCreateView	Create article (auth required)
/mahalliy/	LocalNewsView	Local news category
/xorij/	XorijNewsView	Foreign news category
/sport/	SportNewsView	Sports news category
/texnalogiya/	TechnologyNewsView	Technology news category
/searchResult/?q=	SearchResultsListView	Search results
/contact-us/	ContactPageView	Contact form
/account/	accounts app	Register, login, profile, edit
/adminpage/	admin_page_view	Superuser admin page

---

🗄️ Data Models

News

• title, slug, body, image, category, publish_time, status (Draft/Published)
• Custom PublishedManager to filter only published articles
• Translated fields: title_uz, title_ru, body_uz, body_ru

Category

• name — e.g. Mahalliy, Xorij, Sport, Texnalogiya

Comment

• Linked to News and User via ForeignKey
• body, created_time, active flag

Profile

• OneToOne with Django User
• photo, date_of_birth

Contact

• name, email, message

---

📝 License

This project is licensed under the terms in the LICENSE file.

---

👤 Author

Aziz — github.com/aziz-200