Repository navigation
Releases
Releases · qiyascc/django-sightline
0.4.0
0.4.0
- New opt-in
CAPTURE_INPUTS(defaultFalse). When on, the tracker
records what was typed intoinput,textareaandselectfields,
once the field settles (about 0.8 s after the last key, on change, on
blur, on submit and when the page is left), cut to 160 characters, with
the field'sname, id, label or placeholder. Fields inside
MASK_SELECTORSstill record nothing. Password fields record only their
length as*unlessCAPTURE_PASSWORDSis also on. File inputs never
record a value. - The replay lists every typed value under its page, and fills the fields
in as playback passes them. - With
CAPTURE_INPUTSoff the collect endpoint drops any value or
metadata sent with an input event, so the default stays "typing only".
0.3.0
Security release. Upgrading changes two defaults; read the last two points.
- Fixed stored XSS in the replay player. A path sent to the public collect
endpoint was written into the step list as HTML. The list is now built
with DOM nodes and text. - Paths are validated at ingest. Only plain site paths are accepted (one
leading slash, no backslash, no markup); anything else gets a 400. The
player only fetches same site paths, and the heatmap links in the panel
and the admin are only rendered for safe paths. - The overlay and tracker config is escaped for inline scripts, so a
craftedsl_pathlink can no longer break out of the script tag. - The collect endpoint is throttled per address:
THROTTLE_BATCHES
(600 perTHROTTLE_BATCHES_SECONDS, 600) andTHROTTLE_SESSIONS
(60 new visits perTHROTTLE_SESSIONS_SECONDS, 3600), answering 429,
counted in the cache named byTHROTTLE_CACHE. MAX_EVENTS_PER_SESSION(5000) caps a visit,MAX_META_BYTES(1024)
caps the eventmetaJSON, and withRESOLVE_PATHS(on) only paths
that the URLconf serves create pages.- A stored page title is no longer overwritten by later batches.
sightline_prunealso deletes heatmap rollups older than
ROLLUP_RETAIN_DAYS(365,0keeps them) and pages left with no visit
and no rollup. New--rollup-daysoption.- Default changed: the panel, replays, heat data and overlay need the
permission inPERMISSION,sightline.view_sessionby default, on top
of staff status. Superusers pass. Grant it to your viewers or set
"PERMISSION": Nonefor the old behaviour. - Default changed: the client address no longer trusts the first
X-Forwarded-Forentry, which the client controls.IP_SOURCEdefaults
to"remote_addr"; behind a proxy set"x-real-ip"or"xff-last",
or every visitor shares one throttle bucket and visitor keys collapse. - No migration.
0.2.0
First release on PyPI.
pip install django-cc-sightlineOn PyPI: https://pypi.org/project/django-cc-sightline/0.2.0/
Click heatmaps, scroll maps and session replay for Django, with an admin panel and a live overlay you open on the real site. Everything is stored in your own database.
The name django-sightline on PyPI belongs to an unrelated project, so this one is published as django-cc-sightline. Inside Django it is still the sightline app.
What changed since 0.1.3 is in the changelog. Django 4.2 to 6.1, Python 3.10 and up. The wheel and the source archive below are the same files that were uploaded to PyPI.