Skip to main content

Add an Intercom chat widget inside the Wagtail admin

Project description

Add an Intercom widget to your Wagtail admin.

Installing

Install using pip:

$ pip install wagailadminintercom

Add it to your INSTALLED_APPS before wagtail.wagtailadmin:

INSTALLED_APPS = [
    # ...
    'wagailadminintercom',
    'wagtail.wagtailadmin',
    # ...
]

Configuring

Add WAGTAILADMIN_INTERCOM_APP_ID and WAGTAILADMIN_INTERCOM_SECRET_KEY settings to your settings file:

WAGTAILADMIN_INTERCOM_APP_ID = 'abc123'
WAGTAILADMIN_INTERCOM_SECRET_KEY = '983th8fj98hgh98dj09gj08g4w'

By default, identity verification is enabled using user IDs. This can be overridden using the WAGTAILADMIN_INTERCOM_IDENTITY_VERIFICATION setting:

WAGTAILADMIN_INTERCOM_IDENTITY_VERIFICATION = 'email'

This setting can take three possible values:

'email':
Identity verification using email addresses.
'id':
Default. Identity verification via user IDs.
None:
Disable identity verification.

The users email address is taken from the email attribute on the user model by default. If this is incorrect, it can be overridden using the WAGTAILADMIN_INTERCOM_EMAIL_ATTRIBUTE setting. Set WAGTAILADMIN_INTERCOM_EMAIL_ATTRIBUTE to None to disable sending users emails.

By default, the widget will only appear when DEBUG is False to prevent the widget appearing during development. To force the widget to show or hide itself, set the WAGTAILADMIN_INTERCOM_ENABLED setting:

WAGTAILADMIN_INTERCOM_ENABLED = True

That is it! You should now see the widget appear in the Wagtail admin.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
wagtailadminintercom-0.1.1-py2.py3-none-any.whl (7.9 kB) Copy SHA256 hash SHA256 Wheel 3.5

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page