Metadata-Version: 2.4
Name: django-classified
Version: 1.2.1
Summary: Django Classified
Home-page: https://github.com/slyapustin/django-classified
Author: Sergey Lyapustin
Author-email: s.lyapustin@gmail.com
Keywords: django classified
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: django-bootstrap-form
Requires-Dist: Django<6.1,>=5.2
Requires-Dist: Pillow
Requires-Dist: sorl-thumbnail
Requires-Dist: babel
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Django Classified

## Features

- Item groups, categories and areas (for ex. Cities or Locations)
- Image
  - upload multiple images per item
  - generating preview (via [sorl-thumbnail](https://github.com/mariocesar/sorl-thumbnail))
  - display using [Lightbox JS](http://lokeshdhakar.com/projects/lightbox2/) library
- Search ability
- SEO optimization
  - SEO-friendly urls
  - generating META description and meta keywords
  - sitemap.xml
  - robots.txt
  - RSS feed
  - Google Analytics 4 (GA4) integration
  - [Open Graph protocol](http://ogp.me/) support
  - Support for non-Latin characters in URLs (Arabic, Cyrillic, etc.)
- Caching
- Translation
  - Arabic
  - Azerbaijani
  - English
  - French (thanks to [Teolemon](https://github.com/teolemon))
  - German
  - Polish
  - Portuguese
  - Russian
  - Spanish (thanks to [4bimcad](https://github.com/4bimcad))
  - Turkish (thanks to [Mirat Can Bayrak](https://github.com/miratcan))
  - Help translate to other languages at [Transifex](https://www.transifex.com/inoks/django-classified/)

## Requirements

- Python >=3.10
- Django >=5.2, <6.1

## Design

- [Bootstrap 3 Jumbotron](https://getbootstrap.com/docs/3.3/examples/jumbotron-narrow/)

## Demo project

Demo project with user registration (via Email/Facebook) available [here](https://github.com/slyapustin/django-classified-demo).

## Installation

- Install app `pip install django-classified`
- Add `django_classified` to the `INSTALLED_APPS`:

```python
INSTALLED_APPS = [
    # Default Django applications
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.messages',
    'django.contrib.sessions',
    'django.contrib.staticfiles',

     # Required by Django Classified
    'django.contrib.sites',
    'django.contrib.humanize',
    'django.contrib.sitemaps',

     # External applications required by Django Classified
    'bootstrapform',
    'sorl.thumbnail',

    # Django Classified
    'django_classified',
]
```

- Add `SITE_ID` to `settings.py` file:

```python
SITE_ID = 1
```

- Import `include` in addition to `path` and add `path('', include('django_classified.urls', namespace='django_classified')),` to the project `urls.py` file:

```python
from django.urls import path, include

urlpatterns = [
    path('', include('django_classified.urls', namespace='django_classified')),
]
```

- Add `'django_classified.context_processors.common_values'` to the settings `TEMPLATES` `context_processors` list:

```python
TEMPLATES[0]['OPTIONS']['context_processors'].append('django_classified.context_processors.common_values')
```

## Customization:

You can provide additional customization in settings.py

- `DCF_SITE_NAME` - Site title
- `DCF_SITE_DESCRIPTION` - Site description
- `DCF_ITEM_PER_USER_LIMIT` - Max Items allowed per user
- `DCF_SITEMAP_LIMIT` - Sitemap items limit
- `DCF_RSS_LIMIT` - RSS feed items limit
- `DCF_RELATED_LIMIT` - Number of related items displayed
- `DCF_ITEM_PER_PAGE` - Number of items per page
- `DCF_LOGIN_TO_CONTACT` - Hide contact information for unauthorized requests
- `DCF_DISPLAY_EMPTY_GROUPS` - Display groups without items in the groups list
- `DCF_CURRENCY` - Site currency (default: 'USD')

### Optional integrations

- `GOOGLE_ANALYTICS_PROPERTY_ID` - Google Analytics 4 measurement ID (e.g. 'G-XXXXXXXXXX')
- `GOOGLE_SITE_VERIFICATION_ID` - Google Search Console verification code
- `FACEBOOK_APP_ID` - Facebook App ID for Open Graph integration

## Current Version

The current version is 1.2.1 (April 2026).
