https://github.com/jhthorsen/mojolicious-plugin-surveil

Surveil user actions
https://github.com/jhthorsen/mojolicious-plugin-surveil

Last synced: about 1 month ago
JSON representation

Surveil user actions

• Host: GitHub
• URL: https://github.com/jhthorsen/mojolicious-plugin-surveil
• Owner: jhthorsen
• Created: 2014-07-24T07:03:34.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2018-12-21T00:44:32.000Z (about 6 years ago)
• Last Synced: 2024-10-16T11:58:30.367Z (3 months ago)
• Language: Perl
• Size: 19.5 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# NAME

Mojolicious::Plugin::Surveil - Surveil user actions

# VERSION

0.03

# DESCRIPTION

[Mojolicious::Plugin::Surveil](https://metacpan.org/pod/Mojolicious::Plugin::Surveil) is a plugin which allow you to see every

event a user trigger on your web page. It is meant as a debug tool for

seeing events, even if the browser does not have a JavaScript console.

CAVEAT: The JavaScript that is injected require WebSocket in the browser to

run. The surveil events are attached to the "body" element, so any other event

that prevent events from bubbling will not emit this to the WebSocket

resource.

# SYNOPSIS

## Application

    use Mojolicious::Lite;

    plugin "surveil";

## In your browser

Visit [http://localhost:3000?\_surveil=1](http://localhost:3000?_surveil=1) to enable the logging. Try clicking

around on your page and look in the console for log messages.

## Custom event handler

    use Mojo::Redis;

    use Mojo::JSON "encode_json";

    plugin "surveil", {

      handler => sub {

        my ($c, $event) = @_;

        my $ip = $c->tx->remote_address;

        $c->redis->pubsub->notify("surveil:$ip" => encode_json $event);

      }

    };

The above example is useful if you want to publish the events to

[Redis](https://metacpan.org/pod/Mojo::Redis) instead of a log file. A developer can then run commands

below to see what a given user is doing:

    $ redis-cli psubscribe "surveil:*"

    $ redis-cli subscribe "surveil:192.168.0.100"

# METHODS

## register

    $self->register($app, \%config);

    $app->plugin("surveil" => \%config);

Used to add an "after\_render" hook into the application which adds a

JavaScript to every HTML document when the ["enable\_param"](#enable_param) is set.

`%config` can have the following settings:

- enable\_param

    Used to specify a query parameter to be part of the URL to enable surveil.

    Default is "\_surveil".

- events

    The events that should be reported back over the WebSocket.

    Defaults to blur, click, focus, touchstart, touchcancel and touchend.

    Note that the default list might change in the future.

- handler

    A code ref that handles the events from the web page. This is useful if you

    want to post them to an event bus instead of in the log file.

- path

    The path to the WebSocket route.

    Defaults to `/mojolicious/plugin/surveil`.

# COPYRIGHT AND LICENSE

Copyright (C) 2014-2018, Jan Henning Thorsen

This program is free software, you can redistribute it and/or modify it under

the terms of the Artistic License version 2.0.

# AUTHOR

Jan Henning Thorsen - `[email protected]`