django-admin-mobile 0.2.4__tar.gz → 0.2.7__tar.gz

{django_admin_mobile-0.2.4 → django_admin_mobile-0.2.7}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.7
+
+- The phone filter panel is a bottom sheet: dimmed backdrop, 16px top corners, grab handle, sticky Filters / Reset / Close header, chevrons, 44px options with an accent check and right-aligned counts, and a sticky Show results button. The scrim darkens the page in light and dark. A selected row keeps a visible accent tint and check in dark mode.
+- Long filter lists get a search field. Date and range inputs stay in the sheet. With JavaScript off, the filters stay inline.
+
+## 0.2.6
+
+- “Save this list” is a full-width 44px control on the same 16px edge as the rest of the changelist.
+- While the sticky bulk bar is open, the top action menu and Run are hidden. Select all and the count stay. With JavaScript off, that top row stays in place.
+
+## 0.2.5
+
+- A selected changelist card uses a light accent tint and outline instead of Django’s flat selected-row fill.
+- The checkbox and the linked column share one left-aligned title line. Field labels stay on the rows below, about 40% wide, with values wrapping in the rest of the row.
+- Rich cell HTML and list-editable inputs stay inside the value column. The sticky bulk bar is full width above the tab bar: the count, the action menu, and Run share one row.
+
 ## 0.2.4
 
 - The action menu and Run share one 44px row and the same corner radius. Run stays only as wide as its label.

{django_admin_mobile-0.2.4 → django_admin_mobile-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: django-admin-mobile
-Version: 0.2.4
+Version: 0.2.7
 Summary: Make the native Django admin usable on phones without replacing its look.
 Project-URL: Homepage, https://github.com/daniilshamraev/django-admin-mobile
 Project-URL: Repository, https://github.com/daniilshamraev/django-admin-mobile
@@ -40,15 +40,57 @@ Description-Content-Type: text/markdown
 
 # django-admin-mobile
 
-Phone layout for the **native** Django admin. It is not a theme: colors, typography, and chrome stay on Django's own CSS variables, including `html[data-theme]` and `prefers-color-scheme`.
+Phone ergonomics for the native Django admin. Same colors, same templates, a layout that fits a 375px screen.
 
-Targets Django 4.2 LTS, 5.x, and 6.x on Python 3.10+.
+[![PyPI](https://img.shields.io/pypi/v/django-admin-mobile)](https://pypi.org/project/django-admin-mobile/)
+[![Python versions](https://img.shields.io/pypi/pyversions/django-admin-mobile)](https://pypi.org/project/django-admin-mobile/)
+[![Django versions](https://img.shields.io/badge/Django-4.2%20%7C%205.2%20%7C%206.0-092e20)](https://docs.djangoproject.com/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![CI](https://github.com/daniilshamraev/django-admin-mobile/actions/workflows/ci.yml/badge.svg)](https://github.com/daniilshamraev/django-admin-mobile/actions/workflows/ci.yml)
 
-![Changelist at 375px](docs/screenshots/changelist-375.png)
+![Index, a selected changelist, the filter sheet, and a change form](docs/hero.png)
 
-![Change form at 375px](docs/screenshots/change-form-375.png)
+## Before / after
 
-## Install
+Stock Django admin at 375px, then the same changelist with this package.
+
+| Before | After |
+| --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/stock-changelist-375-dark.png"><img alt="Stock Django admin changelist at 375px" src="docs/screenshots/stock-changelist-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/changelist-375-dark.png"><img alt="Changelist with django-admin-mobile at 375px" src="docs/screenshots/changelist-375.png" width="250"></picture> |
+
+## Changelist
+
+Cards, a full-width action row, and a sticky bulk bar. Selecting a row hides the top action menu so Run appears once.
+
+| Cards | One row selected | Bulk bar |
+| --- | --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/changelist-375-dark.png"><img alt="Book changelist cards" src="docs/screenshots/changelist-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/payments-375-dark.png"><img alt="Payments changelist with nothing selected" src="docs/screenshots/payments-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/payments-selected-375-dark.png"><img alt="Payments changelist with the sticky bulk bar" src="docs/screenshots/payments-selected-375.png" width="250"></picture> |
+
+## Filters
+
+`FILTER_SHEET` opens filters in a bottom sheet: dimmed backdrop, grab handle, Reset, a close control, 44px rows, and Show results. Long lists get a search field. Date and range widgets stay inside the sheet. With JavaScript off, `#changelist-filter` stays inline.
+
+| Light | Dark |
+| --- | --- |
+| <img alt="Filter bottom sheet, light" src="docs/screenshots/filters-375.png" width="250"> | <img alt="Filter bottom sheet, dark" src="docs/screenshots/filters-375-dark.png" width="250"> |
+
+## Change form
+
+Native date and time inputs, stacked inlines, and a submit bar that sits above the tab bar.
+
+| Change form | Edition | History |
+| --- | --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/change-form-375-dark.png"><img alt="Book change form" src="docs/screenshots/change-form-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/edition-375-dark.png"><img alt="Edition change form" src="docs/screenshots/edition-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/history-375-dark.png"><img alt="Object history" src="docs/screenshots/history-375.png" width="250"></picture> |
+
+## Index and navigation
+
+| Index | App index | Search |
+| --- | --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/index-375-dark.png"><img alt="Admin index" src="docs/screenshots/index-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/app-index-375-dark.png"><img alt="App index" src="docs/screenshots/app-index-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/search-375-dark.png"><img alt="Global search" src="docs/screenshots/search-375.png" width="250"></picture> |
+
+Screenshots are the 375px viewport, light and dark. More captures live in [`docs/screenshots/`](docs/screenshots/).
+
+## Quick start
 
 ```bash
 pip install django-admin-mobile
@@ -68,7 +110,7 @@ That is enough. `admin_mobile` overrides `admin/base.html`, calls `{{ block.supe
 
 No CDN and no build step. The package ships plain files under `admin_mobile/static/`.
 
-## If you already override `admin/base.html`
+### If you already override `admin/base.html`
 
 Django will use your template and skip this app's override. Load the tag yourself, and still call `{{ block.super }}`:
 
@@ -89,19 +131,14 @@ Django will use your template and skip this app's override. Load the tag yoursel
 
 `{% admin_mobile_assets %}` emits both. If `admin_mobile` is listed after `django.contrib.admin`, system check `admin_mobile.W001` warns you.
 
-## Settings
+## Configuration
 
-All keys are optional booleans.
+Every key is optional. Unknown keys are rejected. Boolean flags must be real bools.
 
 ```python
 ADMIN_MOBILE = {
     "ENABLED": True,
-    "CHANGELIST_CARDS": True,
-    "TABULAR_INLINE_STACK": True,
-    "STICKY_SUBMIT": True,
-    "TOUCH_TARGETS": True,
-    "COLLAPSIBLE_FILTERS": True,
-    "USE_NATIVE_DATETIME": False,
+    "FILTER_SHEET": True,
 }
 ```
 
@@ -113,14 +150,14 @@ ADMIN_MOBILE = {
 | `STICKY_SUBMIT` | `True` | The last `.submit-row` sticks to the bottom of the viewport. The login page is left alone. |
 | `TOUCH_TARGETS` | `True` | Targets at least 44px, inputs at 16px (stops iOS from zooming), larger checkboxes. |
 | `COLLAPSIBLE_FILTERS` | `True` | `#changelist-filter` collapses behind a button. Django's filters, django-admin-rangefilter, and django-more-admin-filters render inside that node; this package does not import them. |
+| `FILTER_SHEET` | `True` | On a phone, filters open as a bottom sheet with Reset, a close control, an active-count badge, search on long lists, and Show results. With JavaScript off, the filter block stays inline. |
 | `USE_NATIVE_DATETIME` | `False` | Opt in to native date/time widgets on **every** `ModelAdmin` and inline. A custom `formfield_overrides` widget is kept. |
 | `BOTTOM_TABS` | `True` | Home, search, recent, and saved-model tabs. Favorites stay in `localStorage`. |
 | `GLOBAL_SEARCH` | `True` | Staff search across admins that define `search_fields`. Permissions are checked per model. |
 | `SWIPE_ACTIONS` | `True` | Swipe a card right to open it, left for Open/Delete. Delete still posts `delete_selected` after confirm. |
 | `PULL_TO_REFRESH` | `True` | Pull down on a changelist to reload. |
 | `INFINITE_SCROLL` | `False` | Fetch the next changelist page instead of using the pager. |
-| `FILTER_SHEET` | `True` | Filters open in a bottom sheet with an active-count badge and Reset. |
-| `STICKY_ACTIONS` | `True` | `Selected N`, the action menu, and Run stick above the tab bar. |
+| `STICKY_ACTIONS` | `True` | `Selected N`, the action menu, and Run stick above the tab bar. While that bar is open, the top action menu is hidden. |
 | `UNSAVED_GUARD` | `True` | `beforeunload` when a change form is dirty. |
 | `FORM_DRAFTS` | `False` | Autosave add-form text fields in `localStorage` and offer restore. Passwords and files are skipped. |
 | `CAMERA_CAPTURE` | `True` | Camera button on file inputs, with a preview. |
@@ -137,18 +174,16 @@ ADMIN_MOBILE = {
 | `ACCENT` | unset | Hex color (`#rgb` or `#rrggbb`) mapped to `--button-bg`, `--default-button-bg`, and `--object-tools-bg` for both `data-theme` values and `prefers-color-scheme`. It does not set `--accent`, because that variable is also the header title color. |
 | `PALETTE` | unset | Optional map of allow-listed admin variable names (`primary`, `header-bg`, `link-fg`, …) to hex colors. |
 | `READONLY_MODELS` | `[]` | `app.model` labels that lose add/change/delete when the `admin_mobile_viewport=mobile` cookie is set. |
-
-`MobileAdminMixin` also accepts `mobile_card_title`, `mobile_card_subtitle`, `mobile_card_image`, `mobile_list_display`, and `mobile_readonly = True`.
+| `UNDO_SECONDS` | `8` | Seconds to wait when `UNDO_DELETE` is on. An int from 5 to 10. |
+| `SWIPE_CONFIRM_ACTIONS` | `["delete_selected"]` | Action names that use the slide-to-confirm control. |
 
 `mobile_readonly` and `READONLY_MODELS` only look at a cookie the phone script sets. That is a UX guard. It does not replace permissions: a desktop client, or a client that drops the cookie, keeps the real Django permissions.
 
 Surfaces use Django admin CSS variables, including `html[data-theme]` and `prefers-color-scheme`. The service worker does not cache HTML or authenticated responses.
 
-Unknown keys are rejected. Boolean flags must be real bools. `ACCENT` and `PALETTE` must be hex.
-
-## Native date and time widgets
+## MobileAdminMixin
 
-Per model, without the global flag:
+Per model, without the global date flag:
 
 ```python
 from django.contrib import admin
@@ -158,7 +193,11 @@ from library.models import Book
 
 @admin.register(Book)
 class BookAdmin(MobileAdminMixin, admin.ModelAdmin):
-    pass
+    mobile_card_title = "title"
+    mobile_card_subtitle = "author"
+    mobile_list_display = ("status", "published_on")
+    # mobile_card_image = "cover"
+    # mobile_readonly = True
 ```
 
 `MobileAdminMixin` must come before `admin.ModelAdmin` or `admin.TabularInline`. It sets `formfield_overrides` to:
@@ -171,6 +210,12 @@ Values stay on `SplitDateTimeField` / `DateField` / `TimeField`, so Django still
 
 These widgets do **not** load `DateTimeShortcuts`, so you do not get a second calendar on top of the native picker.
 
+## Compatibility
+
+Python 3.10+ and Django 4.2 LTS, 5.2, and 6.0+. Django 6 needs Python 3.12+. `tox.ini` and GitHub Actions run that matrix.
+
+The stylesheet also covers the rest of the built-in admin at `≤600px`: login, password change, and logout; the index and app list; the nav sidebar and its filter; header, user tools, and breadcrumbs; changelist search, actions, select-all, sortable headers, date hierarchy, pagination, result counts, and `list_editable`; every built-in filter (choices, related, date, empty, and facets on Django 5+); change-form fieldsets (including collapse), help, errors, readonly fields, related-object icons, raw id lookup, autocomplete, filter horizontal/vertical, radios, and file Currently/Change/Clear; stacked and tabular inlines; object history; delete confirmation; related-object popups; messages; the stock calendar and clock when native widgets are off; admindocs; and RTL (`dir="rtl"`).
+
 ## Example
 
 ```bash
@@ -183,17 +228,11 @@ With `DEBUG` and `ADMIN_MOBILE_DEMO` (both set in `example/example/settings.py`)
 
 Open http://127.0.0.1:8741/admin/ and narrow the window to 375px, or use device mode.
 
-![Filters open](docs/screenshots/filters-375.png)
-
-![Changelist, dark](docs/screenshots/changelist-375-dark.png)
-
-The same stylesheet also covers the rest of the built-in admin at `≤600px`: login, password change, and logout; the index and app list; the nav sidebar and its filter; header, user tools, and breadcrumbs; changelist search, actions, select-all, sortable headers, date hierarchy, pagination, result counts, and `list_editable`; every built-in filter (choices, related, date, empty, and facets on Django 5+); change-form fieldsets (including collapse), help, errors, readonly fields, related-object icons, raw id lookup, autocomplete, filter horizontal/vertical, radios, and file Currently/Change/Clear; stacked and tabular inlines; object history; delete confirmation; related-object popups; messages; the stock calendar and clock when native widgets are off; admindocs; and RTL (`dir="rtl"`, logical alignment).
-
-Further 375px captures live in `docs/screenshots/` (`login`, `index`, `nav-sidebar`, `edition`, `calendar`, `clock`, `history`, `delete-confirm`, `popup`, `admindocs`, `rtl-changelist`, and others).
-
 `Appointment` in the example keeps Django's calendar and clock. `Book` and `Edition` use `MobileAdminMixin`. `USE_NATIVE_DATETIME` stays off in the example so both modes are visible.
 
-## Tests
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ```bash
 uv run ruff check .
@@ -203,14 +242,14 @@ uv run pytest -m playwright
 uv run tox
 ```
 
-`tox.ini` runs Django 4.2, 5.2, and 6.0. GitHub Actions adds Python 3.10–3.13 where each Django release allows it.
+## License
+
+MIT. Copyright (c) 2026 Daniil Shamraev. See [LICENSE](LICENSE).
 
 ## Publishing
 
-0.1.0 is already on PyPI. This tree is 0.2.4 and is not published from here.
+0.1.0 is already on PyPI. This tree is 0.2.7 and is not published from here.
 
-1. Tag `0.2.4` when you want a release.
+1. Tag `0.2.7` when you want a release.
 2. Build: `uv build`.
 3. Publish: `uv publish` with a PyPI token.
-
-Author: Daniil Shamraev. License: MIT.

{django_admin_mobile-0.2.4 → django_admin_mobile-0.2.7}/README.md

@@ -1,14 +1,56 @@
 # django-admin-mobile
 
-Phone layout for the **native** Django admin. It is not a theme: colors, typography, and chrome stay on Django's own CSS variables, including `html[data-theme]` and `prefers-color-scheme`.
+Phone ergonomics for the native Django admin. Same colors, same templates, a layout that fits a 375px screen.
 
-Targets Django 4.2 LTS, 5.x, and 6.x on Python 3.10+.
+[![PyPI](https://img.shields.io/pypi/v/django-admin-mobile)](https://pypi.org/project/django-admin-mobile/)
+[![Python versions](https://img.shields.io/pypi/pyversions/django-admin-mobile)](https://pypi.org/project/django-admin-mobile/)
+[![Django versions](https://img.shields.io/badge/Django-4.2%20%7C%205.2%20%7C%206.0-092e20)](https://docs.djangoproject.com/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![CI](https://github.com/daniilshamraev/django-admin-mobile/actions/workflows/ci.yml/badge.svg)](https://github.com/daniilshamraev/django-admin-mobile/actions/workflows/ci.yml)
 
-![Changelist at 375px](docs/screenshots/changelist-375.png)
+![Index, a selected changelist, the filter sheet, and a change form](docs/hero.png)
 
-![Change form at 375px](docs/screenshots/change-form-375.png)
+## Before / after
 
-## Install
+Stock Django admin at 375px, then the same changelist with this package.
+
+| Before | After |
+| --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/stock-changelist-375-dark.png"><img alt="Stock Django admin changelist at 375px" src="docs/screenshots/stock-changelist-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/changelist-375-dark.png"><img alt="Changelist with django-admin-mobile at 375px" src="docs/screenshots/changelist-375.png" width="250"></picture> |
+
+## Changelist
+
+Cards, a full-width action row, and a sticky bulk bar. Selecting a row hides the top action menu so Run appears once.
+
+| Cards | One row selected | Bulk bar |
+| --- | --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/changelist-375-dark.png"><img alt="Book changelist cards" src="docs/screenshots/changelist-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/payments-375-dark.png"><img alt="Payments changelist with nothing selected" src="docs/screenshots/payments-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/payments-selected-375-dark.png"><img alt="Payments changelist with the sticky bulk bar" src="docs/screenshots/payments-selected-375.png" width="250"></picture> |
+
+## Filters
+
+`FILTER_SHEET` opens filters in a bottom sheet: dimmed backdrop, grab handle, Reset, a close control, 44px rows, and Show results. Long lists get a search field. Date and range widgets stay inside the sheet. With JavaScript off, `#changelist-filter` stays inline.
+
+| Light | Dark |
+| --- | --- |
+| <img alt="Filter bottom sheet, light" src="docs/screenshots/filters-375.png" width="250"> | <img alt="Filter bottom sheet, dark" src="docs/screenshots/filters-375-dark.png" width="250"> |
+
+## Change form
+
+Native date and time inputs, stacked inlines, and a submit bar that sits above the tab bar.
+
+| Change form | Edition | History |
+| --- | --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/change-form-375-dark.png"><img alt="Book change form" src="docs/screenshots/change-form-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/edition-375-dark.png"><img alt="Edition change form" src="docs/screenshots/edition-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/history-375-dark.png"><img alt="Object history" src="docs/screenshots/history-375.png" width="250"></picture> |
+
+## Index and navigation
+
+| Index | App index | Search |
+| --- | --- | --- |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/index-375-dark.png"><img alt="Admin index" src="docs/screenshots/index-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/app-index-375-dark.png"><img alt="App index" src="docs/screenshots/app-index-375.png" width="250"></picture> | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/search-375-dark.png"><img alt="Global search" src="docs/screenshots/search-375.png" width="250"></picture> |
+
+Screenshots are the 375px viewport, light and dark. More captures live in [`docs/screenshots/`](docs/screenshots/).
+
+## Quick start
 
 ```bash
 pip install django-admin-mobile
@@ -28,7 +70,7 @@ That is enough. `admin_mobile` overrides `admin/base.html`, calls `{{ block.supe
 
 No CDN and no build step. The package ships plain files under `admin_mobile/static/`.
 
-## If you already override `admin/base.html`
+### If you already override `admin/base.html`
 
 Django will use your template and skip this app's override. Load the tag yourself, and still call `{{ block.super }}`:
 
@@ -49,19 +91,14 @@ Django will use your template and skip this app's override. Load the tag yoursel
 
 `{% admin_mobile_assets %}` emits both. If `admin_mobile` is listed after `django.contrib.admin`, system check `admin_mobile.W001` warns you.
 
-## Settings
+## Configuration
 
-All keys are optional booleans.
+Every key is optional. Unknown keys are rejected. Boolean flags must be real bools.
 
 ```python
 ADMIN_MOBILE = {
     "ENABLED": True,
-    "CHANGELIST_CARDS": True,
-    "TABULAR_INLINE_STACK": True,
-    "STICKY_SUBMIT": True,
-    "TOUCH_TARGETS": True,
-    "COLLAPSIBLE_FILTERS": True,
-    "USE_NATIVE_DATETIME": False,
+    "FILTER_SHEET": True,
 }
 ```
 
@@ -73,14 +110,14 @@ ADMIN_MOBILE = {
 | `STICKY_SUBMIT` | `True` | The last `.submit-row` sticks to the bottom of the viewport. The login page is left alone. |
 | `TOUCH_TARGETS` | `True` | Targets at least 44px, inputs at 16px (stops iOS from zooming), larger checkboxes. |
 | `COLLAPSIBLE_FILTERS` | `True` | `#changelist-filter` collapses behind a button. Django's filters, django-admin-rangefilter, and django-more-admin-filters render inside that node; this package does not import them. |
+| `FILTER_SHEET` | `True` | On a phone, filters open as a bottom sheet with Reset, a close control, an active-count badge, search on long lists, and Show results. With JavaScript off, the filter block stays inline. |
 | `USE_NATIVE_DATETIME` | `False` | Opt in to native date/time widgets on **every** `ModelAdmin` and inline. A custom `formfield_overrides` widget is kept. |
 | `BOTTOM_TABS` | `True` | Home, search, recent, and saved-model tabs. Favorites stay in `localStorage`. |
 | `GLOBAL_SEARCH` | `True` | Staff search across admins that define `search_fields`. Permissions are checked per model. |
 | `SWIPE_ACTIONS` | `True` | Swipe a card right to open it, left for Open/Delete. Delete still posts `delete_selected` after confirm. |
 | `PULL_TO_REFRESH` | `True` | Pull down on a changelist to reload. |
 | `INFINITE_SCROLL` | `False` | Fetch the next changelist page instead of using the pager. |
-| `FILTER_SHEET` | `True` | Filters open in a bottom sheet with an active-count badge and Reset. |
-| `STICKY_ACTIONS` | `True` | `Selected N`, the action menu, and Run stick above the tab bar. |
+| `STICKY_ACTIONS` | `True` | `Selected N`, the action menu, and Run stick above the tab bar. While that bar is open, the top action menu is hidden. |
 | `UNSAVED_GUARD` | `True` | `beforeunload` when a change form is dirty. |
 | `FORM_DRAFTS` | `False` | Autosave add-form text fields in `localStorage` and offer restore. Passwords and files are skipped. |
 | `CAMERA_CAPTURE` | `True` | Camera button on file inputs, with a preview. |
@@ -97,18 +134,16 @@ ADMIN_MOBILE = {
 | `ACCENT` | unset | Hex color (`#rgb` or `#rrggbb`) mapped to `--button-bg`, `--default-button-bg`, and `--object-tools-bg` for both `data-theme` values and `prefers-color-scheme`. It does not set `--accent`, because that variable is also the header title color. |
 | `PALETTE` | unset | Optional map of allow-listed admin variable names (`primary`, `header-bg`, `link-fg`, …) to hex colors. |
 | `READONLY_MODELS` | `[]` | `app.model` labels that lose add/change/delete when the `admin_mobile_viewport=mobile` cookie is set. |
-
-`MobileAdminMixin` also accepts `mobile_card_title`, `mobile_card_subtitle`, `mobile_card_image`, `mobile_list_display`, and `mobile_readonly = True`.
+| `UNDO_SECONDS` | `8` | Seconds to wait when `UNDO_DELETE` is on. An int from 5 to 10. |
+| `SWIPE_CONFIRM_ACTIONS` | `["delete_selected"]` | Action names that use the slide-to-confirm control. |
 
 `mobile_readonly` and `READONLY_MODELS` only look at a cookie the phone script sets. That is a UX guard. It does not replace permissions: a desktop client, or a client that drops the cookie, keeps the real Django permissions.
 
 Surfaces use Django admin CSS variables, including `html[data-theme]` and `prefers-color-scheme`. The service worker does not cache HTML or authenticated responses.
 
-Unknown keys are rejected. Boolean flags must be real bools. `ACCENT` and `PALETTE` must be hex.
-
-## Native date and time widgets
+## MobileAdminMixin
 
-Per model, without the global flag:
+Per model, without the global date flag:
 
 ```python
 from django.contrib import admin
@@ -118,7 +153,11 @@ from library.models import Book
 
 @admin.register(Book)
 class BookAdmin(MobileAdminMixin, admin.ModelAdmin):
-    pass
+    mobile_card_title = "title"
+    mobile_card_subtitle = "author"
+    mobile_list_display = ("status", "published_on")
+    # mobile_card_image = "cover"
+    # mobile_readonly = True
 ```
 
 `MobileAdminMixin` must come before `admin.ModelAdmin` or `admin.TabularInline`. It sets `formfield_overrides` to:
@@ -131,6 +170,12 @@ Values stay on `SplitDateTimeField` / `DateField` / `TimeField`, so Django still
 
 These widgets do **not** load `DateTimeShortcuts`, so you do not get a second calendar on top of the native picker.
 
+## Compatibility
+
+Python 3.10+ and Django 4.2 LTS, 5.2, and 6.0+. Django 6 needs Python 3.12+. `tox.ini` and GitHub Actions run that matrix.
+
+The stylesheet also covers the rest of the built-in admin at `≤600px`: login, password change, and logout; the index and app list; the nav sidebar and its filter; header, user tools, and breadcrumbs; changelist search, actions, select-all, sortable headers, date hierarchy, pagination, result counts, and `list_editable`; every built-in filter (choices, related, date, empty, and facets on Django 5+); change-form fieldsets (including collapse), help, errors, readonly fields, related-object icons, raw id lookup, autocomplete, filter horizontal/vertical, radios, and file Currently/Change/Clear; stacked and tabular inlines; object history; delete confirmation; related-object popups; messages; the stock calendar and clock when native widgets are off; admindocs; and RTL (`dir="rtl"`).
+
 ## Example
 
 ```bash
@@ -143,17 +188,11 @@ With `DEBUG` and `ADMIN_MOBILE_DEMO` (both set in `example/example/settings.py`)
 
 Open http://127.0.0.1:8741/admin/ and narrow the window to 375px, or use device mode.
 
-![Filters open](docs/screenshots/filters-375.png)
-
-![Changelist, dark](docs/screenshots/changelist-375-dark.png)
-
-The same stylesheet also covers the rest of the built-in admin at `≤600px`: login, password change, and logout; the index and app list; the nav sidebar and its filter; header, user tools, and breadcrumbs; changelist search, actions, select-all, sortable headers, date hierarchy, pagination, result counts, and `list_editable`; every built-in filter (choices, related, date, empty, and facets on Django 5+); change-form fieldsets (including collapse), help, errors, readonly fields, related-object icons, raw id lookup, autocomplete, filter horizontal/vertical, radios, and file Currently/Change/Clear; stacked and tabular inlines; object history; delete confirmation; related-object popups; messages; the stock calendar and clock when native widgets are off; admindocs; and RTL (`dir="rtl"`, logical alignment).
-
-Further 375px captures live in `docs/screenshots/` (`login`, `index`, `nav-sidebar`, `edition`, `calendar`, `clock`, `history`, `delete-confirm`, `popup`, `admindocs`, `rtl-changelist`, and others).
-
 `Appointment` in the example keeps Django's calendar and clock. `Book` and `Edition` use `MobileAdminMixin`. `USE_NATIVE_DATETIME` stays off in the example so both modes are visible.
 
-## Tests
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ```bash
 uv run ruff check .
@@ -163,14 +202,14 @@ uv run pytest -m playwright
 uv run tox
 ```
 
-`tox.ini` runs Django 4.2, 5.2, and 6.0. GitHub Actions adds Python 3.10–3.13 where each Django release allows it.
+## License
+
+MIT. Copyright (c) 2026 Daniil Shamraev. See [LICENSE](LICENSE).
 
 ## Publishing
 
-0.1.0 is already on PyPI. This tree is 0.2.4 and is not published from here.
+0.1.0 is already on PyPI. This tree is 0.2.7 and is not published from here.
 
-1. Tag `0.2.4` when you want a release.
+1. Tag `0.2.7` when you want a release.
 2. Build: `uv build`.
 3. Publish: `uv publish` with a PyPI token.
-
-Author: Daniil Shamraev. License: MIT.

{django_admin_mobile-0.2.4 → django_admin_mobile-0.2.7}/example/library/admin.py

@@ -1,6 +1,8 @@
 from __future__ import annotations
 
 from django.contrib import admin
+from django.templatetags.static import static
+from django.utils.html import format_html
 
 from admin_mobile.mixins import MobileAdminMixin
 from library.models import (
@@ -10,6 +12,7 @@ from library.models import (
     Chapter,
     Citation,
     Edition,
+    Payment,
     Publisher,
     Revision,
     Series,
@@ -142,6 +145,46 @@ class RevisionAdmin(admin.ModelAdmin):
     search_fields = ("label",)
 
 
+@admin.action(description="Отметить проверенным")
+def mark_reviewed(
+    modeladmin: admin.ModelAdmin, request: object, queryset: object
+) -> None:
+    del modeladmin, request
+    queryset.update(reviewed=True)
+
+
+@admin.register(Payment)
+class PaymentAdmin(MobileAdminMixin, admin.ModelAdmin):
+    """No card-title hint: the link column itself has to become the title."""
+
+    list_display = (
+        "id",
+        "payer",
+        "amount",
+        "system",
+        "status",
+        "paid_on",
+        "external_id",
+        "comment",
+        "currency",
+    )
+    list_display_links = ("id",)
+    list_editable = ("amount",)
+    list_per_page = 10
+    actions = (mark_reviewed,)
+
+    @admin.display(description="Пользователь")
+    def payer(self, obj: Payment) -> str:
+        return format_html(
+            '<img alt="" src="{}" width="16" height="16"> <strong>{}</strong> '
+            '(<a href="https://vk.com/id{}">vk.com/id{}</a>)',
+            static("admin/img/icon-viewlink.svg"),
+            obj.payer_name,
+            obj.vk_id,
+            obj.vk_id,
+        )
+
+
 @admin.register(Appointment)
 class AppointmentAdmin(admin.ModelAdmin):
     """Stock widgets on purpose, so the admin calendar and clock remain."""

{django_admin_mobile-0.2.4 → django_admin_mobile-0.2.7}/example/library/demo.py

@@ -26,6 +26,7 @@ def seed_demo(*args: object, **kwargs: object) -> bool:
         Chapter,
         Citation,
         Edition,
+        Payment,
         Publisher,
         Revision,
         Series,
@@ -140,4 +141,15 @@ def seed_demo(*args: object, **kwargs: object) -> bool:
         at_time=time(18, 30),
         when=timezone.make_aware(datetime(2026, 4, 2, 18, 30)),
     )
+    Payment.objects.create(
+        payer_name="Мария Александровна Волконская",
+        vk_id="123456789012345678",
+        amount="1490.50",
+        system=Payment.System.WALLET,
+        status="Оплачен",
+        paid_on=date(2026, 3, 2),
+        external_id="pay-1843-notes",
+        comment="Перевод за второе издание",
+        currency="RUB",
+    )
     return True