mirror of
https://github.com/jwinterm/modoboa.git
synced 2026-10-20 06:08:35 +02:00
117 lines
3.4 KiB
Python
117 lines
3.4 KiB
Python
from django.conf import settings
|
|
from django.conf.urls import include
|
|
|
|
|
|
class ModoExtension(object):
|
|
"""Base extension class
|
|
|
|
Each Modoboa extension must inherit from this class to be
|
|
considered as valid.
|
|
"""
|
|
name = None
|
|
label = None
|
|
version = "NA"
|
|
description = ""
|
|
url = None
|
|
needs_media = False
|
|
always_active = False
|
|
available_for_topredirection = False
|
|
|
|
def infos(self):
|
|
return dict(
|
|
name=self.name, label=self.label, version=self.version,
|
|
description=self.description, url=self.url,
|
|
always_active=self.always_active
|
|
)
|
|
|
|
def init(self):
|
|
pass
|
|
|
|
def destroy(self):
|
|
pass
|
|
|
|
def load(self):
|
|
pass
|
|
|
|
|
|
class ExtensionsPool(object):
|
|
"""The extensions manager"""
|
|
|
|
def __init__(self):
|
|
self.extensions = {}
|
|
|
|
def register_extension(self, ext, show=True):
|
|
self.extensions[ext.name] = dict(cls=ext, show=show)
|
|
|
|
def get_extension(self, name):
|
|
if not name in self.extensions:
|
|
return None
|
|
if not "instance" in self.extensions[name]:
|
|
self.extensions[name]["instance"] = self.extensions[name]["cls"]()
|
|
return self.extensions[name]["instance"]
|
|
|
|
def is_extension_enabled(self, name):
|
|
from modoboa.core.models import Extension
|
|
|
|
if not name in self.extensions:
|
|
return False
|
|
return Extension.objects.get(name=name).enabled
|
|
|
|
def get_extension_infos(self, name):
|
|
instance = self.get_extension(name)
|
|
if instance is None:
|
|
return None
|
|
return instance.infos()
|
|
|
|
def load_all(self):
|
|
"""Load all enabled extensions.
|
|
|
|
Each extension must be loaded in order to integrate with
|
|
Modoboa. Only enabled and special extensions are loaded but
|
|
urls are always returned. The reason is urls are imported only
|
|
once so must know all of them when the python process
|
|
starts. Otherwise, it would lead to unexpected 404 errors :p
|
|
|
|
:return: a list of url maps
|
|
"""
|
|
from modoboa.core.models import Extension
|
|
|
|
result = []
|
|
for ext in settings.MODOBOA_APPS:
|
|
__import__(ext)
|
|
extname = ext.split('.')[-1]
|
|
extinstance = self.get_extension(extname)
|
|
if extinstance is None:
|
|
continue
|
|
try:
|
|
baseurl = extinstance.url \
|
|
if extinstance.url is not None else extname
|
|
result += [(r'^%s/' % (baseurl),
|
|
include("%s.urls" % extinstance.__module__))]
|
|
except ImportError:
|
|
# No urls for this extension
|
|
pass
|
|
if not extinstance.always_active:
|
|
try:
|
|
ext = Extension.objects.get(name=extname)
|
|
if not ext.enabled:
|
|
continue
|
|
except Extension.DoesNotExist:
|
|
continue
|
|
extinstance.load()
|
|
return result
|
|
|
|
def list_all(self):
|
|
"""List all defined extensions.
|
|
"""
|
|
result = []
|
|
for extname, extdef in self.extensions.iteritems():
|
|
if not extdef["show"]:
|
|
continue
|
|
infos = self.get_extension_infos(extname)
|
|
infos["id"] = extname
|
|
result += [infos]
|
|
return sorted(result, key=lambda i: i["name"])
|
|
|
|
exts_pool = ExtensionsPool()
|