trigger custom

analytical/templatetags/uservoice.py

@@ -61,7 +61,9 @@ class UserVoiceNode(Node):
         options = {}
         options.update(getattr(settings, 'USERVOICE_WIDGET_OPTIONS', {}))
         options.update(context.get('uservoice_widget_options', {}))
-        trigger = getattr(settings, 'USERVOICE_ADD_TRIGGER', True)
+
+        trigger = context.get('uservoice_add_trigger',
+                              getattr(settings, 'USERVOICE_ADD_TRIGGER', True))
 
         html = TRACKING_CODE % {'widget_key': widget_key,
                                 'options':  simplejson.dumps(options),

docs/services/uservoice.rst

@@ -129,6 +129,30 @@ with ``uservoice_widget_key``:
 These variable passed in the context overrides the default
 widget configuration.
 
+
+.. _uservoice-link:
+
+Using a custom link
+-------------------
+
+Instead of showing the default feedback icon or tab, you can make the UserVoice
+widget launch when a visitor clicks a link or when some other event
+occurs. As the `documentation describe <https://developer.uservoice.com/docs/widgets/methods/#custom-trigger>`_, simply add the ``data-uv-trigger`` HTML attribute to the element. For example::
+
+    <a href="mailto:questions@uservoice.com" data-uv-trigger>Contact us</a>
+
+
+In order to hidden the default trigger, you should disable it putting
+``uservoice_add_trigger`` to ``False``.
+
+    context = RequestContext({'uservoice_add_trigger': False})
+    return your_template_with_custom_uservoice_link.render(context)
+
+If you want to disable the automatic trigger globally, set in :file:`settings.py`::
+
+    USERVOICE_ADD_TRIGGER = False
+
+
 Setting the widget key in a context processor
 .............................................