# -*- coding: utf-8 -*-
#
# Copyright 2011-2022 Univention GmbH
#
# https://www.univention.de/
#
# All rights reserved.
#
# The source code of this program is made available
# under the terms of the GNU Affero General Public License version 3
# (GNU AGPL V3) as published by the Free Software Foundation.
#
# Binary versions of this program provided by Univention to you as
# well as other copyrighted, protected or trademarked materials like
# Logos, graphics, fonts, specific documentations and configurations,
# cryptographic keys etc. are subject to a license agreement between
# you and Univention and not subject to the GNU AGPL V3.
#
# In the case you use this program under the terms of the GNU AGPL V3,
# the program is provided 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 with the Debian GNU/Linux or Univention distribution in file
# /usr/share/common-licenses/AGPL-3; if not, see
# <https://www.gnu.org/licenses/>.
"""
|UDM| module for extended options
"""
from univention.admin.layout import Tab, Group
import univention.admin.filter
import univention.admin.handlers
import univention.admin.localization
from univention.debug import debug, ADMIN, INFO
translation = univention.admin.localization.translation('univention.admin.handlers.settings')
_ = translation.translate
module = 'settings/extended_options'
operations = ['add', 'edit', 'remove', 'search', 'move']
superordinate = 'settings/cn'
childs = False
short_description = _('Settings: Extended option')
object_name = _('Extended option')
object_name_plural = _('Extended options')
long_description = _('Options for extended attributes')
options = {
'default': univention.admin.option(
short_description=short_description,
default=True,
objectClasses=['top', 'univentionUDMOption'],
),
}
property_descriptions = {
'name': univention.admin.property(
short_description=_('Name'),
long_description=_('Name'),
syntax=univention.admin.syntax.string,
include_in_default_search=True,
required=True,
may_change=False,
identifies=True,
),
'shortDescription': univention.admin.property(
short_description=_('Default short description'),
long_description=_('Short description for the option as shown on the Option tab.'),
syntax=univention.admin.syntax.string,
include_in_default_search=True,
required=True,
),
'longDescription': univention.admin.property(
short_description=_('Default long description'),
long_description=_('Long description for the option as shown on the Option tab.'),
syntax=univention.admin.syntax.string,
include_in_default_search=True,
),
'translationShortDescription': univention.admin.property(
short_description=_('Translations of short description'),
long_description=_('Translations of the short description for the option as shown on the Option tab'),
syntax=univention.admin.syntax.translationTupleShortDescription,
multivalue=True,
include_in_default_search=True,
),
'translationLongDescription': univention.admin.property(
short_description=_('Translations of long description'),
long_description=_('Translations of the long description for the option as shown on the Option tab'),
syntax=univention.admin.syntax.translationTupleLongDescription,
multivalue=True,
include_in_default_search=True,
),
'default': univention.admin.property(
short_description=_('Default'),
long_description=_('Enable option by default.'),
syntax=univention.admin.syntax.boolean,
),
'editable': univention.admin.property(
short_description=_('Editable'),
long_description=_('Option may be repeatedly turned on and off.'),
syntax=univention.admin.syntax.boolean,
),
'module': univention.admin.property(
short_description=_('Needed module'),
long_description=_('List of modules this option applies to.'),
syntax=univention.admin.syntax.univentionAdminModules,
multivalue=True,
required=True,
),
'objectClass': univention.admin.property(
short_description=_('LDAP object class'),
long_description=_('Mapping to LDAP objectClasses'),
syntax=univention.admin.syntax.ldapObjectClass,
multivalue=True,
),
'isApp': univention.admin.property(
short_description=_('Application'),
long_description=_('Specifies that the option belongs to a UCS Application'),
syntax=univention.admin.syntax.boolean,
),
}
layout = [
Tab(_('General'), _('Basic values'), layout=[
Group(_('General extended options settings'), layout=[
'name',
["shortDescription", "longDescription"],
["translationShortDescription", "translationLongDescription"],
["default", "editable", "isApp"],
['module', "objectClass"],
]),
]),
]
mapping = univention.admin.mapping.mapping()
mapping.register('name', 'cn', None, univention.admin.mapping.ListToString)
mapping.register('shortDescription', 'univentionUDMOptionShortDescription', None, univention.admin.mapping.ListToString)
mapping.register('longDescription', 'univentionUDMOptionLongDescription', None, univention.admin.mapping.ListToString)
mapping.register('default', 'univentionUDMOptionDefault', None, univention.admin.mapping.ListToString, encoding='ASCII')
mapping.register('editable', 'univentionUDMOptionEditable', None, univention.admin.mapping.ListToString, encoding='ASCII')
mapping.register('module', 'univentionUDMOptionModule')
mapping.register('objectClass', 'univentionUDMOptionObjectClass')
mapping.register('isApp', 'univentionUDMOptionIsApp', None, univention.admin.mapping.ListToString, encoding='ASCII')
[docs]class object(univention.admin.handlers.simpleLdap):
module = module
[docs] def open(self):
"""Load and parse translations."""
univention.admin.handlers.simpleLdap.open(self)
for transKey in ['ShortDescription', 'LongDescription']:
translations = [
('%s_%s' % (key[-5:-3].lower(), key[-2:].upper()), vals[0].decode('UTF-8'))
for key, vals in self.oldattr.items()
if key.startswith('univentionUDMOptionTranslation%s;entry-' % transKey)
]
debug(ADMIN, INFO, 'extended_option: added translations for %s: %s' % (transKey, translations))
self['translation%s' % transKey] = translations
self.save()
def _ldap_modlist(self):
"""Save translations."""
ml = univention.admin.handlers.simpleLdap._ldap_modlist(self)
for transKey in ['ShortDescription', 'LongDescription']:
if self.hasChanged('translation%s' % transKey):
oldlist = {}
newlist = {}
for lang, txt in self.oldinfo.get('translation%s' % transKey, []):
lang = lang.replace('_', '-')
oldlist[lang] = txt.encode('UTF-8')
if lang not in newlist:
newlist[lang] = b''
# duplicate lang entries will be removed due to use of dictionary
for lang, txt in self.info.get('translation%s' % transKey, []):
lang = lang.replace('_', '-')
newlist[lang] = txt.encode('UTF-8')
if lang not in oldlist:
oldlist[lang] = b''
# modlist for new items
for lang, txt in oldlist.items():
if txt != newlist[lang]:
ml.append(('univentionUDMOptionTranslation%s;entry-%s' % (transKey, lang), oldlist[lang], newlist[lang]))
return ml
lookup = object.lookup
lookup_filter = object.lookup_filter
identify = object.identify