Settings

Add these settings to your settings.py file to override the defaults.

CONVERSATE_PAGE_SIZE

Number of lines to show on a page

Default: 100

CONVERSATE_IDLE_AT:

The time until the UI decides that the user is idle (in ms)

Default: 60*1000

CONVERSATE_POLL_MIN:

Minimum poll interval (in ms)

Default: 5 * 1000

CONVERSATE_POLL_MAX:

Maximum poll interval (in ms)

Default: 60 * 1000

CONVERSATE_POLL_STEP:

Amount to increase poll interval by when there is no activity (in ms)

Default: 5 * 1000

CONVERSATE_CONTROL_LAYOUT:

If True, Conversate’s JavaScript will control the layout: * changes the container element to position:relative and padding:0 * maximises container element’s height into available space in the window * makes the conversation scroll in place * moves the input field to the bottom of the container

Default: True

CONVERSATE_DISCONNECT_AT:

How long before marking the user as disconnected (in secs)

Defaults to POLL_MAX plus 30 seconds, 60 + 30

CONVERSATE_EMAIL_FROM:

From address for alert e-mails

Default: DEFAULT_FROM_EMAIL (from main Django settings)

CONVERSATE_STORE_ROOT:

Path to dir where uploaded files are stored.

This should not be publicly accessible otherwise files could be downloaded without permission. The default value is the media root so that it works out of the box, but this is insecure as permission checks can be bypassed.

Example: os.path.join(BASE_DIR, "..", "private")

Default: MEDIA_ROOT

Templates and styles

The Conversate templates extend conversate/base.html, which in turn extends base.html. The templates use HTML5 elements.

They will expect the following blocks:

• js for inserting JavaScript

• css for inserting CSS

• title for inserting the title (plain text) - or {{ title }} instead

• content for the body content

You will need to add these to your base.html template. Alternatively, if you already have the blocks but with different names, create conversate/base.html in your own templates folder and map them; for example:

{% block script %}
    {{ block.super }}
    {% block js %}{% endblock %}
{% endblock %}

Once you have mapped these blocks, the default settings and templates should work out of the box with most designs. However, the conversate container element in your site’s base template should be given a fixed height and width to contain the chat interface.

There is a single global JavaScript variable used, CONVERSATE, which the template uses to pass settings and variables to the JavaScript.