From 49fcd8fb7d6c2a96c23bd376320ac76e02c9b5b0 Mon Sep 17 00:00:00 2001
From: Guido Longoni <guido.longoni@briq.it>
Date: Fri, 19 Jun 2026 17:42:00 +0200
Subject: [PATCH] Documenta installazione dal fork git Briq e le differenze del
 fork

- Installazione via dipendenza git (Poetry classico e PEP 621), coerente con
  i deployment Briq, al posto del pip install da PyPI.
- Nota sulle differenze: media locale-aware e reset della paginazione.
---
 README.md | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 77a5891..760b9df 100644
--- a/README.md
+++ b/README.md
@@ -15,8 +15,21 @@ autocomplete widget! No extra package or install required!
 
 ## Installation and Usage
 
-```bash
-$ pip install django-admin-autocomplete-list-filter
+Questo fork Briq si installa dal repository git interno (è la modalità usata
+da tutti i deployment Briq), non da PyPI.
+
+Con Poetry (stile `[tool.poetry.dependencies]`):
+
+```toml
+django-admin-autocomplete-list-filter = {git = "https://git.briq.it/Briq/django-admin-autocomplete-list-filter.git"}
+```
+
+Con il formato PEP 621 (`[project] dependencies`, Poetry 2.x):
+
+```toml
+dependencies = [
+    "django-admin-autocomplete-list-filter @ git+https://git.briq.it/Briq/django-admin-autocomplete-list-filter.git",
+]
 ```
 
 Add `djaa_list_filter` to `INSTALLED_APPS` in your `settings.py`:
@@ -110,6 +123,16 @@ class TagAdmin(admin.ModelAdmin):
 
 ```
 
+## Note di questo fork (Briq)
+
+- **Media locale-aware**: jQuery/select2/autocomplete sono caricati derivandoli
+  dal widget `AutocompleteSelect` di Django, quindi il select2 viene tradotto
+  nella lingua attiva (es. `it`) e i percorsi restano corretti tra le versioni di
+  Django. Non serve più mantenere una lista hard-coded dei media.
+- **Reset paginazione**: cambiando il filtro la querystring viene ricostruita
+  senza il parametro `p`, così si torna a pagina 1 come fanno i link filtro
+  standard dell'admin (niente più "pagina senza risultati").
+
 ## Development
 
 You are very welcome to contribute, fix bugs or improve this project. We