analytics/tracker
RobertJoonas 135471c32e
Add tagged-events script extension (#2333)
Adds a new script extension that allows tracking interactions with specific HTML elements on a website. For example - to track link clicks on one specific `<a>` element, you can tag it like this:

```html
<a href=... class="plausible-event-name=<your_event_name>">
```

And you can also tag the link with custom property names and values:

```html
<a href=... class="plausible-event-name=<your_event_name> plausible-event-<your_custom_prop>=<your_value>">
```

Tagging a link as above will send a custom event with the given name and props, if a `click` or `auxclick` browser event happens, and targets the link element.

The tracking behavior is somewhat different based on the HTML element type:  

- `<a>` 
  - triggers on `click` and `auxclick` events
  - intercepts navigation based on the same rules as `outbound-links` and `file-downloads`
- `<form>`
  - triggers on `submit` event
  - always intercepts navigation (calls `form.submit()` after preventing default and sending the Plausible event)
- other (`<img>`, `<button>`, `<span>`, `<div>`, `<h2>`, etc ...)
  - triggers on `click` and `auxclick` events
  - does not prevent default to intercept possible navigation. Simply calls Plausible with the event name and props read from the element class list.
2022-11-21 16:17:44 +02:00
..
src Add tagged-events script extension (#2333) 2022-11-21 16:17:44 +02:00
test Add tagged-events script extension (#2333) 2022-11-21 16:17:44 +02:00
.eslintrc.json Add basic test harness for browserstack/playwright (#1961) 2022-08-04 11:50:09 +03:00
compile.js Add tagged-events script extension (#2333) 2022-11-21 16:17:44 +02:00
LICENSE.md Change Javascript license to MIT (#369) 2020-10-16 11:08:58 +03:00
package-lock.json Remove static tracker files (#2116) 2022-10-11 12:19:28 +02:00
package.json Remove static tracker files (#2116) 2022-10-11 12:19:28 +02:00