add links to webmail, phpmyadmin and phppgadmin

- add new links dropdown to top navigation in template base.html
- add new settings GVA_LINK_WEBMAIL, GVA_LINK_PHPMYADMIN and
  GVA_LINK_PHPPGADMIN to gnuviechadmin.settings.base
- implement gnuviechadmin.context_processors.navigation to add links to
  request context of non-AJAX requests
- add generated documentation for gnuviechadmin.context_processors
- add changelog entry

gnuviechadmin/gnuviechadmin/context_processors.py

@@ -0,0 +1,27 @@
+"""
+This module provides context processor implementations for gnuviechadmin.
+
+"""
+from __future__ import absolute_import, unicode_literals
+
+from django.conf import settings
+
+
+def navigation(request):
+    """
+    Add navigation items to the request context.
+
+    :param request: Django :py:class:`HttpRequest <django.http.HttpRequest>`
+    :return: new context items
+    :rtype: dict
+
+    """
+    if request.is_ajax():
+        return {}
+    context = {
+        'webmail_url': settings.GVA_LINK_WEBMAIL,
+        'phpmyadmin_url': settings.GVA_LINK_PHPMYADMIN,
+        'phppgadmin_url': settings.GVA_LINK_PHPPGADMIN,
+        'active_item': 'dashboard',
+    }
+    return context

gnuviechadmin/gnuviechadmin/settings/base.py

@@ -171,6 +171,8 @@ TEMPLATE_CONTEXT_PROCESSORS = (
     # allauth specific context processors
     'allauth.account.context_processors.account',
     'allauth.socialaccount.context_processors.socialaccount',
+    # custom context processors
+    'gnuviechadmin.context_processors.navigation',
 )
 
 # See: https://docs.djangoproject.com/en/dev/ref/settings/#template-loaders
@@ -359,4 +361,8 @@ OSUSER_SFTP_GROUP = 'sftponly'
 OSUSER_SSH_GROUP = 'sshusers'
 OSUSER_DEFAULT_GROUPS = [OSUSER_SFTP_GROUP]
 OSUSER_UPLOAD_SERVER = get_env_variable('GVA_OSUSER_UPLOADSERVER')
+
+GVA_LINK_WEBMAIL = get_env_variable('GVA_WEBMAIL_URL')
+GVA_LINK_PHPMYADMIN = get_env_variable('GVA_PHPMYADMIN_URL')
+GVA_LINK_PHPPGADMIN = get_env_variable('GVA_PHPPGADMIN_URL')
 ########## END CUSTOM APP CONFIGURATION