class_template.inc 10.78 KiB
<?php
/*
  This code is part of FusionDirectory (http://www.fusiondirectory.org/)
  Copyright (C) 2014-2016  FusionDirectory
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 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 General Public License for more details.
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
/*!
 * \file class_template.inc
 * Source code for the class template
/*! \brief Class for applying a template */
class template
  protected $type;
  protected $dn;
  protected $needed;
  protected $attrs;
  protected $tabObject;
  protected $attributes;
  protected $applied = FALSE;
  static protected $uiSpecialAttributes = array('dn','cn','uid','sn','givenName');
  static function plInfo()
    return array(
      'plShortName'   => _('Template'),
      'plDescription' => _('Object template, used to create several objects with similar values'),
      /* Categories for templates are computed in config class */
      'plCategory'    => array(),
      'plProvidedAcls' => array(
        'template_cn' => _('Template name')
  static function getTemplatedTypes()
    $result = array();
    $types  = objects::types();
    foreach ($types as $type) {
      if (in_array($type, departmentManagement::getDepartmentTypes())) {
        continue;
      $infos = objects::infos($type);
      if ($infos['templateActive']) {
        $result[$type] = $infos['name'];
    asort($result);
    return $result;
7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
function __construct($type, $dn, $targetdn = NULL) { $this->type = $type; $this->dn = $dn; list($this->attrs, $depends) = templateHandling::fetch($this->dn); $this->needed = templateHandling::neededAttrs($this->attrs, $depends); $this->needed[] = 'base'; if ($targetdn === NULL) { $this->tabObject = objects::create($this->type); } else { trigger_error("This should not be used for now"); $this->tabObject = objects::open($this->dn, $this->type); } $tempTabObject = objects::open($this->dn, $this->type); /* Used to know which tab is activated */ $this->attributes = array(); $tempTabObject->setActiveTabs($this->tabObject); foreach ($this->tabObject->by_object as $class => $tab) { if ($tab->is_account || $tab->ignore_account) { $this->attributes[$class] = array(); $attrs = array_unique(array_merge($tab->getRequiredAttributes(), $this->needed)); foreach (array_keys($tab->attributesAccess) as $attr) { if (!$tab->showInTemplate($attr, $this->attrs)) { continue; } if (in_array($attr, $attrs)) { $this->attributes[$class][] = $attr; } } if (empty($this->attributes[$class])) { /* Do not show empty sections */ unset($this->attributes[$class]); } } } } /*! \brief Used when you need to re-apply the same template with different values */ function reset() { list($this->attrs, $depends) = templateHandling::fetch($this->dn); // This is needed because it removes %askme% values from attrs $this->needed = templateHandling::neededAttrs($this->attrs, $depends); $this->needed[] = 'base'; $this->tabObject = objects::create($this->type); /* Used to know which tab is activated */ $tempTabObject = objects::open($this->dn, $this->type); foreach ($tempTabObject->by_object as $class => $plugin) { if ($plugin->is_account || $plugin->ignore_account) { $this->tabObject->by_object[$class]->is_account = $plugin->is_account; } } $this->applied = FALSE; } function getDn() { return $this->dn; } function getBase() { if (is_object($this->tabObject)) { return $this->tabObject->getBaseObject()->base; } else { $infos = objects::infos($this->type); return dn2base($this->dn, 'ou=templates,'.$infos['ou']); } } function getNeeded()
141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
{ return $this->attributes; } function alterAttributes($mandatories, $readonly, $hidden) { foreach ($mandatories as $class => $attrs) { foreach ($attrs as $attr) { if (!in_array($attr, $this->attributes[$class])) { $this->attributes[$class][] = $attr; } $this->tabObject->by_object[$class]->attributesAccess[$attr]->setRequired(TRUE); } } foreach ($readonly as $class => $attrs) { foreach ($attrs as $attr) { if (!in_array($attr, $this->attributes[$class])) { $this->attributes[$class][] = $attr; } $this->tabObject->by_object[$class]->attributesAccess[$attr]->setDisabled(TRUE); } } foreach ($hidden as $class => $attrs) { foreach ($attrs as $attr) { if (!in_array($attr, $this->attributes[$class])) { $this->attributes[$class][] = $attr; } $this->tabObject->by_object[$class]->attributesAccess[$attr]->setDisabled(TRUE); $this->tabObject->by_object[$class]->attributesAccess[$attr]->setVisible(FALSE); } } } /*! \brief Serialize this template for webservice */ function serialize() { $ret = array(); foreach ($this->tabObject->by_object as $class => $plugin) { if (!isset($this->attributes[$class])) { continue; } $ret[$class] = array('name' => $this->tabObject->by_name[$class], 'attrs' => array()); foreach ($this->attributes[$class] as $attr) { $plugin->attributesAccess[$attr]->serializeAttribute($ret[$class]['attrs'], FALSE); } $ret[$class]['attrs_order'] = array_keys($ret[$class]['attrs']); } return $ret; } /*! \brief Deserialize values into the template */ function deserialize($values) { foreach ($values as $class => $class_values) { $result = $this->tabObject->by_object[$class]->deserializeValues($class_values); if ($result !== TRUE) { return $result; } } return TRUE; } /*! \brief Get all attribute values * * this produces a format that you can send to setValues later (after a reset for instance) */ function getValues()
211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
{ $ret = array(); foreach ($this->tabObject->by_object as $class => $plugin) { $ret[$class] = array(); foreach ($plugin->attributesAccess as $name => $attr) { $ret[$class][$name] = $attr->getValue(); } } return $ret; } /*! \brief Set values */ function setValues($values) { foreach ($values as $class => $class_values) { foreach ($class_values as $name => $value) { $this->tabObject->by_object[$class]->attributesAccess[$name]->setValue($value); } } } function save_object() { foreach ($this->tabObject->by_object as $plugin) { $plugin->save_object(); } } public function dialogOpened () { return $this->tabObject->dialogOpened(); } function execute() { $smarty = get_smarty(); $sections = array(); $posted = array(); $smarty->assign('baseACL', 'rw'); foreach ($this->tabObject->by_object as $class => &$plugin) { if (!isset($this->attributes[$class])) { continue; } if ($plugin->is_modal_dialog()) { $dialogResult = $plugin->dialog->execute(); if ($dialogResult === FALSE) { $plugin->closeDialog(); } else { $this->tabObject->current = $class; return $dialogResult; } } $attributesRendered = array(); foreach ($this->attributes[$class] as $attr) { if ($plugin->attributesAccess[$attr]->getAclInfo() !== FALSE) { // We assign ACLs so that attributes can use them in their template code $smarty->assign($plugin->attributesAccess[$attr]->getAcl().'ACL', $plugin->aclGetPermissions($plugin->attributesAccess[$attr]->getAcl())); } $plugin->attributesAccess[$attr]->renderAttribute($attributesRendered, FALSE); } $smarty->assign('section', $this->tabObject->by_name[$class]); $smarty->assign('sectionId', $class); $smarty->assign('sectionClasses', ' fullwidth'); $smarty->assign('attributes', $attributesRendered); $posted[] = $class.'_posted'; $sections[] = $smarty->fetch(get_template_path('simpleplugin_section.tpl'));
281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350
} unset($plugin); $smarty->assign('sections', $sections); $smarty->assign('hiddenPostedInput', $posted); $smarty->assign('focusedField', ''); return $smarty->fetch(get_template_path('simpleplugin.tpl')); } /* Apply template and current values to an object and returns it for saving or edition * Cannot be called twice! If you need to, call reset between calls */ function apply($targetdn = NULL) { if ($this->applied) { trigger_error('Templates can’t be applied twice without calling reset before'); return; } if ($targetdn !== NULL) { $this->tabObject = objects::open($targetdn, $this->type); unset($this->attrs['objectClass']['count']); foreach ($this->tabObject->by_object as $class => $plugin) { if ($plugin->is_account || $plugin->ignore_account) { $this->attrs['objectClass'] = $plugin->mergeObjectClasses($this->attrs['objectClass']); } } } foreach ($this->tabObject->by_object as $class => &$plugin) { if (!isset($this->attributes[$class])) { continue; } foreach ($this->attributes[$class] as $attr) { $plugin->attributesAccess[$attr]->fillLdapValue($this->attrs); } } unset($plugin); foreach ($this->tabObject->by_object as $class => &$plugin) { if (!isset($this->attributes[$class])) { continue; } foreach ($this->attributes[$class] as $attr) { $plugin->attributesAccess[$attr]->fillLdapValueHook($this->attrs); } } unset($plugin); foreach ($this->attrs as &$array) { if (!is_array($array)) { $array = array($array); } if (!isset($array['count'])) { $array['count'] = count($array); } } unset($array); $ui = get_userinfo(); $specialAttrs = array(); foreach (static::$uiSpecialAttributes as $attr) { $specialAttrs['caller'.strtoupper($attr)] = $ui->$attr; } $this->attrs = templateHandling::parseArray($this->attrs, $specialAttrs); $this->tabObject->adapt_from_template($this->attrs, array_merge(...array_values($this->attributes))); $this->applied = TRUE; return $this->tabObject; } }