Docs

Documentation

Wiki collaboratif pour Django Admin — édition dans le navigateur, recherche Postgres. Package PyPI : django-admin-wiki.

1. Installation on-premise

Prérequis : Python ≥ 3.10, Django ≥ 4.2 et < 6. PostgreSQL recommandé pour la recherche full-text.

pip install django-admin-wiki

# settings.py
INSTALLED_APPS = [
    ...,
    "django.contrib.postgres",  # si Postgres FTS
    "django_summernote",
    "django_admin_wiki",
]

MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR / "media"

DJANGO_ADMIN_WIKI = {
    "STORAGE": "local",
    "SEARCH_BACKEND": "postgres",  # ou "fallback"
    "SEARCH_CONFIG": "french",
    "EDITOR": "summernote",
    "URL_PREFIX": "wiki/",
}

# urls.py
path("summernote/", include("django_summernote.urls")),
path("wiki/", include("django_admin_wiki.urls")),

python manage.py migrate
python manage.py setup_wiki_groups
python manage.py runserver

Puis ouvrez /wiki/. is_staff seul ne donne pas l’accès au wiki.

2. Droits d’accès

URL	Qui peut entrer
`/admin/`	Django Admin → `is_staff`
`/wiki/`	groupes Wiki readers ou Wiki editors

Wiki readers — ouvrir, chercher, lire
Wiki editors — créer / éditer / uploader des médias
Les superusers ont toujours un accès complet

Assignez les utilisateurs dans Django Admin → Users (ou Groups).

3. Premium cloud

Abonnez-vous sur django-admin-wiki.enprod.fr. Le tableau de bord fournit les clés API écriture et lecture seule. Aucune table wiki n’est créée dans la base du client.

INSTALLED_APPS = [..., "django_summernote", "django_admin_wiki"]

MIGRATION_MODULES = {"django_admin_wiki": None}

DJANGO_ADMIN_WIKI = {
    "STORAGE": "cloud",
    "CLOUD_API_URL": "https://django-admin-wiki.enprod.fr",
    "CLOUD_API_KEY": "daw_live_...",        # écriture (editors)
    "CLOUD_API_KEY_READ": "daw_live_...",   # lecture (readers)
    "EDITOR": "summernote",
}

Les droits suivent toujours l’utilisateur Django du projet hôte. Le compte Premium ne gère que la facturation et les clés API.

4. Médias & éditeur

Les images sont uploadées en fichiers (pas de base64 en base). Par défaut : filesystem sous DOCS_DIR/uploads/ via POST /wiki/media/upload/.

S3 optionnel (on-premise) :

pip install "django-admin-wiki[s3]"
# MEDIA_BACKEND = "django" + STORAGES["default"] = S3

Éditeur alternatif : EDITOR="textarea" (ou widget custom).

5. Import MkDocs

Mode local uniquement :

python manage.py import_mkdocs
python manage.py refresh_wiki_search_vectors  # Postgres