WIP

.doc/README.md

@@ -0,0 +1,101 @@
+# Phpdoc dokuwiki template
+This directory contains a template for rendering iTop phpdoc as dokuwiki pages.
+
+
+Conventional tags that you should use:
+ * `@internal` : exclude from the documentation.
+ * `@api` : it means that a method is an api, thus it may be interacted with.
+ * `@see` : it points to another documented method
+ * `@link` : external url 
+   * if you point to another page of the wiki, please use relative links.
+ * `@example` : let you provide example of code
+ * `@param`, `@return`, `@throws`, ... 
+
+
+## Special instructions
+
+Some iTop specific tags were added : 
+ * `@api-advanced`: it means that a method is an `@api` but mark it also as "complex" to use
+ * `@overwritable-hook`: used to mark a method as "designed to be extended"
+ * `@extension-hook`: not used for now 
+ * `@phpdoc-tuning-exclude-inherited`: once this tag is present on a class, it's inherited methods won't be showed.
+
+ 
+### known limitations:
+#### `@see` tags must be very specific: 
+   * always prefix class members (attributes or methods) with `ClassName::` (do not use self) 
+   * for methods always suffix them with `()`, 
+   * do not reference variables since they are not documented. If you have to, always prefix them with `$`
+ 
+examples: 
+```
+/** 
+ * @see DBObject
+ * @see DBObject::Get()
+ * @see DBObject::$foo
+ */
+```   
+
+#### Do not use inline tags, they do not work properly, example: 
+```
+/** 
+ * This is a texts with an inline tag {@see [FQSEN] [<description>]} it must never be used 
+ */
+```
+   
+#### The `@example` tag must respect this very precise syntax 
+ * the sentence in the first line (next to the tag) is the title, it  must be enclosed by double quotes 
+ * the following lines are the sample code. 
+ * 💔 since we simply hack the official tag, this syntax must be respected carefully 💔
+example: 
+```
+/** 
+* @example "This is the title of the multiline example"
+* $foo = DBObject::Get('foo');
+* DBObject::Set('foo', ++$foo);
+*/
+```  
+    
+## How content is included into the documentation
+
+**For a class** those requirements have to be respected: 
+ - the file containing the class must be listed in `/phpdoc/files/file[]` of  `.doc/phpdoc-objects-manipulation.dist.xml`
+ - the class **must not** have the tag `@internal`
+ - the class **must** have at least one of: `@api`, `@api-advanced`, `@overwritable-hook`, `@extension-hook` 
+
+Then, **for a method** of an eligible class: 
+ - **public** methods **must** have at least one of: `@api`, `@api-advanced`, `@overwritable-hook`, `@extension-hook` 
+ - **protected** methods **must** have at least one of: `@overwritable-hook`, `@extension-hook` 
+ - **private** methods are **always excluded** 
+
+**Class properties** and **constants** are never documented (this is subject to change).
+
+
+
+
+## A note about the rendering engine
+  
+:notebook: as spaces are used to mark code, the templates (`.doc/phpdoc-templates/combodo-wiki/*`) have very few indentation, thus they are awful to read (sorry).
+
+## Installation
+
+Note : PHP7 is required. Migrating to PHP8 requires some additional work which is questionable as an alternative way to generate a documentation is being considered.
+
+```
+cd .doc
+composer require phpdocumentor/phpdocumentor:~2 --dev
+```
+
+## Generation
+
+1. Switch to this directory : `cd /path/to/itop/.doc`
+2. `composer install`
+3. `./bin/build-doc-object-manipulation`
+3. `./bin/build-doc-extensions`
+4. Get the generated files from `/path/to/itop/data/phpdocumentor/output`
+
+## Dokuwiki requirements
+ * the template uses the [wrap plugin](https://www.dokuwiki.org/plugin:wrap).
+ * the generated files have to be placed under an arbitrary directory of `[/path/to/dokuwiki]/data/pages`.
+ * the html has to be activated [config:htmlok](https://www.dokuwiki.org/config:htmlok)
+ * the generated files have to be in lowercase

.doc/bin/build-doc-extensions

@@ -0,0 +1,6 @@
+#!/bin/sh -x
+
+rm -rf /tmp/phpdoc-twig-cache/ && rm -rf data/phpdocumentor/output/extensions/ && rm -rf data/phpdocumentor/temp/extensions/ && ./vendor/bin/phpdoc -c ./phpdoc-extensions.dist.xml -vvv
+
+# now wee need to lowercase every generated file because dokuwiki can't handle uppercase
+cd ../data/phpdocumentor/output/extensions/ && for i in $(ls | grep [A-Z]); do mv -i $i $(echo $i | tr 'A-Z' 'a-z'); done

.doc/bin/build-doc-object-manipulation

@@ -0,0 +1,7 @@
+#!/bin/sh -x
+
+rm -rf /tmp/phpdoc-twig-cache/ &&  rm -rf ../data/phpdocumentor/output/objects-manipulation/ &&  rm -rf ../data/phpdocumentor/temp/objects-manipulation/ && ./vendor/bin/phpdoc -c ./phpdoc-objects-manipulation.dist.xml -vvv
+
+
+# now wee need to lowercase every generated file because dokuwiki can't handle uppercase
+cd ../data/phpdocumentor/output/objects-manipulation/ && for i in $( ls | grep [A-Z] ); do mv -i $i `echo $i | tr 'A-Z' 'a-z'`; done

.doc/composer.json

@@ -0,0 +1,6 @@
+{
+    "require-dev": {
+        "phpdocumentor/phpdocumentor": "~2",
+	"jms/serializer": "1.7.*"
+    }
+}

.doc/developers.md

@@ -1,9 +0,0 @@
-# Developers
-
-## PHP Code Styles
-We use `PHP CS Fixer` to ensure code formating consistency across PHP codebase.
-You can find the configuration and instructions to run it [here](../tests/php-code-style/README.md).
-
-## PHP Static Analysis
-We use `PHPStan` to ensure code quality and to detect potential bugs in our PHP codebase.
-You can find the configuration and instructions to run it [here](../tests/php-static-analysis/README.md).

.doc/itop-version-history.md

@@ -7,8 +7,7 @@
               'git4': 'grey',
               'git5': 'grey',
               'git6': 'grey',
-              'git7': 'grey',
-              'git8': 'grey'
+              'git7': 'grey'
        }, 'gitGraph': {'showBranches': true,'mainBranchName': 'develop','rotateCommitLabel': true}} }%%
 gitGraph
     commit id: "2016-07-06" tag: "2.3.0" type: HIGHLIGHT
@@ -95,17 +94,11 @@ gitGraph
     commit id: "2024-06-25" tag: "3.2.0-beta1" type: REVERSE
     commit id: "2024-08-07" tag: "3.2.0"
     checkout support/2.7
-    commit id: "2025-02-07a" tag: "2.7.12"
+    commit id: "2025-02-25" tag: "2.7.12"
     checkout support/3.1
-    commit id: "2025-02-07b" tag: "3.1.3"
+    commit id: "2025-02-25 " tag: "3.1.3"
     checkout support/3.2
-    commit id: "2025-02-07c " tag: "3.2.1"
-    commit id: "2025-03-31 " tag: "3.2.1-1"
-    commit id: "2025-07-28 " tag: "3.2.2"
-    checkout support/2.7
-    commit id: "2025-09-25" tag: "2.7.13"
-    checkout support/3.2
-    commit id: "2026-04-27 " tag: "3.2.3"
+    commit id: "2025-02-25  " tag: "3.2.1"
 ```
 
 To learn more, check the [iTop community versions history on the official wiki](https://www.itophub.io/wiki/page?id=latest:release:start).

.doc/phpdoc-extensions.dist.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<phpdoc>
+  <title><![CDATA[iTop extensions]]></title>
+
+  <parser>
+    <target>../data/phpdocumentor/temp/extensions</target>
+  </parser>
+
+  <transformer>
+    <target>../data/phpdocumentor/output/extensions</target>
+  </transformer>
+
+  <transformations>
+    <template name="phpdoc-templates/combodo-wiki"/>
+  </transformations>
+
+  <files>
+    <file>../application/applicationextension.inc.php</file>
+  </files>
+</phpdoc>

.doc/phpdoc-objects-manipulation.dist.xml

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<phpdoc>
+
+  <!--
+    /**
+    The documentation of this file can be found here : https://docs.phpdoc.org/references/configuration.html
+    it has to be completed by the CLI parameters documentation which is more comprehensive: https://docs.phpdoc.org/references/commands/project_run.html#usage
+
+    usage:
+    vendor/bin/phpdoc -c phpdoc-objects-manipulation.dist.xml
+
+    */
+  -->
+
+  <title><![CDATA[iTop's objects manipulation API]]></title>
+
+  <parser>
+    <default-package-name>iTopORM</default-package-name>
+    <target>../data/phpdocumentor/temp/objects-manipulation</target>
+    <visibility>public,protected</visibility>
+    <markers>
+      <!--<item>TODO</item>-->
+      <!--<item>FIXME</item>-->
+    </markers>
+      <extensions>
+          <extension>php</extension>
+      </extensions>
+  </parser>
+
+  <transformer>
+    <target>../data/phpdocumentor/output/objects-manipulation</target>
+  </transformer>
+
+  <transformations>
+    <template name="phpdoc-templates/combodo-wiki"/>
+  </transformations>
+
+  <!--<logging>-->
+    <!--<level>warn</level>-->
+    <!--<paths>-->
+      <!--&lt;!&ndash;<default>data/phpdocumentor/log/objects-manipulation/{DATE}.log</default>&ndash;&gt;-->
+      <!--&lt;!&ndash;<errors>data/phpdocumentor/log/objects-manipulation/{DATE}.errors.log</errors>&ndash;&gt;-->
+
+      <!--<default>{APP_ROOT}/data/log/{DATE}.log</default>-->
+      <!--<errors>{APP_ROOT}/data/log/{DATE}.errors.log</errors>-->
+    <!--</paths>-->
+  <!--</logging>-->
+
+  <files>
+    <file>../core/dbobject.class.php</file>
+    <file>../core/dbobjectsearch.class.php</file>
+    <file>../core/metamodel.class.php</file>
+    <file>../core/dbobjectset.class.php</file>
+    <file>../core/dbsearch.class.php</file>
+    <file>../core/dbunionsearch.class.php</file>
+  </files>
+
+</phpdoc>

.doc/phpdoc-templates/combodo-wiki/class.txt.twig

@@ -0,0 +1,136 @@
+{% extends 'layout.txt.twig' %}
+
+{% block content %}
+<wrap button>[[start|🔙 Back]]</wrap>
+
+{% if node.tags['internal'] is defined %}
+====== {{ node.name }} ======
+<WRAP alert>This class is "internal", and thus is not documented!</WRAP>
+{% elseif node.tags['api'] is not defined and node.tags['api-advanced'] is not defined and node.tags['overwritable-hook'] is not defined and node.tags['extension-hook'] is not defined %}
+====== {{ node.name }} ======
+<WRAP alert>This class is neither "api", "api-advanced", "overwritable-hook" or "extension-hook", and thus is not documented!</WRAP>
+{% else %}
+
+====== {{ node.name }} ======
+
+{% if node.deprecated %}<wrap danger>deprecated</wrap>{% endif %}
+{% if node.abstract %}<wrap warning>abstract</wrap>{% endif %}
+{% if node.final %}<wrap notice>final</wrap>{% endif %}
+{% include 'includes/wrap-tags.txt.twig' with {structure:node, wrap: 'safety', wrapTags: ['api', 'api-advanced', 'overwritable-hook', 'extension-hook']} %}
+
+
+
+{% if node.deprecated %}
+=== **<del>Deprecated</del>**===
+//{{ node.tags.deprecated[0].description }}//
+{% endif %}
+
+
+== {{  node.summary|replace({"\n":""})|raw }} ==
+<html>{{ node.description|markdown|raw }}</html>
+
+
+{% include 'includes/code-examples.txt.twig' with {structure:node, title_level: '====='} %}
+
+
+{% set class = node.parent %}
+{% block hierarchy_element %}
+
+{% if class and class.name is defined and class.name|trim != '' %}
+==== parent ====
+{% set child = class %}
+{% set class = class.parent %}
+{{ block('hierarchy_element') }}
+[[{{ child.name }}|{{ child.name }}]]
+{% endif %}
+{% endblock %}
+
+
+{% for interface in node.interfaces|sort_asc %}
+{% if loop.first %}
+==== Implements ====
+{% endif %}
+{% if loop.length > 1 %}  * {% endif %}{{ interface.fullyQualifiedStructuralElementName ?: interface }}
+{% endfor %}
+
+
+{% for trait in node.usedTraits|sort_asc %}
+{% if loop.first %}
+==== Uses traits ====
+{% endif %}
+{% if loop.length > 1 %}  * {% endif %}{{ trait.fullyQualifiedStructuralElementName ?: trait }}
+{% endfor %}
+
+
+{% include 'includes/see-also.txt.twig' with {structure:node, title_level: '==='} %}
+
+{% include 'includes/tags.txt.twig' with {structure:node, title_level: '=====', blacklist:  ['link', 'see', 'abstract', 'example', 'method', 'property', 'property-read', 'property-write', 'package', 'subpackage', 'phpdoc-tuning-exclude-inherited', 'api', 'api-advanced', 'overwritable-hook', 'extension-hook', 'copyright', 'license', 'code-example']} %}
+
+{% set methods = node.inheritedMethods.merge(node.methods.merge(node.magicMethods)) %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'api'} %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'api-advanced'} %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'overwritable-hook'} %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'extension-hook'} %}
+
+
+{% include 'includes/code-examples.txt.twig' with {structure:node, title_level: '=====', sub_title_level: '=='} %}
+
+<WRAP clear />
+
+{% for method in methods|sort_asc
+    if method.visibility == 'public'
+    and (
+        method.tags['api'] is defined
+        or method.tags['api-advanced'] is defined
+        or method.tags['overwritable-hook'] is defined
+        or method.tags['extension-hook'] is defined
+    )
+    and (
+        node.tags['phpdoc-tuning-exclude-inherited'] is not defined
+        or method.parent.name == node.name
+    )
+%}
+{%- if loop.first %}
+===== Public methods =====
+{% endif %}
+{{ block('method') }}
+{% endfor %}
+{% for method in methods|sort_asc if method.visibility == 'protected' and (method.tags['overwritable-hook'] is defined or method.tags['extension-hook'] is defined) %}
+{%- if loop.first %}
+===== Protected methods =====
+{% endif %}
+{{ block('method') }}
+{% endfor %}
+
+
+
+
+
+{% set constants = node.inheritedConstants.merge(node.constants) %}
+{% if constants|length > 0 %}
+===== Constants =====
+{% for constant in constants|sort_asc %}
+{{ block('constant') }}
+{% endfor %}
+{% endif %}
+
+
+{#{% set properties = node.inheritedProperties.merge(node.properties.merge(node.magicProperties)) %}#}
+{#{% for property in properties|sort_asc if property.visibility == 'public' %}#}
+{#{%- if loop.first %}#}
+{#===== Public properties =====#}
+{#{% endif %}#}
+{#{{ block('property') }}#}
+{#{% endfor %}#}
+{#{% for property in properties|sort_asc if property.visibility == 'protected' %}#}
+{#{%- if loop.first %}#}
+{#===== Protected properties =====#}
+{#{% endif %}#}
+{#{{ block('property') }}#}
+{#{% endfor %}#}
+
+
+{%- endif %} {#{% elseif node.tags['xxx'] is not defined and ... #}
+
+<wrap button>[[start|🔙 Back]]</wrap>
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/elements/constant.txt.twig

@@ -0,0 +1,31 @@
+{% block constant %}
+
+<WRAP group box >
+<WRAP twothirds column >
+==== {{ constant.name }} ====
+</WRAP>{# twothirds column#}
+
+<WRAP third column>
+{% if constant.deprecated %}<wrap danger>deprecated</wrap> {% endif %}
+{% if (node.parent is not null and constant.parent.fullyQualifiedStructuralElementName != node.fullyQualifiedStructuralElementName) %}<wrap notice>inherited</wrap> {% endif %}
+</WRAP>{# third column#}
+
+== {{ constant.summary|replace({"\n":""})|raw }} ==
+<html>{{ constant.description|markdown|raw }}</html>
+
+{% if constant.deprecated %}
+=== Deprecated ===
+{{ constant.tags.deprecated[0].description|raw }}
+{% endif %}
+
+{% include 'includes/inherited-from.txt.twig' with {structure:constant} %}
+
+{% include 'includes/see-also.txt.twig' with {structure:constant, title_level: '=='} %}
+
+{% include 'includes/uses.txt.twig' with {structure:constant, title_level: '=='} %}
+
+{% include 'includes/tags.txt.twig' with {structure:constant, title_level: '==', blacklist:  ['link', 'see', 'var', 'deprecated', 'uses', 'package', 'subpackage', 'todo', 'code-example']} %}
+
+</WRAP>{# group #}
+
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/elements/method.txt.twig

@@ -0,0 +1,95 @@
+{% block method %}
+
+
+<WRAP group box >
+<WRAP twothirds column >
+==== {{ method.name }} ====
+</WRAP>{# twothirds column#}
+<WRAP third column >
+{% include 'includes/wrap-tags.txt.twig' with {structure:method, wrap: 'safety', wrapTags: ['api', 'api-advanced', 'overwritable-hook', 'extension-hook']} %}
+{% if method.deprecated %}<wrap danger>deprecated</wrap> {% endif %}
+{% if (node.parent is not null and method.parent.fullyQualifiedStructuralElementName != node.fullyQualifiedStructuralElementName) %}<wrap notice>inherited</wrap> {% endif %}
+{% if method.abstract %}<wrap warning>abstract</wrap> {% endif %}
+{% if method.final %}<wrap notice>final</wrap> {% endif %}
+<wrap notice>{{ method.visibility }}</wrap>
+{% if method.static %}<wrap warning>static</wrap> {% endif %}
+</WRAP>{# third column#}
+
+
+== {{  method.summary|replace({"\n":""})|raw }} ==
+<html>{{ method.description|markdown|raw }}</html>
+
+<code php>{% if method.abstract %}abstract {% endif %}{% if method.final %}final {% endif %}{{ method.visibility }} {% if method.static %}static {% endif %}{{ method.name }}({% for argument in method.arguments %}{{ argument.isVariadic ? '...' }}{{ argument.name }}{{ argument.default ? (' = '~argument.default)|raw }}{% if not loop.last %}, {% endif %}{% endfor %})</code>
+
+<WRAP twothirds column >
+
+
+=== Parameters ===
+{% if method.arguments|length > 0 -%}
+^ types ^ name ^ default ^ description ^
+{% for argument in method.arguments -%}
+| **<nowiki>{{ argument.types|join('|')|raw }}</nowiki>** | {{ argument.name }} {{ argument.isVariadic ? '<small style="color: gray">variadic</small>' }}  |   <nowiki>{{ argument.default|raw }}</nowiki>   | {{ argument.description|trim|replace("\n", ' ')|raw }} |{{ "\r\n" }}
+{%- endfor %}
+{% else %}
+//none//
+{% endif %}
+
+
+{#=== Parameters ===#}
+{#{% if method.arguments|length > 0 -%}#}
+{#{% for argument in method.arguments -%}#}
+{#== {{ argument.name }} ==#}
+
+
+{#{% set varDesc %}#}
+    {#<span style="margin:0 10px; 0 20px; font-weight: bold;">{{ argument.types|join('|') }}</span>#}
+    {#{{ argument.isVariadic ? '<small style="color: gray">variadic</small>' }}#}
+    {#{{ argument.description|raw }}#}
+{#{% endset %}#}
+{#<html>{{ varDesc|markdown|raw }}</html>#}
+{#{%- endfor %}#}
+{#{% else %}#}
+{#<wrap tip>This method has no parameter</wrap>#}
+{#{% endif %}#}
+
+
+{% if method.response and method.response.types|join() != 'void' %}
+=== Returns ===
+<html>{{ ('**' ~ method.response.types|join('|')|trim ~ '** ' ~ method.response.description)|markdown|raw }}</html>
+{% endif %}
+
+</WRAP>{# twothirds column#}
+
+<WRAP third column >
+
+{% if method.tags.throws|length > 0 or method.tags.throw|length > 0 %}
+=== Throws ===
+{% for exception in method.tags.throws -%}
+{% if loop.length > 1 %}  * {% endif %}''{{ exception.types|join('|')|raw }}'' <nowiki>{{ exception.description|raw }}</nowiki>
+{% endfor %}
+{% endif %}
+
+{% include 'includes/inherited-from.txt.twig' with {structure:method} %}
+
+{% include 'includes/see-also.txt.twig' with {structure:method, title_level: '==='} %}
+
+{% include 'includes/uses.txt.twig' with {structure:method, title_level: '==='} %}
+
+{% include 'includes/used-by.txt.twig' with {structure:method, title_level: '==='} %}
+
+{% include 'includes/tags-with-description.txt.twig' with {structure:method, title_level: '===', WRAP: 'info', tagsWithDescription: ['api', 'api-advanced', 'overwritable-hook', 'extension-hook']} %}
+
+{% include 'includes/tags.txt.twig' with {structure:method, title_level: '===', blacklist:  ['todo', 'link', 'see', 'abstract', 'example', 'param', 'return', 'access', 'deprecated', 'throws', 'throw', 'uses', 'api', 'api-advanced', 'overwritable-hook', 'extension-hook', 'used-by', 'inheritdoc', 'code-example']} %}
+
+</WRAP>{# third column#}
+
+
+
+{% include 'includes/code-examples.txt.twig' with {structure:method, title_level: '==='} %}
+
+</WRAP>{# group #}
+
+
+
+
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/elements/property.txt.twig

@@ -0,0 +1,49 @@
+{% block property %}
+
+<WRAP group box>
+<WRAP twothirds column >
+==== ${{ property.name }} ====
+</WRAP>{# twothirds column#}
+
+<WRAP third column>
+{% if property.deprecated %}<wrap danger>deprecated</wrap> {% endif %}
+{% if (node.parent is not null and property.parent.fullyQualifiedStructuralElementName != node.fullyQualifiedStructuralElementName) %}<wrap notice>inherited</wrap> {% endif %}
+</WRAP>{# third column#}
+
+
+
+
+== {{ property.summary|replace({"\n":""})|raw }} ==
+<html>{{ property.description|markdown|raw }}</html>
+{% if property.var.0.description %}<html>{{ property.var.0.description|markdown|raw }}</html>{% endif %}
+
+
+
+{#{% if property.types %}#}
+{#== Type ==#}
+{#{% for type in property.types  %}#}
+{#{% if loop.length > 1 %}  * {% endif %}{{ type|raw }} : {{ type.description|raw }}#}
+{#{% endfor %}#}
+{#{{ property.types|join('|')|raw }}#}
+{#{% endif %}#}
+
+
+{% if property.deprecated %}
+== Deprecated ==
+  {{ property.tags.deprecated[0].description }}
+{% endif %}
+
+{% include 'includes/inherited-from.txt.twig' with {structure:property} %}
+
+{% include 'includes/see-also.txt.twig' with {structure:property, title_level: '=='} %}
+
+{% include 'includes/uses.txt.twig' with {structure:property, title_level: ''} %}
+
+{% include 'includes/tags.txt.twig' with {structure:property, title_level: '==', blacklist:  ['link', 'see', 'access', 'var', 'deprecated', 'uses', 'todo', 'code-example']} %}
+
+
+<code php>{{ property.visibility }}  ${{ property.name }}{% if property.types %} : {{ property.types|join('|')|raw }}{% endif %}</code>
+
+</WRAP>{# group #}
+
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/file.source.txt.twig

@@ -0,0 +1 @@
+{{ node.source|raw }}

.doc/phpdoc-templates/combodo-wiki/file.txt.twig

@@ -0,0 +1,122 @@
+{% extends 'layout.txt.twig' %}
+
+{% block javascripts %}
+
+{% endblock %}
+
+{% block content %}
+    {#<section class="row-fluid">#}
+        {#<div class="span2 sidebar">#}
+            {#{% set namespace = project.namespace %}#}
+            {#{{ block('sidebarNamespaces') }}#}
+        {#</div>#}
+    {#</section>#}
+    {#<section class="row-fluid">#}
+====== {{ node.path|split('/')|slice(0,-1)|join('/') }}{{ node.name }} ======
+{{ node.summary }}
+<html>{{ node.description|markdown|raw }}</html>
+
+{% if node.traits|length > 0 %}
+
+===== Traits =====
+{% for trait in node.traits %}
+    <tr>
+        <td>{{ trait|raw }}</td>
+        <td><em>{{ trait.summary }}</em></td>
+    </tr>
+{% endfor %}
+{% endif %}
+
+
+{% if node.interfaces|length > 0 %}
+===== Interfaces =====
+    {% for interface in node.interfaces %}
+        <tr>
+            <td>{{ interface|raw }}</td>
+            <td><em>{{ interface.summary }}</em></td>
+        </tr>
+    {% endfor %}
+{% endif %}
+
+{% if node.classes|length > 0 %}
+===== Classes =====
+{% for class in node.classes %}
+{{ class|raw }}
+<em>{{ class.summary }}</em>
+{% endfor %}
+{% endif %}
+
+{% if node.package is not empty and node.package != '\\' %}
+    ===== Package =====
+    {{ node.subpackage ? (node.package ~ '\\' ~ node.subpackage) : node.package }}
+{% endif %}
+
+{% for tagName,tags in node.tags if tagName in ['link', 'see'] %}
+    {% if loop.first %}
+        ===== See also =====
+    {% endif %}
+    {% for tag in tags %}
+        <dd><a href="{{ tag.reference ?: tag.link }}"><div class="namespace-wrapper">{{ tag.description ?: tag.reference }}</div></a></dd>
+    {% endfor %}
+{% endfor %}
+
+                    <h2>Tags</h2>
+                    <table class="table table-condensed">
+                        {% for tagName,tags in node.tags if tagName not in ['link', 'see', 'package', 'subpackage'] %}
+                            <tr>
+                                <th>
+                                    {{ tagName }}
+                                </th>
+                                <td>
+                                    {% for tag in tags %}
+                                        {{ tag.description|markdown|raw }}
+                                    {% endfor %}
+                                </td>
+                            </tr>
+                        {% else %}
+                            <tr><td colspan="2"><em>None found</em></td></tr>
+                        {% endfor %}
+                    </table>
+
+                </aside>
+            </div>
+
+            {% if node.constants|length > 0 %}
+            <div class="row-fluid">
+                <section class="span8 content file">
+                    <h2>Constants</h2>
+                </section>
+                <aside class="span4 detailsbar"></aside>
+            </div>
+
+                {% for constant in node.constants %}
+                    {{ block('constant') }}
+                {% endfor %}
+            {% endif %}
+
+            {% if node.functions|length > 0 %}
+            <div class="row-fluid">
+                <section class="span8 content file">
+                    <h2>Functions</h2>
+                </section>
+                <aside class="span4 detailsbar"></aside>
+            </div>
+
+                {% for method in node.functions %}
+                    {{ block('method') }}
+                {% endfor %}
+            {% endif %}
+
+        </div>
+    </section>
+
+    <div id="source-view" class="modal hide fade" tabindex="-1" role="dialog" aria-labelledby="source-view-label" aria-hidden="true">
+        <div class="modal-header">
+            <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
+            <h3 id="source-view-label">{{ node.file.name }}</h3>
+        </div>
+        <div class="modal-body">
+            <pre data-src="{{ path('files/' ~ node.path ~ '.txt')|raw }}" class="language-php line-numbers"></pre>
+        </div>
+    </div>
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/graphs/class.html.twig

@@ -0,0 +1,42 @@
+{% extends 'layout.html.twig' %}
+
+{% block stylesheets %}
+    <link href="{{ path('css/jquery.iviewer.css') }}" rel="stylesheet" media="all"/>
+    <style>
+        #viewer {
+            position: relative;
+            width: 100%;
+        }
+        .wrapper {
+            overflow: hidden;
+        }
+    </style>
+{% endblock %}
+
+{% block javascripts %}
+    <script src="{{ path('js/jquery.mousewheel.js') }}" type="text/javascript"></script>
+    <script src="{{ path('js/jquery.iviewer.js') }}" type="text/javascript"></script>
+    <script type="text/javascript">
+        $(window).resize(function(){
+            $("#viewer").height($(window).height() - 100);
+        });
+
+        $(document).ready(function() {
+            $("#viewer").iviewer({src: '{{ path('graphs/classes.svg') }}', zoom_animation: false});
+            $('#viewer img').on('dragstart', function(event){
+                event.preventDefault();
+            });
+            $(window).resize();
+        });
+    </script>
+{% endblock %}
+
+{% block content %}
+    <div class="row-fluid">
+        <div class="span12">
+            <div class="wrapper">
+                <div id="viewer" class="viewer"></div>
+            </div>
+        </div>
+    </div>
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/htaccess.dist

@@ -0,0 +1,5 @@
+# Fixes a vulnerability in CentOS: http://stackoverflow.com/questions/20533279/prevent-php-from-parsing-non-php-files-such-as-somefile-php-txt
+<FilesMatch \.php\.txt$>
+    RemoveHandler .php
+    ForceType text/plain
+</FilesMatch>

.doc/phpdoc-templates/combodo-wiki/includes/code-examples.txt.twig

@@ -0,0 +1,34 @@
+{% if title_level is not defined %}
+    {%- set title_level = '==' -%}
+{% endif %}
+
+{% if sub_title_level is not defined %}
+    {%- set sub_title_level = title_level|slice(1) -%}
+{% endif %}
+{% if sub_title_level == '=' %}
+    {%- set sub_title_level = '' -%}
+{% endif %}
+
+{#{% for tagName,tags in structure.tags if tagName in ['code-example'] %}#}
+{#{% if loop.first %}#}
+{#{{title_level}} Examples {{title_level}}#}
+{#{% endif %}#}
+{#{% for tag in tags %}#}
+{#{%- set descToken = tag.description|split("\n", 2) -%}#}
+{#{%- set title = descToken[0] -%}#}
+{#{%- set code = descToken[1] -%}#}
+{#{{sub_title_level}} {{ title }} {{sub_title_level}}#}
+{#<code php>{{ code|raw }}</code>#}
+{#{% endfor %}#}
+{#{% endfor %}#}
+
+
+{% for tagName,tags in structure.tags if tagName in ['example'] %}
+{% if loop.first %}
+{{title_level}} Examples {{title_level}}
+{% endif %}
+{% for tag in tags %}
+{{ sub_title_level }} {{ tag.filePath|escape }}{{ sub_title_level }}
+<code php>{{ tag.description|raw }}</code>
+{% endfor %}
+{% endfor %}

.doc/phpdoc-templates/combodo-wiki/includes/inherited-from.txt.twig

@@ -0,0 +1,12 @@
+{% if title_level is not defined %}
+    {% set title_level='' %}
+{% endif %}
+
+{% if (node.parent is null) %}
+{{title_level}} File {{ structure.path }} {{title_level}}
+{% endif %}
+
+{% if (node.parent is not null and structure.parent.fullyQualifiedStructuralElementName != node.fullyQualifiedStructuralElementName) %}
+{{title_level}} Inherited from {{title_level}}
+[[{{structure.parent}}|{{structure.parent}}]]
+{% endif %}

.doc/phpdoc-templates/combodo-wiki/includes/namespace-structure-toc.html.twig

@@ -0,0 +1,26 @@
+{% for structure in structures|sort_asc if structure.tags['internal'] is not defined and (structure.tags['api'] is defined or structure.tags['api-advanced'] is  defined or structure.tags['overwritable-hook'] is  defined or structure.tags['extension-hook'] is  defined ) %}
+{#{{ structure|raw }}#}
+
+{% set structureName = structure|trim('\\', 'left') %}
+
+<WRAP group box>
+<WRAP twothirds column >
+==== {{ structureName }} ====
+</WRAP>{# twothirds column#}
+
+<WRAP third column>
+{% if structure.deprecated %}<wrap danger>deprecated</wrap>{% endif %}
+{% if structure.abstract %}<wrap warning>abstract</wrap>{% endif %}
+{% if structure.final %}<wrap notice>final</wrap>{% endif %}
+{% if (node.parent is not null and structure.parent.fullyQualifiedStructuralElementName != node.fullyQualifiedStructuralElementName) %}<wrap notice>inherited</wrap> {% endif %}
+{% include 'includes/wrap-tags.txt.twig' with {structure:structure, wrap: 'safety', wrapTags: ['api', 'api-advanced', 'overwritable-hook', 'extension-hook']} %}
+</WRAP>{# third column#}
+
+
+{{ structure.summary|raw }}
+[[{{structureName}}|More information]]
+
+</WRAP>{# group #}
+
+{% endfor %}
+

.doc/phpdoc-templates/combodo-wiki/includes/see-also.txt.twig

@@ -0,0 +1,26 @@
+{% if title_level is not defined %}
+    {%- set title_level='==' -%}
+{% endif %}
+{% for tagName,tags in structure.tags if tagName in ['link', 'see'] %}
+{% if loop.first %}
+{{title_level}} See also {{title_level}}
+{% endif %}
+{% for tag in tags %}
+{%- set linkTag = tag.reference|trim('\\', 'left') -%}
+{% if not('()' in linkTag or '$' in linkTag or node.name in linkTag or  '::' in linkTag ) %}
+    {%- set linkTag = linkTag|lower -%}
+{% elseif node.name~'::' in linkTag %}
+    {%- set linkTag = linkTag|replace({(node.name~'::'): '#'})|lower -%}
+{% elseif '::' in linkTag -%}
+    {%- set linkTag = linkTag|replace({'::': '#'})|lower -%}
+{% else %}
+    {%- set linkTag = '#' ~ linkTag|lower -%}
+{%- endif %}
+
+{% if loop.length > 1 %}  * {% endif %}{% if tag.reference is not empty -%}
+    [[{{linkTag}}|{{ (tag.reference)|trim('\\', 'left') }}]] {% if tag.description|trim is not empty %}: {{ tag.description|trim('\\', 'left') }} {% endif %}
+{%- else -%}
+    {#{{ tag.description|trim('\\', 'left') }}#}
+{% endif %}
+{% endfor %}
+{% endfor %}

.doc/phpdoc-templates/combodo-wiki/includes/tag-synthesys.txt.twig

@@ -0,0 +1,56 @@
+{% if tag is not defined -%}
+    {# Do not display @api if @api-advanced is also present #}
+    {%- set tag = "api" -%}
+{%- endif %}
+
+{% if hidden_by is not defined -%}
+    {# Do not display @api if @api-advanced is also present #}
+    {%- set hidden_by = {"api" : "api-advanced"} -%}
+{%- endif %}
+
+
+
+{% for method in methods|sort_asc
+    if (method.visibility == 'public')
+    and (
+        method.tags[tag] is defined
+        and (
+            hidden_by[tag] is not defined or method.tags[hidden_by[tag]] is not defined
+        )
+    )
+%}
+{%- if loop.first %}
+{% if tag == 'api' %}
+===== API synthesis =====
+<WRAP>
+List of the public API methods.
+When manipulating {{ node.name }}, You can call those methods:
+</WRAP>
+{% elseif tag == 'api-advanced' %}
+===== Advanced API synthesis =====
+<WRAP>
+List of advanced API methods
+Beware they usage is recommended to advanced users only.
+</WRAP>
+{% elseif tag == 'overwritable-hook' %}
+===== overwritable-hook synthesis =====
+<WRAP >When inheriting from {{ node.name }},
+you can overwrite those methods in order to add custom logic:
+</WRAP>
+{% elseif tag == 'extension-hook' %}
+===== extension-hook synthesis =====
+<WRAP >
+When inheriting from {{ node.name }},
+you can extend the behaviour of iTop by implementing:
+</WRAP>
+{% endif %}
+{% endif %}
+{% set sanitizedMethod = method|trim('\\', 'left')|replace({(node.name~'::'): ''}) %}
+{% if '::' in sanitizedMethod -%}
+{%- if node.tags['phpdoc-tuning-exclude-inherited'] is not defined %}
+  * [[{{sanitizedMethod|replace({'::': '#'})|lower}}|↪{{sanitizedMethod}}]] — {{  method.summary|replace({"\n":""})|raw }}
+{% endif %}
+{%- else %}
+  * [[#{{sanitizedMethod}}|{{sanitizedMethod}}]] — {{  method.summary|replace({"\n":""})|raw }}
+{% endif %}
+{% endfor %}

.doc/phpdoc-templates/combodo-wiki/includes/tags-with-description.txt.twig

@@ -0,0 +1,20 @@
+{% if title_level is not defined %}
+    {% set title_level = '==' %}
+{% endif %}
+
+
+{%- for tagName,tags in structure.tags if tagName in tagsWithDescription -%}
+    {%- for tag in tags -%}
+        {%- if tag.description is not empty -%}
+{%- if WRAP is defined -%}
+    <WRAP {{WRAP}}>
+{%- endif -%}
+{{title_level}} {{ tagName }} {{title_level}}
+{{ tag.description|escape }}
+{%- if WRAP is defined -%}
+    </WRAP>
+{%- endif -%}
+        {%- endif -%}
+    {%- endfor -%}
+{%- endfor -%}
+

.doc/phpdoc-templates/combodo-wiki/includes/tags.txt.twig

@@ -0,0 +1,22 @@
+{% if title_level is not defined %}
+    {% set title_level='=====' %}
+{% endif %}
+
+{% if blacklist is not defined %}
+    {% set blacklist =['link', 'see', 'abstract', 'example', 'method', 'property', 'property-read', 'property-write', 'package', 'subpackage', 'api', 'api-advanced', 'todo', 'code-example'] %}
+{% endif %}
+{% if hidden_by is not defined -%}
+    {# Do not display @api if @api-advanced is also present #}
+    {%- set hidden_by = {"api" : "api-advanced"} -%}
+{%- endif %}
+
+{#^ {% for tagName,tags in structure.tags if tagName not in blacklist -%}#}
+{#{{ tagName }} ^#}
+{#{%- endfor %}#}
+
+{% for tagName,tags in structure.tags if tagName not in blacklist and (hidden_by[tagName] is not defined or structure.tags[hidden_by[tagName]] is not defined) %}
+{%- if loop.first %}
+{{title_level}} Tags {{title_level}}
+{% endif %}
+^ {{ tagName }} | {% for tag in tags %}{{ tag.version ? tag.version ~ ' '  : '' }}{{ tag.description}}{% endfor %}   |
+{% endfor %}

.doc/phpdoc-templates/combodo-wiki/includes/used-by.txt.twig

@@ -0,0 +1,24 @@
+{% if title_level is not defined %}
+    {% set title_level='' %}
+{% endif %}
+{% for tagName,tags in structure.tags if tagName in ['used-by'] %}
+{% if loop.first %}
+{{title_level}} Used by {{title_level}}
+{% endif %}
+{% for tag in tags %}
+{% if loop.length > 1 %}  * {% endif %}{{ tag.reference ?: tag.link }} : {{ tag.description ?: tag.reference }}
+{% endfor %}
+{% endfor %}
+
+
+
+
+
+{#{% for tagName,tags in method.tags if tagName in ['uses'] %}#}
+    {#{% if loop.first %}#}
+        {#<dt>Uses</dt>#}
+    {#{% endif %}#}
+    {#{% for tag in tags %}#}
+        {#<dd>{{ tag.reference|raw }}</dd>#}
+    {#{% endfor %}#}
+{#{% endfor %}#}

.doc/phpdoc-templates/combodo-wiki/includes/uses.txt.twig

@@ -0,0 +1,24 @@
+{% if title_level is not defined %}
+    {% set title_level='' %}
+{% endif %}
+{% for tagName,tags in structure.tags if tagName in ['uses'] %}
+{% if loop.first %}
+{{title_level}} Uses {{title_level}}
+{% endif %}
+{% for tag in tags %}
+{% if loop.length > 1 %}  * {% endif %}{{ tag.reference ?: tag.link }} : {{ tag.description ?: tag.reference }}
+{% endfor %}
+{% endfor %}
+
+
+
+
+
+{#{% for tagName,tags in method.tags if tagName in ['uses'] %}#}
+    {#{% if loop.first %}#}
+        {#<dt>Uses</dt>#}
+    {#{% endif %}#}
+    {#{% for tag in tags %}#}
+        {#<dd>{{ tag.reference|raw }}</dd>#}
+    {#{% endfor %}#}
+{#{% endfor %}#}

.doc/phpdoc-templates/combodo-wiki/includes/wrap-tags.txt.twig

@@ -0,0 +1,11 @@
+{% if wrap is not defined -%}
+    {% set wrap = 'notice' %}
+{%- endif -%}
+{% if hidden_by is not defined -%}
+    {# Do not display @api if @api-advanced is also present #}
+    {%- set hidden_by = {"api" : "api-advanced"} -%}
+{%- endif %}
+
+{%- for tagName,tags in structure.tags if tagName in wrapTags and (hidden_by[tagName] is not defined or structure.tags[hidden_by[tagName]] is not defined) %}
+ <wrap {{wrap}}>{{tagName}}</wrap>
+{% endfor %}

.doc/phpdoc-templates/combodo-wiki/interface.txt.twig

@@ -0,0 +1,121 @@
+{% extends 'layout.txt.twig' %}
+
+{% block content %}
+<wrap button>[[start|🔙 Back]]</wrap>
+
+{% if node.tags['internal'] is defined %}
+====== {{ node.name }} ======
+<WRAP alert>This interface is "internal", and thus is not documented!</WRAP>
+{% elseif node.tags['api'] is not defined and node.tags['api-advanced'] is not defined and node.tags['overwritable-hook'] is not defined and node.tags['extension-hook'] is not defined %}
+====== {{ node.name }} ======
+<WRAP alert>This interface is neither "api", "overwritable-hook" or "extension-hook", and thus is not documented!</WRAP>
+{% else %}
+
+====== {{ node.name }} ======
+
+{% if node.deprecated %}<wrap danger>deprecated</wrap>{% endif %}
+{% if node.abstract %}<wrap warning>abstract</wrap>{% endif %}
+{% if node.final %}<wrap notice>final</wrap>{% endif %}
+{% include 'includes/wrap-tags.txt.twig' with {structure:node, wrap: 'safety', wrapTags: ['api', 'api-advanced', 'overwritable-hook', 'extension-hook']} %}
+
+
+
+{% if node.deprecated %}
+=== **<del>Deprecated</del>**===
+//{{ node.tags.deprecated[0].description }}//
+{% endif %}
+
+
+== {{  node.summary|replace({"\n":""})|raw }} ==
+<html>{{ node.description|markdown|raw }}</html>
+
+
+{% include 'includes/code-examples.txt.twig' with {structure:node, title_level: '====='} %}
+
+
+{% set class = node.parent %}
+{% block hierarchy_element %}
+
+{% if class and class.name is defined and class.name|trim != '' %}
+==== parent ====
+{% set child = class %}
+{% set class = class.parent %}
+{{ block('hierarchy_element') }}
+[[{{ child.name }}|{{ child.name }}]]
+{% endif %}
+{% endblock %}
+
+
+{% for interface in node.interfaces|sort_asc %}
+{% if loop.first %}
+==== Implements ====
+{% endif %}
+{% if loop.length > 1 %}  * {% endif %}{{ interface.fullyQualifiedStructuralElementName ?: interface }}
+{% endfor %}
+
+
+{% for trait in node.usedTraits|sort_asc %}
+{% if loop.first %}
+==== Uses traits ====
+{% endif %}
+{% if loop.length > 1 %}  * {% endif %}{{ trait.fullyQualifiedStructuralElementName ?: trait }}
+{% endfor %}
+
+
+{% include 'includes/see-also.txt.twig' with {structure:node, title_level: '==='} %}
+
+{% include 'includes/tags.txt.twig' with {structure:node, title_level: '=====', blacklist:  ['link', 'see', 'abstract', 'example', 'method', 'property', 'property-read', 'property-write', 'package', 'subpackage', 'phpdoc-tuning-exclude-inherited', 'api', 'api-advanced', 'overwritable-hook', 'extension-hook', 'copyright', 'license', 'code-example']} %}
+
+
+{% set methods = node.inheritedMethods.merge(node.methods) %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'api'} %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'api-advanced'} %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'overwritable-hook'} %}
+{% include 'includes/tag-synthesys.txt.twig' with {methods:methods, tag:'extension-hook'} %}
+
+<WRAP clear />
+
+
+{% for method in methods|sort_asc if method.visibility == 'public' %}
+{%- if loop.first %}
+===== Public methods =====
+{% endif %}
+{{ block('method') }}
+{% endfor %}
+{% for method in methods|sort_asc if method.visibility == 'protected' %}
+{%- if loop.first %}
+===== Protected methods =====
+{% endif %}
+{{ block('method') }}
+{% endfor %}
+
+
+
+{% set constants = node.inheritedConstants.merge(node.constants) %}
+{% if constants|length > 0 %}
+===== Constants =====
+{% for constant in constants|sort_asc %}
+{{ block('constant') }}
+{% endfor %}
+{% endif %}
+
+
+{#{% set properties = node.inheritedProperties.merge(node.properties) %}#}
+{#{% for property in properties|sort_asc if property.visibility == 'public' %}#}
+{#{%- if loop.first %}#}
+{#===== Public properties =====#}
+{#{% endif %}#}
+{#{{ block('property') }}#}
+{#{% endfor %}#}
+{#{% for property in properties|sort_asc if property.visibility == 'protected' %}#}
+{#{%- if loop.first %}#}
+{#===== Protected properties =====#}
+{#{% endif %}#}
+{#{{ block('property') }}#}
+{#{% endfor %}#}
+
+
+{%- endif %} {#{% elseif node.tags['xxx'] is not defined and ... #}
+
+<wrap button>[[start|🔙 Back]]</wrap>
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/layout.txt.twig

@@ -0,0 +1,5 @@
+{% use 'elements/constant.txt.twig' %}
+{% use 'elements/property.txt.twig' %}
+{% use 'elements/method.txt.twig' %}
+
+{% block content %}{% endblock %}

.doc/phpdoc-templates/combodo-wiki/namespace.txt.twig

@@ -0,0 +1,51 @@
+{% extends 'layout.txt.twig' %}
+
+{% block content %}
+{% set namespace = project.namespace %}
+{{ block('sidebarNamespaces') }}
+     
+{#{{ node.parent|raw }}#}
+{#====== {{ node.parent.fullyQualifiedStructuralElementName }}{{ node.name }} ======#}
+
+{% if node.children|length > 0 %}
+=====Namespaces=====
+{% include 'includes/namespace-structure-toc.html.twig' with {structures: node.children} %}
+----
+{% endif %}
+
+{% if node.traits|length > 0 %}
+===== Traits =====
+{% include 'includes/namespace-structure-toc.html.twig' with {structures: node.traits} %}
+----
+{%- endif %}
+
+{% if node.interfaces|length > 0 %}
+===== Interfaces =====
+{% include 'includes/namespace-structure-toc.html.twig' with {structures: node.interfaces} %}
+----
+{% endif %}
+
+{% if node.classes|length > 0 %}
+===== Classes =====
+{% include 'includes/namespace-structure-toc.html.twig' with {structures: node.classes} %}
+----
+{% endif %}
+
+
+
+{#{% if node.constants|length > 0 %}#}
+{#===== Constants =====#}
+{#{% for constant in node.constants|sort_asc %}#}
+{#    {{ block('constant') }}#}
+{#{% endfor %}#}
+{#{% endif %}#}
+
+{#{% if node.functions|length > 0 %}#}
+{#===== Functions =====#}
+
+{#{% for method in node.functions|sort_asc %}#}
+{#    {{ block('method') }}#}
+{#{% endfor %}#}
+{#{% endif %}#}
+
+{% endblock %}

.doc/phpdoc-templates/combodo-wiki/reports/deprecated.html.twig

@@ -0,0 +1,49 @@
+
+====== Deprecated elements ======
+
+{#{% for element in project.indexes.elements if element.deprecated %}#}
+    {#{% if element.file.path != previousPath %}#}
+        {#<li><a href="#{{ element.file.path }}"><i class="icon-file"></i> {{ element.file.path }}</a></li>#}
+    {#{% endif %}#}
+    {#{% set previousPath = element.file.path %}#}
+{#{% endfor %}#}
+
+{% for element in project.indexes.elements if element.deprecated %}
+    {% if element.file.path != previousPath %}
+    {% if previousPath %}
+</WRAP>{# group #}
+    {% endif %}
+    {#<a name="{{ element.file.path }}" id="{{ element.file.path }}"></a>#}
+===== {{ element.file.path }} ({{ element.tags.deprecated.count }} found)=====
+
+<WRAP group >
+<WRAP third column >
+Element
+</WRAP>{# third column#}
+<WRAP third column >
+Line
+</WRAP>{# third column#}
+<WRAP third column >
+Description
+</WRAP>{# third column#}
+
+{% endif %}
+{% for tag in element.tags.deprecated %}
+<WRAP group >
+<WRAP third column >
+    {{ element.fullyQualifiedStructuralElementName }}
+</WRAP>{# third column#}
+<WRAP third column >
+    {{ element.line }}
+</WRAP>{# third column#}
+<WRAP third column >
+    {{ tag.description }}
+</WRAP>{# third column#}
+
+{% endfor %}
+</WRAP>{# group #}
+{% set previousPath = element.file.path %}
+{% else %}
+<WRAP info>No deprecated elements have been found in this project.</WRAP>
+{% endfor %}
+

.doc/phpdoc-templates/combodo-wiki/template.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<template>
+  <author>Bruno DA SILVA</author>
+  <email>contact [at] combodo.com</email>
+  <version>1.0.0</version>
+  <copyright>Combodo 2018</copyright>
+  <description><![CDATA[
+
+      Forked from the clean theme of https://github.com/phpDocumentor/phpDocumentor2 provided under the MIT licence.
+      The original work is copyright "Mike van Riel".
+
+      ------------------------------------------------------------------------------------------------------------------
+
+      To improve performance you can add the following to your .htaccess:
+
+      <ifModule mod_deflate.c>
+          <filesMatch "\.(js|css|html)$">
+              SetOutputFilter DEFLATE
+          </filesMatch>
+      </ifModule>
+  ]]></description>
+  <transformations>
+    <transformation writer="twig" query="namespace" source="templates/combodo-wiki/namespace.txt.twig" artifact="start.txt"/>
+    <transformation writer="twig" query="indexes.classes" source="templates/combodo-wiki/class.txt.twig" artifact="{{name}}.txt"/>
+    <transformation writer="twig" query="indexes.interfaces" source="templates/combodo-wiki/interface.txt.twig" artifact="{{name}}.txt" />
+  </transformations>
+</template>

.github/ISSUE_TEMPLATE/bug.yml

@@ -1,60 +0,0 @@
-name: "Bug report"
-description: "Report a bug that you identified in iTop"
-type: bug
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Please explain why you're creating this issue :
-        - Are you willing to create a PR for the bug fix ? If so, we'll indicate in the issue if we're interested in it.
-        - Then, please describe how to reproduce the issue.
-
-  - type: dropdown
-    id: willing_to_pr
-    attributes:
-      label: Are you willing to create (at a later stage) a PR for that?
-      options:
-        - 'Yes'
-        - 'No'
-    validations:
-      required: true
-
-  - type: input
-    id: itop_version
-    attributes:
-      label: iTop version
-      description: "Complete iTop version (e.g., 3.2.3)"
-    validations:
-      required: false
-
-  - type: input
-    id: php_version
-    attributes:
-      label: PHP version
-      description: "Complete PHP version (e.g., 8.4.20)"
-    validations:
-      required: false
-
-  - type: textarea
-    id: reproduction_steps
-    attributes:
-      label: Reproduction procedure
-      description: |
-        Please explain step by step how to reproduce the issue on a standard iTop Community.
-        If it requires a custom datamodel, provide the minimal XML delta to reproduce it.
-      placeholder: |
-        1. First go there
-        2. Then do that
-        3. ...
-        4. Finally, see that... (what is expected and what is actually happening)
-    validations:
-      required: false
-
-  - type: upload
-    id: additional_info
-    attributes:
-      label: Additional information (if needed)
-      description: "Add/drag and drop screenshots, logs or any files that can be relevant for your issue."
-    validations:
-      required: false
-      accept: ".png, .jpg, .jpeg, .gif, .webp, .log, .txt, .json, .csv, .xml, .zip"

.github/ISSUE_TEMPLATE/enhancement.yml

@@ -1,47 +0,0 @@
-name: "Enhancement suggestion"
-description: "Suggest an improvement to iTop"
-type: feature
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Please explain why you're creating this issue :
-        - Please describe what's your improvement proposition.
-        - Then tell us if you're willing to create a PR for this enhancement ? If so, we'll indicate in the issue if we're interested in it.
-
-  - type: textarea
-    id: enhancement_details
-    attributes:
-      label: Enhancement details
-      description: |
-        Please explain what you want to improve, and your proposition to make it better.
-        If it requires a custom datamodel, provide the minimal XML delta to reproduce it.
-    validations:
-      required: false
-
-  - type: input
-    id: itop_version
-    attributes:
-      label: iTop version (if appropriate)
-      description: "Complete iTop version (e.g., 3.2.3)"
-    validations:
-      required: false
-
-  - type: dropdown
-    id: willing_to_pr
-    attributes:
-      label: Are you willing to create (at a later stage) a PR for that?
-      options:
-        - 'Yes'
-        - 'No'
-    validations:
-      required: true
-
-  - type: upload
-    id: additional_info
-    attributes:
-      label: Additional information (if needed)
-      description: "Add/drag and drop screenshots, logs or any files that can be relevant for your issue."
-    validations:
-      required: false
-      accept: ".png, .jpg, .jpeg, .gif, .webp, .log, .txt, .json, .csv, .xml, .zip"

.github/pull_request_template.md

@@ -1,81 +1,83 @@
 <!--
-IMPORTANT: Before creating your PR, please create an issue first to know if Combodo is interested in your contribution (not needed for translations PR).
-Since we may refuse a PR, it's preferable to create an issue first, to avoid spending time coding something that won't be accepted.
 
-Once you've done it, and we confirmed we're interested in it, please follow the guidelines within this PR template before submitting it, it will greatly help us process your PR. 🙏
+IMPORTANT: Please follow the guidelines within this PR template before submitting it, it will greatly help us process your PR. 🙏
 
 Any PRs not following the guidelines or with missing information will not be considered.
+
 -->
 
 ## Base information
+| Question                                                      | Answer 
+|---------------------------------------------------------------|--------
+| Related to a SourceForge thead / Another PR / Combodo ticket? | <!-- Put the URL -->
+| Type of change?                                               | Bug fix / Enhancement / Translations
 
-| Question                                                       | Answer 
-|----------------------------------------------------------------|--------
-| Related to a SourceForge thread / Another PR / A GitHub Issue / Combodo ticket? | <!-- Put the URL -->                 |
-| Type of change?                                                | Bug fix / Enhancement / Translations
-
-| Question                                                                        | Answer                               |
-|---------------------------------------------------------------------------------|--------------------------------------|
-| Related to a SourceForge thread / Another PR / A GitHub Issue / Combodo ticket? | <!-- Put the URL -->                 |
-| Type of change?                                                                 | Bug fix / Enhancement / Translations |
 
 ## Symptom (bug) / Objective (enhancement)
-
 <!--
 If it's a bug
   - Explain the symptom in details
   - If possible put error messages, logs or screenshots (you can paste image directly in this editor).
 
 If it's an enhancement
-  - Describe what is blocking you, what is the objective with as many details as possible.
+  - Describe what is blocking you, what is the objective with as much details as possible.
   - Add screenshots if it's related to UI.
 -->
 
-## Reproduction procedure (bug)
 
+## Reproduction procedure (bug)
 <!--
-Please explain step by step how to reproduce the issue on a standard iTop Community.
+Remove this section only if it's NOT a bug.
+
+Otherwise, explain step by step how to reproduce the issue on a standard iTop Community.
+
 If it requires a custom datamodel, provide the minimal XML delta to reproduce it on a standard iTop Community.
 -->
 
 1. On iTop x.y.z <!-- Put complete iTop version (eg. 3.1.0-2) -->
 2. With PHP x.y.z <!-- Put complete PHP version (eg. 8.1.24) -->
-3. First go there
-4. Then do that
-5. ...
-6. Finally, see that... (what is expected and what is actually happening)
+2. First go there
+2. Then do that
+3. ...
+4. Finally, see that...
 
-## Reproduction procedure (enhancement - if needed)
-
-<!--
-Please explain how we can reproduce the feature/behavior you want to improve, and what's your proposition to make it better.
-Add screenshots if it's related to UI.
-If it requires a custom datamodel, provide the minimal XML delta to reproduce it on a standard iTop Community.
--->
 
 ## Cause (bug)
-
 <!--
 Remove this section only if it's NOT a bug.
 
 Otherwise, explain what is the cause of the issue (where in the code and why)
 -->
 
-## Proposed solution (bug and enhancement)
 
+## Proposed solution (bug and enhancement)
 <!--
 Explain in details how you are proposing to solve this:
   - What did you do in the code and why
   - If you changed something in the UI, put before / after screenshots (you can paste image directly in this editor)
 -->
 
-## Checklist before requesting a review
 
+## Checklist before requesting a review
 <!--
 Don't remove these lines, check them once done.
 -->
-
 - [ ] I have performed a self-review of my code
 - [ ] I have tested all changes I made on an iTop instance
 - [ ] I have added a unit test, otherwise I have explained why I couldn't
-- [ ] Is the PR clear and detailed enough so anyone can understand without digging in the code?
+- [ ] Is the PR clear and detailed enough so anyone can understand digging in the code?
+
+## Checklist of things to do before PR is ready to merge
+<!--
+Things that needs to be done in the PR before it can be considered as ready to be merged
+
+Examples:
+- Changes requested in the review
+- Unit test to add
+- Dictionary entries to translate
+- ...
+-->
+
+- [ ] ...
+- [ ] ...
+- [ ] ...

.github/workflows/action.yml

@@ -1,13 +1,9 @@
 name: Add PRs to Combodo PRs Dashboard
 
 on:
-  pull_request:
+  pull_request_target:
     types:
       - opened
-  issues:
-    types:
-      - opened
-  workflow_call:
 
 jobs:
   add-to-project:
@@ -30,27 +26,18 @@ jobs:
 
           fi
 
-      - name: Add internal tag if member of the organization
+      - name: Add internal tag if member
         if: env.is_member == 'true'
         run: |
           curl -X POST -H "Authorization: token ${{ secrets.PR_AUTOMATICALLY_ADD_TO_PROJECT }}" \
             -H "Accept: application/vnd.github.v3+json" \
-            https://api.github.com/repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/labels \
+            https://api.github.com/repos/Combodo/iTop/issues/${{ github.event.pull_request.number }}/labels \
             -d '{"labels":["internal"]}'
-
-      - name: Set PR author as assignee if member of the organization
-        if: env.is_member == 'true' && github.event_name == 'pull_request'
-        run: |
-          curl -L \
-            -X POST \
-            -H "Accept: application/vnd.github+json" \
-            -H "Authorization: Bearer ${{ secrets.PR_AUTOMATICALLY_ADD_TO_PROJECT }}" \
-            https://api.github.com/repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/assignees \
-            -d '{"assignees":["${{ github.event.pull_request.user.login }}"]}'
         env:
           is_member: ${{ env.is_member }}
+
       - name: Add PR to the appropriate project
-        uses: actions/add-to-project@v2
+        uses: actions/add-to-project@v1.0.2
         with:
           project-url: ${{ env.project_url }}
-          github-token: ${{ secrets.PR_AUTOMATICALLY_ADD_TO_PROJECT }}
+          github-token: ${{ secrets.PR_AUTOMATICALLY_ADD_TO_PROJECT }}

.gitignore

@@ -58,9 +58,6 @@ tests/*/vendor/*
 /tests/php-unit-tests/phpunit.xml
 /tests/php-unit-tests/postbuild_integration.xml
 
-# PHP CS Fixer: Cache file
-/.php-cs-fixer.cache
-
 
 # Jetbrains
 /.idea/**

.make/release/update.classes.inc.php

@@ -199,7 +199,7 @@ class DatamodelsXmlFiles extends AbstractGlobFileVersionUpdater
 		libxml_clear_errors();
 		$oFileXml->formatOutput = true;
 		$oFileXml->preserveWhiteSpace = false;
-		$oFileXml->loadXML($sFileContent, LIBXML_BIGLINES);
+		$oFileXml->loadXML($sFileContent);
 
 		$oFileItopFormat = new iTopDesignFormat($oFileXml);
 

.phpstorm.meta.php

@@ -1,16 +0,0 @@
-<?php
-
-/*
- * @copyright   Copyright (C) 2010-2025 Combodo SAS
- * @license     http://opensource.org/licenses/AGPL-3.0
- */
-
-namespace PHPSTORM_META
-{
-	override(\MetaModel::NewObject(0), map([
-		'' => '@',
-	]));
-	override(\MetaModel::GetObject(0), map([
-		'' => '@',
-	]));
-}

CONTRIBUTING.md

@@ -4,33 +4,30 @@ You want to contribute to iTop? Many thanks to you! 🎉 👍
 
 Here are some guidelines that will help us integrate your work!
 
+
 ## Contributions
 
 ### Subjects
-
 You are welcome to create pull requests on any of those subjects:
 
 * 🐛 bug fix
 * 🌐 translation / i18n / l10n
-* 🚸 enhancement
 
-But before creating a PR, please [create a corresponding issue][itop-issues] for review.
-We should review within two weeks, and get back to you to indicate if we're interested in your proposal or not.
-If you don't create an issue, you won't know if we're interested in your contribution, and you may spend time coding something that won't be accepted.
-If you ever want to begin implementation, do so in a fork, and add a link to the corresponding commits in the issue.
+If you want to implement a **new feature**, please [create a corresponding ticket](https://sourceforge.net/p/itop/tickets/new/) for review.   
+If you ever want to begin implementation, do so in a fork, and add a link to the corresponding commits in the ticket.
 
 For all **security related subjects**, please see our [security policy](SECURITY.md).
 
-All **datamodel modification** should be done in an extension. Beware that such change would
-impact all existing customers, and could prevent them from upgrading!
-Combodo has a long experience of datamodel changes: they are very disruptive!
+All **datamodel modification** should be done in an extension. Beware that such change would 
+impact all existing customers, and could prevent them from 
+upgrading!
+Combodo has a long experience of datamodel changes: they are very disruptive! 
 This is why we avoid them in iTop core, especially the changes on existing objects/fields.   
-If you have an idea you're sure would benefit to all of iTop users, you may
-[create a corresponding issue][itop-issues] to submit it, but be warned that there are lots of good
+If you have an idea you're sure would benefit to all of iTop users, you may 
+[create a corresponding ticket](https://sourceforge.net/p/itop/tickets/new/) to submit it, but be warned that there are lots of good 
 reasons to refuse such changes.
 
 ### 📄 License and copyright
-
 iTop is distributed under the AGPL-3.0 license (see the [license.txt] file).
 
 The iTop repository is divided in three parts: iTop (mainly PHP/JS/XML sources and dictionaries), images, and third-party libraries.
@@ -40,33 +37,48 @@ Anyhow, you are encouraged to signal your contribution by the mean of `@author`
 If you want to use another license or keep the code ownership (copyright), you may [create an extension][wiki new ext].
 
 [license.txt]: https://github.com/Combodo/iTop/blob/develop/license.txt
-
-[itop-issues]: https://github.com/Combodo/iTop/issues
-
 [wiki new ext]: https://www.itophub.io/wiki/page?id=latest%3Acustomization%3Astart#by_writing_your_own_extension
 
+
 ## 🔀 iTop branch model
 
 When we first start with Git, we were using the [GitFlow](https://nvie.com/posts/a-successful-git-branching-model/) branch model. As
-there was some confusions about branches to use for current developed release and previous maintained release, and also because we were
-using just a very few of the GitFlow commands, we decided to add just a little modification to this branch model : since April 2020
-we don't have a `master` branch anymore.
+ there was some confusions about branches to use for current developed release and previous maintained release, and also because we were
+ using just a very few of the GitFlow commands, we decided to add just a little modification to this branch model : since april 2020
+  we don't have a `master` branch anymore.
 
-Here are the branches we use and their meaning :
+Here are the branches we use and their meaning : 
 
 - `develop`: ongoing development version
+- `release/*`: if present, that means we are working on a alpha/beta/rc version for shipping
 - `support/*`: maintenance branches for older versions
 
 For example, if no version is currently prepared for shipping we could have:
 
-- `develop` containing future 3.3.0 version
-- `support/3.2`: 3.2.x maintenance version
+- `develop` containing future 3.1.0 version
+- `support/3.0`: 3.0.x maintenance version
+- `support/2.7`: 2.7.x maintenance version
+- `support/2.6`: 2.6.x maintenance version
 
-And when 3.3.0 will be out:
+In this example, when 3.1.0-beta is shipped that will become:
+
+- `develop`: future 3.2.0 version
+- `release/3.1.0`: 3.1.0-beta
+- `support/3.0`: 3.0.x maintenance version
+- `support/2.7`: 2.7.x maintenance version
+- `support/2.6`: 2.6.x maintenance version
+
+And when 3.1.0 final will be out:
+
+- `develop`: future 3.2.0 version
+- `support/3.1`: 3.1.x maintenance version (will host developments for 3.1.1)
+- `support/3.0`: 3.0.x maintenance version
+- `support/2.7`: 2.7.x maintenance version
+- `support/2.6`: 2.6.x maintenance version
+
+Also note that we have a "micro-version" concept : each of those versions have a very small amount of modifications. They are made from
+ `support/*` branches as well. For example 2.6.2-1 and 2.6.2-2 were made from the `support/2.6.2` branch. 
 
-- `develop`: future 3.4.0 version
-- `support/3.3`: 3.3.x maintenance version (will host developments for 3.3.1)
-- `support/3.2`: 3.2.x maintenance version
 
 ## Coding
 
@@ -80,11 +92,12 @@ A [dedicated page](https://www.itophub.io/wiki/page?id=latest%3Acustomization%3A
 2. Create a branch in this fork, based on the develop branch
 3. Code !
 
-Do create a dedicated branch for each modification you want to propose : if you don't, it will be very hard to merge back your work !
+Do create a dedicated branch for each modification you want to propose : if you don't it will be very hard to merge back your work !
 
-Most of the time you should base your developments on the develop branch.    
+Most of the time you should based your developments on the develop branch.    
 That may be different if you want to fix a bug, please use develop anyway and ask in your PR if rebase is possible.
 
+
 ### 🎨 PHP styleguide
 
 Please follow [our guidelines](https://www.itophub.io/wiki/page?id=latest%3Acustomization%3Acoding_standards).
@@ -93,7 +106,7 @@ Please follow [our guidelines](https://www.itophub.io/wiki/page?id=latest%3Acust
 
 Please create tests that covers as much as possible the code you're submitting.
 
-Our tests are located in the `tests/` directory, containing a PHPUnit config file : `phpunit.xml.dist`.
+Our tests are located in the `test/` directory, containing a PHPUnit config file : `phpunit.xml.dist`.
 
 ### Git Commit Messages
 
@@ -125,14 +138,14 @@ When your code is working, please:
 * Rebase your branch on our repo last commit,
 * Create a pull request. _Detailed procedure to work on fork and create PR is available [in GitHub help pages](https://help.github.com/articles/creating-a-pull-request-from-a-fork/)_.
 * Pull request description: mind to add all the information useful to understand why you're suggesting this modification and anything necessary to dive into your work. Especially:
-    - Bugfixes: exact steps to reproduce the bug (given/when/then), description of the bug cause and what solution is implemented
-    - Enhancements: use cases, implementation details if needed
-* Mind to check the "[Allow edits from maintainers](https://docs.github.com/en/github-ae@latest/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork)" option ! (note that if you are working with an org fork, this
-  option [won't be available](https://github.com/orgs/community/discussions/5634))
+  - Bugfixes: exact steps to reproduce the bug (given/when/then), description of the bug cause and what solution is implemented 
+  - Enhancements: use cases, implementation details if needed
+* Mind to check the "[Allow edits from maintainers](https://docs.github.com/en/github-ae@latest/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork)" option ! (note that if you are working with an org fork, this option [won't be available](https://github.com/orgs/community/discussions/5634))
+
 
 ## 🙏 We are thankful
 
-We are thankful for all your contributions to the iTop universe! As a thank-you gift, we will send stickers to every iTop (& extensions) contributors!
+We are thankful for all your contributions to the iTop universe! As a thank you gift, we will send stickers to every iTop (& extensions) contributors!
 
 We have one sticker per contribution type. You might get multiple stickers with one contribution though :)
 
@@ -146,6 +159,6 @@ We have one sticker per contribution type. You might get multiple stickers with
 * Beta tester: Test and give feedback on beta releases
 * Extension developer: Develop and publish an extension
 
-Here is the design of each sticker:
+Here is the design of each stickers for year 2024:
 
-![iTop stickers](.doc/contributing-guide/contributing-stickers-side-by-side.png)
+![iTop stickers 2024](.doc/contributing-guide/2024.contributing-stickers-side-by-side.png)

README.md

@@ -73,9 +73,6 @@ iTop development is sponsored, led, and supported by [Combodo][0].
 
 [0]: https://www.combodo.com
 
-## Developers
-
-You can find information and instructions about our quality tools and how to run them [here](.doc/developers.md).
 
 ## Contributors
 
@@ -102,7 +99,6 @@ We would like to give a special thank you 🤗 to the people from the community
 - Goethals, Stefan
 - Giuva, Vincenzo Katriel (a.k.a [@DarkNight97boss](https://github.com/DarkNight97boss))
 - Gumble, David
-- Håkon, Harnes (a.k.a [@hakonharnes](https://github.com/hakonharnes))
 - Heloir, Arthur 
 - Janssens, Jelle (a.k.a [@janssensjelle](https://github.com/janssensjelle))
 - Ji, Leeb (冀利斌) (a.k.a [@chileeb](https://github.com/chileeb))

addons/userrights/userrightsprofile.class.inc.php

@@ -1,5 +1,4 @@
 <?php
-
 /*
  * @copyright   Copyright (C) 2010-2024 Combodo SAS
  * @license     http://opensource.org/licenses/AGPL-3.0
@@ -30,52 +29,56 @@ class UserRightsBaseClassGUI extends cmdbAbstractObject
 	}
 }
 
+
 class URP_Profiles extends UserRightsBaseClassGUI
 {
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category"                   => "addon/userrights,grant_by_profile,filter",
 			"key_type"                   => "autoincrement",
 			"name_attcode"               => "name",
-			"complementary_name_attcode" => ['description'],
+			"complementary_name_attcode" => array('description'),
 			"state_attcode"              => "",
-			"reconc_keys"                => [],
+			"reconc_keys"                => array(),
 			"db_table"                   => "priv_urp_profiles",
 			"db_key_field"               => "id",
 			"db_finalclass_field"        => "",
-		];
+		);
 		MetaModel::Init_Params($aParams);
 		//MetaModel::Init_InheritAttributes();
-		MetaModel::Init_AddAttribute(new AttributeString("name", ["allowed_values" => null, "sql" => "name", "default_value" => null, "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeString("description", ["allowed_values" => null, "sql" => "description", "default_value" => null, "is_null_allowed" => false, "depends_on" => []]));
+		MetaModel::Init_AddAttribute(new AttributeString("name", array("allowed_values"=>null, "sql"=>"name", "default_value"=>null, "is_null_allowed"=>false, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeString("description", array("allowed_values"=>null, "sql"=>"description", "default_value"=>null, "is_null_allowed"=>false, "depends_on"=>array())));
 
-		MetaModel::Init_AddAttribute(new AttributeLinkedSetIndirect("user_list", ["linked_class" => "URP_UserProfile", "ext_key_to_me" => "profileid", "ext_key_to_remote" => "userid", "allowed_values" => null, "count_min" => 1, "count_max" => 0, "depends_on" => []]));
+		MetaModel::Init_AddAttribute(new AttributeLinkedSetIndirect("user_list", array("linked_class"=>"URP_UserProfile", "ext_key_to_me"=>"profileid", "ext_key_to_remote"=>"userid", "allowed_values"=>null, "count_min"=>1, "count_max"=>0, "depends_on"=>array())));
 
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['name', 'description', 'user_list']); // Attributes to be displayed for the complete details
-		MetaModel::Init_SetZListItems('list', ['description']); // Attributes to be displayed for a list
+		MetaModel::Init_SetZListItems('details', array('name', 'description', 'user_list')); // Attributes to be displayed for the complete details
+		MetaModel::Init_SetZListItems('list', array('description')); // Attributes to be displayed for a list
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['name','description']); // Criteria of the std search form
-		MetaModel::Init_SetZListItems('default_search', ['name','description']);
+		MetaModel::Init_SetZListItems('standard_search', array('name','description')); // Criteria of the std search form
+		MetaModel::Init_SetZListItems('default_search', array ('name','description'));
 	}
 
 	protected static $m_aCacheProfiles = null;
 
 	public static function DoCreateProfile($sName, $sDescription)
 	{
-		if (is_null(self::$m_aCacheProfiles)) {
-			self::$m_aCacheProfiles = [];
+		if (is_null(self::$m_aCacheProfiles))
+		{
+			self::$m_aCacheProfiles = array();
 			$oFilterAll = new DBObjectSearch('URP_Profiles');
 			$oSet = new DBObjectSet($oFilterAll);
-			while ($oProfile = $oSet->Fetch()) {
+			while ($oProfile = $oSet->Fetch())
+			{
 				self::$m_aCacheProfiles[$oProfile->Get('name')] = $oProfile->GetKey();
 			}
 		}
 
 		$sCacheKey = $sName;
-		if (isset(self::$m_aCacheProfiles[$sCacheKey])) {
+		if (isset(self::$m_aCacheProfiles[$sCacheKey]))
+		{
 			return self::$m_aCacheProfiles[$sCacheKey];
 		}
 		$oNewObj = MetaModel::NewObject("URP_Profiles");
@@ -86,21 +89,27 @@ class URP_Profiles extends UserRightsBaseClassGUI
 		return $iId;
 	}
 
-	public function GetGrantAsHtml($oUserRights, $sClass, $sAction)
+	function GetGrantAsHtml($oUserRights, $sClass, $sAction)
 	{
 		$bGrant = $oUserRights->GetProfileActionGrant($this->GetKey(), $sClass, $sAction);
-		if (is_null($bGrant)) {
-			return '<span class="ibo-user-rights ibo-is-failure">'.Dict::S('UI:UserManagement:ActionAllowed:No').'</span>';
-		} elseif ($bGrant) {
-			return '<span class="ibo-user-rights ibo-is-success">'.Dict::S('UI:UserManagement:ActionAllowed:Yes').'</span>';
-		} else {
-			return '<span class="ibo-user-rights ibo-is-failure">'.Dict::S('UI:UserManagement:ActionAllowed:No').'</span>';
+		if (is_null($bGrant))
+		{
+			return '<span style="background-color: #ffdddd;">'.Dict::S('UI:UserManagement:ActionAllowed:No').'</span>';
+		}
+		elseif ($bGrant)
+		{
+			return '<span style="background-color: #ddffdd;">'.Dict::S('UI:UserManagement:ActionAllowed:Yes').'</span>';
+		}
+		else
+		{
+			return '<span style="background-color: #ffdddd;">'.Dict::S('UI:UserManagement:ActionAllowed:No').'</span>';
 		}
 	}
 
-	public function DoShowGrantSumary($oPage)
+	function DoShowGrantSumary($oPage)
 	{
-		if ($this->GetRawName() == "Administrator") {
+		if ($this->GetRawName() == "Administrator")
+		{
 			// Looks dirty, but ok that's THE ONE
 			$oPage->p(Dict::S('UI:UserManagement:AdminProfile+'));
 			return;
@@ -109,18 +118,21 @@ class URP_Profiles extends UserRightsBaseClassGUI
 		// Note: for sure, we assume that the instance is derived from UserRightsProfile
 		$oUserRights = UserRights::GetModuleInstance();
 
-		$aDisplayData = [];
-		foreach (MetaModel::GetClasses('bizmodel,grant_by_profile') as $sClass) {
-			$aStimuli = [];
-			foreach (MetaModel::EnumStimuli($sClass) as $sStimulusCode => $oStimulus) {
+		$aDisplayData = array();
+		foreach (MetaModel::GetClasses('bizmodel,grant_by_profile') as $sClass)
+		{
+			$aStimuli = array();
+			foreach (MetaModel::EnumStimuli($sClass) as $sStimulusCode => $oStimulus)
+			{
 				$bGrant = $oUserRights->GetClassStimulusGrant($this->GetKey(), $sClass, $sStimulusCode);
-				if ($bGrant === true) {
+				if ($bGrant === true)
+				{
 					$aStimuli[] = '<span title="'.$sStimulusCode.': '.utils::EscapeHtml($oStimulus->GetDescription()).'">'.utils::EscapeHtml($oStimulus->GetLabel()).'</span>';
 				}
 			}
 			$sStimuli = implode(', ', $aStimuli);
 
-			$aDisplayData[] = [
+			$aDisplayData[] = array(
 				'class' => MetaModel::GetName($sClass),
 				'read' => $this->GetGrantAsHtml($oUserRights, $sClass, 'r'),
 				'bulkread' => $this->GetGrantAsHtml($oUserRights, $sClass, 'br'),
@@ -129,22 +141,22 @@ class URP_Profiles extends UserRightsBaseClassGUI
 				'delete' => $this->GetGrantAsHtml($oUserRights, $sClass, 'd'),
 				'bulkdelete' => $this->GetGrantAsHtml($oUserRights, $sClass, 'bd'),
 				'stimuli' => $sStimuli,
-			];
+			);
 		}
 
-		$aDisplayConfig = [];
-		$aDisplayConfig['class'] = ['label' => Dict::S('UI:UserManagement:Class'), 'description' => Dict::S('UI:UserManagement:Class+')];
-		$aDisplayConfig['read'] = ['label' => Dict::S('UI:UserManagement:Action:Read'), 'description' => Dict::S('UI:UserManagement:Action:Read+')];
-		$aDisplayConfig['bulkread'] = ['label' => Dict::S('UI:UserManagement:Action:BulkRead'), 'description' => Dict::S('UI:UserManagement:Action:BulkRead+')];
-		$aDisplayConfig['write'] = ['label' => Dict::S('UI:UserManagement:Action:Modify'), 'description' => Dict::S('UI:UserManagement:Action:Modify+')];
-		$aDisplayConfig['bulkwrite'] = ['label' => Dict::S('UI:UserManagement:Action:BulkModify'), 'description' => Dict::S('UI:UserManagement:Action:BulkModify+')];
-		$aDisplayConfig['delete'] = ['label' => Dict::S('UI:UserManagement:Action:Delete'), 'description' => Dict::S('UI:UserManagement:Action:Delete+')];
-		$aDisplayConfig['bulkdelete'] = ['label' => Dict::S('UI:UserManagement:Action:BulkDelete'), 'description' => Dict::S('UI:UserManagement:Action:BulkDelete+')];
-		$aDisplayConfig['stimuli'] = ['label' => Dict::S('UI:UserManagement:Action:Stimuli'), 'description' => Dict::S('UI:UserManagement:Action:Stimuli+')];
+		$aDisplayConfig = array();
+		$aDisplayConfig['class'] = array('label' => Dict::S('UI:UserManagement:Class'), 'description' => Dict::S('UI:UserManagement:Class+'));
+		$aDisplayConfig['read'] = array('label' => Dict::S('UI:UserManagement:Action:Read'), 'description' => Dict::S('UI:UserManagement:Action:Read+'));
+		$aDisplayConfig['bulkread'] = array('label' => Dict::S('UI:UserManagement:Action:BulkRead'), 'description' => Dict::S('UI:UserManagement:Action:BulkRead+'));
+		$aDisplayConfig['write'] = array('label' => Dict::S('UI:UserManagement:Action:Modify'), 'description' => Dict::S('UI:UserManagement:Action:Modify+'));
+		$aDisplayConfig['bulkwrite'] = array('label' => Dict::S('UI:UserManagement:Action:BulkModify'), 'description' => Dict::S('UI:UserManagement:Action:BulkModify+'));
+		$aDisplayConfig['delete'] = array('label' => Dict::S('UI:UserManagement:Action:Delete'), 'description' => Dict::S('UI:UserManagement:Action:Delete+'));
+		$aDisplayConfig['bulkdelete'] = array('label' => Dict::S('UI:UserManagement:Action:BulkDelete'), 'description' => Dict::S('UI:UserManagement:Action:BulkDelete+'));
+		$aDisplayConfig['stimuli'] = array('label' => Dict::S('UI:UserManagement:Action:Stimuli'), 'description' => Dict::S('UI:UserManagement:Action:Stimuli+'));
 		$oPage->table($aDisplayConfig, $aDisplayData);
 	}
 
-	public function DisplayBareRelations(WebPage $oPage, $bEditMode = false)
+	function DisplayBareRelations(WebPage $oPage, $bEditMode = false)
 	{
 		parent::DisplayBareRelations($oPage, $bEditMode);
 
@@ -154,9 +166,10 @@ class URP_Profiles extends UserRightsBaseClassGUI
 
 	public static function GetReadOnlyAttributes()
 	{
-		return ['name', 'description'];
+		return array('name', 'description');
 	}
 
+
 	// returns an array of id => array of column => php value(so-called "real value")
 	public static function GetPredefinedObjects()
 	{
@@ -168,13 +181,15 @@ class URP_Profiles extends UserRightsBaseClassGUI
 	protected function OnDelete()
 	{
 		// Don't remove admin profile
-		if ($this->Get('name') === ADMIN_PROFILE_NAME) {
+		if ($this->Get('name') === ADMIN_PROFILE_NAME)
+		{
 			throw new SecurityException(Dict::Format('UI:Login:Error:AccessAdmin'));
 		}
 
 		// Note: this may break the rule that says: "a user must have at least ONE profile" !
 		$oLnkSet = $this->Get('user_list');
-		while ($oLnk = $oLnkSet->Fetch()) {
+		while($oLnk = $oLnkSet->Fetch())
+		{
 			$oLnk->DBDelete();
 		}
 	}
@@ -187,10 +202,11 @@ class URP_Profiles extends UserRightsBaseClassGUI
 	 * @param $sTargetState string The target state in which to evalutate the flags, if empty the current state will be used
 	 * @return integer Flags: the binary combination of the flags applicable to this attribute
 	 */
-	public function GetAttributeFlags($sAttCode, &$aReasons = [], $sTargetState = '')
+	public function GetAttributeFlags($sAttCode, &$aReasons = array(), $sTargetState = '')
 	{
 		$iFlags = parent::GetAttributeFlags($sAttCode, $aReasons, $sTargetState);
-		if (MetaModel::GetConfig()->Get('demo_mode')) {
+		if (MetaModel::GetConfig()->Get('demo_mode'))
+		{
 			$aReasons[] = 'Sorry, profiles are read-only in the demonstration mode!';
 			$iFlags |= OPT_ATT_READONLY;
 		}
@@ -198,52 +214,52 @@ class URP_Profiles extends UserRightsBaseClassGUI
 	}
 }
 
+
+
 class URP_UserProfile extends UserRightsBaseClassGUI
 {
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category"            => "addon/userrights,grant_by_profile,filter",
 			"key_type"            => "autoincrement",
-			"name_attcode"        => ["userlogin", "profile"],
+			"name_attcode"        => array("userlogin", "profile"),
 			"state_attcode"       => "",
-			"reconc_keys"         => [],
+			"reconc_keys"         => array(),
 			"db_table"            => "priv_urp_userprofile",
 			"db_key_field"        => "id",
 			"db_finalclass_field" => "",
 			"is_link" 			  => true, /** @since 3.1.0 N°6482 */
-			'uniqueness_rules'    => [
-				'no_duplicate' => [
-					'attributes'  => [
+			'uniqueness_rules'    => array(
+				'no_duplicate' => array(
+					'attributes'  => array(
 						0 => 'userid',
 						1 => 'profileid',
-					],
+					),
 					'filter'      => '',
 					'disabled'    => false,
 					'is_blocking' => true,
-				],
-			],
-		];
+				),
+			),
+		);
 		MetaModel::Init_Params($aParams);
 		//MetaModel::Init_InheritAttributes();
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("userid", ["targetclass" => "User", "jointype" => "", "allowed_values" => null, "sql" => "userid", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("userlogin", ["allowed_values" => null, "extkey_attcode" => 'userid', "target_attcode" => "login"]));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("userid", array("targetclass" => "User", "jointype" => "", "allowed_values" => null, "sql" => "userid", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("userlogin", array("allowed_values" => null, "extkey_attcode" => 'userid', "target_attcode" => "login")));
 
-		MetaModel::Init_AddAttribute(new AttributeExternalKey(
-			"profileid",
-			["targetclass" => "URP_Profiles", "jointype" => "", "allowed_values" => null, "sql" => "profileid", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => [], "allow_target_creation" => false]
-		));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("profile", ["allowed_values" => null, "extkey_attcode" => 'profileid', "target_attcode" => "name"]));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("profileid",
+			array("targetclass" => "URP_Profiles", "jointype" => "", "allowed_values" => null, "sql" => "profileid", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => array(), "allow_target_creation" => false)));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("profile", array("allowed_values" => null, "extkey_attcode" => 'profileid', "target_attcode" => "name")));
 
-		MetaModel::Init_AddAttribute(new AttributeString("reason", ["allowed_values" => null, "sql" => "description", "default_value" => null, "is_null_allowed" => true, "depends_on" => []]));
+		MetaModel::Init_AddAttribute(new AttributeString("reason", array("allowed_values" => null, "sql" => "description", "default_value" => null, "is_null_allowed" => true, "depends_on" => array())));
 
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['userid', 'profileid', 'reason']); // Attributes to be displayed for the complete details
-		MetaModel::Init_SetZListItems('list', ['userid', 'profileid', 'reason']); // Attributes to be displayed for a list
+		MetaModel::Init_SetZListItems('details', array('userid', 'profileid', 'reason')); // Attributes to be displayed for the complete details
+		MetaModel::Init_SetZListItems('list', array('userid', 'profileid', 'reason')); // Attributes to be displayed for a list
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['userid', 'profileid']); // Criteria of the std search form
-		MetaModel::Init_SetZListItems('advanced_search', ['userid', 'profileid']); // Criteria of the advanced search form
+		MetaModel::Init_SetZListItems('standard_search', array('userid', 'profileid')); // Criteria of the std search form
+		MetaModel::Init_SetZListItems('advanced_search', array('userid', 'profileid')); // Criteria of the advanced search form
 	}
 
 	public function CheckToDelete(&$oDeletionPlan)
@@ -251,14 +267,15 @@ class URP_UserProfile extends UserRightsBaseClassGUI
 		if (MetaModel::GetConfig()->Get('demo_mode')) {
 			// Users deletion is NOT allowed in demo mode
 			$oDeletionPlan->AddToDelete($this, null);
-			$oDeletionPlan->SetDeletionIssues($this, ['deletion not allowed in demo mode.'], true);
+			$oDeletionPlan->SetDeletionIssues($this, array('deletion not allowed in demo mode.'), true);
 			$oDeletionPlan->ComputeResults();
 
 			return false;
 		}
 		try {
 			$this->CheckIfProfileIsAllowed(UR_ACTION_DELETE);
-		} catch (SecurityException $e) {
+		}
+		catch (SecurityException $e) {
 			// Users deletion is NOT allowed
 			$oDeletionPlan->AddToDelete($this, null);
 			$oDeletionPlan->SetDeletionIssues($this, [$e->getMessage()], true);
@@ -275,14 +292,15 @@ class URP_UserProfile extends UserRightsBaseClassGUI
 		if (MetaModel::GetConfig()->Get('demo_mode')) {
 			// Users deletion is NOT allowed in demo mode
 			$oDeletionPlan->AddToDelete($this, null);
-			$oDeletionPlan->SetDeletionIssues($this, ['deletion not allowed in demo mode.'], true);
+			$oDeletionPlan->SetDeletionIssues($this, array('deletion not allowed in demo mode.'), true);
 			$oDeletionPlan->ComputeResults();
 
 			return false;
 		}
 		try {
 			$this->CheckIfProfileIsAllowed(UR_ACTION_DELETE);
-		} catch (SecurityException $e) {
+		}
+		catch (SecurityException $e) {
 			// Users deletion is NOT allowed
 			$oDeletionPlan->AddToDelete($this, null);
 			$oDeletionPlan->SetDeletionIssues($this, [$e->getMessage()], true);
@@ -318,30 +336,29 @@ class URP_UserProfile extends UserRightsBaseClassGUI
 	protected function CheckIfProfileIsAllowed($iActionCode)
 	{
 		// When initializing or admin, we need to let everything pass trough
-		if (!UserRights::IsLoggedIn() || UserRights::IsAdministrator()) {
-			return;
-		}
+		if (!UserRights::IsLoggedIn() || UserRights::IsAdministrator()) { return; }
 
 		// Only administrators can manage administrators
 		$iOrigUserId = $this->GetOriginal('userid');
-		if (!empty($iOrigUserId)) {
+		if (!empty($iOrigUserId))
+		{
 			$oUser = MetaModel::GetObject('User', $iOrigUserId, true, true);
-			if (UserRights::IsAdministrator($oUser) && !UserRights::IsAdministrator()) {
+			if (UserRights::IsAdministrator($oUser) && !UserRights::IsAdministrator())
+			{
 				throw new SecurityException(Dict::Format('UI:Login:Error:AccessRestricted'));
 			}
 		}
 		$oUser = MetaModel::GetObject('User', $this->Get('userid'), true, true);
-		if (UserRights::IsAdministrator($oUser) && !UserRights::IsAdministrator()) {
+		if (UserRights::IsAdministrator($oUser) && !UserRights::IsAdministrator())
+		{
 			throw new SecurityException(Dict::Format('UI:Login:Error:AccessRestricted'));
 		}
-
-		$oSet = new \ormLinkSet(get_class($oUser), 'profile_list', \DBObjectSet::FromScratch(\URP_UserProfile::class));
-		$oSet->AddItem(MetaModel::NewObject('URP_UserProfile', ['profileid' => $this->GetKey(), 'reason' => 'CheckIfProfileIsAllowed']));
-
-		if (!UserRights::IsActionAllowed(get_class($this), $iActionCode, $oSet)) {
+		if (!UserRights::IsActionAllowed(get_class($this), $iActionCode, DBObjectSet::FromObject($this)))
+		{
 			throw new SecurityException(Dict::Format('UI:Error:ObjectCannotBeUpdated'));
 		}
-		if (!UserRights::IsAdministrator() && ($this->Get('profile') === ADMIN_PROFILE_NAME)) {
+		if (!UserRights::IsAdministrator() && ($this->Get('profile') === ADMIN_PROFILE_NAME))
+		{
 			throw new SecurityException(Dict::Format('UI:Login:Error:AccessAdmin'));
 		}
 	}
@@ -352,33 +369,33 @@ class URP_UserOrg extends UserRightsBaseClassGUI
 {
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category" => "addon/userrights,grant_by_profile",
 			"key_type" => "autoincrement",
-			"name_attcode" => ["userlogin", "allowed_org_name"],
+			"name_attcode" => array("userlogin", "allowed_org_name"),
 			"state_attcode" => "",
-			"reconc_keys" => [],
+			"reconc_keys" => array(),
 			"db_table" => "priv_urp_userorg",
 			"db_key_field" => "id",
 			"db_finalclass_field" => "",
-		];
+		);
 		MetaModel::Init_Params($aParams);
 		//MetaModel::Init_InheritAttributes();
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("userid", ["targetclass" => "User", "jointype" => "", "allowed_values" => null, "sql" => "userid", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("userlogin", ["allowed_values" => null, "extkey_attcode" => 'userid', "target_attcode" => "login"]));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("userid", array("targetclass"=>"User", "jointype"=> "", "allowed_values"=>null, "sql"=>"userid", "is_null_allowed"=>false, "on_target_delete"=>DEL_AUTO, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("userlogin", array("allowed_values"=>null, "extkey_attcode"=> 'userid', "target_attcode"=>"login")));
 
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("allowed_org_id", ["targetclass" => "Organization", "jointype" => "", "allowed_values" => null, "sql" => "allowed_org_id", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("allowed_org_name", ["allowed_values" => null, "extkey_attcode" => 'allowed_org_id', "target_attcode" => "name"]));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("allowed_org_id", array("targetclass"=>"Organization", "jointype"=> "", "allowed_values"=>null, "sql"=>"allowed_org_id", "is_null_allowed"=>false, "on_target_delete"=>DEL_AUTO, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("allowed_org_name", array("allowed_values"=>null, "extkey_attcode"=> 'allowed_org_id', "target_attcode"=>"name")));
 
-		MetaModel::Init_AddAttribute(new AttributeString("reason", ["allowed_values" => null, "sql" => "reason", "default_value" => null, "is_null_allowed" => true, "depends_on" => []]));
+		MetaModel::Init_AddAttribute(new AttributeString("reason", array("allowed_values"=>null, "sql"=>"reason", "default_value"=>null, "is_null_allowed"=>true, "depends_on"=>array())));
 
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['userid', 'allowed_org_id', 'reason']); // Attributes to be displayed for the complete details
-		MetaModel::Init_SetZListItems('list', ['allowed_org_id', 'reason']); // Attributes to be displayed for a list
+		MetaModel::Init_SetZListItems('details', array('userid', 'allowed_org_id', 'reason')); // Attributes to be displayed for the complete details
+		MetaModel::Init_SetZListItems('list', array('allowed_org_id', 'reason')); // Attributes to be displayed for a list
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['userid', 'allowed_org_id']); // Criteria of the std search form
-		MetaModel::Init_SetZListItems('advanced_search', ['userid', 'allowed_org_id']); // Criteria of the advanced search form
+		MetaModel::Init_SetZListItems('standard_search', array('userid', 'allowed_org_id')); // Criteria of the std search form
+		MetaModel::Init_SetZListItems('advanced_search', array('userid', 'allowed_org_id')); // Criteria of the advanced search form
 	}
 
 	protected function OnInsert()
@@ -401,37 +418,40 @@ class URP_UserOrg extends UserRightsBaseClassGUI
 	 */
 	protected function CheckIfOrgIsAllowed()
 	{
-		if (!UserRights::IsLoggedIn() || UserRights::IsAdministrator()) {
-			return;
-		}
+		if (!UserRights::IsLoggedIn() || UserRights::IsAdministrator()) { return; }
 
 		$oUser = UserRights::GetUserObject();
 		$oAddon = UserRights::GetModuleInstance();
 		$aOrgs = $oAddon->GetUserOrgs($oUser, '');
-		if (count($aOrgs) > 0) {
+		if (count($aOrgs) > 0)
+		{
 			$iOrigOrgId = $this->GetOriginal('allowed_org_id');
-			if ((!empty($iOrigOrgId) && !in_array($iOrigOrgId, $aOrgs)) || !in_array($this->Get('allowed_org_id'), $aOrgs)) {
+			if ((!empty($iOrigOrgId) && !in_array($iOrigOrgId, $aOrgs)) || !in_array($this->Get('allowed_org_id'), $aOrgs))
+			{
 				throw new SecurityException(Dict::Format('Class:User/Error:OrganizationNotAllowed'));
 			}
 		}
 	}
 }
 
+
+
+
 class UserRightsProfile extends UserRightsAddOnAPI
 {
-	public static $m_aActionCodes = [
+	static public $m_aActionCodes = array(
 		UR_ACTION_READ => 'r',
 		UR_ACTION_MODIFY => 'w',
 		UR_ACTION_DELETE => 'd',
 		UR_ACTION_BULK_READ => 'br',
 		UR_ACTION_BULK_MODIFY => 'bw',
 		UR_ACTION_BULK_DELETE => 'bd',
-	];
+	);
 
-	/**
-	 * @var array $aUsersProfilesList Cache of users' profiles. Hash array of user ID => [profile ID => profile friendlyname, profile ID => profile friendlyname, ...]
-	 * @since 2.7.10 3.0.4 3.1.1 3.2.0 N°6887
-	 */
+    /**
+     * @var array $aUsersProfilesList Cache of users' profiles. Hash array of user ID => [profile ID => profile friendlyname, profile ID => profile friendlyname, ...]
+     * @since 2.7.10 3.0.4 3.1.1 3.2.0 N°6887
+     */
 	private $aUsersProfilesList = [];
 
 	// Installation: create the very first user
@@ -452,7 +472,8 @@ class UserRightsProfile extends UserRightsAddOnAPI
 				$oContact = MetaModel::NewObject('Person');
 				$oContact->Set('name', 'My last name');
 				$oContact->Set('first_name', 'My first name');
-				if (MetaModel::IsValidAttCode('Person', 'org_id')) {
+				if (MetaModel::IsValidAttCode('Person', 'org_id'))
+				{
 					$oContact->Set('org_id', $iOrgId);
 				}
 				$oContact->Set('email', 'my.email@foo.org');
@@ -460,19 +481,24 @@ class UserRightsProfile extends UserRightsAddOnAPI
 			}
 		}
 
+
 		$oUser = new UserLocal();
 		$oUser->Set('login', $sAdminUser);
 		$oUser->Set('password', $sAdminPwd);
-		if (MetaModel::IsValidAttCode('UserLocal', 'contactid') && ($iContactId != 0)) {
+		if (MetaModel::IsValidAttCode('UserLocal', 'contactid') && ($iContactId != 0))
+		{
 			$oUser->Set('contactid', $iContactId);
 		}
 		$oUser->Set('language', $sLanguage); // Language was chosen during the installation
 
 		// Add this user to the very specific 'admin' profile
-		$oAdminProfile = MetaModel::GetObjectFromOQL("SELECT URP_Profiles WHERE name = :name", ['name' => ADMIN_PROFILE_NAME], true /*all data*/);
-		if (is_object($oAdminProfile)) {
-			$oSet = new \ormLinkSet(UserLocal::class, 'profile_list', \DBObjectSet::FromScratch(\URP_UserProfile::class));
-			$oSet->AddItem(MetaModel::NewObject('URP_UserProfile', ['profileid' => $oAdminProfile->GetKey(), 'reason' => 'CreateAdministrator']));
+		$oAdminProfile = MetaModel::GetObjectFromOQL("SELECT URP_Profiles WHERE name = :name", array('name' => ADMIN_PROFILE_NAME), true /*all data*/);
+		if (is_object($oAdminProfile))
+		{
+			$oUserProfile = new URP_UserProfile();
+			$oUserProfile->Set('profileid', $oAdminProfile->GetKey());
+			$oUserProfile->Set('reason', 'By definition, the administrator must have the administrator profile');
+			$oSet = DBObjectSet::FromObject($oUserProfile);
 			$oUser->Set('profile_list', $oSet);
 		}
 		$iUserId = $oUser->DBInsertNoReload();
@@ -483,11 +509,11 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	{
 	}
 
-	protected $m_aUserOrgs = []; // userid -> array of orgid
+	protected $m_aUserOrgs = array(); // userid -> array of orgid
 	protected $m_aAdministrators = null; // [user id]
 
 	// Built on demand, could be optimized if necessary (doing a query for each attribute that needs to be read)
-	protected $m_aObjectActionGrants = [];
+	protected $m_aObjectActionGrants = array();
 
 	/**
 	 * Read and cache organizations allowed to the given user
@@ -502,25 +528,31 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	public function GetUserOrgs($oUser, $sClass)
 	{
 		$iUser = $oUser->GetKey();
-		if (!array_key_exists($iUser, $this->m_aUserOrgs)) {
-			$this->m_aUserOrgs[$iUser] = [];
+		if (!array_key_exists($iUser, $this->m_aUserOrgs))
+		{
+			$this->m_aUserOrgs[$iUser] = array();
 
 			$sHierarchicalKeyCode = MetaModel::IsHierarchicalClass('Organization');
-			if ($sHierarchicalKeyCode !== false) {
+			if ($sHierarchicalKeyCode !== false)
+			{
 				$sUserOrgQuery = 'SELECT UserOrg, Org FROM Organization AS Org JOIN Organization AS Root ON Org.'.$sHierarchicalKeyCode.' BELOW Root.id JOIN URP_UserOrg AS UserOrg ON UserOrg.allowed_org_id = Root.id WHERE UserOrg.userid = :userid';
-				$oUserOrgSet = new DBObjectSet(DBObjectSearch::FromOQL_AllData($sUserOrgQuery), [], ['userid' => $iUser]);
-				while ($aRow = $oUserOrgSet->FetchAssoc()) {
+				$oUserOrgSet = new DBObjectSet(DBObjectSearch::FromOQL_AllData($sUserOrgQuery), array(), array('userid' => $iUser));
+				while ($aRow = $oUserOrgSet->FetchAssoc())
+				{
 					$oOrg = $aRow['Org'];
 					$this->m_aUserOrgs[$iUser][] = $oOrg->GetKey();
 				}
-			} else {
+			}
+			else
+			{
 				$oSearch = new DBObjectSearch('URP_UserOrg');
 				$oSearch->AllowAllData();
 				$oCondition = new BinaryExpression(new FieldExpression('userid'), '=', new VariableExpression('userid'));
 				$oSearch->AddConditionExpression($oCondition);
 
-				$oUserOrgSet = new DBObjectSet($oSearch, [], ['userid' => $iUser]);
-				while ($oUserOrg = $oUserOrgSet->Fetch()) {
+				$oUserOrgSet = new DBObjectSet($oSearch, array(), array('userid' => $iUser));
+				while ($oUserOrg = $oUserOrgSet->Fetch())
+				{
 					$this->m_aUserOrgs[$iUser][] = $oUserOrg->Get('allowed_org_id');
 				}
 			}
@@ -531,20 +563,21 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	public function ResetCache()
 	{
 		// Loaded by Load cache
-		$this->m_aUserOrgs = [];
+		$this->m_aUserOrgs = array();
 
 		// Cache
-		$this->m_aObjectActionGrants = [];
+		$this->m_aObjectActionGrants = array();
 		$this->m_aAdministrators = null;
-		$this->aUsersProfilesList = [];
 	}
 
 	public function LoadCache()
 	{
 		static $bSharedObjectInitialized = false;
-		if (!$bSharedObjectInitialized) {
+		if (!$bSharedObjectInitialized)
+		{
 			$bSharedObjectInitialized = true;
-			if (self::HasSharing()) {
+			if (self::HasSharing())
+			{
 				SharedObject::InitSharedClassProperties();
 			}
 		}
@@ -582,40 +615,45 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	 */
 	public function ListProfiles($oUser)
 	{
-		$aRet = [];
+		$aRet = array();
 		$oSearch = new DBObjectSearch('URP_UserProfile');
 		$oSearch->AllowAllData();
 		$oSearch->NoContextParameters();
 		$oSearch->Addcondition('userid', $oUser->GetKey(), '=');
 		$oProfiles = new DBObjectSet($oSearch);
-		while ($oUserProfile = $oProfiles->Fetch()) {
+		while ($oUserProfile = $oProfiles->Fetch())
+		{
 			$aRet[$oUserProfile->Get('profileid')] = $oUserProfile->Get('profileid_friendlyname');
 		}
 		return $aRet;
 	}
 
-	public function GetSelectFilter($oUser, $sClass, $aSettings = [])
+	public function GetSelectFilter($oUser, $sClass, $aSettings = array())
 	{
 		$this->LoadCache();
 
 		// Let us pass an administrator for bypassing the grant matrix check in order to test this method without the need to set up a complex profile
 		// In the nominal case Administrators never end up here (since they completely bypass GetSelectFilter)
-		if (!static::IsAdministrator($oUser) && (MetaModel::HasCategory($sClass, 'silo') || MetaModel::HasCategory($sClass, 'bizmodel'))) {
+		if (!static::IsAdministrator($oUser) && (MetaModel::HasCategory($sClass, 'silo') || MetaModel::HasCategory($sClass, 'bizmodel')))
+		{
 			// N°4354 - Categories 'silo' and 'bizmodel' do check the grant matrix. Whereas 'filter' always allows to read (but the result can be filtered)
 			$aObjectPermissions = $this->GetUserActionGrant($oUser, $sClass, UR_ACTION_READ);
-			if ($aObjectPermissions['permission'] == UR_ALLOWED_NO) {
+			if ($aObjectPermissions['permission'] == UR_ALLOWED_NO)
+			{
 				return false;
 			}
 		}
 
 		$oFilter = true;
-		$aConditions =  [];
+		$aConditions =  array();
 
 		// Determine if this class is part of a silo and build the filter for it
 		$sAttCode = self::GetOwnerOrganizationAttCode($sClass);
-		if (!is_null($sAttCode)) {
+		if (!is_null($sAttCode))
+		{
 			$aUserOrgs = $this->GetUserOrgs($oUser, $sClass);
-			if (count($aUserOrgs) > 0) {
+			if (count($aUserOrgs) > 0)
+			{
 				$oFilter = $this->MakeSelectFilter($sClass, $aUserOrgs, $aSettings, $sAttCode);
 			}
 			// else: No org means 'any org'
@@ -624,15 +662,20 @@ class UserRightsProfile extends UserRightsAddOnAPI
 
 		// Specific conditions to hide, for non-administrators, the Administrator Users, the Administrator Profile and related links
 		// Note: when logged as an administrator, GetSelectFilter is completely bypassed.
-		if ($this->AdministratorsAreHidden()) {
-			if ($sClass == 'URP_Profiles') {
+		if ($this->AdministratorsAreHidden())
+		{
+			if ($sClass == 'URP_Profiles')
+			{
 				$oExpression = new FieldExpression('id', $sClass);
 				$oScalarExpr = new ScalarExpression(1);
 
 				$aConditions[] = new BinaryExpression($oExpression, '!=', $oScalarExpr);
-			} elseif (($sClass == 'URP_UserProfile') || ($sClass == 'User') || (is_subclass_of($sClass, 'User'))) {
+			}
+			else if (($sClass == 'URP_UserProfile') || ($sClass == 'User') || (is_subclass_of($sClass, 'User')))
+			{
 				$aAdministrators = $this->GetAdministrators();
-				if (count($aAdministrators) > 0) {
+				if (count($aAdministrators) > 0)
+				{
 					$sAttCode = ($sClass == 'URP_UserProfile') ? 'userid' : 'id';
 					$oExpression = new FieldExpression($sAttCode, $sClass);
 					$oListExpr = ListExpression::FromScalars($aAdministrators);
@@ -642,14 +685,17 @@ class UserRightsProfile extends UserRightsAddOnAPI
 		}
 
 		// Handling of the added conditions
-		if (count($aConditions) > 0) {
-			if ($oFilter === true) {
+		if (count($aConditions) > 0)
+		{
+			if($oFilter === true)
+			{
 				// No 'silo' filter, let's build a clean one
 				$oFilter = new DBObjectSearch($sClass);
 			}
 
 			// Add the conditions to the filter
-			foreach ($aConditions as $oCondition) {
+			foreach($aConditions as $oCondition)
+			{
 				$oFilter->AddConditionExpression($oCondition);
 			}
 		}
@@ -664,9 +710,10 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	 */
 	private function GetAdministrators()
 	{
-		if ($this->m_aAdministrators === null) {
+		if ($this->m_aAdministrators === null)
+		{
 			// Find all administrators
-			$this->m_aAdministrators = [];
+			$this->m_aAdministrators = array();
 			$oAdministratorsFilter = new DBObjectSearch('User');
 			$oLnkFilter = new DBObjectSearch('URP_UserProfile');
 			$oExpression = new FieldExpression('profileid', 'URP_UserProfile');
@@ -676,8 +723,9 @@ class UserRightsProfile extends UserRightsAddOnAPI
 			$oAdministratorsFilter->AddCondition_ReferencedBy($oLnkFilter, 'userid');
 			$oAdministratorsFilter->AllowAllData(true); // Mandatory to prevent infinite recursion !!
 			$oSet = new DBObjectSet($oAdministratorsFilter);
-			$oSet->OptimizeColumnLoad(['User' => ['login']]);
-			while ($oUser = $oSet->Fetch()) {
+			$oSet->OptimizeColumnLoad(array('User' => array('login')));
+			while($oUser = $oSet->Fetch())
+			{
 				$this->m_aAdministrators[] = $oUser->GetKey();
 			}
 		}
@@ -693,6 +741,7 @@ class UserRightsProfile extends UserRightsAddOnAPI
 		return ((bool)MetaModel::GetConfig()->Get('security.hide_administrators'));
 	}
 
+
 	// This verb has been made public to allow the development of an accurate feedback for the current configuration
 	public function GetProfileActionGrant($iProfile, $sClass, $sAction)
 	{
@@ -709,29 +758,33 @@ class UserRightsProfile extends UserRightsAddOnAPI
 		// load and cache permissions for the current user on the given class
 		//
 		$iUser = $oUser->GetKey();
-		if (isset($this->m_aObjectActionGrants[$iUser][$sClass][$iActionCode])) {
+		if (isset($this->m_aObjectActionGrants[$iUser][$sClass][$iActionCode])){
 			$aTest = $this->m_aObjectActionGrants[$iUser][$sClass][$iActionCode];
-			if (is_array($aTest)) {
-				return $aTest;
-			}
+			if (is_array($aTest)) return $aTest;
 		}
 
 		$sAction = self::$m_aActionCodes[$iActionCode];
 
 		$bStatus = null;
-		// Cache user's profiles
-		if (false === array_key_exists($iUser, $this->aUsersProfilesList)) {
-			$this->aUsersProfilesList[$iUser] = UserRights::ListProfiles($oUser);
+        // Cache user's profiles
+		if(false === array_key_exists($iUser, $this->aUsersProfilesList)){
+		     $this->aUsersProfilesList[$iUser] = UserRights::ListProfiles($oUser);
 		}
 		// Call the API of UserRights because it caches the list for us
-		foreach ($this->aUsersProfilesList[$iUser] as $iProfile => $oProfile) {
+		foreach($this->aUsersProfilesList[$iUser] as $iProfile => $oProfile)
+		{
 			$bGrant = $this->GetProfileActionGrant($iProfile, $sClass, $sAction);
-			if (!is_null($bGrant)) {
-				if ($bGrant) {
-					if (is_null($bStatus)) {
+			if (!is_null($bGrant))
+			{
+				if ($bGrant)
+				{
+					if (is_null($bStatus))
+					{
 						$bStatus = true;
 					}
-				} else {
+				}
+				else
+				{
 					$bStatus = false;
 				}
 			}
@@ -739,9 +792,9 @@ class UserRightsProfile extends UserRightsAddOnAPI
 
 		$iPermission = $bStatus ? UR_ALLOWED_YES : UR_ALLOWED_NO;
 
-		$aRes = [
+		$aRes = array(
 			'permission' => $iPermission,
-		];
+		);
 		$this->m_aObjectActionGrants[$iUser][$sClass][$iActionCode] = $aRes;
 		return $aRes;
 	}
@@ -756,13 +809,20 @@ class UserRightsProfile extends UserRightsAddOnAPI
 		// Note: In most cases the object set is ignored because it was interesting to optimize for huge data sets
 		//       and acceptable to consider only the root class of the object set
 
-		if ($iPermission != UR_ALLOWED_YES) {
+		if ($iPermission != UR_ALLOWED_YES)
+		{
 			// It is already NO for everyone... that's the final word!
-		} elseif ($iActionCode == UR_ACTION_READ) {
+		}
+		elseif ($iActionCode == UR_ACTION_READ)
+		{
 			// We are protected by GetSelectFilter: the object set contains objects allowed or shared for reading
-		} elseif ($iActionCode == UR_ACTION_BULK_READ) {
+		}
+		elseif ($iActionCode == UR_ACTION_BULK_READ)
+		{
 			// We are protected by GetSelectFilter: the object set contains objects allowed or shared for reading
-		} elseif ($oInstanceSet) {
+		}
+		elseif ($oInstanceSet)
+		{
 			// We are protected by GetSelectFilter: the object set contains objects allowed or shared for reading
 			// We have to answer NO for objects shared for reading purposes
 			if (self::HasSharing() && SharedObject::GetSharedClassProperties($sClass)) {
@@ -826,8 +886,8 @@ class UserRightsProfile extends UserRightsAddOnAPI
 		// Note: this code is VERY close to the code of IsActionAllowed()
 		$iUser = $oUser->GetKey();
 
-		// Cache user's profiles
-		if (false === array_key_exists($iUser, $this->aUsersProfilesList)) {
+        // Cache user's profiles
+		if(false === array_key_exists($iUser, $this->aUsersProfilesList)){
 			$this->aUsersProfilesList[$iUser] = UserRights::ListProfiles($oUser);
 		}
 
@@ -835,14 +895,20 @@ class UserRightsProfile extends UserRightsAddOnAPI
 		//       and acceptable to consider only the root class of the object set
 		$bStatus = null;
 		// Call the API of UserRights because it caches the list for us
-		foreach ($this->aUsersProfilesList[$iUser] as $iProfile => $oProfile) {
+		foreach($this->aUsersProfilesList[$iUser] as $iProfile => $oProfile)
+		{
 			$bGrant = $this->GetClassStimulusGrant($iProfile, $sClass, $sStimulusCode);
-			if (!is_null($bGrant)) {
-				if ($bGrant) {
-					if (is_null($bStatus)) {
+			if (!is_null($bGrant))
+			{
+				if ($bGrant)
+				{
+					if (is_null($bStatus))
+					{
 						$bStatus = true;
 					}
-				} else {
+				}
+				else
+				{
 					$bStatus = false;
 				}
 			}
@@ -866,16 +932,22 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	{
 		$sAttCode = null;
 
-		$aCallSpec = [$sClass, 'MapContextParam'];
-		if (($sClass == 'Organization') || is_subclass_of($sClass, 'Organization')) {
+		$aCallSpec = array($sClass, 'MapContextParam');
+		if (($sClass == 'Organization') || is_subclass_of($sClass, 'Organization'))
+		{
 			$sAttCode = 'id';
-		} elseif (is_callable($aCallSpec)) {
+		}
+		elseif (is_callable($aCallSpec))
+		{
 			$sAttCode = call_user_func($aCallSpec, 'org_id'); // Returns null when there is no mapping for this parameter
-			if (!MetaModel::IsValidAttCode($sClass, $sAttCode)) {
+			if (!MetaModel::IsValidAttCode($sClass, $sAttCode))
+			{
 				// Skip silently. The data model checker will tell you something about this...
 				$sAttCode = null;
 			}
-		} elseif (MetaModel::IsValidAttCode($sClass, 'org_id')) {
+		}
+		elseif(MetaModel::IsValidAttCode($sClass, 'org_id'))
+		{
 			$sAttCode = 'org_id';
 		}
 
@@ -888,11 +960,14 @@ class UserRightsProfile extends UserRightsAddOnAPI
 	protected static function HasSharing()
 	{
 		static $bHasSharing;
-		if (!isset($bHasSharing)) {
+		if (!isset($bHasSharing))
+		{
 			$bHasSharing = class_exists('SharedObject');
 		}
 		return $bHasSharing;
 	}
 }
 
+
 UserRights::SelectModule('UserRightsProfile');
+

app.php

@@ -0,0 +1,29 @@
+<?php
+/**
+ * Copyright (C) 2013-2024 Combodo SAS
+ *
+ * This file is part of iTop.
+ *
+ * iTop 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.
+ *
+ * iTop 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
+ */
+
+use Combodo\iTop\Kernel;
+
+require_once __DIR__.'/lib/autoload_runtime.php';
+
+require_once('approot.inc.php');
+require_once('application/startup.inc.php');
+
+return function (array $context) {
+    return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+};

application/DBSearchHelper.php

@@ -1,5 +1,4 @@
 <?php
-
 /*
  * @copyright   Copyright (C) 2010-2024 Combodo SAS
  * @license     http://opensource.org/licenses/AGPL-3.0
@@ -49,7 +48,8 @@ class DBSearchHelper
 								$oHKFilter->AddCondition_PointingTo($oFilter, $sHierarchicalKeyCode, TREE_OPERATOR_BELOW);
 								$oSearch->AddCondition_PointingTo($oHKFilter, $sAttCode);
 							}
-						} catch (Exception $e) {
+						}
+						catch (Exception $e) {
 							// If filtering fails just ignore it
 						}
 					}
@@ -57,4 +57,4 @@ class DBSearchHelper
 			}
 		}
 	}
-}
+}

application/application.inc.php

@@ -1,5 +1,4 @@
 <?php
-
 /*
  * @copyright   Copyright (C) 2010-2024 Combodo SAS
  * @license     http://opensource.org/licenses/AGPL-3.0

application/applicationcontext.class.inc.php

@@ -1,10 +1,9 @@
 <?php
-
 // Copyright (C) 2010-2024 Combodo SAS
 //
 //   This file is part of iTop.
 //
-//   iTop is free software; you can redistribute it and/or modify
+//   iTop 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.
@@ -17,6 +16,7 @@
 //   You should have received a copy of the GNU Affero General Public License
 //   along with iTop. If not, see <http://www.gnu.org/licenses/>
 
+
 /**
  * Class ApplicationContext
  *
@@ -47,16 +47,16 @@ interface iDBObjectURLMaker
 
 /**
  * Direct end-users to the standard iTop application: UI.php
- */
+ */ 
 class iTopStandardURLMaker implements iDBObjectURLMaker
 {
-	/**
-	 * @param string $sClass
-	 * @param string $iId
-	 *
-	 * @return string
-	 * @throws \Exception
-	 */
+    /**
+     * @param string $sClass
+     * @param string $iId
+     *
+     * @return string
+     * @throws \Exception
+     */
 	public static function MakeObjectURL($sClass, $iId)
 	{
 		$sPage = DBObject::ComputeStandardUIPage($sClass);
@@ -68,16 +68,16 @@ class iTopStandardURLMaker implements iDBObjectURLMaker
 
 /**
  * Direct end-users to the standard Portal application
- */
+ */ 
 class PortalURLMaker implements iDBObjectURLMaker
 {
-	/**
-	 * @param string $sClass
-	 * @param string $iId
-	 *
-	 * @return string
-	 * @throws \Exception
-	 */
+    /**
+     * @param string $sClass
+     * @param string $iId
+     *
+     * @return string
+     * @throws \Exception
+     */
 	public static function MakeObjectURL($sClass, $iId)
 	{
 		$sAbsoluteUrl = utils::GetAbsoluteUrlAppRoot();
@@ -86,6 +86,7 @@ class PortalURLMaker implements iDBObjectURLMaker
 	}
 }
 
+
 /**
  * Helper class to store and manipulate the parameters that make the application's context
  *
@@ -98,90 +99,99 @@ class PortalURLMaker implements iDBObjectURLMaker
  */
 class ApplicationContext
 {
-	public static $m_sUrlMakerClass = null;
-	protected static $m_aPluginProperties = null;
-	protected static $aDefaultValues; // Cache shared among all instances
+    public static $m_sUrlMakerClass = null;
+    protected static $m_aPluginProperties = null;
+    protected static $aDefaultValues; // Cache shared among all instances
 
 	protected $aNames;
 	protected $aValues;
 
-	/**
-	 * ApplicationContext constructor.
-	 *
-	 * @param bool $bReadContext
-	 *
-	 * @throws \Exception
-	 */
+    /**
+     * ApplicationContext constructor.
+     *
+     * @param bool $bReadContext
+     *
+     * @throws \Exception
+     */
 	public function __construct($bReadContext = true)
 	{
-		$this->aNames = [
-			'org_id', 'menu',
-		];
-		if ($bReadContext) {
-			$this->ReadContext();
+		$this->aNames = array(
+			'org_id', 'menu'
+		);
+		if ($bReadContext)
+		{
+			$this->ReadContext();			
 		}
 
 	}
 
-	/**
-	 * Read the context directly in the PHP parameters (either POST or GET)
-	 * return nothing
-	 *
-	 * @throws \Exception
-	 */
+    /**
+     * Read the context directly in the PHP parameters (either POST or GET)
+     * return nothing
+     *
+     * @throws \Exception
+     */
 	protected function ReadContext()
 	{
-		if (!isset(self::$aDefaultValues)) {
-			self::$aDefaultValues = [];
-			$aContext = utils::ReadParam('c', [], false, 'context_param');
-			foreach ($this->aNames as $sName) {
+		if (!isset(self::$aDefaultValues))
+		{
+			self::$aDefaultValues = array();
+			$aContext = utils::ReadParam('c', array(), false, 'context_param');
+			foreach($this->aNames as $sName)
+			{
 				$sValue = isset($aContext[$sName]) ? $aContext[$sName] : '';
 				// TO DO: check if some of the context parameters are mandatory (or have default values)
-				if (!empty($sValue)) {
+				if (!empty($sValue))
+				{
 					self::$aDefaultValues[$sName] = $sValue;
 				}
 				// Hmm, there must be a better (more generic) way to handle the case below:
 				// When there is only one possible (allowed) organization, the context must be
 				// fixed to this org unless there is only one organization in the system then
 				// no filter is applied
-				if ($sName == 'org_id') {
-					if (MetaModel::IsValidClass('Organization')) {
+				if ($sName == 'org_id')
+				{
+					if (MetaModel::IsValidClass('Organization'))
+					{
 						$oSearchFilter = new DBObjectSearch('Organization');
 						$oSet = new CMDBObjectSet($oSearchFilter);
 						$iCount = $oSet->CountWithLimit(2);
-						if ($iCount > 1) {
+						if ($iCount > 1)
+						{
 							$oSearchFilter->SetModifierProperty('UserRightsGetSelectFilter', 'bSearchMode', true);
 							$oSet = new CMDBObjectSet($oSearchFilter);
 							$iCount = $oSet->CountWithLimit(2);
-							if ($iCount == 1) {
+							if ($iCount == 1)
+							{
 								// Only one possible value for org_id, set it in the context
 								$oOrg = $oSet->Fetch();
 								self::$aDefaultValues[$sName] = $oOrg->GetKey();
 							}
 						}
-					}
+					}					
 				}
 			}
 		}
 		$this->aValues = self::$aDefaultValues;
 	}
 
-	/**
-	 * Returns the current value for the given parameter
-	 *
-	 * @param string $sParamName Name of the parameter to read
-	 * @param string $defaultValue
-	 *
-	 * @return mixed The value for this parameter
-	 */
+    /**
+     * Returns the current value for the given parameter
+     *
+     * @param string $sParamName Name of the parameter to read
+     * @param string $defaultValue
+     *
+     * @return mixed The value for this parameter
+     */
 	public function GetCurrentValue($sParamName, $defaultValue = '')
 	{
-		if (isset($this->aValues[$sParamName])) {
+		if (isset($this->aValues[$sParamName]))
+		{
 			return $this->aValues[$sParamName];
 		}
 		return $defaultValue;
 	}
-
+	
 	/**
 	 * Returns the context as string with the format name1=value1&name2=value2....
 	 * @return string The context as a string to be appended to an href property
@@ -190,20 +200,21 @@ class ApplicationContext
 	public function GetForLink(bool $bWithLeadingAmpersand = false)
 	{
 		// If there are no parameters, return an empty string
-		if (empty($this->aValues)) {
+		if(empty($this->aValues)){
 			return '';
 		}
 
 		// Build the query string with ampersand separated parameters
-		$aParams = [];
-		foreach ($this->aValues as $sName => $sValue) {
+		$aParams = array();
+		foreach($this->aValues as $sName => $sValue)
+		{
 			$aParams[] = "c[$sName]".'='.urlencode($sValue);
 		}
 		$sReturnValue = implode('&', $aParams);
 
 		// add the leading ampersand if requested
-		if ($bWithLeadingAmpersand) {
-			$sReturnValue = '&'.$sReturnValue;
+		if($bWithLeadingAmpersand){
+			$sReturnValue = '&' . $sReturnValue;
 		}
 
 		return $sReturnValue;
@@ -267,13 +278,14 @@ class ApplicationContext
 	 */
 	public function GetAsHash()
 	{
-		$aReturn = [];
-		foreach ($this->aValues as $sName => $sValue) {
+		$aReturn = array();
+		foreach($this->aValues as $sName => $sValue)
+		{
 			$aReturn["c[$sName]"] = $sValue;
 		}
 		return $aReturn;
 	}
-
+	
 	/**
 	 * Returns an array of the context parameters NAMEs
 	 * @return array The list of context parameters
@@ -286,10 +298,11 @@ class ApplicationContext
 	 * Removes the specified parameter from the context, for example when the same parameter
 	 * is already a search parameter
 	 * @param string $sParamName Name of the parameter to remove
-	 */
+	 */	
 	public function Reset($sParamName)
 	{
-		if (isset($this->aValues[$sParamName])) {
+		if (isset($this->aValues[$sParamName]))
+		{
 			unset($this->aValues[$sParamName]);
 		}
 	}
@@ -305,22 +318,27 @@ class ApplicationContext
 	public function InitObjectFromContext(DBObject &$oObj)
 	{
 		$sClass = get_class($oObj);
-		foreach ($this->GetNames() as $key) {
-			$aCallSpec = [$sClass, 'MapContextParam'];
-			if (is_callable($aCallSpec)) {
-				$sAttCode = call_user_func($aCallSpec, $key); // Returns null when there is no mapping for this parameter
+		foreach($this->GetNames() as $key)
+		{
+			$aCallSpec = array($sClass, 'MapContextParam');
+			if (is_callable($aCallSpec))
+			{
+				$sAttCode = call_user_func($aCallSpec, $key); // Returns null when there is no mapping for this parameter					
 
-				if (MetaModel::IsValidAttCode($sClass, $sAttCode)) {
+				if (MetaModel::IsValidAttCode($sClass, $sAttCode))
+				{
 					$oAttDef = MetaModel::GetAttributeDef($sClass, $sAttCode);
-					if ($oAttDef->IsWritable()) {
+					if ($oAttDef->IsWritable())
+					{
 						$value = $this->GetCurrentValue($key, null);
-						if (!is_null($value)) {
+						if (!is_null($value))
+						{
 							$oObj->Set($sAttCode, $value);
 						}
 					}
 				}
 			}
-		}
+		}		
 	}
 
 	/**
@@ -344,10 +362,14 @@ class ApplicationContext
 	 */
 	public static function GetUrlMakerClass()
 	{
-		if (is_null(self::$m_sUrlMakerClass)) {
-			if (Session::IsSet('UrlMakerClass')) {
+		if (is_null(self::$m_sUrlMakerClass))
+		{
+			if (Session::IsSet('UrlMakerClass'))
+			{
 				self::$m_sUrlMakerClass = Session::Get('UrlMakerClass');
-			} else {
+			}
+			else
+			{
 				self::$m_sUrlMakerClass = 'iTopStandardURLMaker';
 			}
 		}
@@ -365,23 +387,23 @@ class ApplicationContext
 	 * @return string the name of the class
 	 * @throws \Exception
 	 */
-	public static function MakeObjectUrl($sObjClass, $sObjKey, $sUrlMakerClass = null, $bWithNavigationContext = true)
-	{
-		$oAppContext = new ApplicationContext();
+   public static function MakeObjectUrl($sObjClass, $sObjKey, $sUrlMakerClass = null, $bWithNavigationContext = true)
+   {
+   	$oAppContext = new ApplicationContext();
 
-		if (is_null($sUrlMakerClass)) {
-			$sUrlMakerClass = self::GetUrlMakerClass();
-		}
-		$sUrl = call_user_func([$sUrlMakerClass, 'MakeObjectUrl'], $sObjClass, $sObjKey);
-		if (utils::StrLen($sUrl) > 0) {
-			if ($bWithNavigationContext) {
-				return $sUrl.$oAppContext->GetForLink(true);
-			} else {
-				return $sUrl;
-			}
-		} else {
-			return '';
-		}
+        if (is_null($sUrlMakerClass)) {
+	        $sUrlMakerClass = self::GetUrlMakerClass();
+        }
+		$sUrl = call_user_func(array($sUrlMakerClass, 'MakeObjectUrl'), $sObjClass, $sObjKey);
+	   if (utils::StrLen($sUrl) > 0) {
+		   if ($bWithNavigationContext) {
+			   return $sUrl.$oAppContext->GetForLink(true);
+		   } else {
+			   return $sUrl;
+		   }
+	   } else {
+		   return '';
+	   }
 	}
 
 	/**
@@ -390,10 +412,13 @@ class ApplicationContext
 	 */
 	protected static function LoadPluginProperties()
 	{
-		if (Session::IsSet('PluginProperties')) {
+		if (Session::IsSet('PluginProperties'))
+		{
 			self::$m_aPluginProperties = Session::Get('PluginProperties');
-		} else {
-			self::$m_aPluginProperties = [];
+		}
+		else
+		{
+			self::$m_aPluginProperties = array();
 		}
 	}
 
@@ -406,9 +431,7 @@ class ApplicationContext
 	 */
 	public static function SetPluginProperty($sPluginClass, $sProperty, $value)
 	{
-		if (is_null(self::$m_aPluginProperties)) {
-			self::LoadPluginProperties();
-		}
+		if (is_null(self::$m_aPluginProperties)) self::LoadPluginProperties();
 
 		self::$m_aPluginProperties[$sPluginClass][$sProperty] = $value;
 		Session::Set(['PluginProperties', $sPluginClass, $sProperty], $value);
@@ -421,14 +444,15 @@ class ApplicationContext
 	 */
 	public static function GetPluginProperties($sPluginClass)
 	{
-		if (is_null(self::$m_aPluginProperties)) {
-			self::LoadPluginProperties();
-		}
+		if (is_null(self::$m_aPluginProperties)) self::LoadPluginProperties();
 
-		if (array_key_exists($sPluginClass, self::$m_aPluginProperties)) {
+		if (array_key_exists($sPluginClass, self::$m_aPluginProperties))
+		{
 			return self::$m_aPluginProperties[$sPluginClass];
-		} else {
-			return [];
+		}
+		else
+		{
+			return array();
 		}
 	}
 

application/applicationextension.inc.php

@@ -57,6 +57,12 @@ require_once(APPROOT.'application/applicationextension/backoffice/SeparatorPopup
 require_once(APPROOT.'application/applicationextension/backoffice/URLButtonItem.php');
 require_once(APPROOT.'application/applicationextension/backoffice/URLPopupMenuItem.php');
 
+//deprecated class and interface
+require_once(APPROOT.'application/applicationextension/backoffice/iApplicationObjectExtension.php');
+require_once(APPROOT.'application/applicationextension/backoffice/AbstractApplicationObjectExtension.php');
+
+
+
 require_once(APPROOT.'application/applicationextension/iBackupExtraFilesExtension.php');
 require_once(APPROOT.'application/applicationextension/iKPILoggerExtension.php');
 require_once(APPROOT.'application/applicationextension/iModuleExtension.php');
@@ -74,3 +80,7 @@ require_once(APPROOT.'application/applicationextension/rest/iRestInputSanitizer.
 require_once(APPROOT.'application/applicationextension/rest/iRestServiceProvider.php');
 require_once(APPROOT.'application/applicationextension/rest/RestResult.php');
 require_once(APPROOT.'application/applicationextension/rest/RestUtils.php');
+
+
+
+

application/applicationextension/backoffice/AbstractApplicationObjectExtension.php

@@ -0,0 +1,58 @@
+<?php
+
+/**
+ * Extend this class instead of iApplicationObjectExtension if you don't need to overload all methods
+ *
+ * @api
+ * @deprecated  3.1.0 N°4756 use the new event service instead, see {@see DBObject::FireEvent()} method
+ * @package     ORMExtensibilityAPI
+ * @since       2.7.0
+ */
+abstract class AbstractApplicationObjectExtension implements iApplicationObjectExtension
+{
+    /**
+     * @inheritDoc
+     */
+    public function OnIsModified($oObject)
+    {
+        return false;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function OnCheckToWrite($oObject)
+    {
+        return array();
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function OnCheckToDelete($oObject)
+    {
+        return array();
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function OnDBUpdate($oObject, $oChange = null)
+    {
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function OnDBInsert($oObject, $oChange = null)
+    {
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function OnDBDelete($oObject, $oChange = null)
+    {
+    }
+
+}

application/applicationextension/backoffice/AbstractApplicationUIExtension.php

@@ -9,64 +9,64 @@
  */
 abstract class AbstractApplicationUIExtension implements iApplicationUIExtension
 {
-	/**
-	 * @inheritDoc
-	 */
-	public function OnDisplayProperties($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false)
-	{
-	}
+    /**
+     * @inheritDoc
+     */
+    public function OnDisplayProperties($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false)
+    {
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function OnDisplayRelations($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false)
-	{
-	}
+    /**
+     * @inheritDoc
+     */
+    public function OnDisplayRelations($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false)
+    {
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function OnFormSubmit($oObject, $sFormPrefix = '')
-	{
-	}
+    /**
+     * @inheritDoc
+     */
+    public function OnFormSubmit($oObject, $sFormPrefix = '')
+    {
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function OnFormCancel($sTempId)
-	{
-	}
+    /**
+     * @inheritDoc
+     */
+    public function OnFormCancel($sTempId)
+    {
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function EnumUsedAttributes($oObject)
-	{
-		return [];
-	}
+    /**
+     * @inheritDoc
+     */
+    public function EnumUsedAttributes($oObject)
+    {
+        return array();
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetIcon($oObject)
-	{
-		return '';
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetIcon($oObject)
+    {
+        return '';
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetHilightClass($oObject)
-	{
-		return HILIGHT_CLASS_NONE;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetHilightClass($oObject)
+    {
+        return HILIGHT_CLASS_NONE;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function EnumAllowedActions(DBObjectSet $oSet)
-	{
-		return [];
-	}
+    /**
+     * @inheritDoc
+     */
+    public function EnumAllowedActions(DBObjectSet $oSet)
+    {
+        return array();
+    }
 
-}
+}

application/applicationextension/backoffice/AbstractPageUIBlockExtension.php

@@ -9,27 +9,27 @@
  */
 abstract class AbstractPageUIBlockExtension implements iPageUIBlockExtension
 {
-	/**
-	 * @inheritDoc
-	 */
-	public function GetBannerBlock()
-	{
-		return null;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetBannerBlock()
+    {
+        return null;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetHeaderBlock()
-	{
-		return null;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetHeaderBlock()
+    {
+        return null;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetFooterBlock()
-	{
-		return null;
-	}
-}
+    /**
+     * @inheritDoc
+     */
+    public function GetFooterBlock()
+    {
+        return null;
+    }
+}

application/applicationextension/backoffice/AbstractPreferencesExtension.php

@@ -9,20 +9,20 @@
  */
 abstract class AbstractPreferencesExtension implements iPreferencesExtension
 {
-	/**
-	 * @inheritDoc
-	 */
-	public function DisplayPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage)
-	{
-		// Do nothing
-	}
+    /**
+     * @inheritDoc
+     */
+    public function DisplayPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage)
+    {
+        // Do nothing
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function ApplyPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage, $sOperation)
-	{
-		// Do nothing
-	}
+    /**
+     * @inheritDoc
+     */
+    public function ApplyPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage, $sOperation)
+    {
+        // Do nothing
+    }
 
-}
+}

application/applicationextension/backoffice/AbstractWelcomePopupExtension.php

@@ -8,28 +8,28 @@
  */
 abstract class AbstractWelcomePopupExtension implements iWelcomePopupExtension
 {
-	/**
-	 * @inheritDoc
-	 */
-	public function GetIconRelPath(): string
-	{
-		return \Combodo\iTop\Application\Branding::$aLogoPaths[\Combodo\iTop\Application\Branding::ENUM_LOGO_TYPE_MAIN_LOGO_COMPACT]['default'];
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetIconRelPath(): string
+    {
+        return \Combodo\iTop\Application\Branding::$aLogoPaths[\Combodo\iTop\Application\Branding::ENUM_LOGO_TYPE_MAIN_LOGO_COMPACT]['default'];
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetMessages(): array
-	{
-		return [];
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetMessages(): array
+    {
+        return [];
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function AcknowledgeMessage(string $sMessageId): void
-	{
-		// No need to process the acknowledgment notice by default
-		return;
-	}
-}
+    /**
+     * @inheritDoc
+     */
+    public function AcknowledgeMessage(string $sMessageId): void
+    {
+        // No need to process the acknowledgment notice by default
+        return;
+    }
+}

application/applicationextension/backoffice/ApplicationPopupMenuItem.php

@@ -9,141 +9,142 @@
  */
 abstract class ApplicationPopupMenuItem
 {
-	/** @ignore */
-	protected $sUID;
-	/** @ignore */
-	protected $sLabel;
-	/** @ignore */
-	protected $sTooltip;
-	/** @ignore */
-	protected $sIconClass;
-	/** @ignore */
-	protected $aCssClasses;
+    /** @ignore */
+    protected $sUID;
+    /** @ignore */
+    protected $sLabel;
+    /** @ignore */
+    protected $sTooltip;
+    /** @ignore */
+    protected $sIconClass;
+    /** @ignore */
+    protected $aCssClasses;
 
-	/**
-	 * Constructor
-	 *
-	 * @param string $sUID The unique identifier of this menu in iTop... make sure you pass something unique enough
-	 * @param string $sLabel The display label of the menu (must be localized)
-	 * @api
-	 */
-	public function __construct($sUID, $sLabel)
-	{
-		$this->sUID = $sUID;
-		$this->sLabel = $sLabel;
-		$this->sTooltip = '';
-		$this->sIconClass = '';
-		$this->aCssClasses = [];
-	}
+    /**
+     * Constructor
+     *
+     * @param string $sUID The unique identifier of this menu in iTop... make sure you pass something unique enough
+     * @param string $sLabel The display label of the menu (must be localized)
+     * @api
+     */
+    public function __construct($sUID, $sLabel)
+    {
+        $this->sUID = $sUID;
+        $this->sLabel = $sLabel;
+        $this->sTooltip = '';
+        $this->sIconClass = '';
+        $this->aCssClasses = array();
+    }
 
-	/**
-	 * Get the UID
-	 *
-	 * @return string The unique identifier
-	 * @ignore
-	 */
-	public function GetUID()
-	{
-		return $this->sUID;
-	}
+    /**
+     * Get the UID
+     *
+     * @return string The unique identifier
+     * @ignore
+     */
+    public function GetUID()
+    {
+        return $this->sUID;
+    }
 
-	/**
-	 * Get the label
-	 *
-	 * @return string The label
-	 * @ignore
-	 */
-	public function GetLabel()
-	{
-		return $this->sLabel;
-	}
+    /**
+     * Get the label
+     *
+     * @return string The label
+     * @ignore
+     */
+    public function GetLabel()
+    {
+        return $this->sLabel;
+    }
 
-	/**
-	 * Get the CSS classes
-	 *
-	 * @return array
-	 * @ignore
-	 */
-	public function GetCssClasses()
-	{
-		return $this->aCssClasses;
-	}
+    /**
+     * Get the CSS classes
+     *
+     * @return array
+     * @ignore
+     */
+    public function GetCssClasses()
+    {
+        return $this->aCssClasses;
+    }
 
-	/**
-	 * @param $aCssClasses
-	 * @api
-	 */
-	public function SetCssClasses($aCssClasses)
-	{
-		$this->aCssClasses = $aCssClasses;
-	}
+    /**
+     * @param $aCssClasses
+     * @api
+     */
+    public function SetCssClasses($aCssClasses)
+    {
+        $this->aCssClasses = $aCssClasses;
+    }
 
-	/**
-	 * Adds a CSS class to the CSS classes that will be put on the menu item
-	 *
-	 * @param $sCssClass
-	 * @api
-	 */
-	public function AddCssClass($sCssClass)
-	{
-		$this->aCssClasses[] = $sCssClass;
-	}
+    /**
+     * Adds a CSS class to the CSS classes that will be put on the menu item
+     *
+     * @param $sCssClass
+     * @api
+     */
+    public function AddCssClass($sCssClass)
+    {
+        $this->aCssClasses[] = $sCssClass;
+    }
 
-	/**
-	 * @param $sTooltip
-	 *
-	 * @api
-	 * @since 3.0.0
-	 */
-	public function SetTooltip($sTooltip)
-	{
-		$this->sTooltip = $sTooltip;
-	}
 
-	/**
-	 * @return string
-	 *
-	 * @api
-	 * @since 3.0.0
-	 */
-	public function GetTooltip()
-	{
-		return $this->sTooltip;
-	}
+    /**
+     * @param $sTooltip
+     *
+     * @api
+     * @since 3.0.0
+     */
+    public function SetTooltip($sTooltip)
+    {
+        $this->sTooltip = $sTooltip;
+    }
 
-	/**
-	 * @param $sIconClass
-	 *
-	 * @api
-	 * @since 3.0.0
-	 */
-	public function SetIconClass($sIconClass)
-	{
-		$this->sIconClass = $sIconClass;
-	}
+    /**
+     * @return string
+     *
+     * @api
+     * @since 3.0.0
+     */
+    public function GetTooltip()
+    {
+        return $this->sTooltip;
+    }
 
-	/**
-	 * @return string
-	 *
-	 * @api
-	 * @since 3.0.0
-	 */
-	public function GetIconClass()
-	{
-		return $this->sIconClass;
-	}
+    /**
+     * @param $sIconClass
+     *
+     * @api
+     * @since 3.0.0
+     */
+    public function SetIconClass($sIconClass)
+    {
+        $this->sIconClass = $sIconClass;
+    }
 
-	/**
-	 * Returns the components to create a popup menu item in HTML
-	 *
-	 * @return array A hash array: array('label' => , 'url' => , 'target' => , 'onclick' => )
-	 * @ignore
-	 */
-	abstract public function GetMenuItem();
+    /**
+     * @return string
+     *
+     * @api
+     * @since 3.0.0
+     */
+    public function GetIconClass()
+    {
+        return $this->sIconClass;
+    }
 
-	/** @ignore */
-	public function GetLinkedScripts()
-	{
-		return [];
-	}
-}
+    /**
+     * Returns the components to create a popup menu item in HTML
+     *
+     * @return array A hash array: array('label' => , 'url' => , 'target' => , 'onclick' => )
+     * @ignore
+     */
+    abstract public function GetMenuItem();
+
+    /** @ignore */
+    public function GetLinkedScripts()
+    {
+        return array();
+    }
+}

application/applicationextension/backoffice/JSButtonItem.php

@@ -9,4 +9,5 @@
  */
 class JSButtonItem extends JSPopupMenuItem
 {
-}
+
+}

application/applicationextension/backoffice/JSPopupMenuItem.php

@@ -11,60 +11,60 @@
  */
 class JSPopupMenuItem extends ApplicationPopupMenuItem
 {
-	/** @ignore */
-	protected $sJsCode;
-	/** @ignore */
-	protected $sUrl;
-	/** @ignore */
-	protected $aIncludeJSFiles;
+    /** @ignore */
+    protected $sJsCode;
+    /** @ignore */
+    protected $sUrl;
+    /** @ignore */
+    protected $aIncludeJSFiles;
 
-	/**
-	 * Class for adding an item that triggers some Javascript code
-	 *
-	 * @param string $sUID The unique identifier of this menu in iTop... make sure you pass something unique enough
-	 * @param string $sLabel The display label of the menu (must be localized)
-	 * @param string $sJSCode In case the menu consists in executing some havascript code inside the page, pass it here. If supplied $sURL
-	 *     ans $sTarget will be ignored
-	 * @param array $aIncludeJSFiles An array of file URLs to be included (once) to provide some JS libraries for the page.
-	 * @api
-	 */
-	public function __construct($sUID, $sLabel, $sJSCode, $aIncludeJSFiles = [])
-	{
-		parent::__construct($sUID, $sLabel);
-		$this->sJsCode = $sJSCode;
-		$this->sUrl = '#';
-		$this->aIncludeJSFiles = $aIncludeJSFiles;
-	}
+    /**
+     * Class for adding an item that triggers some Javascript code
+     *
+     * @param string $sUID The unique identifier of this menu in iTop... make sure you pass something unique enough
+     * @param string $sLabel The display label of the menu (must be localized)
+     * @param string $sJSCode In case the menu consists in executing some havascript code inside the page, pass it here. If supplied $sURL
+     *     ans $sTarget will be ignored
+     * @param array $aIncludeJSFiles An array of file URLs to be included (once) to provide some JS libraries for the page.
+     * @api
+     */
+    public function __construct($sUID, $sLabel, $sJSCode, $aIncludeJSFiles = array())
+    {
+        parent::__construct($sUID, $sLabel);
+        $this->sJsCode = $sJSCode;
+        $this->sUrl = '#';
+        $this->aIncludeJSFiles = $aIncludeJSFiles;
+    }
 
-	/** @ignore */
-	public function GetMenuItem()
-	{
-		// Note: the semicolumn is a must here!
-		return [
-			'label' => $this->GetLabel(),
-			'onclick' => $this->GetJsCode().'; return false;',
-			'url' => $this->GetUrl(),
-			'css_classes' => $this->GetCssClasses(),
-			'icon_class' => $this->sIconClass,
-			'tooltip' => $this->sTooltip,
-		];
-	}
+    /** @ignore */
+    public function GetMenuItem()
+    {
+        // Note: the semicolumn is a must here!
+        return array(
+            'label' => $this->GetLabel(),
+            'onclick' => $this->GetJsCode() . '; return false;',
+            'url' => $this->GetUrl(),
+            'css_classes' => $this->GetCssClasses(),
+            'icon_class' => $this->sIconClass,
+            'tooltip' => $this->sTooltip
+        );
+    }
 
-	/** @ignore */
-	public function GetLinkedScripts()
-	{
-		return $this->aIncludeJSFiles;
-	}
+    /** @ignore */
+    public function GetLinkedScripts()
+    {
+        return $this->aIncludeJSFiles;
+    }
 
-	/** @ignore */
-	public function GetJsCode()
-	{
-		return $this->sJsCode;
-	}
+    /** @ignore */
+    public function GetJsCode()
+    {
+        return $this->sJsCode;
+    }
 
-	/** @ignore */
-	public function GetUrl()
-	{
-		return $this->sUrl;
-	}
-}
+    /** @ignore */
+    public function GetUrl()
+    {
+        return $this->sUrl;
+    }
+}

application/applicationextension/backoffice/SeparatorPopupMenuItem.php

@@ -10,20 +10,20 @@
  */
 class SeparatorPopupMenuItem extends ApplicationPopupMenuItem
 {
-	public static $idx = 0;
+    static $idx = 0;
 
-	/**
-	 * Constructor
-	 * @api
-	 */
-	public function __construct()
-	{
-		parent::__construct('_separator_'.(self::$idx++), '');
-	}
+    /**
+     * Constructor
+     * @api
+     */
+    public function __construct()
+    {
+        parent::__construct('_separator_' . (self::$idx++), '');
+    }
 
-	/** @ignore */
-	public function GetMenuItem()
-	{
-		return ['label' => '<hr class="menu-separator">', 'url' => '', 'css_classes' => $this->aCssClasses];
-	}
-}
+    /** @ignore */
+    public function GetMenuItem()
+    {
+        return array('label' => '<hr class="menu-separator">', 'url' => '', 'css_classes' => $this->aCssClasses);
+    }
+}

application/applicationextension/backoffice/URLButtonItem.php

@@ -9,4 +9,5 @@
  */
 class URLButtonItem extends URLPopupMenuItem
 {
-}
+
+}

application/applicationextension/backoffice/URLPopupMenuItem.php

@@ -11,48 +11,48 @@
  */
 class URLPopupMenuItem extends ApplicationPopupMenuItem
 {
-	/** @ignore */
-	protected $sUrl;
-	/** @ignore */
-	protected $sTarget;
+    /** @ignore */
+    protected $sUrl;
+    /** @ignore */
+    protected $sTarget;
 
-	/**
-	 * Constructor
-	 *
-	 * @param string $sUID The unique identifier of this menu in iTop... make sure you pass something unique enough
-	 * @param string $sLabel The display label of the menu (must be localized)
-	 * @param string $sUrl If the menu is an hyperlink, provide the absolute hyperlink here
-	 * @param string $sTarget In case the menu is an hyperlink and a specific target is needed (_blank for example), pass it here
-	 * @api
-	 */
-	public function __construct($sUID, $sLabel, $sUrl, $sTarget = '_top')
-	{
-		parent::__construct($sUID, $sLabel);
-		$this->sUrl = $sUrl;
-		$this->sTarget = $sTarget;
-	}
+    /**
+     * Constructor
+     *
+     * @param string $sUID The unique identifier of this menu in iTop... make sure you pass something unique enough
+     * @param string $sLabel The display label of the menu (must be localized)
+     * @param string $sUrl If the menu is an hyperlink, provide the absolute hyperlink here
+     * @param string $sTarget In case the menu is an hyperlink and a specific target is needed (_blank for example), pass it here
+     * @api
+     */
+    public function __construct($sUID, $sLabel, $sUrl, $sTarget = '_top')
+    {
+        parent::__construct($sUID, $sLabel);
+        $this->sUrl = $sUrl;
+        $this->sTarget = $sTarget;
+    }
 
-	/** @ignore */
-	public function GetMenuItem()
-	{
-		return ['label' => $this->GetLabel(),
-			'url' => $this->GetUrl(),
-			'target' => $this->GetTarget(),
-			'css_classes' => $this->aCssClasses,
-			'icon_class' => $this->sIconClass,
-			'tooltip' => $this->sTooltip,
-		];
-	}
+    /** @ignore */
+    public function GetMenuItem()
+    {
+        return array('label' => $this->GetLabel(),
+            'url' => $this->GetUrl(),
+            'target' => $this->GetTarget(),
+            'css_classes' => $this->aCssClasses,
+            'icon_class' => $this->sIconClass,
+            'tooltip' => $this->sTooltip
+        );
+    }
 
-	/** @ignore */
-	public function GetUrl()
-	{
-		return $this->sUrl;
-	}
+    /** @ignore */
+    public function GetUrl()
+    {
+        return $this->sUrl;
+    }
 
-	/** @ignore */
-	public function GetTarget()
-	{
-		return $this->sTarget;
-	}
-}
+    /** @ignore */
+    public function GetTarget()
+    {
+        return $this->sTarget;
+    }
+}

application/applicationextension/backoffice/iApplicationObjectExtension.php

@@ -0,0 +1,111 @@
+<?php
+
+/**
+ * Implement this interface to perform specific operations when objects are manipulated
+ *
+ * Note that those methods will be called when objects are manipulated, either in a programmatic way
+ * or through the GUI.
+ *
+ * @api
+ * @deprecated  3.1.0 N°4756 use the new event service instead, see {@see DBObject::FireEvent()} method. More details on each method PHPDoc.
+ * @package     ORMExtensibilityAPI
+ */
+interface iApplicationObjectExtension
+{
+    /**
+     * Invoked to determine whether an object has been modified in memory
+     *
+     * The GUI calls this verb to determine the message that will be displayed to the end-user.
+     * Anyhow, this API can be called in other contexts such as the CSV import tool.
+     *
+     * If the extension returns false, then the framework will perform the usual evaluation.
+     * Otherwise, the answer is definitively "yes, the object has changed".
+     *
+     * @param /cmdbAbstractObject $oObject The target object
+     *
+     * @return boolean True if something has changed for the target object
+     * @api
+     * @deprecated 3.1.0 N°4756 No alternative available, this API was unstable and is abandoned
+     */
+    public function OnIsModified($oObject);
+
+    /**
+     * Invoked to determine whether an object can be written to the database
+     *
+     * The GUI calls this verb and reports any issue.
+     * Anyhow, this API can be called in other contexts such as the CSV import tool.
+     *
+     * @param \cmdbAbstractObject $oObject The target object
+     *
+     * @return string[] A list of errors message. An error message is made of one line and it can be displayed to the end-user.
+     * @api
+     * @deprecated 3.1.0 N°4756 Use EVENT_DB_CHECK_TO_WRITE event instead
+     */
+    public function OnCheckToWrite($oObject);
+
+    /**
+     * Invoked to determine wether an object can be deleted from the database
+     *
+     * The GUI calls this verb and stops the deletion process if any issue is reported.
+     *
+     * Please not that it is not possible to cascade deletion by this mean: only stopper issues can be handled.
+     *
+     * @param \cmdbAbstractObject $oObject The target object
+     *
+     * @return string[] A list of errors message. An error message is made of one line and it can be displayed to the end-user.
+     * @api
+     * @deprecated 3.1.0 N°4756 Use EVENT_DB_CHECK_TO_DELETE event instead
+     */
+    public function OnCheckToDelete($oObject);
+
+    /**
+     * Invoked when an object is updated into the database. The method is called right <b>after</b> the object has been written to the
+     * database.
+     *
+     * Useful methods you can call on $oObject :
+     *
+     * * {@see DBObject::ListPreviousValuesForUpdatedAttributes()} : list of changed attributes and their values before the change
+     * * {@see DBObject::Get()} : for a given attribute the new value that was persisted
+     *
+     * @param \cmdbAbstractObject $oObject The target object
+     * @param CMDBChange|null $oChange A change context. Since 2.0 it is fine to ignore it, as the framework does maintain this information
+     *     once for all the changes made within the current page
+     *
+     * @return void
+     *
+     * @deprecated 3.1.0 N°4756 Use EVENT_DB_AFTER_WRITE event instead
+     * @api
+     * @since 2.7.0 N°2293 can access object changes by calling {@see DBObject::ListPreviousValuesForUpdatedAttributes()} on $oObject
+     */
+    public function OnDBUpdate($oObject, $oChange = null);
+
+    /**
+     * Invoked when an object is created into the database
+     *
+     * The method is called right <b>after</b> the object has been written to the database.
+     *
+     * @param \cmdbAbstractObject $oObject The target object
+     * @param CMDBChange|null $oChange A change context. Since 2.0 it is fine to ignore it, as the framework does maintain this information
+     *     once for all the changes made within the current page
+     *
+     * @return void
+     * @deprecated 3.1.0 N°4756 Use EVENT_DB_AFTER_WRITE event instead
+     * @api
+     */
+    public function OnDBInsert($oObject, $oChange = null);
+
+    /**
+     * Invoked when an object is deleted from the database
+     *
+     * The method is called right <b>before</b> the object will be deleted from the database.
+     *
+     * @param \cmdbAbstractObject $oObject The target object
+     * @param CMDBChange|null $oChange A change context. Since 2.0 it is fine to ignore it, as the framework does maintain this information
+     *     once for all the changes made within the current page
+     *
+     * @return void
+     * @deprecated 3.1.0 N°4756 Use EVENT_DB_AFTER_DELETE event instead
+     * @api
+     */
+    public function OnDBDelete($oObject, $oChange = null);
+}

application/applicationextension/backoffice/iApplicationUIExtension.php

@@ -27,147 +27,147 @@
  */
 interface iApplicationUIExtension
 {
-	/**
-	 *    Invoked when an object is being displayed (wiew or edit)
-	 *
-	 * The method is called right after the main tab has been displayed.
-	 * You can add output to the page, either to change the display, or to add a form input
-	 *
-	 * Example:
-	 * <code>
-	 * if ($bEditMode)
-	 * {
-	 *    $oPage->p('Age of the captain: &lt;input type="text" name="captain_age"/&gt;');
-	 * }
-	 * else
-	 * {
-	 *    $oPage->p('Age of the captain: '.$iCaptainAge);
-	 * }
-	 * </code>
-	 *
-	 * @api
-	 *
-	 *@param \Combodo\iTop\Application\WebPage\WebPage $oPage The output context
-	 * @param boolean $bEditMode True if the edition form is being displayed
-	 *
-	 * @param DBObject $oObject The object being displayed
-	 *
-	 * @return void
-	 */
-	public function OnDisplayProperties($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false);
+    /**
+     *    Invoked when an object is being displayed (wiew or edit)
+     *
+     * The method is called right after the main tab has been displayed.
+     * You can add output to the page, either to change the display, or to add a form input
+     *
+     * Example:
+     * <code>
+     * if ($bEditMode)
+     * {
+     *    $oPage->p('Age of the captain: &lt;input type="text" name="captain_age"/&gt;');
+     * }
+     * else
+     * {
+     *    $oPage->p('Age of the captain: '.$iCaptainAge);
+     * }
+     * </code>
+     *
+     * @api
+     *
+     *@param \Combodo\iTop\Application\WebPage\WebPage $oPage The output context
+     * @param boolean $bEditMode True if the edition form is being displayed
+     *
+     * @param DBObject $oObject The object being displayed
+     *
+     * @return void
+     */
+    public function OnDisplayProperties($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false);
 
-	/**
-	 * Invoked when an object is being displayed (wiew or edit)
-	 *
-	 * The method is called rigth after all the tabs have been displayed
-	 *
-	 * @api
-	 *
-	 *@param \Combodo\iTop\Application\WebPage\WebPage $oPage The output context
-	 * @param boolean $bEditMode True if the edition form is being displayed
-	 *
-	 * @param DBObject $oObject The object being displayed
-	 *
-	 * @return void
-	 */
-	public function OnDisplayRelations($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false);
+    /**
+     * Invoked when an object is being displayed (wiew or edit)
+     *
+     * The method is called rigth after all the tabs have been displayed
+     *
+     * @api
+     *
+     *@param \Combodo\iTop\Application\WebPage\WebPage $oPage The output context
+     * @param boolean $bEditMode True if the edition form is being displayed
+     *
+     * @param DBObject $oObject The object being displayed
+     *
+     * @return void
+     */
+    public function OnDisplayRelations($oObject, \Combodo\iTop\Application\WebPage\WebPage $oPage, $bEditMode = false);
 
-	/**
-	 * Invoked when the end-user clicks on Modify from the object edition form
-	 *
-	 * The method is called after the changes from the standard form have been
-	 * taken into account, and before saving the changes into the database.
-	 *
-	 * @param DBObject $oObject The object being edited
-	 * @param string $sFormPrefix Prefix given to the HTML form inputs
-	 *
-	 * @return void
-	 * @api
-	 */
-	public function OnFormSubmit($oObject, $sFormPrefix = '');
+    /**
+     * Invoked when the end-user clicks on Modify from the object edition form
+     *
+     * The method is called after the changes from the standard form have been
+     * taken into account, and before saving the changes into the database.
+     *
+     * @param DBObject $oObject The object being edited
+     * @param string $sFormPrefix Prefix given to the HTML form inputs
+     *
+     * @return void
+     * @api
+     */
+    public function OnFormSubmit($oObject, $sFormPrefix = '');
 
-	/**
-	 * Invoked when the end-user clicks on Cancel from the object edition form
-	 *
-	 * Implement here any cleanup. This is necessary when you have injected some
-	 * javascript into the edition form, and if that code requires to store temporary data
-	 * (this is the case when a file must be uploaded).
-	 *
-	 * @param string $sTempId Unique temporary identifier made of session_id and transaction_id. It identifies the object in a unique way.
-	 *
-	 * @return void
-	 * @api
-	 */
-	public function OnFormCancel($sTempId);
+    /**
+     * Invoked when the end-user clicks on Cancel from the object edition form
+     *
+     * Implement here any cleanup. This is necessary when you have injected some
+     * javascript into the edition form, and if that code requires to store temporary data
+     * (this is the case when a file must be uploaded).
+     *
+     * @param string $sTempId Unique temporary identifier made of session_id and transaction_id. It identifies the object in a unique way.
+     *
+     * @return void
+     * @api
+     */
+    public function OnFormCancel($sTempId);
 
-	/**
-	 * Not yet called by the framework!
-	 *
-	 * Sorry, the verb has been reserved. You must implement it, but it is not called as of now.
-	 *
-	 * @param DBObject $oObject The object being displayed
-	 *
-	 * @return string[] desc
-	 * @api
-	 */
-	public function EnumUsedAttributes($oObject); // Not yet implemented
+    /**
+     * Not yet called by the framework!
+     *
+     * Sorry, the verb has been reserved. You must implement it, but it is not called as of now.
+     *
+     * @param DBObject $oObject The object being displayed
+     *
+     * @return string[] desc
+     * @api
+     */
+    public function EnumUsedAttributes($oObject); // Not yet implemented
 
-	/**
-	 * Not yet called by the framework!
-	 *
-	 * Sorry, the verb has been reserved. You must implement it, but it is not called as of now.
-	 *
-	 * @param DBObject $oObject The object being displayed
-	 *
-	 * @return string Path of the icon, relative to the modules directory.
-	 * @api
-	 */
-	public function GetIcon($oObject); // Not yet implemented
+    /**
+     * Not yet called by the framework!
+     *
+     * Sorry, the verb has been reserved. You must implement it, but it is not called as of now.
+     *
+     * @param DBObject $oObject The object being displayed
+     *
+     * @return string Path of the icon, relative to the modules directory.
+     * @api
+     */
+    public function GetIcon($oObject); // Not yet implemented
 
-	/**
-	 * Invoked when the object is displayed alone or within a list
-	 *
-	 * Returns a value influencing the appearance of the object depending on its
-	 * state.
-	 *
-	 * Possible values are:
-	 *
-	 * * HILIGHT_CLASS_CRITICAL
-	 * * HILIGHT_CLASS_WARNING
-	 * * HILIGHT_CLASS_OK
-	 * * HILIGHT_CLASS_NONE
-	 *
-	 * @param DBObject $oObject The object being displayed
-	 *
-	 * @return integer The value representing the mood of the object
-	 * @api
-	 */
-	public function GetHilightClass($oObject);
+    /**
+     * Invoked when the object is displayed alone or within a list
+     *
+     * Returns a value influencing the appearance of the object depending on its
+     * state.
+     *
+     * Possible values are:
+     *
+     * * HILIGHT_CLASS_CRITICAL
+     * * HILIGHT_CLASS_WARNING
+     * * HILIGHT_CLASS_OK
+     * * HILIGHT_CLASS_NONE
+     *
+     * @param DBObject $oObject The object being displayed
+     *
+     * @return integer The value representing the mood of the object
+     * @api
+     */
+    public function GetHilightClass($oObject);
 
-	/**
-	 * Called when building the Actions menu for a single object or a list of objects
-	 *
-	 * Use this to add items to the Actions menu. You will have to specify a label and an URL.
-	 *
-	 * Example:
-	 * <code>
-	 * $oObject = $oSet->fetch();
-	 * if ($oObject instanceof Sheep)
-	 * {
-	 *    return array('View in my app' => 'http://myserver/view_sheeps?id='.$oObject->Get('name'));
-	 * }
-	 * else
-	 * {
-	 *    return array();
-	 * }
-	 * </code>
-	 *
-	 * See also iPopupMenuExtension for greater flexibility
-	 *
-	 * @param DBObjectSet $oSet A set of persistent objects (DBObject)
-	 *
-	 * @return array
-	 * @api
-	 */
-	public function EnumAllowedActions(DBObjectSet $oSet);
-}
+    /**
+     * Called when building the Actions menu for a single object or a list of objects
+     *
+     * Use this to add items to the Actions menu. You will have to specify a label and an URL.
+     *
+     * Example:
+     * <code>
+     * $oObject = $oSet->fetch();
+     * if ($oObject instanceof Sheep)
+     * {
+     *    return array('View in my app' => 'http://myserver/view_sheeps?id='.$oObject->Get('name'));
+     * }
+     * else
+     * {
+     *    return array();
+     * }
+     * </code>
+     *
+     * See also iPopupMenuExtension for greater flexibility
+     *
+     * @param DBObjectSet $oSet A set of persistent objects (DBObject)
+     *
+     * @return array
+     * @api
+     */
+    public function EnumAllowedActions(DBObjectSet $oSet);
+}

application/applicationextension/backoffice/iBackofficeDictEntriesExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeDictEntriesExtension
 {
-	/**
-	 * @return array
-	 * @see \iTopWebPage::a_dict_entries
-	 * @api
-	 */
-	public function GetDictEntries(): array;
-}
+    /**
+     * @return array
+     * @see \iTopWebPage::a_dict_entries
+     * @api
+     */
+    public function GetDictEntries(): array;
+}

application/applicationextension/backoffice/iBackofficeDictEntriesPrefixesExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeDictEntriesPrefixesExtension
 {
-	/**
-	 * @return array
-	 * @see \iTopWebPage::a_dict_entries_prefixes
-	 * @api
-	 */
-	public function GetDictEntriesPrefixes(): array;
-}
+    /**
+     * @return array
+     * @see \iTopWebPage::a_dict_entries_prefixes
+     * @api
+     */
+    public function GetDictEntriesPrefixes(): array;
+}

application/applicationextension/backoffice/iBackofficeEarlyScriptExtension.php

@@ -11,10 +11,10 @@
  */
 interface iBackofficeEarlyScriptExtension
 {
-	/**
-	 * @return string
-	 * @see \iTopWebPage::$a_early_scripts
-	 * @api
-	 */
-	public function GetEarlyScript(): string;
-}
+    /**
+     * @return string
+     * @see \iTopWebPage::$a_early_scripts
+     * @api
+     */
+    public function GetEarlyScript(): string;
+}

application/applicationextension/backoffice/iBackofficeInitScriptExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeInitScriptExtension
 {
-	/**
-	 * @return string
-	 * @see \iTopWebPage::$a_init_scripts
-	 * @api
-	 */
-	public function GetInitScript(): string;
-}
+    /**
+     * @return string
+     * @see \iTopWebPage::$a_init_scripts
+     * @api
+     */
+    public function GetInitScript(): string;
+}

application/applicationextension/backoffice/iBackofficeLinkedScriptsExtension.php

@@ -10,11 +10,11 @@
  */
 interface iBackofficeLinkedScriptsExtension
 {
-	/**
-	 * Each script will be included using this property
-	 * @return array An array of absolute URLs to the files to include
-	 * @see \iTopWebPage::$a_linked_scripts
-	 * @api
-	 */
-	public function GetLinkedScriptsAbsUrls(): array;
-}
+    /**
+     * Each script will be included using this property
+     * @return array An array of absolute URLs to the files to include
+     * @see \iTopWebPage::$a_linked_scripts
+     * @api
+     */
+    public function GetLinkedScriptsAbsUrls(): array;
+}

application/applicationextension/backoffice/iBackofficeLinkedStylesheetsExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeLinkedStylesheetsExtension
 {
-	/**
-	 * @return array An array of absolute URLs to the files to include
-	 * @see \iTopWebPage::$a_linked_stylesheets
-	 * @api
-	 */
-	public function GetLinkedStylesheetsAbsUrls(): array;
-}
+    /**
+     * @return array An array of absolute URLs to the files to include
+     * @see \iTopWebPage::$a_linked_stylesheets
+     * @api
+     */
+    public function GetLinkedStylesheetsAbsUrls(): array;
+}

application/applicationextension/backoffice/iBackofficeReadyScriptExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeReadyScriptExtension
 {
-	/**
-	 * @return string
-	 * @see \iTopWebPage::$a_ready_scripts
-	 * @api
-	 */
-	public function GetReadyScript(): string;
-}
+    /**
+     * @return string
+     * @see \iTopWebPage::$a_ready_scripts
+     * @api
+     */
+    public function GetReadyScript(): string;
+}

application/applicationextension/backoffice/iBackofficeSassExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeSassExtension
 {
-	/**
-	 * @return string
-	 * @see \iTopWebPage::$a_styles
-	 * @api
-	 */
-	public function GetSass(): string;
-}
+    /**
+     * @return string
+     * @see \iTopWebPage::$a_styles
+     * @api
+     */
+    public function GetSass(): string;
+}

application/applicationextension/backoffice/iBackofficeScriptExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeScriptExtension
 {
-	/**
-	 * @return string
-	 * @see \iTopWebPage::$a_scripts
-	 * @api
-	 */
-	public function GetScript(): string;
-}
+    /**
+     * @return string
+     * @see \iTopWebPage::$a_scripts
+     * @api
+     */
+    public function GetScript(): string;
+}

application/applicationextension/backoffice/iBackofficeStyleExtension.php

@@ -10,10 +10,10 @@
  */
 interface iBackofficeStyleExtension
 {
-	/**
-	 * @return string
-	 * @see \iTopWebPage::$a_styles
-	 * @api
-	 */
-	public function GetStyle(): string;
-}
+    /**
+     * @return string
+     * @see \iTopWebPage::$a_styles
+     * @api
+     */
+    public function GetStyle(): string;
+}

application/applicationextension/backoffice/iFieldRendererMappingsExtension.php

@@ -11,25 +11,25 @@
  */
 interface iFieldRendererMappingsExtension
 {
-	/**
-	 * @return array {
-	 *              array: {
-	 *                  field: string,
-	 *                  form_renderer: string,
-	 *                  field_renderer: string
-	 *              }
-	 *          }  List of field renderer mapping: FQCN field class, FQCN Form Renderer class, FQCN Field Renderer class
-	 *
-	 * Example:
-	 *
-	 * ```php
-	 * [
-	 *  ['field' => 'FQCN\FieldA', 'form_renderer' => 'Combodo\iTop\Renderer\Console\ConsoleFormRenderer', 'field_renderer' => 'FQCN\FieldRendererA'],
-	 *  ['field' => 'FQCN\FieldB', 'form_renderer' => 'Combodo\iTop\Renderer\Console\ConsoleFormRenderer', 'field_renderer' => 'FQCN\FieldRendererB'],
-	 *  ['field' => 'FQCN\FieldA', 'form_renderer' => 'Combodo\iTop\Renderer\Bootstrap\BsFormRenderer', 'field_renderer' => 'FQCN\FieldRendererA'],
-	 *  ['field' => 'FQCN\FieldB', 'form_renderer' => 'Combodo\iTop\Renderer\Bootstrap\BsFormRenderer', 'field_renderer' => 'FQCN\FieldRendererB'],
-	 * ]
-	 * ```
-	 */
-	public static function RegisterSupportedFields(): array;
-}
+    /**
+     * @return array {
+     *              array: {
+     *                  field: string,
+     *                  form_renderer: string,
+     *                  field_renderer: string
+     *              }
+     *          }  List of field renderer mapping: FQCN field class, FQCN Form Renderer class, FQCN Field Renderer class
+     *
+     * Example:
+     *
+     * ```php
+     * [
+     *  ['field' => 'FQCN\FieldA', 'form_renderer' => 'Combodo\iTop\Renderer\Console\ConsoleFormRenderer', 'field_renderer' => 'FQCN\FieldRendererA'],
+     *  ['field' => 'FQCN\FieldB', 'form_renderer' => 'Combodo\iTop\Renderer\Console\ConsoleFormRenderer', 'field_renderer' => 'FQCN\FieldRendererB'],
+     *  ['field' => 'FQCN\FieldA', 'form_renderer' => 'Combodo\iTop\Renderer\Bootstrap\BsFormRenderer', 'field_renderer' => 'FQCN\FieldRendererA'],
+     *  ['field' => 'FQCN\FieldB', 'form_renderer' => 'Combodo\iTop\Renderer\Bootstrap\BsFormRenderer', 'field_renderer' => 'FQCN\FieldRendererB'],
+     * ]
+     * ```
+     */
+    public static function RegisterSupportedFields(): array;
+}

application/applicationextension/backoffice/iPageUIBlockExtension.php

@@ -21,27 +21,27 @@
  */
 interface iPageUIBlockExtension
 {
-	/**
-	 * Add content to the "admin banner"
-	 *
-	 * @api
-	 * @return \Combodo\iTop\Application\UI\Base\iUIBlock|null The Block to add into the page
-	 */
-	public function GetBannerBlock();
+    /**
+     * Add content to the "admin banner"
+     *
+     * @api
+     * @return \Combodo\iTop\Application\UI\Base\iUIBlock|null The Block to add into the page
+     */
+    public function GetBannerBlock();
 
-	/**
-	 * Add content to the header of the page
-	 *
-	 * @api
-	 * @return \Combodo\iTop\Application\UI\Base\iUIBlock|null The Block to add into the page
-	 */
-	public function GetHeaderBlock();
+    /**
+     * Add content to the header of the page
+     *
+     * @api
+     * @return \Combodo\iTop\Application\UI\Base\iUIBlock|null The Block to add into the page
+     */
+    public function GetHeaderBlock();
 
-	/**
-	 * Add content to the footer of the page
-	 *
-	 * @api
-	 * @return \Combodo\iTop\Application\UI\Base\iUIBlock|null The Block to add into the page
-	 */
-	public function GetFooterBlock();
-}
+    /**
+     * Add content to the footer of the page
+     *
+     * @api
+     * @return \Combodo\iTop\Application\UI\Base\iUIBlock|null The Block to add into the page
+     */
+    public function GetFooterBlock();
+}

application/applicationextension/backoffice/iPopupMenuExtension.php

@@ -13,100 +13,100 @@
  */
 interface iPopupMenuExtension
 {
-	/**
-	 * Insert an item into the Actions menu of a list
-	 *
-	 * $param is a DBObjectSet containing the list of objects
-	 * @api
-	 */
-	public const MENU_OBJLIST_ACTIONS = 1;
-	/**
-	 * Insert an item into the Toolkit menu of a list
-	 *
-	 * $param is a DBObjectSet containing the list of objects
-	 * @api
-	 */
-	public const MENU_OBJLIST_TOOLKIT = 2;
-	/**
-	 * Insert an item into the Actions menu on an object details page
-	 *
-	 * $param is a DBObject instance: the object currently displayed
-	 * @api
-	 */
-	public const MENU_OBJDETAILS_ACTIONS = 3;
-	/**
-	 * Insert an item into the Dashboard menu
-	 *
-	 * The dashboad menu is shown on the top right corner when a dashboard
-	 * is being displayed.
-	 *
-	 * $param is a Dashboard instance: the dashboard currently displayed
-	 * @api
-	 */
-	public const MENU_DASHBOARD_ACTIONS = 4;
-	/**
-	 * Insert an item into the User menu (upper right corner)
-	 *
-	 * $param is null
-	 * @api
-	 */
-	public const MENU_USER_ACTIONS = 5;
-	/**
-	 * Insert an item into the Action menu on an object item in an objects list in the portal
-	 *
-	 * $param is an array('portal_id' => $sPortalId, 'object' => $oObject) containing the portal id and a DBObject instance (the object on
-	 * the current line)
-	 * @api
-	 */
-	public const PORTAL_OBJLISTITEM_ACTIONS = 7;
-	/**
-	 * Insert an item into the Action menu on an object details page in the portal
-	 *
-	 * $param is an array('portal_id' => $sPortalId, 'object' => $oObject) containing the portal id and a DBObject instance (the object
-	 * currently displayed)
-	 * @api
-	 */
-	public const PORTAL_OBJDETAILS_ACTIONS = 8;
+    /**
+     * Insert an item into the Actions menu of a list
+     *
+     * $param is a DBObjectSet containing the list of objects
+     * @api
+     */
+    const MENU_OBJLIST_ACTIONS = 1;
+    /**
+     * Insert an item into the Toolkit menu of a list
+     *
+     * $param is a DBObjectSet containing the list of objects
+     * @api
+     */
+    const MENU_OBJLIST_TOOLKIT = 2;
+    /**
+     * Insert an item into the Actions menu on an object details page
+     *
+     * $param is a DBObject instance: the object currently displayed
+     * @api
+     */
+    const MENU_OBJDETAILS_ACTIONS = 3;
+    /**
+     * Insert an item into the Dashboard menu
+     *
+     * The dashboad menu is shown on the top right corner when a dashboard
+     * is being displayed.
+     *
+     * $param is a Dashboard instance: the dashboard currently displayed
+     * @api
+     */
+    const MENU_DASHBOARD_ACTIONS = 4;
+    /**
+     * Insert an item into the User menu (upper right corner)
+     *
+     * $param is null
+     * @api
+     */
+    const MENU_USER_ACTIONS = 5;
+    /**
+     * Insert an item into the Action menu on an object item in an objects list in the portal
+     *
+     * $param is an array('portal_id' => $sPortalId, 'object' => $oObject) containing the portal id and a DBObject instance (the object on
+     * the current line)
+     * @api
+     */
+    const PORTAL_OBJLISTITEM_ACTIONS = 7;
+    /**
+     * Insert an item into the Action menu on an object details page in the portal
+     *
+     * $param is an array('portal_id' => $sPortalId, 'object' => $oObject) containing the portal id and a DBObject instance (the object
+     * currently displayed)
+     * @api
+     */
+    const PORTAL_OBJDETAILS_ACTIONS = 8;
 
-	/**
-	 * Insert an item into the Actions menu of a list in the portal
-	 * Note: This is not implemented yet !
-	 *
-	 * $param is an array('portal_id' => $sPortalId, 'object_set' => $oSet) containing DBObjectSet containing the list of objects
-	 *
-	 * @todo
-	 */
-	public const PORTAL_OBJLIST_ACTIONS = 6;
-	/**
-	 * Insert an item into the user menu of the portal
-	 * Note: This is not implemented yet !
-	 *
-	 * $param is the portal id
-	 *
-	 * @todo
-	 */
-	public const PORTAL_USER_ACTIONS = 9;
-	/**
-	 * Insert an item into the navigation menu of the portal
-	 * Note: This is not implemented yet !
-	 *
-	 * $param is the portal id
-	 *
-	 * @todo
-	 */
-	public const PORTAL_MENU_ACTIONS = 10;
+    /**
+     * Insert an item into the Actions menu of a list in the portal
+     * Note: This is not implemented yet !
+     *
+     * $param is an array('portal_id' => $sPortalId, 'object_set' => $oSet) containing DBObjectSet containing the list of objects
+     *
+     * @todo
+     */
+    const PORTAL_OBJLIST_ACTIONS = 6;
+    /**
+     * Insert an item into the user menu of the portal
+     * Note: This is not implemented yet !
+     *
+     * $param is the portal id
+     *
+     * @todo
+     */
+    const PORTAL_USER_ACTIONS = 9;
+    /**
+     * Insert an item into the navigation menu of the portal
+     * Note: This is not implemented yet !
+     *
+     * $param is the portal id
+     *
+     * @todo
+     */
+    const PORTAL_MENU_ACTIONS = 10;
 
-	/**
-	 * Get the list of items to be added to a menu.
-	 *
-	 * This method is called by the framework for each menu.
-	 * The items will be inserted in the menu in the order of the returned array.
-	 *
-	 * @param int $iMenuId The identifier of the type of menu, as listed by the constants MENU_xxx
-	 * @param mixed $param Depends on $iMenuId, see the constants defined above
-	 *
-	 * @return object[] An array of ApplicationPopupMenuItem or an empty array if no action is to be added to the menu
-	 * @api
-	 */
-	public static function EnumItems($iMenuId, $param);
-}
+    /**
+     * Get the list of items to be added to a menu.
+     *
+     * This method is called by the framework for each menu.
+     * The items will be inserted in the menu in the order of the returned array.
+     *
+     * @param int $iMenuId The identifier of the type of menu, as listed by the constants MENU_xxx
+     * @param mixed $param Depends on $iMenuId, see the constants defined above
+     *
+     * @return object[] An array of ApplicationPopupMenuItem or an empty array if no action is to be added to the menu
+     * @api
+     */
+    public static function EnumItems($iMenuId, $param);
+}

application/applicationextension/backoffice/iPreferencesExtension.php

@@ -7,22 +7,22 @@
  */
 interface iPreferencesExtension
 {
-	/**
-	 * @api
-	 *
-	 * @param \Combodo\iTop\Application\WebPage\WebPage $oPage
-	 *
-	 */
-	public function DisplayPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage);
+    /**
+     * @api
+     *
+     * @param \Combodo\iTop\Application\WebPage\WebPage $oPage
+     *
+     */
+    public function DisplayPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage);
 
-	/**
-	 * @api
-	 *
-	 * @param string $sOperation
-	 *
-	 * @param \Combodo\iTop\Application\WebPage\WebPage $oPage
-	 *
-	 * @return bool true if the operation has been used
-	 */
-	public function ApplyPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage, $sOperation);
-}
+    /**
+     * @api
+     *
+     * @param string $sOperation
+     *
+     * @param \Combodo\iTop\Application\WebPage\WebPage $oPage
+     *
+     * @return bool true if the operation has been used
+     */
+    public function ApplyPreferences(\Combodo\iTop\Application\WebPage\WebPage $oPage, $sOperation);
+}

application/applicationextension/backoffice/iWelcomePopupExtension.php

@@ -8,31 +8,31 @@
  */
 interface iWelcomePopupExtension
 {
-	// Importance for ordering messages
-	// Just two levels since less important messages have nothing to do in the welcome popup
-	public const ENUM_IMPORTANCE_CRITICAL = 0;
-	public const ENUM_IMPORTANCE_HIGH = 1;
-	public const DEFAULT_IMPORTANCE = self::ENUM_IMPORTANCE_HIGH;
+    // Importance for ordering messages
+    // Just two levels since less important messages have nothing to do in the welcome popup
+    public const ENUM_IMPORTANCE_CRITICAL = 0;
+    public const ENUM_IMPORTANCE_HIGH = 1;
+    public const DEFAULT_IMPORTANCE = self::ENUM_IMPORTANCE_HIGH;
 
-	/**
-	 * Overload this method if you need to display an icon representing the provider (eg. your own company logo, module icon, ...)
-	 *
-	 * @return string Relative path (from app. root) of the icon representing the provider
-	 * @api
-	 */
-	public function GetIconRelPath(): string;
+    /**
+     * Overload this method if you need to display an icon representing the provider (eg. your own company logo, module icon, ...)
+     *
+     * @return string Relative path (from app. root) of the icon representing the provider
+     * @api
+     */
+    public function GetIconRelPath(): string;
 
-	/**
-	 * @return \Combodo\iTop\Application\WelcomePopup\Message[]
-	 * @api
-	 */
-	public function GetMessages(): array;
+    /**
+     * @return \Combodo\iTop\Application\WelcomePopup\Message[]
+     * @api
+     */
+    public function GetMessages(): array;
 
-	/**
-	 * Overload this method if the provider needs to do some additional processing after the message ($sMessageId) has been acknowledged by the current user
-	 *
-	 * @param string $sMessageId
-	 * @api
-	 */
-	public function AcknowledgeMessage(string $sMessageId): void;
-}
+    /**
+     * Overload this method if the provider needs to do some additional processing after the message ($sMessageId) has been acknowledged by the current user
+     *
+     * @param string $sMessageId
+     * @api
+     */
+    public function AcknowledgeMessage(string $sMessageId): void;
+}

application/applicationextension/iBackupExtraFilesExtension.php

@@ -8,9 +8,9 @@
  */
 interface iBackupExtraFilesExtension
 {
-	/**
-	 * @return string[] Array of relative paths (from app root) for files and directories to be included in the backup
-	 * @api
-	 */
-	public function GetExtraFilesRelPaths(): array;
-}
+    /**
+     * @return string[] Array of relative paths (from app root) for files and directories to be included in the backup
+     * @api
+     */
+    public function GetExtraFilesRelPaths(): array;
+}

application/applicationextension/iKPILoggerExtension.php

@@ -7,19 +7,19 @@
  */
 interface iKPILoggerExtension
 {
-	/**
-	 * Init the statistics collected
-	 *
-	 * @return void
-	 */
-	public function InitStats();
+    /**
+     * Init the statistics collected
+     *
+     * @return void
+     */
+    public function InitStats();
 
-	/**
-	 * Add a new KPI to the stats
-	 *
-	 * @param \Combodo\iTop\Core\Kpi\KpiLogData $oKpiLogData
-	 *
-	 * @return mixed
-	 */
-	public function LogOperation($oKpiLogData);
-}
+    /**
+     * Add a new KPI to the stats
+     *
+     * @param \Combodo\iTop\Core\Kpi\KpiLogData $oKpiLogData
+     *
+     * @return mixed
+     */
+    public function LogOperation($oKpiLogData);
+}

application/applicationextension/iModuleExtension.php

@@ -9,8 +9,8 @@
  */
 interface iModuleExtension
 {
-	/**
-	 * @api
-	 */
-	public function __construct();
-}
+    /**
+     * @api
+     */
+    public function __construct();
+}

application/applicationextension/login/AbstractLoginFSMExtension.php

@@ -16,144 +16,144 @@
  */
 abstract class AbstractLoginFSMExtension implements iLoginFSMExtension
 {
-	/**
-	 * @inheritDoc
-	 */
-	abstract public function ListSupportedLoginModes();
+    /**
+     * @inheritDoc
+     */
+    abstract public function ListSupportedLoginModes();
 
-	/**
-	 * @inheritDoc
-	 */
-	public function LoginAction($sLoginState, &$iErrorCode)
-	{
-		switch ($sLoginState) {
-			case LoginWebPage::LOGIN_STATE_START:
-				return $this->OnStart($iErrorCode);
+    /**
+     * @inheritDoc
+     */
+    public function LoginAction($sLoginState, &$iErrorCode)
+    {
+        switch ($sLoginState) {
+            case LoginWebPage::LOGIN_STATE_START:
+                return $this->OnStart($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_MODE_DETECTION:
-				return $this->OnModeDetection($iErrorCode);
+            case LoginWebPage::LOGIN_STATE_MODE_DETECTION:
+                return $this->OnModeDetection($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_READ_CREDENTIALS:
-				return $this->OnReadCredentials($iErrorCode);
+            case LoginWebPage::LOGIN_STATE_READ_CREDENTIALS:
+                return $this->OnReadCredentials($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_CHECK_CREDENTIALS:
-				return $this->OnCheckCredentials($iErrorCode);
+            case LoginWebPage::LOGIN_STATE_CHECK_CREDENTIALS:
+                return $this->OnCheckCredentials($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_CREDENTIALS_OK:
-				return $this->OnCredentialsOK($iErrorCode);
+            case LoginWebPage::LOGIN_STATE_CREDENTIALS_OK:
+                return $this->OnCredentialsOK($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_USER_OK:
-				return $this->OnUsersOK($iErrorCode);
+            case LoginWebPage::LOGIN_STATE_USER_OK:
+                return $this->OnUsersOK($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_CONNECTED:
-				return $this->OnConnected($iErrorCode);
+            case LoginWebPage::LOGIN_STATE_CONNECTED:
+                return $this->OnConnected($iErrorCode);
 
-			case LoginWebPage::LOGIN_STATE_ERROR:
-				return $this->OnError($iErrorCode);
-		}
+            case LoginWebPage::LOGIN_STATE_ERROR:
+                return $this->OnError($iErrorCode);
+        }
 
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * Initialization
-	 *
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnStart(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * Initialization
+     *
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnStart(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * Detect login mode explicitly without respecting configured order (legacy mode)
-	 * In most case do nothing here
-	 *
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnModeDetection(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * Detect login mode explicitly without respecting configured order (legacy mode)
+     * In most case do nothing here
+     *
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnModeDetection(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * Obtain the credentials either if login mode is empty or set to yours.
-	 * This step can be called multiple times by the FSM:
-	 * for example:
-	 * 1 - display login form
-	 * 2 - read the values posted by the user (store that in session)
-	 *
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnReadCredentials(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * Obtain the credentials either if login mode is empty or set to yours.
+     * This step can be called multiple times by the FSM:
+     * for example:
+     * 1 - display login form
+     * 2 - read the values posted by the user (store that in session)
+     *
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnReadCredentials(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * Control the validity of the data from the session
-	 * Automatic user provisioning can be done here
-	 *
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnCheckCredentials(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * Control the validity of the data from the session
+     * Automatic user provisioning can be done here
+     *
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnCheckCredentials(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnCredentialsOK(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnCredentialsOK(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnUsersOK(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnUsersOK(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnConnected(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
+    /**
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnConnected(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
 
-	/**
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	protected function OnError(&$iErrorCode)
-	{
-		return LoginWebPage::LOGIN_FSM_CONTINUE;
-	}
-}
+    /**
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    protected function OnError(&$iErrorCode)
+    {
+        return LoginWebPage::LOGIN_FSM_CONTINUE;
+    }
+}

application/applicationextension/login/iLoginExtension.php

@@ -7,11 +7,11 @@
  */
 interface iLoginExtension
 {
-	/**
-	 * Return the list of supported login modes for this plugin
-	 *
-	 * @return array of supported login modes
-	 * @api
-	 */
-	public function ListSupportedLoginModes();
-}
+    /**
+     * Return the list of supported login modes for this plugin
+     *
+     * @return array of supported login modes
+     * @api
+     */
+    public function ListSupportedLoginModes();
+}

application/applicationextension/login/iLoginFSMExtension.php

@@ -7,18 +7,18 @@
  */
 interface iLoginFSMExtension extends iLoginExtension
 {
-	/**
-	 * Execute action for this login state
-	 * If a page is displayed, the action must exit at this point
-	 * if LoginWebPage::LOGIN_FSM_RETURN_ERROR is returned $iErrorCode must be set
-	 * if LoginWebPage::LOGIN_FSM_RETURN_OK is returned then the login is OK and terminated
-	 * if LoginWebPage::LOGIN_FSM_CONTINUE is returned then the FSM will proceed to next plugin or state
-	 *
-	 * @param string $sLoginState (see LoginWebPage::LOGIN_STATE_...)
-	 * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
-	 *
-	 * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
-	 * @api
-	 */
-	public function LoginAction($sLoginState, &$iErrorCode);
-}
+    /**
+     * Execute action for this login state
+     * If a page is displayed, the action must exit at this point
+     * if LoginWebPage::LOGIN_FSM_RETURN_ERROR is returned $iErrorCode must be set
+     * if LoginWebPage::LOGIN_FSM_RETURN_OK is returned then the login is OK and terminated
+     * if LoginWebPage::LOGIN_FSM_CONTINUE is returned then the FSM will proceed to next plugin or state
+     *
+     * @param string $sLoginState (see LoginWebPage::LOGIN_STATE_...)
+     * @param int $iErrorCode (see LoginWebPage::EXIT_CODE_...)
+     *
+     * @return int LoginWebPage::LOGIN_FSM_RETURN_ERROR, LoginWebPage::LOGIN_FSM_RETURN_OK or LoginWebPage::LOGIN_FSM_CONTINUE
+     * @api
+     */
+    public function LoginAction($sLoginState, &$iErrorCode);
+}

application/applicationextension/login/iLoginUIExtension.php

@@ -9,9 +9,9 @@
  */
 interface iLoginUIExtension extends iLoginExtension
 {
-	/**
-	 * @return LoginTwigContext
-	 * @api
-	 */
-	public function GetTwigContext();
-}
+    /**
+     * @return LoginTwigContext
+     * @api
+     */
+    public function GetTwigContext();
+}

application/applicationextension/login/iLogoutExtension.php

@@ -7,9 +7,9 @@
  */
 interface iLogoutExtension extends iLoginExtension
 {
-	/**
-	 * Execute all actions to log out properly
-	 * @api
-	 */
-	public function LogoutAction();
-}
+    /**
+     * Execute all actions to log out properly
+     * @api
+     */
+    public function LogoutAction();
+}

application/applicationextension/portal/AbstractPortalUIExtension.php

@@ -9,59 +9,59 @@
  */
 abstract class AbstractPortalUIExtension implements iPortalUIExtension
 {
-	/**
-	 * @inheritDoc
-	 */
-	public function GetCSSFiles(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return [];
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetCSSFiles(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return array();
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetCSSInline(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return null;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetCSSInline(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return null;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetJSFiles(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return [];
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetJSFiles(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return array();
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetJSInline(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return null;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetJSInline(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return null;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetBodyHTML(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return null;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetBodyHTML(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return null;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetMainContentHTML(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return null;
-	}
+    /**
+     * @inheritDoc
+     */
+    public function GetMainContentHTML(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return null;
+    }
 
-	/**
-	 * @inheritDoc
-	 */
-	public function GetNavigationMenuHTML(\Symfony\Component\DependencyInjection\Container $oContainer)
-	{
-		return null;
-	}
-}
+    /**
+     * @inheritDoc
+     */
+    public function GetNavigationMenuHTML(\Symfony\Component\DependencyInjection\Container $oContainer)
+    {
+        return null;
+    }
+}

application/applicationextension/portal/iPortalUIExtension.php

@@ -11,77 +11,77 @@
  */
 interface iPortalUIExtension
 {
-	public const ENUM_PORTAL_EXT_UI_BODY = 'Body';
-	public const ENUM_PORTAL_EXT_UI_NAVIGATION_MENU = 'NavigationMenu';
-	public const ENUM_PORTAL_EXT_UI_MAIN_CONTENT = 'MainContent';
+    const ENUM_PORTAL_EXT_UI_BODY = 'Body';
+    const ENUM_PORTAL_EXT_UI_NAVIGATION_MENU = 'NavigationMenu';
+    const ENUM_PORTAL_EXT_UI_MAIN_CONTENT = 'MainContent';
 
-	/**
-	 * Returns an array of CSS file urls
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return array
-	 * @api
-	 */
-	public function GetCSSFiles(\Symfony\Component\DependencyInjection\Container $oContainer);
+    /**
+     * Returns an array of CSS file urls
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return array
+     * @api
+     */
+    public function GetCSSFiles(\Symfony\Component\DependencyInjection\Container $oContainer);
 
-	/**
-	 * Returns inline (raw) CSS
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return string
-	 * @api
-	 */
-	public function GetCSSInline(\Symfony\Component\DependencyInjection\Container $oContainer);
+    /**
+     * Returns inline (raw) CSS
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return string
+     * @api
+     */
+    public function GetCSSInline(\Symfony\Component\DependencyInjection\Container $oContainer);
 
-	/**
-	 * Returns an array of JS file urls
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return array
-	 * @api
-	 */
-	public function GetJSFiles(\Symfony\Component\DependencyInjection\Container $oContainer);
+    /**
+     * Returns an array of JS file urls
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return array
+     * @api
+     */
+    public function GetJSFiles(\Symfony\Component\DependencyInjection\Container $oContainer);
 
-	/**
-	 * Returns raw JS code
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return string
-	 * @api
-	 */
-	public function GetJSInline(\Symfony\Component\DependencyInjection\Container $oContainer);
+    /**
+     * Returns raw JS code
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return string
+     * @api
+     */
+    public function GetJSInline(\Symfony\Component\DependencyInjection\Container $oContainer);
 
-	/**
-	 * Returns raw HTML code to put at the end of the <body> tag
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return string
-	 * @api
-	 */
-	public function GetBodyHTML(\Symfony\Component\DependencyInjection\Container $oContainer);
+    /**
+     * Returns raw HTML code to put at the end of the <body> tag
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return string
+     * @api
+     */
+    public function GetBodyHTML(\Symfony\Component\DependencyInjection\Container $oContainer);
 
-	/**
-	 * Returns raw HTML code to put at the end of the #main-wrapper element
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return string
-	 * @api
-	 */
-	public function GetMainContentHTML(\Symfony\Component\DependencyInjection\Container $oContainer);
+    /**
+     * Returns raw HTML code to put at the end of the #main-wrapper element
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return string
+     * @api
+     */
+    public function GetMainContentHTML(\Symfony\Component\DependencyInjection\Container $oContainer);
 
-	/**
-	 * Returns raw HTML code to put at the end of the #topbar and #sidebar elements
-	 *
-	 * @param \Symfony\Component\DependencyInjection\Container $oContainer
-	 *
-	 * @return string
-	 * @api
-	 */
-	public function GetNavigationMenuHTML(\Symfony\Component\DependencyInjection\Container $oContainer);
-}
+    /**
+     * Returns raw HTML code to put at the end of the #topbar and #sidebar elements
+     *
+     * @param \Symfony\Component\DependencyInjection\Container $oContainer
+     *
+     * @return string
+     * @api
+     */
+    public function GetNavigationMenuHTML(\Symfony\Component\DependencyInjection\Container $oContainer);
+}

application/applicationextension/rest/RestResult.php

@@ -9,94 +9,94 @@
  */
 class RestResult
 {
-	/**
-	 * Result: no issue has been encountered
-	 * @api
-	 */
-	public const OK = 0;
-	/**
-	 * Result: missing/wrong credentials or the user does not have enough rights to perform the requested operation
-	 * @api
-	 */
-	public const UNAUTHORIZED = 1;
-	/**
-	 * Result: the parameter 'version' is missing
-	 * @api
-	 */
-	public const MISSING_VERSION = 2;
-	/**
-	 * Result: the parameter 'json_data' is missing
-	 * @api
-	 */
-	public const MISSING_JSON = 3;
-	/**
-	 * Result: the input structure is not a valid JSON string
-	 * @api
-	 */
-	public const INVALID_JSON = 4;
-	/**
-	 * Result: the parameter 'auth_user' is missing, authentication aborted
-	 * @api
-	 */
-	public const MISSING_AUTH_USER = 5;
-	/**
-	 * Result: the parameter 'auth_pwd' is missing, authentication aborted
-	 * @api
-	 */
-	public const MISSING_AUTH_PWD = 6;
-	/**
-	 * Result: no operation is available for the specified version
-	 * @api
-	 */
-	public const UNSUPPORTED_VERSION = 10;
-	/**
-	 * Result: the requested operation is not valid for the specified version
-	 * @api
-	 */
-	public const UNKNOWN_OPERATION = 11;
-	/**
-	 * Result: the requested operation cannot be performed because it can cause data (integrity) loss
-	 * @api
-	 */
-	public const UNSAFE = 12;
-	/**
-	 * Result: the request page number is not valid. It must be an integer greater than 0
-	 * @api
-	 */
-	public const INVALID_PAGE = 13;
-	/**
-	 * Result: the operation could not be performed, see the message for troubleshooting
-	 * @api
-	 */
-	public const INTERNAL_ERROR = 100;
+    /**
+     * Result: no issue has been encountered
+     * @api
+     */
+    const OK = 0;
+    /**
+     * Result: missing/wrong credentials or the user does not have enough rights to perform the requested operation
+     * @api
+     */
+    const UNAUTHORIZED = 1;
+    /**
+     * Result: the parameter 'version' is missing
+     * @api
+     */
+    const MISSING_VERSION = 2;
+    /**
+     * Result: the parameter 'json_data' is missing
+     * @api
+     */
+    const MISSING_JSON = 3;
+    /**
+     * Result: the input structure is not a valid JSON string
+     * @api
+     */
+    const INVALID_JSON = 4;
+    /**
+     * Result: the parameter 'auth_user' is missing, authentication aborted
+     * @api
+     */
+    const MISSING_AUTH_USER = 5;
+    /**
+     * Result: the parameter 'auth_pwd' is missing, authentication aborted
+     * @api
+     */
+    const MISSING_AUTH_PWD = 6;
+    /**
+     * Result: no operation is available for the specified version
+     * @api
+     */
+    const UNSUPPORTED_VERSION = 10;
+    /**
+     * Result: the requested operation is not valid for the specified version
+     * @api
+     */
+    const UNKNOWN_OPERATION = 11;
+    /**
+     * Result: the requested operation cannot be performed because it can cause data (integrity) loss
+     * @api
+     */
+    const UNSAFE = 12;
+    /**
+     * Result: the request page number is not valid. It must be an integer greater than 0
+     * @api
+     */
+    const INVALID_PAGE = 13;
+    /**
+     * Result: the operation could not be performed, see the message for troubleshooting
+     * @api
+     */
+    const INTERNAL_ERROR = 100;
 
-	/**
-	 * Default constructor - ok!
-	 * @api
-	 */
-	public function __construct()
-	{
-		$this->code = RestResult::OK;
-	}
+    /**
+     * Default constructor - ok!
+     * @api
+     */
+    public function __construct()
+    {
+        $this->code = RestResult::OK;
+    }
 
-	/**
-	 * Result code
-	 * @var int
-	 * @api
-	 */
-	public $code;
-	/**
-	 * Result message
-	 * @var string
-	 * @api
-	 */
-	public $message;
+    /**
+     * Result code
+     * @var int
+     * @api
+     */
+    public $code;
+    /**
+     * Result message
+     * @var string
+     * @api
+     */
+    public $message;
 
-	/**
-	 * Sanitize the content of this result to hide sensitive information
-	 */
-	public function SanitizeContent()
-	{
-		// The default implementation does nothing
-	}
-}
+    /**
+     * Sanitize the content of this result to hide sensitive information
+     */
+    public function SanitizeContent()
+    {
+        // The default implementation does nothing
+    }
+}

application/applicationextension/rest/RestUtils.php

@@ -8,357 +8,361 @@
  */
 class RestUtils
 {
-	/**
-	 * Registering tracking information. Any further object modification be associated with the given comment, when the modification gets
-	 * recorded into the DB
-	 *
-	 * @param StdClass $oData Structured input data. Must contain 'comment'.
-	 *
-	 * @return void
-	 * @throws Exception
-	 * @api
-	 *
-	 */
-	public static function InitTrackingComment($oData)
-	{
-		$sComment = self::GetMandatoryParam($oData, 'comment');
-		CMDBObject::SetTrackInfo($sComment);
-	}
+    /**
+     * Registering tracking information. Any further object modification be associated with the given comment, when the modification gets
+     * recorded into the DB
+     *
+     * @param StdClass $oData Structured input data. Must contain 'comment'.
+     *
+     * @return void
+     * @throws Exception
+     * @api
+     *
+     */
+    public static function InitTrackingComment($oData)
+    {
+        $sComment = self::GetMandatoryParam($oData, 'comment');
+        CMDBObject::SetTrackInfo($sComment);
+    }
 
-	/**
-	 * Read a mandatory parameter from  from a Rest/Json structure.
-	 *
-	 * @param string $sParamName Name of the parameter to fetch from the input data
-	 * @param StdClass $oData Structured input data. Must contain the entry defined by sParamName.
-	 *
-	 * @return mixed parameter value if present
-	 * @throws Exception If the parameter is missing
-	 * @api
-	 */
-	public static function GetMandatoryParam($oData, $sParamName)
-	{
-		if (isset($oData->$sParamName)) {
-			return $oData->$sParamName;
-		} else {
-			throw new Exception("Missing parameter '$sParamName'");
-		}
-	}
+    /**
+     * Read a mandatory parameter from  from a Rest/Json structure.
+     *
+     * @param string $sParamName Name of the parameter to fetch from the input data
+     * @param StdClass $oData Structured input data. Must contain the entry defined by sParamName.
+     *
+     * @return mixed parameter value if present
+     * @throws Exception If the parameter is missing
+     * @api
+     */
+    public static function GetMandatoryParam($oData, $sParamName)
+    {
+        if (isset($oData->$sParamName)) {
+            return $oData->$sParamName;
+        } else {
+            throw new Exception("Missing parameter '$sParamName'");
+        }
+    }
 
-	/**
-	 * Read an optional parameter from a Rest/Json structure.
-	 *
-	 * @param string $sParamName Name of the parameter to fetch from the input data
-	 * @param mixed $default Default value if the parameter is not found in the input data
-	 *
-	 * @param StdClass $oData Structured input data.
-	 *
-	 * @return mixed
-	 * @throws Exception
-	 * @api
-	 */
-	public static function GetOptionalParam($oData, $sParamName, $default)
-	{
-		if (isset($oData->$sParamName)) {
-			return $oData->$sParamName;
-		} else {
-			return $default;
-		}
-	}
 
-	/**
-	 * Read a class from a Rest/Json structure.
-	 *
-	 * @param string $sParamName Name of the parameter to fetch from the input data
-	 * @param StdClass $oData Structured input data. Must contain the entry defined by sParamName.
-	 *
-	 * @return string
-	 * @throws Exception If the parameter is missing or the class is unknown
-	 * @api
-	 */
-	public static function GetClass($oData, $sParamName)
-	{
-		$sClass = self::GetMandatoryParam($oData, $sParamName);
-		if (!MetaModel::IsValidClass($sClass)) {
-			throw new Exception("$sParamName: '$sClass' is not a valid class'");
-		}
+    /**
+     * Read an optional parameter from a Rest/Json structure.
+     *
+     * @param string $sParamName Name of the parameter to fetch from the input data
+     * @param mixed $default Default value if the parameter is not found in the input data
+     *
+     * @param StdClass $oData Structured input data.
+     *
+     * @return mixed
+     * @throws Exception
+     * @api
+     */
+    public static function GetOptionalParam($oData, $sParamName, $default)
+    {
+        if (isset($oData->$sParamName)) {
+            return $oData->$sParamName;
+        } else {
+            return $default;
+        }
+    }
 
-		return $sClass;
-	}
 
-	/**
-	 * Read a list of attribute codes from a Rest/Json structure.
-	 *
-	 * @param StdClass $oData Structured input data.
-	 * @param string $sParamName Name of the parameter to fetch from the input data
-	 *
-	 * @param string $sClass Name of the class
-	 *
-	 * @return array of class => list of attributes (see RestResultWithObjects::AddObject that uses it)
-	 * @throws Exception
-	 * @api
-	 */
-	public static function GetFieldList($sClass, $oData, $sParamName)
-	{
-		$sFields = self::GetOptionalParam($oData, $sParamName, '*');
-		$aShowFields = [];
-		if ($sFields == '*') {
-			foreach (MetaModel::ListAttributeDefs($sClass) as $sAttCode => $oAttDef) {
-				$aShowFields[$sClass][] = $sAttCode;
-			}
-		} elseif ($sFields == '*+') {
-			foreach (MetaModel::EnumChildClasses($sClass, ENUM_CHILD_CLASSES_ALL) as $sRefClass) {
-				foreach (MetaModel::ListAttributeDefs($sRefClass) as $sAttCode => $oAttDef) {
-					$aShowFields[$sRefClass][] = $sAttCode;
-				}
-			}
-		} else {
-			foreach (explode(',', $sFields) as $sAttCode) {
-				$sAttCode = trim($sAttCode);
-				if (($sAttCode != 'id') && (!MetaModel::IsValidAttCode($sClass, $sAttCode))) {
-					throw new Exception("$sParamName: invalid attribute code '$sAttCode'");
-				}
-				$aShowFields[$sClass][] = $sAttCode;
-			}
-		}
+    /**
+     * Read a class from a Rest/Json structure.
+     *
+     * @param string $sParamName Name of the parameter to fetch from the input data
+     * @param StdClass $oData Structured input data. Must contain the entry defined by sParamName.
+     *
+     * @return string
+     * @throws Exception If the parameter is missing or the class is unknown
+     * @api
+     */
+    public static function GetClass($oData, $sParamName)
+    {
+        $sClass = self::GetMandatoryParam($oData, $sParamName);
+        if (!MetaModel::IsValidClass($sClass)) {
+            throw new Exception("$sParamName: '$sClass' is not a valid class'");
+        }
 
-		return $aShowFields;
-	}
+        return $sClass;
+    }
 
-	/**
-	 * Read and interpret object search criteria from a Rest/Json structure
-	 *
-	 * @param string $sClass Name of the class
-	 * @param StdClass $oCriteria Hash of attribute code => value (can be a substructure or a scalar, depending on the nature of the
-	 *     attriute)
-	 *
-	 * @return object The object found
-	 * @throws Exception If the input structure is not valid or it could not find exactly one object
-	 * @api
-	 */
-	protected static function FindObjectFromCriteria($sClass, $oCriteria)
-	{
-		$aCriteriaReport = [];
-		if (isset($oCriteria->finalclass)) {
-			if (!MetaModel::IsValidClass($oCriteria->finalclass)) {
-				throw new Exception("finalclass: Unknown class '".$oCriteria->finalclass."'");
-			}
-			if (!MetaModel::IsParentClass($sClass, $oCriteria->finalclass)) {
-				throw new Exception("finalclass: '".$oCriteria->finalclass."' is not a child class of '$sClass'");
-			}
-			$sClass = $oCriteria->finalclass;
-		}
-		$oSearch = new DBObjectSearch($sClass);
-		foreach ($oCriteria as $sAttCode => $value) {
-			$realValue = static::MakeValue($sClass, $sAttCode, $value);
-			$oSearch->AddCondition($sAttCode, $realValue, '=');
-			if (is_object($value) || is_array($value)) {
-				$value = json_encode($value);
-			}
-			$aCriteriaReport[] = "$sAttCode: $value ($realValue)";
-		}
-		$oSet = new DBObjectSet($oSearch);
-		$iCount = $oSet->Count();
-		if ($iCount == 0) {
-			throw new Exception("No item found with criteria: ".implode(', ', $aCriteriaReport));
-		} elseif ($iCount > 1) {
-			throw new Exception("Several items found ($iCount) with criteria: ".implode(', ', $aCriteriaReport));
-		}
-		$res = $oSet->Fetch();
 
-		return $res;
-	}
+    /**
+     * Read a list of attribute codes from a Rest/Json structure.
+     *
+     * @param StdClass $oData Structured input data.
+     * @param string $sParamName Name of the parameter to fetch from the input data
+     *
+     * @param string $sClass Name of the class
+     *
+     * @return array of class => list of attributes (see RestResultWithObjects::AddObject that uses it)
+     * @throws Exception
+     * @api
+     */
+    public static function GetFieldList($sClass, $oData, $sParamName)
+    {
+        $sFields = self::GetOptionalParam($oData, $sParamName, '*');
+        $aShowFields = array();
+        if ($sFields == '*') {
+            foreach (MetaModel::ListAttributeDefs($sClass) as $sAttCode => $oAttDef) {
+                $aShowFields[$sClass][] = $sAttCode;
+            }
+        } elseif ($sFields == '*+') {
+            foreach (MetaModel::EnumChildClasses($sClass, ENUM_CHILD_CLASSES_ALL) as $sRefClass) {
+                foreach (MetaModel::ListAttributeDefs($sRefClass) as $sAttCode => $oAttDef) {
+                    $aShowFields[$sRefClass][] = $sAttCode;
+                }
+            }
+        } else {
+            foreach (explode(',', $sFields) as $sAttCode) {
+                $sAttCode = trim($sAttCode);
+                if (($sAttCode != 'id') && (!MetaModel::IsValidAttCode($sClass, $sAttCode))) {
+                    throw new Exception("$sParamName: invalid attribute code '$sAttCode'");
+                }
+                $aShowFields[$sClass][] = $sAttCode;
+            }
+        }
 
-	/**
-	 * Find an object from a polymorph search specification (Rest/Json)
-	 *
-	 * @param mixed $key Either search criteria (substructure), or an object or an OQL string.
-	 * @param bool $bAllowNullValue Allow the cases such as key = 0 or key = {null} and return null then
-	 * @param string $sClass Name of the class
-	 *
-	 * @return DBObject The object found
-	 * @throws Exception If the input structure is not valid or it could not find exactly one object
-	 *
-	 * @api
-	 * @see DBObject::CheckChangedExtKeysValues() generic method to check that we can access the linked object isn't used in that use case because values can be literal, OQL, friendlyname
-	 */
-	public static function FindObjectFromKey($sClass, $key, $bAllowNullValue = false)
-	{
-		if (is_object($key)) {
-			$res = static::FindObjectFromCriteria($sClass, $key);
-		} elseif (is_numeric($key)) {
-			if ($bAllowNullValue && ($key == 0)) {
-				$res = null;
-			} else {
-				$res = MetaModel::GetObject($sClass, $key, false);
-				if (is_null($res)) {
-					throw new Exception("Invalid object $sClass::$key");
-				}
-			}
-		} elseif (is_string($key)) {
-			// OQL
-			$oSearch = DBObjectSearch::FromOQL($key);
-			$oSet = new DBObjectSet($oSearch);
-			$iCount = $oSet->Count();
-			if ($iCount == 0) {
-				throw new Exception("No item found for query: $key");
-			} elseif ($iCount > 1) {
-				throw new Exception("Several items found ($iCount) for query: $key");
-			}
-			$res = $oSet->Fetch();
-		} else {
-			throw new Exception("Wrong format for key");
-		}
+        return $aShowFields;
+    }
 
-		return $res;
-	}
+    /**
+     * Read and interpret object search criteria from a Rest/Json structure
+     *
+     * @param string $sClass Name of the class
+     * @param StdClass $oCriteria Hash of attribute code => value (can be a substructure or a scalar, depending on the nature of the
+     *     attriute)
+     *
+     * @return object The object found
+     * @throws Exception If the input structure is not valid or it could not find exactly one object
+     * @api
+     */
+    protected static function FindObjectFromCriteria($sClass, $oCriteria)
+    {
+        $aCriteriaReport = array();
+        if (isset($oCriteria->finalclass)) {
+            if (!MetaModel::IsValidClass($oCriteria->finalclass)) {
+                throw new Exception("finalclass: Unknown class '" . $oCriteria->finalclass . "'");
+            }
+            if (!MetaModel::IsParentClass($sClass, $oCriteria->finalclass)) {
+                throw new Exception("finalclass: '" . $oCriteria->finalclass . "' is not a child class of '$sClass'");
+            }
+            $sClass = $oCriteria->finalclass;
+        }
+        $oSearch = new DBObjectSearch($sClass);
+        foreach ($oCriteria as $sAttCode => $value) {
+            $realValue = static::MakeValue($sClass, $sAttCode, $value);
+            $oSearch->AddCondition($sAttCode, $realValue, '=');
+            if (is_object($value) || is_array($value)) {
+                $value = json_encode($value);
+            }
+            $aCriteriaReport[] = "$sAttCode: $value ($realValue)";
+        }
+        $oSet = new DBObjectSet($oSearch);
+        $iCount = $oSet->Count();
+        if ($iCount == 0) {
+            throw new Exception("No item found with criteria: " . implode(', ', $aCriteriaReport));
+        } elseif ($iCount > 1) {
+            throw new Exception("Several items found ($iCount) with criteria: " . implode(', ', $aCriteriaReport));
+        }
+        $res = $oSet->Fetch();
 
-	/**
-	 * Search objects from a polymorph search specification (Rest/Json)
-	 *
-	 * @param string $sClass Name of the class
-	 * @param mixed $key Either search criteria (substructure), or an object or an OQL string.
-	 * @param int $iLimit The limit of results to return
-	 * @param int $iOffset The offset of results to return
-	 *
-	 * @return DBObjectSet The search result set
-	 * @throws Exception If the input structure is not valid
-	 * @api
-	 */
-	public static function GetObjectSetFromKey($sClass, $key, $iLimit = 0, $iOffset = 0)
-	{
-		if (is_object($key)) {
-			if (isset($key->finalclass)) {
-				$sClass = $key->finalclass;
-				if (!MetaModel::IsValidClass($sClass)) {
-					throw new Exception("finalclass: Unknown class '$sClass'");
-				}
-			}
+        return $res;
+    }
 
-			$oSearch = new DBObjectSearch($sClass);
-			foreach ($key as $sAttCode => $value) {
-				$realValue = static::MakeValue($sClass, $sAttCode, $value);
-				$oSearch->AddCondition($sAttCode, $realValue, '=');
-			}
-		} elseif (is_numeric($key)) {
-			$oSearch = new DBObjectSearch($sClass);
-			$oSearch->AddCondition('id', $key);
-		} elseif (is_string($key)) {
-			// OQL
-			try {
-				$oSearch = DBObjectSearch::FromOQL($key);
-			} catch (Exception $e) {
-				throw new CoreOqlException('Query failed to execute', [
-					'query' => $key,
-					'exception_class' => get_class($e),
-					'exception_message' => $e->getMessage(),
-				]);
-			}
-		} else {
-			throw new Exception("Wrong format for key");
-		}
-		$oObjectSet = new DBObjectSet($oSearch, [], [], null, $iLimit, $iOffset);
 
-		return $oObjectSet;
-	}
+    /**
+     * Find an object from a polymorph search specification (Rest/Json)
+     *
+     * @param mixed $key Either search criteria (substructure), or an object or an OQL string.
+     * @param bool $bAllowNullValue Allow the cases such as key = 0 or key = {null} and return null then
+     * @param string $sClass Name of the class
+     *
+     * @return DBObject The object found
+     * @throws Exception If the input structure is not valid or it could not find exactly one object
+     *
+     * @api
+     * @see DBObject::CheckChangedExtKeysValues() generic method to check that we can access the linked object isn't used in that use case because values can be literal, OQL, friendlyname
+     */
+    public static function FindObjectFromKey($sClass, $key, $bAllowNullValue = false)
+    {
+        if (is_object($key)) {
+            $res = static::FindObjectFromCriteria($sClass, $key);
+        } elseif (is_numeric($key)) {
+            if ($bAllowNullValue && ($key == 0)) {
+                $res = null;
+            } else {
+                $res = MetaModel::GetObject($sClass, $key, false);
+                if (is_null($res)) {
+                    throw new Exception("Invalid object $sClass::$key");
+                }
+            }
+        } elseif (is_string($key)) {
+            // OQL
+            $oSearch = DBObjectSearch::FromOQL($key);
+            $oSet = new DBObjectSet($oSearch);
+            $iCount = $oSet->Count();
+            if ($iCount == 0) {
+                throw new Exception("No item found for query: $key");
+            } elseif ($iCount > 1) {
+                throw new Exception("Several items found ($iCount) for query: $key");
+            }
+            $res = $oSet->Fetch();
+        } else {
+            throw new Exception("Wrong format for key");
+        }
 
-	/**
-	 * Interpret the Rest/Json value and get a valid attribute value
-	 *
-	 * @param string $sAttCode Attribute code
-	 * @param mixed $value Depending on the type of attribute (a scalar, or search criteria, or list of related objects...)
-	 * @param string $sClass Name of the class
-	 *
-	 * @return mixed The value that can be used with DBObject::Set()
-	 * @throws Exception If the specification of the value is not valid.
-	 * @api
-	 */
-	public static function MakeValue($sClass, $sAttCode, $value)
-	{
-		try {
-			if (!MetaModel::IsValidAttCode($sClass, $sAttCode)) {
-				throw new Exception("Unknown attribute");
-			}
-			$oAttDef = MetaModel::GetAttributeDef($sClass, $sAttCode);
-			if ($oAttDef instanceof AttributeExternalKey) {
-				$oExtKeyObject = static::FindObjectFromKey($oAttDef->GetTargetClass(), $value, true /* allow null */);
-				$value = ($oExtKeyObject != null) ? $oExtKeyObject->GetKey() : 0;
-			} elseif ($oAttDef instanceof AttributeLinkedSet) {
-				if (!is_array($value)) {
-					throw new Exception("A link set must be defined by an array of objects");
-				}
-				$sLnkClass = $oAttDef->GetLinkedClass();
-				$aLinks = [];
-				foreach ($value as $oValues) {
-					$oLnk = static::MakeObjectFromFields($sLnkClass, $oValues);
-					// Fix for N°1939
-					if (($oAttDef instanceof AttributeLinkedSetIndirect) && ($oLnk->Get($oAttDef->GetExtKeyToRemote()) == 0)) {
-						continue;
-					}
-					$aLinks[] = $oLnk;
-				}
-				$value = DBObjectSet::FromArray($sLnkClass, $aLinks);
-			} elseif ($oAttDef instanceof AttributeTagSet) {
-				if (!is_array($value)) {
-					throw new Exception("A tag set must be defined by an array of tag codes");
-				}
-				$value = $oAttDef->FromJSONToValue($value);
-			} else {
-				$value = $oAttDef->FromJSONToValue($value);
-			}
-		} catch (Exception $e) {
-			throw new Exception("$sAttCode: ".$e->getMessage(), $e->getCode());
-		}
+        return $res;
+    }
 
-		return $value;
-	}
+    /**
+     * Search objects from a polymorph search specification (Rest/Json)
+     *
+     * @param string $sClass Name of the class
+     * @param mixed $key Either search criteria (substructure), or an object or an OQL string.
+     * @param int $iLimit The limit of results to return
+     * @param int $iOffset The offset of results to return
+     *
+     * @return DBObjectSet The search result set
+     * @throws Exception If the input structure is not valid
+     * @api
+     */
+    public static function GetObjectSetFromKey($sClass, $key, $iLimit = 0, $iOffset = 0)
+    {
+        if (is_object($key)) {
+            if (isset($key->finalclass)) {
+                $sClass = $key->finalclass;
+                if (!MetaModel::IsValidClass($sClass)) {
+                    throw new Exception("finalclass: Unknown class '$sClass'");
+                }
+            }
 
-	/**
-	 * Interpret a Rest/Json structure that defines attribute values, and build an object
-	 *
-	 * @param array $aFields A hash of attribute code => value specification.
-	 * @param string $sClass Name of the class
-	 *
-	 * @return DBObject The newly created object
-	 * @throws Exception If the specification of the values is not valid
-	 * @api
-	 */
-	public static function MakeObjectFromFields($sClass, $aFields)
-	{
-		$oObject = MetaModel::NewObject($sClass);
-		foreach ($aFields as $sAttCode => $value) {
-			$realValue = static::MakeValue($sClass, $sAttCode, $value);
-			try {
-				$oObject->Set($sAttCode, $realValue);
-			} catch (Exception $e) {
-				throw new Exception("$sAttCode: ".$e->getMessage(), $e->getCode());
-			}
-		}
+            $oSearch = new DBObjectSearch($sClass);
+            foreach ($key as $sAttCode => $value) {
+                $realValue = static::MakeValue($sClass, $sAttCode, $value);
+                $oSearch->AddCondition($sAttCode, $realValue, '=');
+            }
+        } elseif (is_numeric($key)) {
+            $oSearch = new DBObjectSearch($sClass);
+            $oSearch->AddCondition('id', $key);
+        } elseif (is_string($key)) {
+            // OQL
+            try {
+                $oSearch = DBObjectSearch::FromOQL($key);
+            } catch (Exception $e) {
+                throw new CoreOqlException('Query failed to execute', [
+                    'query' => $key,
+                    'exception_class' => get_class($e),
+                    'exception_message' => $e->getMessage(),
+                ]);
+            }
+        } else {
+            throw new Exception("Wrong format for key");
+        }
+        $oObjectSet = new DBObjectSet($oSearch, array(), array(), null, $iLimit, $iOffset);
 
-		return $oObject;
-	}
+        return $oObjectSet;
+    }
 
-	/**
-	 * Interpret a Rest/Json structure that defines attribute values, and update the given object
-	 *
-	 * @param array $aFields A hash of attribute code => value specification.
-	 * @param DBObject $oObject The object being modified
-	 *
-	 * @return DBObject The object modified
-	 * @throws Exception If the specification of the values is not valid
-	 * @api
-	 */
-	public static function UpdateObjectFromFields($oObject, $aFields)
-	{
-		$sClass = get_class($oObject);
-		foreach ($aFields as $sAttCode => $value) {
-			$realValue = static::MakeValue($sClass, $sAttCode, $value);
-			try {
-				$oObject->Set($sAttCode, $realValue);
-			} catch (Exception $e) {
-				throw new Exception("$sAttCode: ".$e->getMessage(), $e->getCode());
-			}
-		}
+    /**
+     * Interpret the Rest/Json value and get a valid attribute value
+     *
+     * @param string $sAttCode Attribute code
+     * @param mixed $value Depending on the type of attribute (a scalar, or search criteria, or list of related objects...)
+     * @param string $sClass Name of the class
+     *
+     * @return mixed The value that can be used with DBObject::Set()
+     * @throws Exception If the specification of the value is not valid.
+     * @api
+     */
+    public static function MakeValue($sClass, $sAttCode, $value)
+    {
+        try {
+            if (!MetaModel::IsValidAttCode($sClass, $sAttCode)) {
+                throw new Exception("Unknown attribute");
+            }
+            $oAttDef = MetaModel::GetAttributeDef($sClass, $sAttCode);
+            if ($oAttDef instanceof AttributeExternalKey) {
+                $oExtKeyObject = static::FindObjectFromKey($oAttDef->GetTargetClass(), $value, true /* allow null */);
+                $value = ($oExtKeyObject != null) ? $oExtKeyObject->GetKey() : 0;
+            } elseif ($oAttDef instanceof AttributeLinkedSet) {
+                if (!is_array($value)) {
+                    throw new Exception("A link set must be defined by an array of objects");
+                }
+                $sLnkClass = $oAttDef->GetLinkedClass();
+                $aLinks = array();
+                foreach ($value as $oValues) {
+                    $oLnk = static::MakeObjectFromFields($sLnkClass, $oValues);
+                    // Fix for N°1939
+                    if (($oAttDef instanceof AttributeLinkedSetIndirect) && ($oLnk->Get($oAttDef->GetExtKeyToRemote()) == 0)) {
+                        continue;
+                    }
+                    $aLinks[] = $oLnk;
+                }
+                $value = DBObjectSet::FromArray($sLnkClass, $aLinks);
+            } elseif ($oAttDef instanceof AttributeTagSet) {
+                if (!is_array($value)) {
+                    throw new Exception("A tag set must be defined by an array of tag codes");
+                }
+                $value = $oAttDef->FromJSONToValue($value);
+            } else {
+                $value = $oAttDef->FromJSONToValue($value);
+            }
+        } catch (Exception $e) {
+            throw new Exception("$sAttCode: " . $e->getMessage(), $e->getCode());
+        }
 
-		return $oObject;
-	}
-}
+        return $value;
+    }
+
+    /**
+     * Interpret a Rest/Json structure that defines attribute values, and build an object
+     *
+     * @param array $aFields A hash of attribute code => value specification.
+     * @param string $sClass Name of the class
+     *
+     * @return DBObject The newly created object
+     * @throws Exception If the specification of the values is not valid
+     * @api
+     */
+    public static function MakeObjectFromFields($sClass, $aFields)
+    {
+        $oObject = MetaModel::NewObject($sClass);
+        foreach ($aFields as $sAttCode => $value) {
+            $realValue = static::MakeValue($sClass, $sAttCode, $value);
+            try {
+                $oObject->Set($sAttCode, $realValue);
+            } catch (Exception $e) {
+                throw new Exception("$sAttCode: " . $e->getMessage(), $e->getCode());
+            }
+        }
+
+        return $oObject;
+    }
+
+    /**
+     * Interpret a Rest/Json structure that defines attribute values, and update the given object
+     *
+     * @param array $aFields A hash of attribute code => value specification.
+     * @param DBObject $oObject The object being modified
+     *
+     * @return DBObject The object modified
+     * @throws Exception If the specification of the values is not valid
+     * @api
+     */
+    public static function UpdateObjectFromFields($oObject, $aFields)
+    {
+        $sClass = get_class($oObject);
+        foreach ($aFields as $sAttCode => $value) {
+            $realValue = static::MakeValue($sClass, $sAttCode, $value);
+            try {
+                $oObject->Set($sAttCode, $realValue);
+            } catch (Exception $e) {
+                throw new Exception("$sAttCode: " . $e->getMessage(), $e->getCode());
+            }
+        }
+
+        return $oObject;
+    }
+}

application/applicationextension/rest/iRestInputSanitizer.php

@@ -8,5 +8,5 @@
  */
 interface iRestInputSanitizer
 {
-	public function SanitizeJsonInput(string $sJsonInput): string;
-}
+    public function SanitizeJsonInput(string $sJsonInput): string;
+}

application/applicationextension/rest/iRestServiceProvider.php

@@ -9,25 +9,25 @@
  */
 interface iRestServiceProvider
 {
-	/**
-	 * Enumerate services delivered by this class
-	 *
-	 * @param string $sVersion The version (e.g. 1.0) supported by the services
-	 *
-	 * @return array An array of hash 'verb' => verb, 'description' => description
-	 * @api
-	 */
-	public function ListOperations($sVersion);
+    /**
+     * Enumerate services delivered by this class
+     *
+     * @param string $sVersion The version (e.g. 1.0) supported by the services
+     *
+     * @return array An array of hash 'verb' => verb, 'description' => description
+     * @api
+     */
+    public function ListOperations($sVersion);
 
-	/**
-	 * Enumerate services delivered by this class
-	 *
-	 * @param string $sVersion The version (e.g. 1.0) supported by the services
-	 * @param string $sVerb
-	 * @param array $aParams
-	 *
-	 * @return RestResult The standardized result structure (at least a message)
-	 * @api
-	 */
-	public function ExecOperation($sVersion, $sVerb, $aParams);
-}
+    /**
+     * Enumerate services delivered by this class
+     *
+     * @param string $sVersion The version (e.g. 1.0) supported by the services
+     * @param string $sVerb
+     * @param array $aParams
+     *
+     * @return RestResult The standardized result structure (at least a message)
+     * @api
+     */
+    public function ExecOperation($sVersion, $sVerb, $aParams);
+}

application/audit.category.class.inc.php

@@ -1,10 +1,9 @@
 <?php
-
 // Copyright (C) 2010-2024 Combodo SAS
 //
 //   This file is part of iTop.
 //
-//   iTop is free software; you can redistribute it and/or modify
+//   iTop 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.
@@ -17,6 +16,7 @@
 //   You should have received a copy of the GNU Affero General Public License
 //   along with iTop. If not, see <http://www.gnu.org/licenses/>
 
+
 /**
  * This class manages the audit "categories". Each category defines a set of objects
  * to check and is linked to a set of rules that determine the valid or invalid objects
@@ -32,36 +32,34 @@ class AuditCategory extends cmdbAbstractObject
 {
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category"            => "application,grant_by_profile",
 			"key_type"            => "autoincrement",
 			"name_attcode"        => "name",
 			"state_attcode"       => "",
-			"reconc_keys"         => ['name'],
+			"reconc_keys"         => array('name'),
 			"db_table"            => "priv_auditcategory",
 			"db_key_field"        => "id",
 			"db_finalclass_field" => "",
 			'style'               => new ormStyle(null, null, null, null, null, '../images/icons/icons8-audit-folder.svg'),
-		];
+		);
 		MetaModel::Init_Params($aParams);
-		MetaModel::Init_AddAttribute(new AttributeString("name", ["description" => "Short name for this category", "allowed_values" => null, "sql" => "name", "default_value" => "", "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeString("description", ["allowed_values" => null, "sql" => "description", "default_value" => "", "is_null_allowed" => true, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeOQL("definition_set", ["allowed_values" => null, "sql" => "definition_set", "default_value" => "", "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeLinkedSet("rules_list", ["linked_class" => "AuditRule", "ext_key_to_me" => "category_id", "allowed_values" => null, "count_min" => 0, "count_max" => 0, "depends_on" => [], "edit_mode" => LINKSET_EDITMODE_INPLACE, "edit_when" => LINKSET_EDITWHEN_ALWAYS, "tracking_level" => LINKSET_TRACKING_ALL]));
-		MetaModel::Init_AddAttribute(new AttributeInteger("ok_error_tolerance", ["allowed_values" => null, "sql" => "ok_error_tolerance", "default_value" => 5, "is_null_allowed" => true, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeInteger("warning_error_tolerance", ["allowed_values" => null, "sql" => "warning_error_tolerance", "default_value" => 25, "is_null_allowed" => true, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeLinkedSetIndirect(
-			"domains_list",
-			["linked_class" => "lnkAuditCategoryToAuditDomain", "ext_key_to_me" => "category_id", "ext_key_to_remote" => "domain_id", "allowed_values" => null, "count_min" => 0, "count_max" => 0, "depends_on" => [], "display_style" => 'property']
-		));
+		MetaModel::Init_AddAttribute(new AttributeString("name", array("description"=>"Short name for this category", "allowed_values"=>null, "sql"=>"name", "default_value"=>"", "is_null_allowed"=>false, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeString("description", array("allowed_values"=>null, "sql"=>"description", "default_value"=>"", "is_null_allowed"=>true, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeOQL("definition_set", array("allowed_values"=>null, "sql"=>"definition_set", "default_value"=>"", "is_null_allowed"=>false, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeLinkedSet("rules_list", array("linked_class"=>"AuditRule", "ext_key_to_me"=>"category_id", "allowed_values"=>null, "count_min"=>0, "count_max"=>0, "depends_on"=>array(), "edit_mode" => LINKSET_EDITMODE_INPLACE, "tracking_level" => LINKSET_TRACKING_ALL)));
+		MetaModel::Init_AddAttribute(new AttributeInteger("ok_error_tolerance", array("allowed_values"=>null, "sql"=>"ok_error_tolerance", "default_value"=>5, "is_null_allowed"=>true, "depends_on"=>array())));
+		MetaModel::Init_AddAttribute(new AttributeInteger("warning_error_tolerance", array("allowed_values" => null, "sql" => "warning_error_tolerance", "default_value" => 25, "is_null_allowed" => true, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeLinkedSetIndirect("domains_list",
+			array("linked_class" => "lnkAuditCategoryToAuditDomain", "ext_key_to_me" => "category_id", "ext_key_to_remote" => "domain_id", "allowed_values" => null, "count_min" => 0, "count_max" => 0, "depends_on" => array(), "display_style" => 'property')));
 
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['name', 'description', 'definition_set', 'ok_error_tolerance', 'warning_error_tolerance', 'rules_list', 'domains_list']); // Attributes to be displayed for the complete details
-		MetaModel::Init_SetZListItems('list', ['description', ]); // Attributes to be displayed for a list
+		MetaModel::Init_SetZListItems('details', array('name', 'description', 'definition_set', 'ok_error_tolerance', 'warning_error_tolerance', 'rules_list', 'domains_list')); // Attributes to be displayed for the complete details
+		MetaModel::Init_SetZListItems('list', array('description', )); // Attributes to be displayed for a list
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['description', 'definition_set']); // Criteria of the std search form
-		MetaModel::Init_SetZListItems('default_search', ['name', 'description']); // Criteria of the default search form
+		MetaModel::Init_SetZListItems('standard_search', array('description', 'definition_set')); // Criteria of the std search form
+		MetaModel::Init_SetZListItems('default_search', array('name', 'description')); // Criteria of the default search form
 	}
 
 	/**
@@ -76,9 +74,9 @@ class AuditCategory extends cmdbAbstractObject
 	public function GetReportColor($iTotal, $iErrors)
 	{
 		$sResult = 'red';
-		if (($iTotal == 0) || ($iErrors / $iTotal) <= ($this->Get('ok_error_tolerance') / 100)) {
+		if ( ($iTotal == 0) || ($iErrors / $iTotal) <= ($this->Get('ok_error_tolerance') / 100) ) {
 			$sResult = 'green';
-		} elseif (($iErrors / $iTotal) <= ($this->Get('warning_error_tolerance') / 100)) {
+		} else if (($iErrors / $iTotal) <= ($this->Get('warning_error_tolerance') / 100)) {
 			$sResult = 'orange';
 		}
 
@@ -95,3 +93,4 @@ class AuditCategory extends cmdbAbstractObject
 		return $aShortcutActions;
 	}
 }
+?>

application/audit.domain.class.inc.php

@@ -1,5 +1,4 @@
 <?php
-
 // Copyright (C) 2010-2024 Combodo SAS
 //
 //   This file is part of iTop.
@@ -17,6 +16,7 @@
 //   You should have received a copy of the GNU Affero General Public License
 //   along with iTop. If not, see <http://www.gnu.org/licenses/>
 
+
 /**
  * This class manages the audit "categories". Each category defines a set of objects
  * to check and is linked to a set of rules that determine the valid or invalid objects
@@ -33,34 +33,32 @@ class AuditDomain extends cmdbAbstractObject
 {
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category"                   => "application,grant_by_profile",
 			"key_type"                   => "autoincrement",
 			"name_attcode"               => "name",
-			"complementary_name_attcode" => ['description'],
+			"complementary_name_attcode" => array('description'),
 			"state_attcode"              => "",
-			"reconc_keys"                => ['name'],
+			"reconc_keys"                => array('name'),
 			"db_table"                   => "priv_auditdomain",
 			"db_key_field"               => "id",
 			"db_finalclass_field"        => "",
 			'style'                      => new ormStyle(null, null, null, null, null, '../images/icons/icons8-audit-album.svg'),
-		];
+		);
 		MetaModel::Init_Params($aParams);
-		MetaModel::Init_AddAttribute(new AttributeString("name", ["description" => "Short name for this category", "allowed_values" => null, "sql" => "name", "default_value" => "", "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeString("description", ["allowed_values" => null, "sql" => "description", "default_value" => "", "is_null_allowed" => true, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeImage("icon", ["is_null_allowed" => true, "depends_on" => [], "display_max_width" => 96, "display_max_height" => 96, "storage_max_width" => 256, "storage_max_height" => 256, "default_image" => null, "always_load_in_tables" => false]));
-		MetaModel::Init_AddAttribute(new AttributeLinkedSetIndirect(
-			"categories_list",
-			["linked_class" => "lnkAuditCategoryToAuditDomain", "ext_key_to_me" => "domain_id", "ext_key_to_remote" => "category_id", "allowed_values" => null, "count_min" => 0, "count_max" => 0, "depends_on" => []]
-		));
+		MetaModel::Init_AddAttribute(new AttributeString("name", array("description" => "Short name for this category", "allowed_values" => null, "sql" => "name", "default_value" => "", "is_null_allowed" => false, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeString("description", array("allowed_values" => null, "sql" => "description", "default_value" => "", "is_null_allowed" => true, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeImage("icon", array("is_null_allowed" => true, "depends_on" => array(), "display_max_width" => 96, "display_max_height" => 96, "storage_max_width" => 256, "storage_max_height" => 256, "default_image" => null, "always_load_in_tables" => false)));
+		MetaModel::Init_AddAttribute(new AttributeLinkedSetIndirect("categories_list",
+			array("linked_class" => "lnkAuditCategoryToAuditDomain", "ext_key_to_me" => "domain_id", "ext_key_to_remote" => "category_id", "allowed_values" => null, "count_min" => 0, "count_max" => 0, "depends_on" => array())));
 
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['name', 'description', 'icon', 'categories_list']); // Attributes to be displayed for the complete details
-		MetaModel::Init_SetZListItems('list', ['description',]); // Attributes to be displayed for a list
+		MetaModel::Init_SetZListItems('details', array('name', 'description', 'icon', 'categories_list')); // Attributes to be displayed for the complete details
+		MetaModel::Init_SetZListItems('list', array('description',)); // Attributes to be displayed for a list
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['description']); // Criteria of the std search form
-		MetaModel::Init_SetZListItems('default_search', ['name', 'description']); // Criteria of the default search form
+		MetaModel::Init_SetZListItems('standard_search', array('description')); // Criteria of the std search form
+		MetaModel::Init_SetZListItems('default_search', array('name', 'description')); // Criteria of the default search form
 	}
 
 	public static function GetShortcutActions($sFinalClass)
@@ -86,39 +84,40 @@ class lnkAuditCategoryToAuditDomain extends cmdbAbstractObject
 	 */
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category"            => "application,grant_by_profile",
 			"key_type"            => "autoincrement",
 			"name_attcode"        => "",
 			"state_attcode"       => "",
-			"reconc_keys"         => ['category_id', 'domain_id'],
+			"reconc_keys"         => array('category_id', 'domain_id'),
 			"db_table"            => "priv_link_audit_category_domain",
 			"db_key_field"        => "id",
 			"db_finalclass_field" => "",
 			"is_link"             => true,
-			'uniqueness_rules'    => [
-				'no_duplicate' => [
-					'attributes'  => [
+			'uniqueness_rules'    => array(
+				'no_duplicate' => array(
+					'attributes'  => array(
 						0 => 'category_id',
 						1 => 'domain_id',
-					],
+					),
 					'filter'      => '',
 					'disabled'    => false,
 					'is_blocking' => true,
-				],
-			],
-		];
+				),
+			),
+		);
 		MetaModel::Init_Params($aParams);
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("category_id", ["targetclass" => "AuditCategory", "jointype" => '', "allowed_values" => null, "sql" => "category_id", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("category_name", ["allowed_values" => null, "extkey_attcode" => 'category_id', "target_attcode" => "name"]));
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("domain_id", ["targetclass" => "AuditDomain", "jointype" => '', "allowed_values" => null, "sql" => "domain_id", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("domain_name", ["allowed_values" => null, "extkey_attcode" => 'domain_id', "target_attcode" => "name"]));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("category_id", array("targetclass" => "AuditCategory", "jointype" => '', "allowed_values" => null, "sql" => "category_id", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("category_name", array("allowed_values" => null, "extkey_attcode" => 'category_id', "target_attcode" => "name")));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("domain_id", array("targetclass" => "AuditDomain", "jointype" => '', "allowed_values" => null, "sql" => "domain_id", "is_null_allowed" => false, "on_target_delete" => DEL_AUTO, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("domain_name", array("allowed_values" => null, "extkey_attcode" => 'domain_id', "target_attcode" => "name")));
 
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['category_id', 'domain_id']);
-		MetaModel::Init_SetZListItems('list', ['category_id', 'domain_id']);
+		MetaModel::Init_SetZListItems('details', array('category_id', 'domain_id'));
+		MetaModel::Init_SetZListItems('list', array('category_id', 'domain_id'));
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['category_id', 'domain_id']);
+		MetaModel::Init_SetZListItems('standard_search', array('category_id', 'domain_id'));
 	}
 }
+

application/audit.rule.class.inc.php

@@ -1,10 +1,9 @@
 <?php
-
 // Copyright (C) 2010-2024 Combodo SAS
 //
 //   This file is part of iTop.
 //
-//   iTop is free software; you can redistribute it and/or modify
+//   iTop 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.
@@ -17,6 +16,7 @@
 //   You should have received a copy of the GNU Affero General Public License
 //   along with iTop. If not, see <http://www.gnu.org/licenses/>
 
+
 /**
  * This class manages the audit "rule" linked to a given audit category.
  * Each rule is based on an OQL expression that returns either the "good" objects
@@ -33,35 +33,35 @@ class AuditRule extends cmdbAbstractObject
 {
 	public static function Init()
 	{
-		$aParams =
-		[
+		$aParams = array
+		(
 			"category"            => "application,grant_by_profile",
 			"key_type"            => "autoincrement",
 			"name_attcode"        => "name",
 			"state_attcode"       => "",
-			"reconc_keys"         => ['name'],
+			"reconc_keys"         => array('name'),
 			"db_table"            => "priv_auditrule",
 			"db_key_field"        => "id",
 			"db_finalclass_field" => "",
 			'style'               => new ormStyle(null, null, null, null, null, '../images/icons/icons8-audit.svg'),
-		];
+		);
 		MetaModel::Init_Params($aParams);
-		MetaModel::Init_AddAttribute(new AttributeString("name", ["allowed_values" => null, "sql" => "name", "default_value" => "", "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeString("description", ["allowed_values" => null, "sql" => "description", "default_value" => "", "is_null_allowed" => true, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeOQL("query", ["allowed_values" => null, "sql" => "query", "default_value" => "", "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeEnum("valid_flag", ["allowed_values" => new ValueSetEnum('true,false'), "sql" => "valid_flag", "default_value" => "true", "is_null_allowed" => false, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("category_id", ["allowed_values" => null, "sql" => "category_id", "targetclass" => "AuditCategory", "is_null_allowed" => false, "on_target_delete" => DEL_MANUAL, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeExternalField("category_name", ["allowed_values" => null, "extkey_attcode" => 'category_id', "target_attcode" => "name"]));
-		MetaModel::Init_AddAttribute(new AttributeExternalKey("contact_id", ["allowed_values" => null, "sql" => "contact_id", "targetclass" => "Contact", "is_null_allowed" => true, "on_target_delete" => DEL_MANUAL, "depends_on" => []]));
-		MetaModel::Init_AddAttribute(new AttributeHTML("process", ["allowed_values" => null, "sql" => "process", "default_value" => "", "is_null_allowed" => true, "depends_on" => []]));
+		MetaModel::Init_AddAttribute(new AttributeString("name", array("allowed_values" => null, "sql" => "name", "default_value" => "", "is_null_allowed" => false, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeString("description", array("allowed_values" => null, "sql" => "description", "default_value" => "", "is_null_allowed" => true, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeOQL("query", array("allowed_values" => null, "sql" => "query", "default_value" => "", "is_null_allowed" => false, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeEnum("valid_flag", array("allowed_values" => new ValueSetEnum('true,false'), "sql" => "valid_flag", "default_value" => "true", "is_null_allowed" => false, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalKey("category_id", array("allowed_values" => null, "sql" => "category_id", "targetclass" => "AuditCategory", "is_null_allowed" => false, "on_target_delete" => DEL_MANUAL, "depends_on" => array())));
+		MetaModel::Init_AddAttribute(new AttributeExternalField("category_name", array("allowed_values" => null, "extkey_attcode" => 'category_id', "target_attcode" => "name")));
+
 		// Display lists
-		MetaModel::Init_SetZListItems('details', ['category_id', 'name', 'description', 'query', 'valid_flag', 'process', 'contact_id']); // Attributes to be displayed for the complete details
-		MetaModel::Init_SetZListItems('list', ['category_id', 'description', 'query']); // Attributes to be displayed for a list
+		MetaModel::Init_SetZListItems('details', array('category_id', 'name', 'description', 'query', 'valid_flag')); // Attributes to be displayed for the complete details
+		MetaModel::Init_SetZListItems('list', array('category_id', 'description', 'valid_flag')); // Attributes to be displayed for a list
 		// Search criteria
-		MetaModel::Init_SetZListItems('standard_search', ['category_id', 'name', 'description', 'valid_flag', 'query']); // Criteria of the std search form
-		MetaModel::Init_SetZListItems('default_search', ['name', 'description', 'category_id', 'contact_id', 'query']); // Criteria of the advanced search form
+		MetaModel::Init_SetZListItems('standard_search', array('category_id', 'name', 'description', 'valid_flag', 'query')); // Criteria of the std search form
+		MetaModel::Init_SetZListItems('default_search', array('name', 'description', 'category_id')); // Criteria of the advanced search form
 	}
 
+
 	public static function GetShortcutActions($sFinalClass)
 	{
 		$aShortcutActions = parent::GetShortcutActions($sFinalClass);
@@ -72,3 +72,4 @@ class AuditRule extends cmdbAbstractObject
 		return $aShortcutActions;
 	}
 }
+?>

application/compilecssservice.class.inc.php

@@ -1,5 +1,4 @@
 <?php
-
 /**
  * Copyright (C) 2013-2024 Combodo SAS
  *
@@ -33,8 +32,7 @@ class CompileCSSService
 	{
 	}
 
-	public function CompileCSSFromSASS($sSassContent, $aImportPaths =  [], $aVariables = [])
-	{
+	public function CompileCSSFromSASS($sSassContent, $aImportPaths =  [], $aVariables = []){
 		return utils::CompileCSSFromSASS($sSassContent, $aImportPaths, $aVariables);
 	}
-}
+}