mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-02-04 08:13:38 +00:00
In a module, when URL is not avialable for a shortcut, send None instead of an implementation specific detail on how to show description. This allows use to change the implementation of how description is shown without changes to modules.
108 lines
3.0 KiB
Python
108 lines
3.0 KiB
Python
#
|
|
# This file is part of Plinth.
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU Affero General Public License as
|
|
# published by the Free Software Foundation, either version 3 of the
|
|
# License, or (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU Affero General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Affero General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
#
|
|
|
|
"""
|
|
Plinth module to configure Mumble server
|
|
"""
|
|
|
|
from django.utils.translation import ugettext_lazy as _
|
|
|
|
from plinth import actions
|
|
from plinth import action_utils
|
|
from plinth import cfg
|
|
from plinth import frontpage
|
|
from plinth import service as service_module
|
|
from plinth.views import ServiceView
|
|
|
|
|
|
version = 1
|
|
|
|
depends = ['apps']
|
|
|
|
title = _('Voice Chat (Mumble)')
|
|
|
|
service = None
|
|
|
|
managed_services = ['mumble-server']
|
|
|
|
managed_packages = ['mumble-server']
|
|
|
|
description = [
|
|
_('Mumble is an open source, low-latency, encrypted, high quality '
|
|
'voice chat software.'),
|
|
|
|
_('You can connect to your Mumble server on the regular Mumble port '
|
|
'64738. <a href="http://mumble.info">Clients</a> to connect to Mumble '
|
|
'from your desktop and Android devices are available.')
|
|
]
|
|
|
|
|
|
def init():
|
|
"""Intialize the Mumble module."""
|
|
menu = cfg.main_menu.get('apps:index')
|
|
menu.add_urlname(title, 'glyphicon-headphones', 'mumble:index')
|
|
|
|
global service
|
|
service = service_module.Service(
|
|
managed_services[0], title, ports=['mumble-plinth'], is_external=True,
|
|
enable=enable, disable=disable)
|
|
|
|
if service.is_enabled():
|
|
add_shortcut()
|
|
|
|
|
|
class MumbleServiceView(ServiceView):
|
|
service_id = managed_services[0]
|
|
diagnostics_module_name = "mumble"
|
|
description = description
|
|
|
|
|
|
def setup(helper, old_version=None):
|
|
"""Install and configure the module."""
|
|
helper.install(managed_packages)
|
|
helper.call('post', service.notify_enabled, None, True)
|
|
helper.call('post', add_shortcut)
|
|
|
|
|
|
def add_shortcut():
|
|
frontpage.add_shortcut('mumble', title, None, 'glyphicon-headphones',
|
|
description)
|
|
|
|
|
|
def enable():
|
|
"""Enable the module."""
|
|
actions.superuser_run('service', ['enable', managed_services[0]])
|
|
add_shortcut()
|
|
|
|
|
|
def disable():
|
|
"""Disable the module."""
|
|
actions.superuser_run('service', ['disable', managed_services[0]])
|
|
frontpage.remove_shortcut('mumble')
|
|
|
|
|
|
def diagnose():
|
|
"""Run diagnostics and return the results."""
|
|
results = []
|
|
|
|
results.append(action_utils.diagnose_port_listening(64738, 'tcp4'))
|
|
results.append(action_utils.diagnose_port_listening(64738, 'tcp6'))
|
|
results.append(action_utils.diagnose_port_listening(64738, 'udp4'))
|
|
results.append(action_utils.diagnose_port_listening(64738, 'udp6'))
|
|
|
|
return results
|