diff --git a/.gitignore b/.gitignore
index 044ece9716..433abf068e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,4 @@
dist/
-vendor/
.gh_token
*.min.*
var/
diff --git a/GLPI_Plugin_Development_Guide.md b/GLPI_Plugin_Development_Guide.md
new file mode 100644
index 0000000000..6673494ab3
--- /dev/null
+++ b/GLPI_Plugin_Development_Guide.md
@@ -0,0 +1,2194 @@
+# GLPI 11.x Plugin Development Guide
+
+> Practical, consolidated reference for building GLPI 11.x plugins.
+> Every pattern, gotcha, and rule here comes from real production experience — not theory.
+> Written for AI assistants and developers alike. Update this document as new patterns are discovered.
+
+**Target:** GLPI 11.0–11.99, PHP 8.1+, MySQL 5.7+ / MariaDB 10.3+
+
+---
+
+## Table of Contents
+
+1. [Plugin Structure](#1-plugin-structure)
+2. [setup.php — Registration & Hooks](#2-setupphp--registration--hooks)
+3. [hook.php — Database Schema & Migration](#3-hookphp--database-schema--migration)
+4. [Namespaces & Autoloading](#4-namespaces--autoloading)
+5. [Core Base Classes](#5-core-base-classes)
+6. [Dropdowns — CommonDropdown](#6-dropdowns--commondropdown)
+7. [Forms — showForm() Patterns](#7-forms--showform-patterns)
+8. [Search Options — rawSearchOptions()](#8-search-options--rawsearchoptions)
+9. [Tabs System](#9-tabs-system)
+10. [Front Controllers](#10-front-controllers)
+11. [AJAX Endpoints](#11-ajax-endpoints)
+12. [Database Access](#12-database-access)
+13. [Relations — CommonDBRelation](#13-relations--commondbrelation)
+14. [Configuration Pages](#14-configuration-pages)
+15. [GLPI Group Hierarchy](#15-glpi-group-hierarchy)
+16. [GLPI Hook System](#16-glpi-hook-system)
+17. [Permissions & Rights](#17-permissions--rights)
+18. [Sessions & Authentication](#18-sessions--authentication)
+19. [Translations (i18n)](#19-translations-i18n)
+20. [Frontend (JS/CSS)](#20-frontend-jscss)
+21. [File & Document Handling](#21-file--document-handling)
+22. [PDF Generation](#22-pdf-generation)
+23. [Notifications](#23-notifications)
+24. [Logging](#24-logging)
+25. [Security Checklist](#25-security-checklist)
+26. [What Does NOT Work / Forbidden Patterns](#26-what-does-not-work--forbidden-patterns)
+27. [Common Gotchas & Known Pitfalls](#27-common-gotchas--known-pitfalls)
+28. [Useful Constants & Paths](#28-useful-constants--paths)
+29. [Checklists](#29-checklists)
+
+---
+
+## 1. Plugin Structure
+
+GLPI 11.x supports **two class autoloading schemes**. Both work; modern PSR-4 (`src/`) is recommended for new plugins.
+
+### Modern layout (PSR-4 — recommended)
+
+```
+myplugin/ # lowercase, no hyphens, no underscores
+├── setup.php # REQUIRED — plugin registration, hooks, version
+├── hook.php # REQUIRED — install / upgrade / uninstall
+├── src/ # PSR-4 classes (GLPI autoloads from here)
+│ ├── MyItem.php # extends CommonDBTM
+│ ├── MyItem_User.php # extends CommonDBRelation
+│ ├── MyCategory.php # extends CommonDropdown
+│ └── MyTab.php # extends CommonGLPI (tab-only, no DB table)
+├── front/ # User-facing pages (routing entry points)
+│ ├── myitem.php # list view (Search::show)
+│ ├── myitem.form.php # form view (create/edit + POST handlers)
+│ ├── myitem_user.form.php # relation POST handler
+│ └── config.form.php # plugin configuration page
+├── ajax/ # AJAX endpoints
+│ └── endpoint.php
+├── public/ # Static assets
+│ ├── css/
+│ └── js/
+└── locales/ # Gettext .po translation files
+ ├── en_GB.po
+ └── pl_PL.po
+```
+
+### Legacy layout (inc/ autoloader)
+
+```
+myplugin/
+├── setup.php
+├── hook.php
+├── inc/ # Classes auto-discovered by filename convention
+│ └── feature.class.php # Class: PluginMypluginFeature
+├── front/
+├── ajax/
+├── public/
+└── locales/
+```
+
+**No build tools.** GLPI plugins use plain PHP, CSS, and JS. No npm, no Composer, no webpack. Edit files directly.
+
+### Naming Conventions
+
+| Thing | Convention | Example |
+|-------|-----------|---------|
+| Plugin directory | lowercase alpha only | `myplugin` |
+| DB tables | `glpi_plugin_{name}_{tablename}` | `glpi_plugin_myplugin_myitems` |
+| Relation tables | `glpi_plugin_{name}_{item1s}_{item2s}` | `glpi_plugin_myplugin_myitems_users` |
+| Rights key | `plugin_{name}_{rightname}` | `plugin_myplugin_myitem` |
+| PHP namespace (PSR-4) | `GlpiPlugin\{Pluginname}` | `GlpiPlugin\Myplugin` |
+| Legacy class name | `Plugin{Name}{Class}` | `PluginMypluginFeature` |
+| Legacy file name | `inc/{class}.class.php` | `inc/feature.class.php` |
+| Constants | `PLUGIN_{NAME}_VERSION` | `PLUGIN_MYPLUGIN_VERSION` |
+| Functions | `plugin_{name}_xxx()` | `plugin_myplugin_install()` |
+
+---
+
+## 2. setup.php — Registration & Hooks
+
+This file is loaded on **every GLPI page load** when the plugin is active. Keep it lightweight.
+
+### Required Functions
+
+```php
+ 'My Plugin',
+ 'version' => PLUGIN_MYPLUGIN_VERSION,
+ 'author' => 'Author Name',
+ 'license' => 'GPLv3',
+ 'homepage' => 'https://example.com',
+ 'requirements' => [
+ 'glpi' => ['min' => '11.0', 'max' => '11.99'],
+ 'php' => ['min' => '8.1'],
+ ],
+ ];
+}
+
+function plugin_myplugin_check_prerequisites(): bool {
+ return true; // Add version checks if needed
+}
+
+function plugin_myplugin_check_config($verbose = false): bool {
+ return true; // Validate config state
+}
+```
+
+### plugin_init Function
+
+```php
+function plugin_init_myplugin(): void {
+ global $PLUGIN_HOOKS;
+
+ // MANDATORY — plugin won't load without this
+ $PLUGIN_HOOKS['csrf_compliant']['myplugin'] = true;
+
+ // Register classes
+ Plugin::registerClass(MyItem::class);
+ Plugin::registerClass(MyCategory::class);
+
+ // Inject a tab on User detail pages
+ Plugin::registerClass(MyItem_User::class, [
+ 'addtabon' => ['User'],
+ ]);
+
+ // Menu entry (appears under Assets, Management, Tools, Admin, or Config)
+ if (MyItem::canView()) {
+ $PLUGIN_HOOKS['menu_toadd']['myplugin'] = [
+ 'assets' => MyItem::class, // or 'management', 'tools', 'admin'
+ ];
+ }
+
+ // Register dropdowns in Setup > Dropdowns
+ $PLUGIN_HOOKS['plugin_dropdowns']['myplugin'] = [
+ MyCategory::class,
+ ];
+
+ // Config page (adds "Configure" link on Setup > Plugins)
+ $PLUGIN_HOOKS['config_page']['myplugin'] = 'front/config.form.php';
+
+ // CSS/JS — always append version to bust cache
+ $v = PLUGIN_MYPLUGIN_VERSION;
+ $PLUGIN_HOOKS['add_css']['myplugin'] = ["public/css/myplugin.css?v={$v}"];
+ $PLUGIN_HOOKS['add_javascript']['myplugin'] = ["public/js/myplugin.js?v={$v}"];
+
+ // Hook registrations (see Section 16 for full details)
+ $PLUGIN_HOOKS['item_update']['myplugin'] = [
+ 'Ticket' => 'plugin_myplugin_ticket_update',
+ ];
+
+ // IMPORTANT: Wrap permission checks in try-catch.
+ // Tables don't exist during install — any DB query will throw.
+ if (Session::getLoginUserID()) {
+ try {
+ // plugin-specific permission check
+ } catch (\Throwable $e) {
+ // Silently fail during install/upgrade
+ }
+ }
+}
+```
+
+### Key Rules
+
+- `csrf_compliant` **must** be set to `true` or GLPI blocks all POST requests.
+- Always append `?v=VERSION` to CSS/JS includes to prevent browser caching stale files.
+- Wrap **all** DB-dependent code in `try-catch` — `plugin_init` runs during install when tables don't exist yet.
+- Keep `plugin_init` fast — it runs on every page load.
+- `Plugin::registerClass()` with `'addtabon'` is how you inject tabs into other item types. Tab-only classes (extending `CommonGLPI`, no DB table) typically only need registration if they inject tabs into **other** item types. For tabs on your own item type, `addStandardTab()` in `defineTabs()` is sufficient.
+- Menu categories: `'assets'`, `'management'`, `'tools'`, `'admin'`, `'config'`.
+
+---
+
+## 3. hook.php — Database Schema & Migration
+
+### Install
+
+```php
+tableExists('glpi_plugin_myplugin_myitems')) {
+ $DB->doQuery("CREATE TABLE `glpi_plugin_myplugin_myitems` (
+ `id` INT unsigned NOT NULL AUTO_INCREMENT,
+ `name` VARCHAR(255) NOT NULL DEFAULT '',
+ `comment` TEXT,
+ `status` VARCHAR(50) NOT NULL DEFAULT 'active',
+ `entities_id` INT unsigned NOT NULL DEFAULT 0,
+ `is_recursive` TINYINT NOT NULL DEFAULT 0,
+ `is_deleted` TINYINT NOT NULL DEFAULT 0,
+ `users_id` INT unsigned NOT NULL DEFAULT 0,
+ `date_mod` TIMESTAMP NULL DEFAULT NULL,
+ `date_creation` TIMESTAMP NULL DEFAULT NULL,
+ PRIMARY KEY (`id`),
+ KEY `name` (`name`),
+ KEY `entities_id` (`entities_id`),
+ KEY `is_deleted` (`is_deleted`),
+ KEY `users_id` (`users_id`),
+ KEY `status` (`status`),
+ KEY `date_mod` (`date_mod`),
+ KEY `date_creation` (`date_creation`)
+ ) ENGINE=InnoDB DEFAULT CHARSET={$charset}
+ COLLATE={$collation} ROW_FORMAT=DYNAMIC");
+ }
+
+ // Insert default config values (if using a config table)
+ if ($DB->tableExists('glpi_plugin_myplugin_configs')) {
+ $defaults = ['feature_enabled' => '1'];
+ foreach ($defaults as $key => $value) {
+ $existing = $DB->request([
+ 'FROM' => 'glpi_plugin_myplugin_configs',
+ 'WHERE' => ['config_key' => $key],
+ 'LIMIT' => 1,
+ ]);
+ if (count($existing) === 0) {
+ $DB->insert('glpi_plugin_myplugin_configs', [
+ 'config_key' => $key,
+ 'value' => $value,
+ ]);
+ }
+ }
+ }
+
+ // Provision rights via GLPI's native rights system
+ ProfileRight::addProfileRights([MyItem::$rightname]);
+
+ // Grant Super-Admin full rights
+ $profile = new Profile();
+ foreach ($profile->find(['interface' => 'central']) as $data) {
+ if ($data['name'] === 'Super-Admin') {
+ $profileRight = new ProfileRight();
+ $profileRight->updateProfileRights($data['id'], [
+ MyItem::$rightname => ALLSTANDARDRIGHT,
+ ]);
+ }
+ }
+
+ $migration->executeMigration();
+ return true;
+}
+```
+
+### Upgrade
+
+```php
+function plugin_myplugin_upgrade(string $fromVersion): bool {
+ global $DB;
+
+ $migration = new Migration(PLUGIN_MYPLUGIN_VERSION);
+
+ // Guard each migration by checking actual DB state — never compare version strings
+ if (!$DB->fieldExists('glpi_plugin_myplugin_myitems', 'new_column')) {
+ $migration->addField(
+ 'glpi_plugin_myplugin_myitems',
+ 'new_column',
+ 'string', // GLPI type: 'integer', 'string', 'text', 'bool', etc.
+ ['value' => '']
+ );
+ $migration->addKey('glpi_plugin_myplugin_myitems', 'new_column');
+ }
+
+ // For new config keys
+ if ($DB->tableExists('glpi_plugin_myplugin_configs')) {
+ $newConfigs = ['new_setting' => 'default'];
+ foreach ($newConfigs as $key => $value) {
+ $exists = $DB->request([
+ 'FROM' => 'glpi_plugin_myplugin_configs',
+ 'WHERE' => ['config_key' => $key],
+ 'LIMIT' => 1,
+ ]);
+ if (count($exists) === 0) {
+ $DB->insert('glpi_plugin_myplugin_configs', [
+ 'config_key' => $key,
+ 'value' => $value,
+ ]);
+ }
+ }
+ }
+
+ $migration->executeMigration();
+ return true;
+}
+```
+
+### Uninstall
+
+```php
+function plugin_myplugin_uninstall(): bool {
+ global $DB;
+
+ // Drop in reverse dependency order (children first)
+ $tables = [
+ 'glpi_plugin_myplugin_myitems_users',
+ 'glpi_plugin_myplugin_myitems',
+ 'glpi_plugin_myplugin_configs',
+ ];
+
+ foreach ($tables as $table) {
+ if ($DB->tableExists($table)) {
+ $DB->doQuery("DROP TABLE `{$table}`");
+ }
+ }
+
+ // Clean up rights
+ ProfileRight::deleteProfileRights([MyItem::$rightname]);
+
+ return true;
+}
+```
+
+### Migration Field Types
+
+| GLPI Type | SQL Result |
+|-----------|-----------|
+| `'integer'` | `INT unsigned NOT NULL DEFAULT {value}` |
+| `'string'` | `VARCHAR(255)` |
+| `'text'` | `TEXT` |
+| `'bool'` | `TINYINT NOT NULL DEFAULT {value}` |
+| `'decimal(20,4)'` | `DECIMAL(20,4)` |
+
+### Required Columns by Feature
+
+| Feature | Required Columns |
+|---------|-----------------|
+| Entity support | `entities_id` INT unsigned, `is_recursive` TINYINT |
+| Soft delete / Trash | `is_deleted` TINYINT |
+| History / Log tab | `date_mod` TIMESTAMP |
+| Timestamps | `date_mod` TIMESTAMP, `date_creation` TIMESTAMP |
+
+### Key Rules
+
+- Always use `IF NOT EXISTS` / `$DB->tableExists()` / `$DB->fieldExists()` — install and upgrade must be **idempotent** (safe to run multiple times).
+- Use `DBConnection::getDefaultCharset()` / `getDefaultCollation()` instead of hardcoding charset.
+- Never use version string comparisons for migrations — check the actual DB state.
+- Add indexes on foreign key columns and frequently filtered columns.
+- Call `$migration->executeMigration()` at the end of install and upgrade.
+- Provision rights with `ProfileRight::addProfileRights()` during install.
+- Clean up rights with `ProfileRight::deleteProfileRights()` during uninstall.
+- Drop tables in reverse dependency order during uninstall (children first).
+- Bump the version constant whenever the schema changes, or migration code won't run.
+
+---
+
+## 4. Namespaces & Autoloading
+
+GLPI 11.x supports two autoloading mechanisms. **Both work simultaneously**, but PSR-4 is recommended for new plugins.
+
+### PSR-4 (modern — recommended)
+
+Classes live in `src/` under the `GlpiPlugin\{Pluginname}` namespace:
+
+| Class | File |
+|-------|------|
+| `GlpiPlugin\Myplugin\MyItem` | `src/MyItem.php` |
+| `GlpiPlugin\Myplugin\MyItem_User` | `src/MyItem_User.php` |
+| `GlpiPlugin\Myplugin\MyCategory` | `src/MyCategory.php` |
+
+```php
+ self::getMenuName(),
+ 'page' => '/plugins/myplugin/front/myitem.php',
+ 'icon' => 'fas fa-box',
+ ];
+ if (Session::haveRight('config', READ)) {
+ $menu['options']['config'] = [
+ 'title' => __('Configuration', 'myplugin'),
+ 'page' => '/plugins/myplugin/front/config.form.php',
+ 'icon' => 'fas fa-cog',
+ ];
+ }
+ return $menu;
+ }
+}
+```
+
+### Adding a Tab to an Existing GLPI Item
+
+Any class can provide tabs on other GLPI items. Register it in `setup.php`:
+
+```php
+Plugin::registerClass(MyItem_User::class, ['addtabon' => ['User']]);
+```
+
+Then implement the tab interface:
+
+```php
+public function getTabNameForItem(CommonGLPI $item, $withtemplate = 0) {
+ if ($item instanceof \User) {
+ $count = countElementsInTable(self::getTable(), [
+ 'users_id' => $item->getID(),
+ ]);
+ return self::createTabEntry(__('My Items', 'myplugin'), $count);
+ }
+ return '';
+}
+
+static function displayTabContentForItem(CommonGLPI $item, $tabnum = 1, $withtemplate = 0) {
+ if ($item instanceof \User) {
+ self::showForUser($item);
+ return true;
+ }
+ return false;
+}
+```
+
+---
+
+## 6. Dropdowns — CommonDropdown
+
+For simple categorization / lookup lists:
+
+```php
+namespace GlpiPlugin\Myplugin;
+
+use CommonDropdown;
+
+class MyCategory extends CommonDropdown {
+ public $can_be_recursive = true;
+
+ static function getTypeName($nb = 0) {
+ return _n('My Category', 'My Categories', $nb, 'myplugin');
+ }
+}
+```
+
+Register in `setup.php`:
+
+```php
+Plugin::registerClass(MyCategory::class);
+$PLUGIN_HOOKS['plugin_dropdowns']['myplugin'] = [MyCategory::class];
+```
+
+Table name auto-resolves to `glpi_plugin_myplugin_mycategories`.
+
+For **hierarchical / tree dropdowns**, extend `CommonTreeDropdown` instead — this adds parent-child relationships with `completename` (full path like `Root > Child > Grandchild`).
+
+---
+
+## 7. Forms — showForm() Patterns
+
+GLPI supports two form rendering approaches. **Legacy table-based is recommended for plugins** — simpler, well-tested, and stable across GLPI versions.
+
+### Basic showForm() Structure
+
+```php
+function showForm($ID, array $options = []) {
+ $this->initForm($ID, $options); // loads $this->fields from DB
+ $this->showFormHeader($options); // opens
+ return true;
+}
+```
+
+**CRITICAL**: `initForm()` must be called before accessing `$this->fields`. `showFormButtons()` must close the form — without it, no Save/Add button is rendered.
+
+### Form Field Types
+
+```php
+// Text input
+echo Html::input('fieldname', ['value' => $this->fields['fieldname'] ?? '', 'size' => 40]);
+
+// Textarea
+echo "";
+
+// GLPI dropdown (FK to standard GLPI type)
+Dropdown::show(Manufacturer::class, [
+ 'name' => 'manufacturers_id',
+ 'value' => $this->fields['manufacturers_id'] ?? 0,
+ 'entity' => $this->getEntityID(),
+]);
+
+// Plugin dropdown (FK to plugin's own dropdown type)
+Dropdown::show(MyCategory::class, [
+ 'name' => 'plugin_myplugin_mycategories_id',
+ 'value' => $this->fields['plugin_myplugin_mycategories_id'] ?? 0,
+ 'entity' => $this->getEntityID(),
+]);
+
+// User dropdown
+User::dropdown([
+ 'name' => 'users_id_owner',
+ 'value' => $this->fields['users_id_owner'] ?? 0,
+ 'right' => 'all',
+ 'entity' => $this->getEntityID(),
+]);
+
+// Group dropdown
+Group::dropdown([
+ 'name' => 'groups_id_department',
+ 'value' => $this->fields['groups_id_department'] ?? 0,
+ 'entity' => $this->getEntityID(),
+]);
+
+// Yes/No dropdown
+Dropdown::showYesNo('is_paid', $this->fields['is_paid'] ?? 0);
+
+// Static array dropdown
+Dropdown::showFromArray('is_external', [
+ 0 => __('Internal'),
+ 1 => __('External'),
+], ['value' => $this->fields['is_external'] ?? 0]);
+
+// Number input
+echo Html::input('price', [
+ 'id' => 'price',
+ 'value' => $this->fields['price'] ?? '',
+ 'type' => 'number',
+ 'step' => '0.01',
+ 'min' => '0',
+]);
+```
+
+### Inline JavaScript in Forms
+
+```php
+echo Html::scriptBlock("
+ function myPluginToggle(val) {
+ document.getElementById('my_element').style.display = val == 1 ? '' : 'none';
+ }
+");
+```
+
+**WARNING about `on_change` with Select2**: GLPI renders most dropdowns using Select2. The `on_change` parameter works with `Dropdown::showFromArray()` and `Dropdown::showYesNo()`, but the event fires with Select2's value. Use `'on_change' => 'myFunction(this.value)'`.
+
+### Legend / Info Row on Forms
+
+```php
+echo "";
+echo "";
+echo " ";
+echo " ";
+```
+
+---
+
+## 8. Search Options — rawSearchOptions()
+
+Search options define columns visible in list views, searchable fields, and export data.
+
+```php
+function rawSearchOptions() {
+ $tab = [];
+
+ // Section header (required as first entry)
+ $tab[] = [
+ 'id' => 'common',
+ 'name' => self::getTypeName(2),
+ ];
+
+ // Name (clickable link to item)
+ $tab[] = [
+ 'id' => 1,
+ 'table' => self::getTable(),
+ 'field' => 'name',
+ 'name' => __('Name'),
+ 'datatype' => 'itemlink', // makes it a clickable link
+ 'searchtype' => ['contains'],
+ 'massiveaction' => false,
+ ];
+
+ // Simple text field
+ $tab[] = [
+ 'id' => 3,
+ 'table' => self::getTable(),
+ 'field' => 'comment',
+ 'name' => __('Comments'),
+ 'datatype' => 'text',
+ ];
+
+ // Boolean field
+ $tab[] = [
+ 'id' => 5,
+ 'table' => self::getTable(),
+ 'field' => 'is_recursive',
+ 'name' => __('Child entities'),
+ 'datatype' => 'bool',
+ ];
+
+ // Entity (standard pattern — GLPI auto-joins)
+ $tab[] = [
+ 'id' => 4,
+ 'table' => 'glpi_entities',
+ 'field' => 'completename',
+ 'name' => Entity::getTypeName(1),
+ 'datatype' => 'dropdown',
+ ];
+
+ // FK to standard GLPI type (standard column name like manufacturers_id)
+ $tab[] = [
+ 'id' => 9,
+ 'table' => 'glpi_manufacturers',
+ 'field' => 'name',
+ 'name' => Manufacturer::getTypeName(1),
+ 'datatype' => 'dropdown',
+ ];
+
+ // FK with NON-STANDARD column name (e.g., users_id_owner instead of users_id)
+ $tab[] = [
+ 'id' => 14,
+ 'table' => 'glpi_users',
+ 'field' => 'name',
+ 'name' => __('Owner'),
+ 'datatype' => 'dropdown',
+ 'linkfield' => 'users_id_owner', // <-- REQUIRED for non-standard FK names
+ ];
+
+ // FK to Group with non-standard column
+ $tab[] = [
+ 'id' => 16,
+ 'table' => 'glpi_groups',
+ 'field' => 'completename', // use 'completename' for tree dropdowns
+ 'name' => __('Department'),
+ 'datatype' => 'dropdown',
+ 'linkfield' => 'groups_id_department',
+ ];
+
+ // Join through a relation table (e.g., find items by assigned user)
+ $tab[] = [
+ 'id' => 8,
+ 'table' => 'glpi_users',
+ 'field' => 'name',
+ 'name' => __('User'),
+ 'datatype' => 'dropdown',
+ 'forcegroupby' => true, // groups results (one item can have many users)
+ 'massiveaction' => false,
+ 'joinparams' => [
+ 'beforejoin' => [
+ 'table' => 'glpi_plugin_myplugin_myitems_users',
+ 'joinparams' => [
+ 'jointype' => 'child', // relation table is a "child" of main table
+ ],
+ ],
+ ],
+ ];
+
+ // URL / weblink
+ $tab[] = [
+ 'id' => 11,
+ 'table' => self::getTable(),
+ 'field' => 'portal_url',
+ 'name' => __('Portal URL'),
+ 'datatype' => 'weblink',
+ ];
+
+ // Decimal
+ $tab[] = [
+ 'id' => 13,
+ 'table' => self::getTable(),
+ 'field' => 'price',
+ 'name' => __('Price'),
+ 'datatype' => 'decimal',
+ ];
+
+ return $tab;
+}
+```
+
+### CRITICAL: `linkfield` vs `joinparams`
+
+- **Standard FK** (column name matches GLPI convention like `manufacturers_id`): No extra params needed — GLPI auto-detects the join.
+- **Non-standard FK** (column like `users_id_owner`, `groups_id_department`): **Must use `'linkfield' => 'column_name'`** to tell GLPI which column to join on.
+- **Through a relation table**: Use `joinparams` with `beforejoin`.
+
+**DO NOT USE** `'field_fkey'` — this is NOT a valid GLPI search option parameter. It will be silently ignored and the search will break.
+
+### Available Datatypes
+
+`itemlink`, `string`, `text`, `number`, `integer`, `decimal`, `bool`, `datetime`, `date`, `dropdown`, `weblink`, `email`, `specific`
+
+---
+
+## 9. Tabs System
+
+### Adding tabs to your own item type
+
+In your `CommonDBTM` class:
+
+```php
+function defineTabs($options = []) {
+ $tabs = [];
+ $this->addDefaultFormTab($tabs); // main form
+ $this->addStandardTab(MyItem_User::class, $tabs, $options); // custom tab
+ $this->addStandardTab('Log', $tabs, $options); // history
+ $this->addStandardTab('Notepad', $tabs, $options); // notes
+ return $tabs;
+}
+```
+
+### Adding tabs to OTHER item types (e.g., User pages)
+
+In `setup.php`:
+
+```php
+Plugin::registerClass(MyItem_User::class, [
+ 'addtabon' => ['User'],
+]);
+```
+
+### Tab provider class
+
+```php
+function getTabNameForItem(CommonGLPI $item, $withtemplate = 0) {
+ if ($item instanceof MyItem) {
+ $count = countElementsInTable(self::getTable(), [
+ 'plugin_myplugin_myitems_id' => $item->getID(),
+ ]);
+ return self::createTabEntry(__('Users', 'myplugin'), $count);
+ }
+ return '';
+}
+
+static function displayTabContentForItem(CommonGLPI $item, $tabnum = 1, $withtemplate = 0) {
+ if ($item instanceof MyItem) {
+ self::showForMyItem($item);
+ return true;
+ }
+ return false;
+}
+```
+
+### CRITICAL: Tabs are loaded via AJAX
+
+Tab content is loaded via AJAX through `/ajax/common.tabs.php`. If your tab class has a PHP error (e.g., missing `use` import), the AJAX request returns a 500 error and the tab shows a blank/error page in the browser.
+
+**Debug tip**: Check the browser's Network tab for the failing AJAX request to `common.tabs.php` and look at the response body for the PHP error message.
+
+---
+
+## 10. Front Controllers
+
+Files in `front/` are the entry points for user-facing pages.
+
+### List Page (front/myitem.php)
+
+```php
+check(-1, CREATE, $_POST);
+ $item->add($_POST);
+ Html::back();
+} else if (isset($_POST['update'])) {
+ $item->check($_POST['id'], UPDATE);
+ $item->update($_POST);
+ Html::back();
+} else if (isset($_POST['delete'])) {
+ $item->check($_POST['id'], DELETE);
+ $item->delete($_POST);
+ $item->redirectToList();
+} else if (isset($_POST['restore'])) {
+ $item->check($_POST['id'], DELETE);
+ $item->restore($_POST);
+ Html::back();
+} else if (isset($_POST['purge'])) {
+ $item->check($_POST['id'], PURGE);
+ $item->delete($_POST, 1);
+ $item->redirectToList();
+} else {
+ $menus = ['assets', MyItem::class];
+ MyItem::displayFullPageForItem($_GET['id'] ?? 0, $menus, [
+ 'formoptions' => "data-track-changes=true",
+ ]);
+}
+```
+
+### CRITICAL RULE: Never Call Session::checkCRSF() in /front/ Files
+
+GLPI's bootstrap (`inc/includes.php`) automatically validates CSRF tokens for all POST requests routed through `/front/`. Calling `Session::checkCRSF()` a second time causes a failure because the token has already been consumed from the session token pool (`$_SESSION['glpicsrftokens']`).
+
+---
+
+## 11. AJAX Endpoints
+
+```php
+ false, 'error' => 'Not authenticated']);
+ return;
+}
+
+try {
+ $param = $_GET['param'] ?? '';
+ $result = PluginMypluginFeature::getData($param);
+ echo json_encode(['success' => true, 'data' => $result]);
+} catch (\Throwable $e) {
+ http_response_code(500);
+ echo json_encode(['success' => false, 'error' => $e->getMessage()]);
+}
+```
+
+### Key Rules
+
+- AJAX endpoints do **not** need CSRF validation — session authentication is sufficient.
+- Always set `Content-Type: application/json; charset=utf-8`.
+- Always check `Session::getLoginUserID()` and return 403 if not authenticated.
+- Wrap in try-catch to prevent PHP errors from corrupting JSON output.
+
+---
+
+## 12. Database Access
+
+GLPI provides a `$DB` global object. **Never use raw `mysqli_*` calls.**
+
+### Read (SELECT)
+
+```php
+global $DB;
+
+// Simple query
+$rows = $DB->request([
+ 'FROM' => 'glpi_plugin_myplugin_myitems',
+ 'WHERE' => ['status' => 'active', 'users_id' => $userId],
+ 'ORDER' => 'name ASC',
+ 'LIMIT' => 50,
+]);
+foreach ($rows as $row) {
+ $id = $row['id'];
+ $name = $row['name'];
+}
+
+// With JOIN
+$rows = $DB->request([
+ 'SELECT' => [
+ 'glpi_plugin_myplugin_myitems.*',
+ 'glpi_users.name AS username',
+ ],
+ 'FROM' => 'glpi_plugin_myplugin_myitems',
+ 'LEFT JOIN' => [
+ 'glpi_users' => [
+ 'FKEY' => [
+ 'glpi_plugin_myplugin_myitems' => 'users_id_owner',
+ 'glpi_users' => 'id',
+ ],
+ ],
+ ],
+ 'WHERE' => [
+ 'glpi_plugin_myplugin_myitems.is_deleted' => 0,
+ ],
+ 'ORDER' => ['glpi_plugin_myplugin_myitems.name ASC'],
+]);
+
+// LIKE search (escape user input)
+$pattern = '%' . $DB->escape($searchTerm) . '%';
+$rows = $DB->request([
+ 'FROM' => 'glpi_plugin_myplugin_myitems',
+ 'WHERE' => [
+ 'OR' => [
+ ['name' => ['LIKE', $pattern]],
+ ['serial' => ['LIKE', $pattern]],
+ ],
+ ],
+]);
+
+// IN clause
+$rows = $DB->request([
+ 'FROM' => 'glpi_plugin_myplugin_myitems',
+ 'WHERE' => ['id' => [1, 2, 3, 4]], // Generates IN (1,2,3,4)
+]);
+```
+
+### Count
+
+```php
+// Using GLPI helper
+$count = countElementsInTable('glpi_plugin_myplugin_myitems', [
+ 'users_id' => $userId,
+]);
+
+// Using $DB->request
+$count = count($DB->request([...]));
+
+// Aggregate (MAX, COUNT, etc.)
+$row = $DB->request([
+ 'SELECT' => ['MAX' => 'level AS max_level'],
+ 'FROM' => 'glpi_groups',
+])->current();
+$maxLevel = (int)$row['max_level'];
+```
+
+### Insert
+
+```php
+$DB->insert('glpi_plugin_myplugin_myitems', [
+ 'name' => $name,
+ 'status' => 'active',
+ 'users_id' => (int)$userId,
+ 'date_creation' => date('Y-m-d H:i:s'),
+ 'date_mod' => date('Y-m-d H:i:s'),
+]);
+$newId = $DB->insertId();
+```
+
+### Update
+
+```php
+$DB->update(
+ 'glpi_plugin_myplugin_myitems',
+ ['status' => 'completed', 'date_mod' => date('Y-m-d H:i:s')], // SET
+ ['id' => $itemId] // WHERE
+);
+```
+
+### Update or Insert (Upsert)
+
+```php
+$DB->updateOrInsert(
+ 'glpi_plugin_myplugin_configs',
+ ['setting' => $value], // data to set
+ ['id' => 1] // WHERE clause
+);
+```
+
+### Delete
+
+```php
+$DB->delete('glpi_plugin_myplugin_myitems', ['id' => $itemId]);
+```
+
+### Schema Checks
+
+```php
+$DB->tableExists('glpi_plugin_myplugin_myitems'); // true/false
+$DB->fieldExists('glpi_plugin_myplugin_myitems', 'new_column'); // true/false
+```
+
+### Key Rules
+
+- All values passed in arrays are auto-escaped — no manual escaping needed for insert/update/where.
+- Use `$DB->escape()` only for LIKE patterns or raw `doQuery()` calls.
+- Always cast integer IDs: `(int)$userId`.
+- `$DB->request()` returns an iterator — use `foreach` or `count()`.
+- For raw SQL (migrations only): `$DB->doQuery("ALTER TABLE ...")`.
+
+---
+
+## 13. Relations — CommonDBRelation
+
+For many-to-many links between items (e.g., linking Users to your plugin items).
+
+### Class Setup
+
+```php
+namespace GlpiPlugin\Myplugin;
+
+use CommonDBRelation;
+
+class MyItem_User extends CommonDBRelation {
+ static public $itemtype_1 = MyItem::class;
+ static public $items_id_1 = 'plugin_myplugin_myitems_id'; // FK column name
+
+ static public $itemtype_2 = 'User';
+ static public $items_id_2 = 'users_id'; // FK column name
+
+ // Rights: check rights on side 1 only
+ static public $checkItem_1_Rights = self::HAVE_SAME_RIGHT_ON_ITEM;
+ static public $checkItem_2_Rights = self::DONT_CHECK_ITEM_RIGHTS;
+
+ // Log history on both sides
+ static public $logs_for_item_1 = true;
+ static public $logs_for_item_2 = true;
+}
+```
+
+### Form URL Override
+
+CommonDBRelation needs a custom `getFormURL()` pointing to the front-end handler:
+
+```php
+static function getFormURL($full = true) {
+ return Plugin::getWebDir('myplugin', $full) . '/front/myitem_user.form.php';
+}
+```
+
+### Front-End Handler File (REQUIRED)
+
+You **must** create `front/myitem_user.form.php` — without it, add/delete buttons on the relation tab will 404:
+
+```php
+check(-1, CREATE, $_POST);
+ $link->add($_POST);
+ Html::back();
+} else if (isset($_POST['purge'])) {
+ $link->check($_POST['id'], PURGE);
+ $link->delete($_POST, 1); // 1 = force purge
+ Html::back();
+}
+```
+
+### Delete/Purge Buttons
+
+```php
+// CORRECT — plain text label
+echo Html::submit(__('Delete'), [
+ 'name' => 'purge',
+ 'class' => 'btn btn-danger btn-sm',
+ 'confirm' => __('Confirm the final deletion?'),
+]);
+
+// WRONG — Html::submit() escapes HTML, so icons show as raw text
+echo Html::submit("
+
+ OT
+
+
+
+ Potwierdzenie włączenia do użytku / Lokalizacja środków trwałych
+
+
+
+
+ (Nachweis der Inbetriebnahme / Verteilung der Sachanlagen)
+
+
+
+
+
+
+
+ Numer faktury: {$invoice_display}
+
+
+ Dostawca / Producent: {$supplier_esc}
+
+
+
+
+
+
+
+ Poz
+ Ilość/
+ Nazwa środka trwałego /
+ Nr seryjny /
+ Nr środka trwałego /
+ Wartość /
+ Lokaliz. /
+ Cost
+ Order
+ Data włącz. do użytku /
+ Data zdep. w magazynie /
+
+
+
+ {$items_html}
+
+ SUMA / Summe:
+ {$total_formatted}
+
+
+
+
+
+ ____________________________ czytelny podpis
+
+
+
+
+ Zmiany lokalizacji środków trwałych / (Verschiebung von Anlagenvermögen)
+
+
+
+
+
+
+
+ Poz
+ Ilość/
+ Nazwa środka trwałego /
+ Nr seryjny /
+ Nr środka trwałego /
+ Lokaliz. /
+ Cost
+ Order
+ Data przes. /
+ Data włącz. do użytku /
+
+
+
+HTML;
+
+ // 10 empty rows for the relocation section
+ for ($i = 1; $i <= 10; $i++) {
+ $html .= "";
+ for ($c = 0; $c < 10; $c++) {
+ $html .= " ";
+ }
+ $html .= " \n";
+ }
+
+ $html .= <<
+
+
+
+ ____________________________ czytelny podpis
+
+ * nach Bearbeitung durch Rechnungsprüfer Kopie an LZ
+
+
+
+
+
+
+HTML;
+
+ return $html;
+ }
+
+
+ /**
+ * Generate PDF from HTML using fallback chain: wkhtmltopdf -> Chromium -> mPDF -> HTML file.
+ *
+ * @param string $html Full HTML document
+ * @param string $base_name Base filename (without extension)
+ * @return string|false Path to generated file, or false on failure
+ */
+ public function generatePdf(string $html, string $base_name)
+ {
+ $tmp_dir = GLPI_TMP_DIR;
+ $html_path = $tmp_dir . '/' . $base_name . '_' . uniqid() . '.html';
+ $pdf_path = $tmp_dir . '/' . $base_name . '_' . uniqid() . '.pdf';
+
+ file_put_contents($html_path, $html);
+
+ // 1. Try wkhtmltopdf
+ $wk_path = $this->findBinary('wkhtmltopdf');
+ if ($wk_path) {
+ $cmd = sprintf(
+ '%s --quiet --page-size A4 --orientation Portrait --encoding utf-8 --margin-top 10 --margin-bottom 10 --margin-left 8 --margin-right 8 %s %s 2>&1',
+ escapeshellarg($wk_path),
+ escapeshellarg($html_path),
+ escapeshellarg($pdf_path),
+ );
+ exec($cmd, $output, $exit_code);
+ @unlink($html_path);
+ if ($exit_code === 0 && file_exists($pdf_path)) {
+ return $pdf_path;
+ }
+ }
+
+ // 2. Try Chromium headless
+ $chrome_path = $this->findBinary('chromium-browser') ?: $this->findBinary('chromium') ?: $this->findBinary('google-chrome');
+ if ($chrome_path) {
+ $cmd = sprintf(
+ '%s --headless --disable-gpu --no-sandbox --print-to-pdf=%s --no-pdf-header-footer file://%s 2>&1',
+ escapeshellarg($chrome_path),
+ escapeshellarg($pdf_path),
+ escapeshellarg($html_path),
+ );
+ exec($cmd, $output, $exit_code);
+ @unlink($html_path);
+ if ($exit_code === 0 && file_exists($pdf_path)) {
+ return $pdf_path;
+ }
+ }
+
+ // 3. Try mPDF
+ if (class_exists('\\Mpdf\\Mpdf')) {
+ try {
+ $mpdf = new \Mpdf\Mpdf([
+ 'mode' => 'utf-8',
+ 'format' => 'A4',
+ 'margin_left' => 8,
+ 'margin_right' => 8,
+ 'margin_top' => 10,
+ 'margin_bottom' => 10,
+ 'tempDir' => $tmp_dir,
+ ]);
+ // Adapt for mPDF limitations
+ $adapted_html = str_replace("'DejaVu Sans'", "'dejavusans'", $html);
+ $mpdf->WriteHTML($adapted_html);
+ $mpdf->Output($pdf_path, \Mpdf\Output\Destination::FILE);
+ @unlink($html_path);
+ if (file_exists($pdf_path)) {
+ return $pdf_path;
+ }
+ } catch (\Throwable $e) {
+ // mPDF failed, continue to fallback
+ }
+ }
+
+ // 4. Fallback: save as HTML
+ @unlink($pdf_path);
+ // Return the HTML file path directly
+ return $html_path;
+ }
+
+
+ /**
+ * Find a binary in common system paths.
+ *
+ * @param string $name Binary name
+ * @return string|null Full path if found, null otherwise
+ */
+ private function findBinary(string $name): ?string
+ {
+ $search_paths = [
+ '/usr/bin/',
+ '/usr/local/bin/',
+ '/snap/bin/',
+ ];
+
+ foreach ($search_paths as $dir) {
+ $path = $dir . $name;
+ if (is_executable($path)) {
+ return $path;
+ }
+ }
+
+ // Try `which` as last resort
+ $result = trim((string) shell_exec('which ' . escapeshellarg($name) . ' 2>/dev/null'));
+ if ($result && is_executable($result)) {
+ return $result;
+ }
+
+ return null;
+ }
+
+
+ /**
+ * Save the generated file as a GLPI Document linked to the order.
+ *
+ * @param PluginOrderOrder $order The order (already loaded)
+ * @param string $filepath Absolute path to the generated file
+ * @param string $filename Document filename (e.g. "OT_PO123.pdf")
+ * @param string $mime MIME type
+ * @return int|false Document ID on success, false on failure
+ */
+ public function saveAsDocument(PluginOrderOrder $order, string $filepath, string $filename, string $mime)
+ {
+ if (!file_exists($filepath)) {
+ return false;
+ }
+
+ // Move file to GLPI document storage
+ $doc_dir = GLPI_DOC_DIR . '/_plugins/order/ot/';
+ @mkdir($doc_dir, 0755, true);
+
+ $dest_path = $doc_dir . $filename;
+ // If file already exists, add unique suffix
+ if (file_exists($dest_path)) {
+ $info = pathinfo($filename);
+ $dest_path = $doc_dir . $info['filename'] . '_' . date('YmdHis') . '.' . $info['extension'];
+ $filename = basename($dest_path);
+ }
+
+ if (!rename($filepath, $dest_path)) {
+ if (!copy($filepath, $dest_path)) {
+ return false;
+ }
+ @unlink($filepath);
+ }
+
+ // Relative path from GLPI_DOC_DIR
+ $relative_path = '_plugins/order/ot/' . $filename;
+
+ // Create GLPI Document record
+ $doc = new Document();
+ $doc_id = $doc->add([
+ 'name' => $filename,
+ 'filename' => $filename,
+ 'filepath' => $relative_path,
+ 'mime' => $mime,
+ 'entities_id' => $order->fields['entities_id'],
+ 'is_recursive' => $order->fields['is_recursive'] ?? 0,
+ ]);
+
+ if (!$doc_id) {
+ return false;
+ }
+
+ // Link document to the order
+ $doc_item = new Document_Item();
+ $doc_item->add([
+ 'documents_id' => $doc_id,
+ 'itemtype' => PluginOrderOrder::class,
+ 'items_id' => $order->getID(),
+ 'entities_id' => $order->fields['entities_id'],
+ ]);
+
+ return $doc_id;
+ }
+
+
+ /**
+ * Stream a document file as a download response.
+ *
+ * @param int $doc_id GLPI Document ID
+ * @return void
+ */
+ public static function downloadDocument(int $doc_id): void
+ {
+ $doc = new Document();
+ if (!$doc->getFromDB($doc_id)) {
+ return;
+ }
+
+ $filepath = GLPI_DOC_DIR . '/' . $doc->fields['filepath'];
+ if (!file_exists($filepath)) {
+ return;
+ }
+
+ $filename = $doc->fields['filename'];
+ $mime = $doc->fields['mime'] ?: 'application/octet-stream';
+
+ header('Content-Type: ' . $mime);
+ header('Content-Disposition: attachment; filename="' . addslashes($filename) . '"');
+ header('Content-Length: ' . filesize($filepath));
+ header('Cache-Control: private, max-age=0, must-revalidate');
+ header('Pragma: public');
+
+ readfile($filepath);
+ }
+}
diff --git a/inc/reference.class.php b/inc/reference.class.php
index a54866540b..18f257f6cc 100644
--- a/inc/reference.class.php
+++ b/inc/reference.class.php
@@ -295,6 +295,169 @@ public function post_getEmpty()
}
+ /**
+ * Get the Type dropdown class for an itemtype, supporting GLPI 11+ custom assets.
+ *
+ * @param string $itemtype The itemtype class name
+ * @return string|null The Type class name, or null if none exists
+ */
+ public static function getTypeClassForItemtype(string $itemtype): ?string
+ {
+ // Standard convention (e.g. Computer → ComputerType)
+ $type_class = $itemtype . 'Type';
+ if (class_exists($type_class)) {
+ return $type_class;
+ }
+
+ // GLPI 11+ custom assets: resolve via AssetDefinition
+ if (class_exists('Glpi\Asset\Asset') && is_a($itemtype, 'Glpi\Asset\Asset', true)) {
+ $item = getItemForItemtype($itemtype);
+ if ($item !== false && method_exists($item, 'getDefinition')) {
+ $definition = $item->getDefinition();
+ if ($definition !== null && method_exists($definition, 'getAssetTypeClassName')) {
+ $custom_type_class = $definition->getAssetTypeClassName();
+ if (!empty($custom_type_class) && class_exists($custom_type_class)) {
+ return $custom_type_class;
+ }
+ }
+ }
+ }
+
+ return null;
+ }
+
+
+ /**
+ * Get the Model dropdown class for an itemtype, supporting GLPI 11+ custom assets.
+ *
+ * @param string $itemtype The itemtype class name
+ * @return string|null The Model class name, or null if none exists
+ */
+ public static function getModelClassForItemtype(string $itemtype): ?string
+ {
+ // Standard convention (e.g. Computer → ComputerModel)
+ $model_class = $itemtype . 'Model';
+ if (class_exists($model_class)) {
+ return $model_class;
+ }
+
+ // GLPI 11+ custom assets: resolve via AssetDefinition
+ if (class_exists('Glpi\Asset\Asset') && is_a($itemtype, 'Glpi\Asset\Asset', true)) {
+ $item = getItemForItemtype($itemtype);
+ if ($item !== false && method_exists($item, 'getDefinition')) {
+ $definition = $item->getDefinition();
+ if ($definition !== null && method_exists($definition, 'getAssetModelClassName')) {
+ $custom_model_class = $definition->getAssetModelClassName();
+ if (!empty($custom_model_class) && class_exists($custom_model_class)) {
+ return $custom_model_class;
+ }
+ }
+ }
+ }
+
+ return null;
+ }
+
+
+ /**
+ * Check if an itemtype is a GLPI 11+ custom asset.
+ *
+ * @param string $itemtype The itemtype class name
+ * @return bool
+ */
+ public static function isCustomAsset(string $itemtype): bool
+ {
+ // Check by class hierarchy if the class exists
+ if (class_exists('Glpi\Asset\Asset') && is_a($itemtype, 'Glpi\Asset\Asset', true)) {
+ return true;
+ }
+
+ // Check by namespace pattern: Glpi\CustomAsset\{name}Asset
+ return (bool) preg_match('/^Glpi\\\\CustomAsset\\\\/', $itemtype);
+ }
+
+
+ /**
+ * Get the AssetDefinition ID for a GLPI 11+ custom asset itemtype.
+ *
+ * @param string $itemtype The itemtype class name
+ * @return int|null The definition ID, or null if not a custom asset
+ */
+ public static function getAssetDefinitionId(string $itemtype): ?int
+ {
+ if (!self::isCustomAsset($itemtype)) {
+ return null;
+ }
+
+ // Try ORM approach
+ $item = getItemForItemtype($itemtype);
+ if ($item !== false && method_exists($item, 'getDefinition')) {
+ $definition = $item->getDefinition();
+ if ($definition !== null) {
+ return (int) $definition->getID();
+ }
+ }
+
+ // Fallback: extract system_name from class and look up in DB
+ if (preg_match('/^Glpi\\\\CustomAsset\\\\(.+)Asset$/', $itemtype, $matches)) {
+ /** @var DBmysql $DB */
+ global $DB;
+ try {
+ if ($DB->tableExists('glpi_assets_assetdefinitions')) {
+ $result = $DB->request([
+ 'SELECT' => ['id'],
+ 'FROM' => 'glpi_assets_assetdefinitions',
+ 'WHERE' => ['system_name' => $matches[1]],
+ 'LIMIT' => 1,
+ ]);
+ foreach ($result as $row) {
+ return (int) $row['id'];
+ }
+ }
+ } catch (\Throwable $e) {
+ // Fall through
+ }
+ }
+
+ return null;
+ }
+
+
+ /**
+ * Get the display label for a custom asset type from glpi_assets_assetdefinitions.
+ *
+ * @param string $itemtype The itemtype class name (e.g. Glpi\CustomAsset\LaptopAsset)
+ * @return string The label from the definition, or the class name as fallback
+ */
+ public static function getCustomAssetLabel(string $itemtype): string
+ {
+ /** @var DBmysql $DB */
+ global $DB;
+
+ // Extract system_name from class: Glpi\CustomAsset\{system_name}Asset
+ if (preg_match('/^Glpi\\\\CustomAsset\\\\(.+)Asset$/', $itemtype, $matches)) {
+ $system_name = $matches[1];
+ try {
+ if ($DB->tableExists('glpi_assets_assetdefinitions')) {
+ $result = $DB->request([
+ 'SELECT' => ['label'],
+ 'FROM' => 'glpi_assets_assetdefinitions',
+ 'WHERE' => ['system_name' => $system_name],
+ 'LIMIT' => 1,
+ ]);
+ foreach ($result as $row) {
+ return htmlspecialchars($row['label'], ENT_QUOTES, 'UTF-8');
+ }
+ }
+ } catch (\Throwable $e) {
+ // Fall through to default
+ }
+ }
+
+ return htmlspecialchars($itemtype, ENT_QUOTES, 'UTF-8');
+ }
+
+
public function prepareInputForAdd($input)
{
if (!isset($input["name"]) || $input["name"] == '') {
@@ -403,7 +566,7 @@ public static function displayTabContentForItem(CommonGLPI $item, $tabnum = 1, $
}
- public function dropdownTemplate($name, $entity, $table, $value = 0)
+ public function dropdownTemplate($name, $entity, $table, $value = 0, $itemtype = '')
{
/** @var DBmysql $DB */
global $DB;
@@ -420,6 +583,15 @@ public function dropdownTemplate($name, $entity, $table, $value = 0)
'ORDER' => 'template_name',
];
+ // For GLPI 11+ custom assets, scope templates to the specific asset definition
+ // since all custom assets share the glpi_assets_assets table
+ if (!empty($itemtype)) {
+ $definition_id = self::getAssetDefinitionId($itemtype);
+ if ($definition_id !== null) {
+ $query['WHERE']['assets_assetdefinitions_id'] = $definition_id;
+ }
+ }
+
$option[0] = Dropdown::EMPTY_VALUE;
foreach ($DB->request($query) as $data) {
$option[$data["id"]] = $data["template_name"];
@@ -490,6 +662,11 @@ public function checkIfTemplateExistsInEntity($detailID, $itemtype, $entity)
'is_template' => 1,
],
];
+ // For GLPI 11+ custom assets, scope to the specific asset definition
+ $definition_id = self::getAssetDefinitionId($itemtype);
+ if ($definition_id !== null) {
+ $criteria_template['WHERE']['assets_assetdefinitions_id'] = $definition_id;
+ }
$result_template = $DB->request($criteria_template);
if (count($result_template) >= 1) {
$row_template = $result_template->current();
@@ -564,12 +741,20 @@ public function dropdownAllItems($options = [])
foreach ($types as $type) {
$item = getItemForItemtype($type);
- echo "getTypeName();
+ } else {
+ // For custom assets, try to get label from glpi_assets_assetdefinitions
+ $label = self::getCustomAssetLabel($type);
+ }
+
+ echo " " . ($item !== false ? $item->getTypeName() : $type) . " \n";
+ echo " >" . $label . "\n";
}
echo "";
@@ -674,7 +859,7 @@ public function showForm($id, $options = [])
if ($id > 0) {
$itemtype = $this->fields["itemtype"];
$item = getItemForItemtype($itemtype);
- echo($item !== false ? $item->getTypeName() : $itemtype);
+ echo($item !== false ? $item->getTypeName() : self::getCustomAssetLabel($itemtype));
echo Html::hidden('itemtype', ['value' => $itemtype]);
} else {
$this->dropdownAllItems([
@@ -692,8 +877,8 @@ public function showForm($id, $options = [])
echo "";
echo "";
if ($options['item']) {
- $itemtypeclass = $options['item'] . "Type";
- if (class_exists($itemtypeclass)) {
+ $itemtypeclass = self::getTypeClassForItemtype($options['item']);
+ if ($itemtypeclass !== null) {
if (!$reference_in_use) {
Dropdown::show($itemtypeclass, [
'name' => "types_id",
@@ -711,8 +896,9 @@ public function showForm($id, $options = [])
echo "" . __s("Model") . " ";
echo "";
echo "";
- if ($options['item'] && class_exists($itemtypeclass)) {
- Dropdown::show($options['item'] . "Model", [
+ $itemmodelclass = $options['item'] ? self::getModelClassForItemtype($options['item']) : null;
+ if ($itemmodelclass !== null) {
+ Dropdown::show($itemmodelclass, [
'name' => "models_id",
'value' => $this->fields["models_id"],
]);
@@ -724,16 +910,17 @@ public function showForm($id, $options = [])
echo " " . __s("Template name") . " ";
echo "";
echo "";
- if (
- !empty($options['item'])
- && $DB->fieldExists($options['item']::getTable(), 'is_template')
- ) {
- $this->dropdownTemplate(
- 'templates_id',
- $this->fields['entities_id'],
- $options['item']::getTable(),
- $this->fields['templates_id'],
- );
+ if (!empty($options['item'])) {
+ $item_instance = getItemForItemtype($options['item']);
+ if ($item_instance !== false && $item_instance->maybeTemplate()) {
+ $this->dropdownTemplate(
+ 'templates_id',
+ $this->fields['entities_id'],
+ $item_instance->getTable(),
+ $this->fields['templates_id'],
+ $options['item'],
+ );
+ }
}
echo " ";
@@ -794,13 +981,15 @@ public function dropdownAllItemsByType(
}
$condition = [];
- if (class_exists($itemtype . "Type", false) && $types_id != 0) {
- $fk = getForeignKeyFieldForTable(getTableForItemType($itemtype . "Type"));
+ $type_class = self::getTypeClassForItemtype($itemtype);
+ if ($type_class !== null && $types_id != 0) {
+ $fk = getForeignKeyFieldForTable(getTableForItemType($type_class));
$condition[$fk] = $types_id;
}
- if (class_exists($itemtype . "Model", false) && $models_id != 0) {
- $fk = getForeignKeyFieldForTable(getTableForItemType($itemtype . "Model"));
+ $model_class = self::getModelClassForItemtype($itemtype);
+ if ($model_class !== null && $models_id != 0) {
+ $fk = getForeignKeyFieldForTable(getTableForItemType($model_class));
$condition[$fk] = $models_id;
}
diff --git a/setup.php b/setup.php
index 7cd7cfd6b0..2acf71fa00 100644
--- a/setup.php
+++ b/setup.php
@@ -30,7 +30,7 @@
use function Safe\define;
-define('PLUGIN_ORDER_VERSION', '2.12.6');
+define('PLUGIN_ORDER_VERSION', '2.13.1');
// Minimal GLPI version, inclusive
define("PLUGIN_ORDER_MIN_GLPI", "11.0.0");
@@ -125,6 +125,49 @@ function plugin_init_order()
'Pdu',
];
+ // GLPI 11+ custom assets support: dynamically discover user-defined asset types
+ // Custom assets are stored in glpi_assets_assetdefinitions (definitions) and
+ // glpi_assets_assets (instances). The concrete class name follows the pattern:
+ // Glpi\CustomAsset\{system_name}Asset
+ if (class_exists('Glpi\Asset\AssetDefinition')) {
+ try {
+ // Try ORM approach first
+ $asset_definition = new \Glpi\Asset\AssetDefinition();
+ $found_via_orm = false;
+ foreach ($asset_definition->find(['is_active' => 1]) as $def) {
+ $asset_definition->getFromDB($def['id']);
+ if (method_exists($asset_definition, 'getAssetClassName')) {
+ $concrete_class = $asset_definition->getAssetClassName();
+ if (!empty($concrete_class) && !in_array($concrete_class, $ORDER_TYPES)) {
+ $ORDER_TYPES[] = $concrete_class;
+ $found_via_orm = true;
+ }
+ }
+ }
+
+ // Fallback: query DB directly and construct class names
+ if (!$found_via_orm) {
+ /** @var DBmysql $DB */
+ global $DB;
+ if ($DB->tableExists('glpi_assets_assetdefinitions')) {
+ $result = $DB->request([
+ 'SELECT' => ['id', 'system_name', 'label'],
+ 'FROM' => 'glpi_assets_assetdefinitions',
+ 'WHERE' => ['is_active' => 1],
+ ]);
+ foreach ($result as $row) {
+ $concrete_class = 'Glpi\\CustomAsset\\' . $row['system_name'] . 'Asset';
+ if (!in_array($concrete_class, $ORDER_TYPES)) {
+ $ORDER_TYPES[] = $concrete_class;
+ }
+ }
+ }
+ }
+ } catch (\Throwable $e) {
+ // Tables may not exist during install/upgrade — silently ignore
+ }
+ }
+
$CFG_GLPI['plugin_order_types'] = $ORDER_TYPES;
$PLUGIN_HOOKS['pre_item_purge']['order'] = [
@@ -205,8 +248,8 @@ function plugin_version_order()
return [
'name' => __s("Orders management", "order"),
'version' => PLUGIN_ORDER_VERSION,
- 'author' => 'The plugin order team',
- 'homepage' => 'https://github.com/pluginsGLPI/order',
+ 'author' => 'geek95dg',
+ 'homepage' => 'https://github.com/geek95dg/order',
'license' => 'GPLv2+',
'requirements' => [
'glpi' => [
diff --git a/vendor/autoload.php b/vendor/autoload.php
new file mode 100644
index 0000000000..272e155647
--- /dev/null
+++ b/vendor/autoload.php
@@ -0,0 +1,22 @@
+
+ * Jordi Boggiano
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Composer\Autoload;
+
+/**
+ * ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
+ *
+ * $loader = new \Composer\Autoload\ClassLoader();
+ *
+ * // register classes with namespaces
+ * $loader->add('Symfony\Component', __DIR__.'/component');
+ * $loader->add('Symfony', __DIR__.'/framework');
+ *
+ * // activate the autoloader
+ * $loader->register();
+ *
+ * // to enable searching the include path (eg. for PEAR packages)
+ * $loader->setUseIncludePath(true);
+ *
+ * In this example, if you try to use a class in the Symfony\Component
+ * namespace or one of its children (Symfony\Component\Console for instance),
+ * the autoloader will first look for the class under the component/
+ * directory, and it will then fallback to the framework/ directory if not
+ * found before giving up.
+ *
+ * This class is loosely based on the Symfony UniversalClassLoader.
+ *
+ * @author Fabien Potencier
+ * @author Jordi Boggiano
+ * @see https://www.php-fig.org/psr/psr-0/
+ * @see https://www.php-fig.org/psr/psr-4/
+ */
+class ClassLoader
+{
+ /** @var \Closure(string):void */
+ private static $includeFile;
+
+ /** @var string|null */
+ private $vendorDir;
+
+ // PSR-4
+ /**
+ * @var array>
+ */
+ private $prefixLengthsPsr4 = array();
+ /**
+ * @var array>
+ */
+ private $prefixDirsPsr4 = array();
+ /**
+ * @var list
+ */
+ private $fallbackDirsPsr4 = array();
+
+ // PSR-0
+ /**
+ * List of PSR-0 prefixes
+ *
+ * Structured as array('F (first letter)' => array('Foo\Bar (full prefix)' => array('path', 'path2')))
+ *
+ * @var array>>
+ */
+ private $prefixesPsr0 = array();
+ /**
+ * @var list
+ */
+ private $fallbackDirsPsr0 = array();
+
+ /** @var bool */
+ private $useIncludePath = false;
+
+ /**
+ * @var array
+ */
+ private $classMap = array();
+
+ /** @var bool */
+ private $classMapAuthoritative = false;
+
+ /**
+ * @var array
+ */
+ private $missingClasses = array();
+
+ /** @var string|null */
+ private $apcuPrefix;
+
+ /**
+ * @var array
+ */
+ private static $registeredLoaders = array();
+
+ /**
+ * @param string|null $vendorDir
+ */
+ public function __construct($vendorDir = null)
+ {
+ $this->vendorDir = $vendorDir;
+ self::initializeIncludeClosure();
+ }
+
+ /**
+ * @return array>
+ */
+ public function getPrefixes()
+ {
+ if (!empty($this->prefixesPsr0)) {
+ return call_user_func_array('array_merge', array_values($this->prefixesPsr0));
+ }
+
+ return array();
+ }
+
+ /**
+ * @return array>
+ */
+ public function getPrefixesPsr4()
+ {
+ return $this->prefixDirsPsr4;
+ }
+
+ /**
+ * @return list
+ */
+ public function getFallbackDirs()
+ {
+ return $this->fallbackDirsPsr0;
+ }
+
+ /**
+ * @return list
+ */
+ public function getFallbackDirsPsr4()
+ {
+ return $this->fallbackDirsPsr4;
+ }
+
+ /**
+ * @return array Array of classname => path
+ */
+ public function getClassMap()
+ {
+ return $this->classMap;
+ }
+
+ /**
+ * @param array $classMap Class to filename map
+ *
+ * @return void
+ */
+ public function addClassMap(array $classMap)
+ {
+ if ($this->classMap) {
+ $this->classMap = array_merge($this->classMap, $classMap);
+ } else {
+ $this->classMap = $classMap;
+ }
+ }
+
+ /**
+ * Registers a set of PSR-0 directories for a given prefix, either
+ * appending or prepending to the ones previously set for this prefix.
+ *
+ * @param string $prefix The prefix
+ * @param list|string $paths The PSR-0 root directories
+ * @param bool $prepend Whether to prepend the directories
+ *
+ * @return void
+ */
+ public function add($prefix, $paths, $prepend = false)
+ {
+ $paths = (array) $paths;
+ if (!$prefix) {
+ if ($prepend) {
+ $this->fallbackDirsPsr0 = array_merge(
+ $paths,
+ $this->fallbackDirsPsr0
+ );
+ } else {
+ $this->fallbackDirsPsr0 = array_merge(
+ $this->fallbackDirsPsr0,
+ $paths
+ );
+ }
+
+ return;
+ }
+
+ $first = $prefix[0];
+ if (!isset($this->prefixesPsr0[$first][$prefix])) {
+ $this->prefixesPsr0[$first][$prefix] = $paths;
+
+ return;
+ }
+ if ($prepend) {
+ $this->prefixesPsr0[$first][$prefix] = array_merge(
+ $paths,
+ $this->prefixesPsr0[$first][$prefix]
+ );
+ } else {
+ $this->prefixesPsr0[$first][$prefix] = array_merge(
+ $this->prefixesPsr0[$first][$prefix],
+ $paths
+ );
+ }
+ }
+
+ /**
+ * Registers a set of PSR-4 directories for a given namespace, either
+ * appending or prepending to the ones previously set for this namespace.
+ *
+ * @param string $prefix The prefix/namespace, with trailing '\\'
+ * @param list|string $paths The PSR-4 base directories
+ * @param bool $prepend Whether to prepend the directories
+ *
+ * @throws \InvalidArgumentException
+ *
+ * @return void
+ */
+ public function addPsr4($prefix, $paths, $prepend = false)
+ {
+ $paths = (array) $paths;
+ if (!$prefix) {
+ // Register directories for the root namespace.
+ if ($prepend) {
+ $this->fallbackDirsPsr4 = array_merge(
+ $paths,
+ $this->fallbackDirsPsr4
+ );
+ } else {
+ $this->fallbackDirsPsr4 = array_merge(
+ $this->fallbackDirsPsr4,
+ $paths
+ );
+ }
+ } elseif (!isset($this->prefixDirsPsr4[$prefix])) {
+ // Register directories for a new namespace.
+ $length = strlen($prefix);
+ if ('\\' !== $prefix[$length - 1]) {
+ throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
+ }
+ $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
+ $this->prefixDirsPsr4[$prefix] = $paths;
+ } elseif ($prepend) {
+ // Prepend directories for an already registered namespace.
+ $this->prefixDirsPsr4[$prefix] = array_merge(
+ $paths,
+ $this->prefixDirsPsr4[$prefix]
+ );
+ } else {
+ // Append directories for an already registered namespace.
+ $this->prefixDirsPsr4[$prefix] = array_merge(
+ $this->prefixDirsPsr4[$prefix],
+ $paths
+ );
+ }
+ }
+
+ /**
+ * Registers a set of PSR-0 directories for a given prefix,
+ * replacing any others previously set for this prefix.
+ *
+ * @param string $prefix The prefix
+ * @param list|string $paths The PSR-0 base directories
+ *
+ * @return void
+ */
+ public function set($prefix, $paths)
+ {
+ if (!$prefix) {
+ $this->fallbackDirsPsr0 = (array) $paths;
+ } else {
+ $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths;
+ }
+ }
+
+ /**
+ * Registers a set of PSR-4 directories for a given namespace,
+ * replacing any others previously set for this namespace.
+ *
+ * @param string $prefix The prefix/namespace, with trailing '\\'
+ * @param list|string $paths The PSR-4 base directories
+ *
+ * @throws \InvalidArgumentException
+ *
+ * @return void
+ */
+ public function setPsr4($prefix, $paths)
+ {
+ if (!$prefix) {
+ $this->fallbackDirsPsr4 = (array) $paths;
+ } else {
+ $length = strlen($prefix);
+ if ('\\' !== $prefix[$length - 1]) {
+ throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
+ }
+ $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
+ $this->prefixDirsPsr4[$prefix] = (array) $paths;
+ }
+ }
+
+ /**
+ * Turns on searching the include path for class files.
+ *
+ * @param bool $useIncludePath
+ *
+ * @return void
+ */
+ public function setUseIncludePath($useIncludePath)
+ {
+ $this->useIncludePath = $useIncludePath;
+ }
+
+ /**
+ * Can be used to check if the autoloader uses the include path to check
+ * for classes.
+ *
+ * @return bool
+ */
+ public function getUseIncludePath()
+ {
+ return $this->useIncludePath;
+ }
+
+ /**
+ * Turns off searching the prefix and fallback directories for classes
+ * that have not been registered with the class map.
+ *
+ * @param bool $classMapAuthoritative
+ *
+ * @return void
+ */
+ public function setClassMapAuthoritative($classMapAuthoritative)
+ {
+ $this->classMapAuthoritative = $classMapAuthoritative;
+ }
+
+ /**
+ * Should class lookup fail if not found in the current class map?
+ *
+ * @return bool
+ */
+ public function isClassMapAuthoritative()
+ {
+ return $this->classMapAuthoritative;
+ }
+
+ /**
+ * APCu prefix to use to cache found/not-found classes, if the extension is enabled.
+ *
+ * @param string|null $apcuPrefix
+ *
+ * @return void
+ */
+ public function setApcuPrefix($apcuPrefix)
+ {
+ $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
+ }
+
+ /**
+ * The APCu prefix in use, or null if APCu caching is not enabled.
+ *
+ * @return string|null
+ */
+ public function getApcuPrefix()
+ {
+ return $this->apcuPrefix;
+ }
+
+ /**
+ * Registers this instance as an autoloader.
+ *
+ * @param bool $prepend Whether to prepend the autoloader or not
+ *
+ * @return void
+ */
+ public function register($prepend = false)
+ {
+ spl_autoload_register(array($this, 'loadClass'), true, $prepend);
+
+ if (null === $this->vendorDir) {
+ return;
+ }
+
+ if ($prepend) {
+ self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders;
+ } else {
+ unset(self::$registeredLoaders[$this->vendorDir]);
+ self::$registeredLoaders[$this->vendorDir] = $this;
+ }
+ }
+
+ /**
+ * Unregisters this instance as an autoloader.
+ *
+ * @return void
+ */
+ public function unregister()
+ {
+ spl_autoload_unregister(array($this, 'loadClass'));
+
+ if (null !== $this->vendorDir) {
+ unset(self::$registeredLoaders[$this->vendorDir]);
+ }
+ }
+
+ /**
+ * Loads the given class or interface.
+ *
+ * @param string $class The name of the class
+ * @return true|null True if loaded, null otherwise
+ */
+ public function loadClass($class)
+ {
+ if ($file = $this->findFile($class)) {
+ $includeFile = self::$includeFile;
+ $includeFile($file);
+
+ return true;
+ }
+
+ return null;
+ }
+
+ /**
+ * Finds the path to the file where the class is defined.
+ *
+ * @param string $class The name of the class
+ *
+ * @return string|false The path if found, false otherwise
+ */
+ public function findFile($class)
+ {
+ // class map lookup
+ if (isset($this->classMap[$class])) {
+ return $this->classMap[$class];
+ }
+ if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
+ return false;
+ }
+ if (null !== $this->apcuPrefix) {
+ $file = apcu_fetch($this->apcuPrefix.$class, $hit);
+ if ($hit) {
+ return $file;
+ }
+ }
+
+ $file = $this->findFileWithExtension($class, '.php');
+
+ // Search for Hack files if we are running on HHVM
+ if (false === $file && defined('HHVM_VERSION')) {
+ $file = $this->findFileWithExtension($class, '.hh');
+ }
+
+ if (null !== $this->apcuPrefix) {
+ apcu_add($this->apcuPrefix.$class, $file);
+ }
+
+ if (false === $file) {
+ // Remember that this class does not exist.
+ $this->missingClasses[$class] = true;
+ }
+
+ return $file;
+ }
+
+ /**
+ * Returns the currently registered loaders keyed by their corresponding vendor directories.
+ *
+ * @return array
+ */
+ public static function getRegisteredLoaders()
+ {
+ return self::$registeredLoaders;
+ }
+
+ /**
+ * @param string $class
+ * @param string $ext
+ * @return string|false
+ */
+ private function findFileWithExtension($class, $ext)
+ {
+ // PSR-4 lookup
+ $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
+
+ $first = $class[0];
+ if (isset($this->prefixLengthsPsr4[$first])) {
+ $subPath = $class;
+ while (false !== $lastPos = strrpos($subPath, '\\')) {
+ $subPath = substr($subPath, 0, $lastPos);
+ $search = $subPath . '\\';
+ if (isset($this->prefixDirsPsr4[$search])) {
+ $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
+ foreach ($this->prefixDirsPsr4[$search] as $dir) {
+ if (file_exists($file = $dir . $pathEnd)) {
+ return $file;
+ }
+ }
+ }
+ }
+ }
+
+ // PSR-4 fallback dirs
+ foreach ($this->fallbackDirsPsr4 as $dir) {
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
+ return $file;
+ }
+ }
+
+ // PSR-0 lookup
+ if (false !== $pos = strrpos($class, '\\')) {
+ // namespaced class name
+ $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
+ . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
+ } else {
+ // PEAR-like class name
+ $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
+ }
+
+ if (isset($this->prefixesPsr0[$first])) {
+ foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
+ if (0 === strpos($class, $prefix)) {
+ foreach ($dirs as $dir) {
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+ return $file;
+ }
+ }
+ }
+ }
+ }
+
+ // PSR-0 fallback dirs
+ foreach ($this->fallbackDirsPsr0 as $dir) {
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+ return $file;
+ }
+ }
+
+ // PSR-0 include paths.
+ if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
+ return $file;
+ }
+
+ return false;
+ }
+
+ /**
+ * @return void
+ */
+ private static function initializeIncludeClosure()
+ {
+ if (self::$includeFile !== null) {
+ return;
+ }
+
+ /**
+ * Scope isolated include.
+ *
+ * Prevents access to $this/self from included files.
+ *
+ * @param string $file
+ * @return void
+ */
+ self::$includeFile = \Closure::bind(static function($file) {
+ include $file;
+ }, null, null);
+ }
+}
diff --git a/vendor/composer/InstalledVersions.php b/vendor/composer/InstalledVersions.php
new file mode 100644
index 0000000000..2052022fd8
--- /dev/null
+++ b/vendor/composer/InstalledVersions.php
@@ -0,0 +1,396 @@
+
+ * Jordi Boggiano
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Composer;
+
+use Composer\Autoload\ClassLoader;
+use Composer\Semver\VersionParser;
+
+/**
+ * This class is copied in every Composer installed project and available to all
+ *
+ * See also https://getcomposer.org/doc/07-runtime.md#installed-versions
+ *
+ * To require its presence, you can require `composer-runtime-api ^2.0`
+ *
+ * @final
+ */
+class InstalledVersions
+{
+ /**
+ * @var string|null if set (by reflection by Composer), this should be set to the path where this class is being copied to
+ * @internal
+ */
+ private static $selfDir = null;
+
+ /**
+ * @var mixed[]|null
+ * @psalm-var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array}|array{}|null
+ */
+ private static $installed;
+
+ /**
+ * @var bool
+ */
+ private static $installedIsLocalDir;
+
+ /**
+ * @var bool|null
+ */
+ private static $canGetVendors;
+
+ /**
+ * @var array[]
+ * @psalm-var array}>
+ */
+ private static $installedByVendor = array();
+
+ /**
+ * Returns a list of all package names which are present, either by being installed, replaced or provided
+ *
+ * @return string[]
+ * @psalm-return list
+ */
+ public static function getInstalledPackages()
+ {
+ $packages = array();
+ foreach (self::getInstalled() as $installed) {
+ $packages[] = array_keys($installed['versions']);
+ }
+
+ if (1 === \count($packages)) {
+ return $packages[0];
+ }
+
+ return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
+ }
+
+ /**
+ * Returns a list of all package names with a specific type e.g. 'library'
+ *
+ * @param string $type
+ * @return string[]
+ * @psalm-return list
+ */
+ public static function getInstalledPackagesByType($type)
+ {
+ $packagesByType = array();
+
+ foreach (self::getInstalled() as $installed) {
+ foreach ($installed['versions'] as $name => $package) {
+ if (isset($package['type']) && $package['type'] === $type) {
+ $packagesByType[] = $name;
+ }
+ }
+ }
+
+ return $packagesByType;
+ }
+
+ /**
+ * Checks whether the given package is installed
+ *
+ * This also returns true if the package name is provided or replaced by another package
+ *
+ * @param string $packageName
+ * @param bool $includeDevRequirements
+ * @return bool
+ */
+ public static function isInstalled($packageName, $includeDevRequirements = true)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (isset($installed['versions'][$packageName])) {
+ return $includeDevRequirements || !isset($installed['versions'][$packageName]['dev_requirement']) || $installed['versions'][$packageName]['dev_requirement'] === false;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Checks whether the given package satisfies a version constraint
+ *
+ * e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call:
+ *
+ * Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3')
+ *
+ * @param VersionParser $parser Install composer/semver to have access to this class and functionality
+ * @param string $packageName
+ * @param string|null $constraint A version constraint to check for, if you pass one you have to make sure composer/semver is required by your package
+ * @return bool
+ */
+ public static function satisfies(VersionParser $parser, $packageName, $constraint)
+ {
+ $constraint = $parser->parseConstraints((string) $constraint);
+ $provided = $parser->parseConstraints(self::getVersionRanges($packageName));
+
+ return $provided->matches($constraint);
+ }
+
+ /**
+ * Returns a version constraint representing all the range(s) which are installed for a given package
+ *
+ * It is easier to use this via isInstalled() with the $constraint argument if you need to check
+ * whether a given version of a package is installed, and not just whether it exists
+ *
+ * @param string $packageName
+ * @return string Version constraint usable with composer/semver
+ */
+ public static function getVersionRanges($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ $ranges = array();
+ if (isset($installed['versions'][$packageName]['pretty_version'])) {
+ $ranges[] = $installed['versions'][$packageName]['pretty_version'];
+ }
+ if (array_key_exists('aliases', $installed['versions'][$packageName])) {
+ $ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
+ }
+ if (array_key_exists('replaced', $installed['versions'][$packageName])) {
+ $ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
+ }
+ if (array_key_exists('provided', $installed['versions'][$packageName])) {
+ $ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
+ }
+
+ return implode(' || ', $ranges);
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
+ */
+ public static function getVersion($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ if (!isset($installed['versions'][$packageName]['version'])) {
+ return null;
+ }
+
+ return $installed['versions'][$packageName]['version'];
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
+ */
+ public static function getPrettyVersion($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ if (!isset($installed['versions'][$packageName]['pretty_version'])) {
+ return null;
+ }
+
+ return $installed['versions'][$packageName]['pretty_version'];
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference
+ */
+ public static function getReference($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ if (!isset($installed['versions'][$packageName]['reference'])) {
+ return null;
+ }
+
+ return $installed['versions'][$packageName]['reference'];
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as install path. Packages of type metapackages also have a null install path.
+ */
+ public static function getInstallPath($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null;
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @return array
+ * @psalm-return array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}
+ */
+ public static function getRootPackage()
+ {
+ $installed = self::getInstalled();
+
+ return $installed[0]['root'];
+ }
+
+ /**
+ * Returns the raw installed.php data for custom implementations
+ *
+ * @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect.
+ * @return array[]
+ * @psalm-return array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array}
+ */
+ public static function getRawData()
+ {
+ @trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED);
+
+ if (null === self::$installed) {
+ // only require the installed.php file if this file is loaded from its dumped location,
+ // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
+ if (substr(__DIR__, -8, 1) !== 'C') {
+ self::$installed = include __DIR__ . '/installed.php';
+ } else {
+ self::$installed = array();
+ }
+ }
+
+ return self::$installed;
+ }
+
+ /**
+ * Returns the raw data of all installed.php which are currently loaded for custom implementations
+ *
+ * @return array[]
+ * @psalm-return list}>
+ */
+ public static function getAllRawData()
+ {
+ return self::getInstalled();
+ }
+
+ /**
+ * Lets you reload the static array from another file
+ *
+ * This is only useful for complex integrations in which a project needs to use
+ * this class but then also needs to execute another project's autoloader in process,
+ * and wants to ensure both projects have access to their version of installed.php.
+ *
+ * A typical case would be PHPUnit, where it would need to make sure it reads all
+ * the data it needs from this class, then call reload() with
+ * `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure
+ * the project in which it runs can then also use this class safely, without
+ * interference between PHPUnit's dependencies and the project's dependencies.
+ *
+ * @param array[] $data A vendor/composer/installed.php data set
+ * @return void
+ *
+ * @psalm-param array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $data
+ */
+ public static function reload($data)
+ {
+ self::$installed = $data;
+ self::$installedByVendor = array();
+
+ // when using reload, we disable the duplicate protection to ensure that self::$installed data is
+ // always returned, but we cannot know whether it comes from the installed.php in __DIR__ or not,
+ // so we have to assume it does not, and that may result in duplicate data being returned when listing
+ // all installed packages for example
+ self::$installedIsLocalDir = false;
+ }
+
+ /**
+ * @return string
+ */
+ private static function getSelfDir()
+ {
+ if (self::$selfDir === null) {
+ self::$selfDir = strtr(__DIR__, '\\', '/');
+ }
+
+ return self::$selfDir;
+ }
+
+ /**
+ * @return array[]
+ * @psalm-return list}>
+ */
+ private static function getInstalled()
+ {
+ if (null === self::$canGetVendors) {
+ self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
+ }
+
+ $installed = array();
+ $copiedLocalDir = false;
+
+ if (self::$canGetVendors) {
+ $selfDir = self::getSelfDir();
+ foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
+ $vendorDir = strtr($vendorDir, '\\', '/');
+ if (isset(self::$installedByVendor[$vendorDir])) {
+ $installed[] = self::$installedByVendor[$vendorDir];
+ } elseif (is_file($vendorDir.'/composer/installed.php')) {
+ /** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $required */
+ $required = require $vendorDir.'/composer/installed.php';
+ self::$installedByVendor[$vendorDir] = $required;
+ $installed[] = $required;
+ if (self::$installed === null && $vendorDir.'/composer' === $selfDir) {
+ self::$installed = $required;
+ self::$installedIsLocalDir = true;
+ }
+ }
+ if (self::$installedIsLocalDir && $vendorDir.'/composer' === $selfDir) {
+ $copiedLocalDir = true;
+ }
+ }
+ }
+
+ if (null === self::$installed) {
+ // only require the installed.php file if this file is loaded from its dumped location,
+ // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
+ if (substr(__DIR__, -8, 1) !== 'C') {
+ /** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $required */
+ $required = require __DIR__ . '/installed.php';
+ self::$installed = $required;
+ } else {
+ self::$installed = array();
+ }
+ }
+
+ if (self::$installed !== array() && !$copiedLocalDir) {
+ $installed[] = self::$installed;
+ }
+
+ return $installed;
+ }
+}
diff --git a/vendor/composer/LICENSE b/vendor/composer/LICENSE
new file mode 100644
index 0000000000..f27399a042
--- /dev/null
+++ b/vendor/composer/LICENSE
@@ -0,0 +1,21 @@
+
+Copyright (c) Nils Adermann, Jordi Boggiano
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
diff --git a/vendor/composer/autoload_classmap.php b/vendor/composer/autoload_classmap.php
new file mode 100644
index 0000000000..8ed8a70aab
--- /dev/null
+++ b/vendor/composer/autoload_classmap.php
@@ -0,0 +1,21 @@
+ $vendorDir . '/composer/InstalledVersions.php',
+ 'Odtphp\\Attributes\\AllowDynamicProperties' => $vendorDir . '/sboden/odtphp/src/Attributes/AllowDynamicProperties.php',
+ 'Odtphp\\Exceptions\\OdfException' => $vendorDir . '/sboden/odtphp/src/Exceptions/OdfException.php',
+ 'Odtphp\\Exceptions\\PclZipProxyException' => $vendorDir . '/sboden/odtphp/src/Exceptions/PclZipProxyException.php',
+ 'Odtphp\\Exceptions\\PhpZipProxyException' => $vendorDir . '/sboden/odtphp/src/Exceptions/PhpZipProxyException.php',
+ 'Odtphp\\Exceptions\\SegmentException' => $vendorDir . '/sboden/odtphp/src/Exceptions/SegmentException.php',
+ 'Odtphp\\Odf' => $vendorDir . '/sboden/odtphp/src/Odf.php',
+ 'Odtphp\\Segment' => $vendorDir . '/sboden/odtphp/src/Segment.php',
+ 'Odtphp\\SegmentIterator' => $vendorDir . '/sboden/odtphp/src/SegmentIterator.php',
+ 'Odtphp\\Zip\\PclZipProxy' => $vendorDir . '/sboden/odtphp/src/Zip/PclZipProxy.php',
+ 'Odtphp\\Zip\\PhpZipProxy' => $vendorDir . '/sboden/odtphp/src/Zip/PhpZipProxy.php',
+ 'Odtphp\\Zip\\ZipInterface' => $vendorDir . '/sboden/odtphp/src/Zip/ZipInterface.php',
+);
diff --git a/vendor/composer/autoload_files.php b/vendor/composer/autoload_files.php
new file mode 100644
index 0000000000..abe1efd8a6
--- /dev/null
+++ b/vendor/composer/autoload_files.php
@@ -0,0 +1,10 @@
+ $vendorDir . '/sboden/odtphp/lib/pclzip.lib.php',
+);
diff --git a/vendor/composer/autoload_namespaces.php b/vendor/composer/autoload_namespaces.php
new file mode 100644
index 0000000000..15a2ff3ad6
--- /dev/null
+++ b/vendor/composer/autoload_namespaces.php
@@ -0,0 +1,9 @@
+ array($vendorDir . '/sboden/odtphp/src'),
+);
diff --git a/vendor/composer/autoload_real.php b/vendor/composer/autoload_real.php
new file mode 100644
index 0000000000..87617a25fc
--- /dev/null
+++ b/vendor/composer/autoload_real.php
@@ -0,0 +1,50 @@
+register(true);
+
+ $filesToLoad = \Composer\Autoload\ComposerStaticInit477a35eb4fd921399aa876f53273c09d::$files;
+ $requireFile = \Closure::bind(static function ($fileIdentifier, $file) {
+ if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) {
+ $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true;
+
+ require $file;
+ }
+ }, null, null);
+ foreach ($filesToLoad as $fileIdentifier => $file) {
+ $requireFile($fileIdentifier, $file);
+ }
+
+ return $loader;
+ }
+}
diff --git a/vendor/composer/autoload_static.php b/vendor/composer/autoload_static.php
new file mode 100644
index 0000000000..414bf23242
--- /dev/null
+++ b/vendor/composer/autoload_static.php
@@ -0,0 +1,51 @@
+ __DIR__ . '/..' . '/sboden/odtphp/lib/pclzip.lib.php',
+ );
+
+ public static $prefixLengthsPsr4 = array (
+ 'O' =>
+ array (
+ 'Odtphp\\' => 7,
+ ),
+ );
+
+ public static $prefixDirsPsr4 = array (
+ 'Odtphp\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/sboden/odtphp/src',
+ ),
+ );
+
+ public static $classMap = array (
+ 'Composer\\InstalledVersions' => __DIR__ . '/..' . '/composer/InstalledVersions.php',
+ 'Odtphp\\Attributes\\AllowDynamicProperties' => __DIR__ . '/..' . '/sboden/odtphp/src/Attributes/AllowDynamicProperties.php',
+ 'Odtphp\\Exceptions\\OdfException' => __DIR__ . '/..' . '/sboden/odtphp/src/Exceptions/OdfException.php',
+ 'Odtphp\\Exceptions\\PclZipProxyException' => __DIR__ . '/..' . '/sboden/odtphp/src/Exceptions/PclZipProxyException.php',
+ 'Odtphp\\Exceptions\\PhpZipProxyException' => __DIR__ . '/..' . '/sboden/odtphp/src/Exceptions/PhpZipProxyException.php',
+ 'Odtphp\\Exceptions\\SegmentException' => __DIR__ . '/..' . '/sboden/odtphp/src/Exceptions/SegmentException.php',
+ 'Odtphp\\Odf' => __DIR__ . '/..' . '/sboden/odtphp/src/Odf.php',
+ 'Odtphp\\Segment' => __DIR__ . '/..' . '/sboden/odtphp/src/Segment.php',
+ 'Odtphp\\SegmentIterator' => __DIR__ . '/..' . '/sboden/odtphp/src/SegmentIterator.php',
+ 'Odtphp\\Zip\\PclZipProxy' => __DIR__ . '/..' . '/sboden/odtphp/src/Zip/PclZipProxy.php',
+ 'Odtphp\\Zip\\PhpZipProxy' => __DIR__ . '/..' . '/sboden/odtphp/src/Zip/PhpZipProxy.php',
+ 'Odtphp\\Zip\\ZipInterface' => __DIR__ . '/..' . '/sboden/odtphp/src/Zip/ZipInterface.php',
+ );
+
+ public static function getInitializer(ClassLoader $loader)
+ {
+ return \Closure::bind(function () use ($loader) {
+ $loader->prefixLengthsPsr4 = ComposerStaticInit477a35eb4fd921399aa876f53273c09d::$prefixLengthsPsr4;
+ $loader->prefixDirsPsr4 = ComposerStaticInit477a35eb4fd921399aa876f53273c09d::$prefixDirsPsr4;
+ $loader->classMap = ComposerStaticInit477a35eb4fd921399aa876f53273c09d::$classMap;
+
+ }, null, ClassLoader::class);
+ }
+}
diff --git a/vendor/composer/installed.json b/vendor/composer/installed.json
new file mode 100644
index 0000000000..4790d1ac03
--- /dev/null
+++ b/vendor/composer/installed.json
@@ -0,0 +1,63 @@
+{
+ "packages": [
+ {
+ "name": "sboden/odtphp",
+ "version": "3.2.1",
+ "version_normalized": "3.2.1.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/sboden/odtphp.git",
+ "reference": "989e51fa6edaaf9010b27aa14c5556ca4f14f6f2"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/sboden/odtphp/zipball/989e51fa6edaaf9010b27aa14c5556ca4f14f6f2",
+ "reference": "989e51fa6edaaf9010b27aa14c5556ca4f14f6f2",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.1"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "^1.0",
+ "drupal/coder": "^8.3",
+ "phpunit/phpunit": "^10.4",
+ "scrutinizer/ocular": "^1.9",
+ "symfony/var-dumper": "^6.4"
+ },
+ "time": "2025-07-24T20:26:09+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "2.0-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "files": [
+ "lib/pclzip.lib.php"
+ ],
+ "psr-4": {
+ "Odtphp\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "GPL-3.0-only"
+ ],
+ "description": "ODT document generator (plugin replacement for cybermonde/odtphp)",
+ "homepage": "https://github.com/sboden/odtphp",
+ "keywords": [
+ "odt",
+ "php"
+ ],
+ "support": {
+ "issues": "https://github.com/sboden/odtphp/issues",
+ "source": "https://github.com/sboden/odtphp/tree/3.2.1"
+ },
+ "install-path": "../sboden/odtphp"
+ }
+ ],
+ "dev": false,
+ "dev-package-names": []
+}
diff --git a/vendor/composer/installed.php b/vendor/composer/installed.php
new file mode 100644
index 0000000000..e2b4cc5381
--- /dev/null
+++ b/vendor/composer/installed.php
@@ -0,0 +1,32 @@
+ array(
+ 'name' => 'glpi-plugin/order',
+ 'pretty_version' => 'dev-main',
+ 'version' => 'dev-main',
+ 'reference' => 'c374176bdbf3b6233b19d2116e3693b7ea046af4',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../../',
+ 'aliases' => array(),
+ 'dev' => false,
+ ),
+ 'versions' => array(
+ 'glpi-plugin/order' => array(
+ 'pretty_version' => 'dev-main',
+ 'version' => 'dev-main',
+ 'reference' => 'c374176bdbf3b6233b19d2116e3693b7ea046af4',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../../',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'sboden/odtphp' => array(
+ 'pretty_version' => '3.2.1',
+ 'version' => '3.2.1.0',
+ 'reference' => '989e51fa6edaaf9010b27aa14c5556ca4f14f6f2',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../sboden/odtphp',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ ),
+);
diff --git a/vendor/composer/platform_check.php b/vendor/composer/platform_check.php
new file mode 100644
index 0000000000..14bf88da3a
--- /dev/null
+++ b/vendor/composer/platform_check.php
@@ -0,0 +1,25 @@
+= 80200)) {
+ $issues[] = 'Your Composer dependencies require a PHP version ">= 8.2.0". You are running ' . PHP_VERSION . '.';
+}
+
+if ($issues) {
+ if (!headers_sent()) {
+ header('HTTP/1.1 500 Internal Server Error');
+ }
+ if (!ini_get('display_errors')) {
+ if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
+ fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL);
+ } elseif (!headers_sent()) {
+ echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL;
+ }
+ }
+ throw new \RuntimeException(
+ 'Composer detected issues in your platform: ' . implode(' ', $issues)
+ );
+}
diff --git a/vendor/sboden/odtphp/.gitattributes b/vendor/sboden/odtphp/.gitattributes
new file mode 100644
index 0000000000..2f673eb9b3
--- /dev/null
+++ b/vendor/sboden/odtphp/.gitattributes
@@ -0,0 +1,65 @@
+# Drupal git normalization
+# @see https://www.kernel.org/pub/software/scm/git/docs/gitattributes.html
+# @see https://www.drupal.org/node/1542048
+
+# Normally these settings would be done with macro attributes for improved
+# readability and easier maintenance. However macros can only be defined at the
+# repository root directory. Drupal avoids making any assumptions about where it
+# is installed.
+
+# Define text file attributes.
+# - Treat them as text.
+# - Ensure no CRLF line-endings, neither on checkout nor on checkin.
+# - Detect whitespace errors.
+# - Exposed by default in `git diff --color` on the CLI.
+# - Validate with `git diff --check`.
+# - Deny applying with `git apply --whitespace=error-all`.
+# - Fix automatically with `git apply --whitespace=fix`.
+
+*.config text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.css text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.dist text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.engine text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.html text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=html
+*.inc text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.install text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.js text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.json text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.lock text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.map text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.md text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.module text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.php text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.po text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.profile text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.script text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.sh text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.sql text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.svg text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.theme text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2 diff=php linguist-language=php
+*.twig text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.txt text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.xml text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+*.yml text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tab-in-indent,tabwidth=2
+
+# PHPStan's baseline uses tabs instead of spaces.
+core/.phpstan-baseline.php text eol=lf whitespace=blank-at-eol,-blank-at-eof,-space-before-tab,tabwidth=2 diff=php linguist-language=php
+
+# Define binary file attributes.
+# - Do not treat them as text.
+# - Include binary diff in patches instead of "binary files differ."
+*.eot binary -text diff
+*.exe binary -text diff
+*.gif binary -text diff
+*.gz binary -text diff
+*.ico binary -text diff
+*.jpeg binary -text diff
+*.jpg binary -text diff
+*.otf binary -text diff
+*.phar binary -text diff
+*.png binary -text diff
+*.svgz binary -text diff
+*.ttf binary -text diff
+*.woff binary -text diff
+*.woff2 binary -text diff
+*.odt binary -text diff
diff --git a/vendor/sboden/odtphp/.gitignore b/vendor/sboden/odtphp/.gitignore
new file mode 100644
index 0000000000..241f3f05e8
--- /dev/null
+++ b/vendor/sboden/odtphp/.gitignore
@@ -0,0 +1,11 @@
+vendor/
+build/
+bin/
+.idea/
+.github/
+.phpunit.result.cache
+test-results.xml
+
+# Commit your application's lock file http://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file
+# You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file
+composer.lock
diff --git a/vendor/sboden/odtphp/LICENSE b/vendor/sboden/odtphp/LICENSE
new file mode 100755
index 0000000000..9cecc1d466
--- /dev/null
+++ b/vendor/sboden/odtphp/LICENSE
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. .
diff --git a/vendor/sboden/odtphp/README.md b/vendor/sboden/odtphp/README.md
new file mode 100644
index 0000000000..3866e116aa
--- /dev/null
+++ b/vendor/sboden/odtphp/README.md
@@ -0,0 +1,494 @@
+# ODTPHP
+
+A PHP library for creating and manipulating ODT (OpenDocument Text) files.
+
+## Requirements
+
+- PHP 8.1 or higher
+- PHP ZIP Extension or PclZip library. PHP ZIP Extension is recommended as we will probably
+ remove the PclZip library sometime in the future.
+
+## Installation
+
+Install via Composer:
+
+```bash
+composer require sboden/odtphp:^3
+```
+
+## Basic Usage
+
+### Simple Variable Substitution
+
+```php
+setVars('company_name', 'ACME Corporation');
+$odt->setVars('current_date', date('Y-m-d'));
+
+// Save the modified document
+$odt->saveToDisk('output.odt');
+```
+
+### Advanced Usage with Images and Segments
+
+```php
+ '{',
+ 'DELIMITER_RIGHT' => '}',
+];
+$odt = new Odf("invoice_template.odt", $config);
+
+// Insert a company logo
+$odt->setImage('company_logo', 'path/to/logo.png');
+
+// Create a repeatable segment for line items
+$lineItems = $odt->setSegment('invoice_items');
+foreach ($invoiceData['items'] as $item) {
+ $lineItems->setVars('item_name', $item->name);
+ $lineItems->setVars('item_price', number_format($item->price, 2));
+ $lineItems->setVars('item_quantity', $item->quantity);
+ $lineItems->merge();
+}
+
+// Set summary variables
+$odt->setVars('total_amount', number_format($invoiceData['total'], 2));
+$odt->setVars('invoice_number', $invoiceData['number']);
+
+// Save the completed invoice
+$odt->saveToDisk('invoice.odt');
+```
+
+### Custom Properties
+
+You can set custom document properties in your ODT file using the `setCustomProperty()` method:
+
+```php
+$odf->setCustomProperty('Author', 'John Doe');
+$odf->setCustomProperty('Version', '1.0');
+```
+
+Important notes about custom properties:
+- It's recommended to use only strings for custom properties. The reason is that the value will be replaced by odtphp,
+ but the value is supposed to be in the internal format as defined by odt for that particular type. Odtphp only
+ replaces the value of the custom property, odtphp will not do data conversions.
+- For dates e.g., make sure to use YYYY-MM-DD as format as that is what ODT wants as internal date format.
+- Special characters will be HTML encoded by default.
+- Properties must exist in the document before they can be set.
+- Setting custom properties works when using LibreOffice/OpenOffice only. It seems to fail using Microsoft Word as
+ Microsoft Word does not update the custom property values upon opening an ODT file.
+- Newlines are not supported in custom property values because the LibreOffice GUI does not allow newlines.
+ setCustomProperty() will happily insert newlines and the newlines will also be outputted, but this
+ "unofficial" functionality which may be blocked in the future by ODT.
+
+Examples:
+```php
+// Basic string properties
+$odf->setCustomProperty('Author', 'John Doe');
+$odf->setCustomProperty('Department', 'Engineering');
+
+// Dates should use YYYY-MM-DD format
+$odf->setCustomProperty('Creation Date', '2024-01-20');
+
+// Special characters are encoded by default
+$odf->setCustomProperty('Note', ' & urgent'); // Will be encoded
+$odf->setCustomProperty('Note', ' & urgent', FALSE); // Won't be encoded
+```
+
+### Images
+
+You can insert images into your ODT file using different measurement units:
+
+```php
+// Using centimeters (original function)
+$odf->setImage('logo', 'path/to/logo.png', -1, 5, 7.5); // 5cm width, 7.5cm height
+$odf->setImage('photo', 'path/to/photo.jpg', 1, 10, 15, 2, 2); // On page 1 with 2cm offsets
+
+// Using millimeters
+$odf->setImageMm('logo', 'path/to/logo.png', -1, 50, 75); // 50mm width, 75mm height
+$odf->setImageMm('photo', 'path/to/photo.jpg', 1, 100, 150, 20, 20); // On page 1 with 20mm offsets
+
+// Using pixels (automatically converts to mm)
+$odf->setImagePixel('logo', 'path/to/logo.png', -1, 189, 283); // 189px ≈ 5cm, 283px ≈ 7.5cm
+$odf->setImagePixel('photo', 'path/to/photo.jpg', 1, 378, 567, 76, 76); // On page 1 with 76px offsets
+
+// Keep original image size
+$odf->setImage('icon1', 'path/to/icon.png'); // Will convert to cm
+$odf->setImageMm('icon2', 'path/to/icon.png'); // Will convert to mm
+$odf->setImagePixel('icon3', 'path/to/icon.png'); // Will keep original pixel dimensions
+```
+
+Parameters for all image functions:
+- `$key`: Name of the variable in the template
+- `$value`: Path to the image file
+- `$page`: Page number (-1 for as-char anchoring)
+- `$width`: Width in respective units (null to keep original)
+- `$height`: Height in respective units (null to keep original)
+- `$offsetX`: Horizontal offset (ignored if $page is -1)
+- `$offsetY`: Vertical offset (ignored if $page is -1)
+
+Note: While `setImagePixel` accepts measurements in pixels, the ODT format requires millimeters or
+centimeters internally. The function automatically converts pixel measurements to the appropriate
+format.
+
+### Error Handling
+
+```php
+setVars('non_existent_variable', 'Some Value');
+} catch (OdfException $e) {
+ // Handle template-related errors
+ error_log("ODT Processing Error: " . $e->getMessage());
+}
+```
+
+### Testing
+
+1. Install dependencies:
+```
+composer install
+```
+
+2. Run the tests:
+
+On Linux:
+```bash
+# Go to the root of odtphp, then:
+./run-tests.sh
+```
+
+On Windows:
+```bash
+# Go to the root of odtphp, then:
+run-tests.bat
+
+# Note that depending on your PHP installation you may have to edit the
+# script to include the path to php.exe
+```
+
+You can also run the PHPUnit tests e.g. in PHPStorm, but you have to exclude
+the vendor directory to avoid warnings about the PHPUnit framework itself.
+
+
+#### Test Structure
+
+The test suite covers various aspects of the ODT templating functionality:
+
+1. **Basic Tests** (`Basic1Test.php` and `Basic2Test.php`):
+ - Verify basic variable substitution in ODT templates
+ - Test both PhpZip and PclZip ZIP handling methods
+ - Demonstrate simple text replacement and encoding
+
+2. **Configuration Tests** (`ConfigTest.php`):
+ - Validate configuration handling
+ - Test custom delimiters
+ - Check error handling for invalid configurations
+
+3. **Edge Case Tests** (`EdgeCaseTest.php`):
+ - Handle complex scenarios like:
+ * Large variable substitution
+ * Nested segment merging
+ * Special character encoding
+ * Advanced image insertion
+ * Invalid template handling
+
+4. **Image Tests** (`ImageTest.php`):
+ - Verify image insertion functionality
+ - Test image resizing
+ - Check error handling for invalid image paths
+
+5. **Variable Tests** (`VariableTest.php`):
+ - Test variable existence checks
+ - Verify special character handling
+ - Check multiline text substitution
+
+5. **Custom Property Test** (`SetCustomPropertyTest.php`):
+ - Test custom propertyfunctionality
+
+Each test is designed to ensure the robustness and reliability of the ODT
+templating library across different use cases and configurations.
+
+A lot of tests run twice:
+- Once using PclZip library
+- Once using PHP's native Zip extension
+
+The tests generate ODT files and compare them with gold standard files located in:
+- `tests/src/files/gold_phpzip/` - Gold files for PHP Zip tests
+- `tests/src/files/gold_pclzip/` - Gold files for PclZip tests
+
+
+### Linting
+
+On Linux:
+```bash
+# Go to the root of odtphp, then:
+composer install
+vendor/bin/phpcs --standard="Drupal,DrupalPractice" -n --extensions="php,module,inc,install,test,profile,theme" src
+```
+
+
+## Features
+
+- Template variable substitution
+- Image insertion and manipulation
+- Segment management for repeatable content
+- Support for custom delimiters
+- Type-safe implementation
+- Modern PHP 8.1+ features
+
+## Configuration
+
+```php
+$config = [
+ 'ZIP_PROXY' => \Odtphp\Zip\PhpZipProxy::class, // or PclZipProxy
+ 'DELIMITER_LEFT' => '{',
+ 'DELIMITER_RIGHT' => '}',
+ 'PATH_TO_TMP' => '/tmp'
+];
+
+$odt = new Odf("template.odt", $config);
+```
+
+## Type Safety
+
+This library is built with PHP 8.1's type system in mind:
+- Strict typing enabled
+- Property type declarations
+- Return type declarations
+- Parameter type hints
+- Improved error handling
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
+
+The GPL-3.0 license is because of what the cybermonde/odtphp author put it
+to, I (sboden) don't want to change it. I don't consider odtphp to be "my" software, I
+only tried to make the cybermonde/odtphp fork work properly in PHP v8.3
+and beyond.
+
+Personally (sboden) I would have used an MIT or BSD license for odtphp, but I
+will happily abide with the original author's intent.
+
+The original version/source code of odtphp is at [https://sourceforge.
+net/projects/odtphp/](https://sourceforge.net/projects/odtphp/). The
+cybermonde/odtphp fork I started from is at [https://github.
+com/cybermonde/odtphp](https://github.com/cybermonde/odtphp).
+
+
+### Usage justification
+How and why we use odtphp in our projects.
+
+Some of our projects send out letters (either PDF or on physical paper) to people:
+the idea is to have a nice template, fill in some data, create a PDF file from the
+filled-in template, and send the resulting PDF to the recipient.
+
+The template is an ODT file, the data is stored in a database. We use odtphp to fill
+in the template. The filled-in ODT file is then transformed into a PDF file using
+(originally) jodconverter, and in newer projects using gotenberg.dev (which is
+essentially jodconverter using golang). The PDF converters run in a different
+container than the main applications.
+
+The reason for using gotenberg over jodconverter is that gotenberg is better
+supported. And jodconverter was initially not able to handle large volumes since
+the most commonly used Docker container did not clean up after itself, so I had to
+build this in myself.
+
+Why not generate PDFs directly from PHP? We tried, but it's difficult to
+have nice-looking PDFs using the existing PHP libraries. One PHP library has
+problems with images, another PHP PDF library faces issues with margins and
+headers/footers, ... We tried a lot of different setups and finally settled
+for odtphp/gotenberg to have the PDF output "pixel perfect". Another
+limitation was that we needed about 50,000 PDFs per day for which we run
+parallel queues to the PDF converters.
+
+
+### Technical informations
+
+#### Why do my variables sometimes not get filled in?
+
+Because LibreOffice adds metadata to text that you change. E.g. when you have
+something as follows in your ODT file:
+
+```
+{variable_text}
+```
+
+And you make a small change to the previous text it may very well end up as:
+
+```
+{variables _text}]
+```
+where you don't see the "text:span" part visually, but it is there. And since
+odtphp plainly matches variables in an ODT file, the variable name will not match
+anymore and will not be replaced.
+
+How to get around that: When you change variable texts, select the variable
+text (including the begin and end delimiters), copy it, and then use "Paste
+special/Paste unformatted text" to copy the text in the same place without any
+invisible metadata.
+
+#### Variables vs Custom Properties
+
+ODT files support two different ways to insert dynamic content: variables and custom properties.
+
+#### Variables
+Variables are an ODTPhp feature that works by replacing text anchors (like `{variable_name}`) with new content:
+```php
+$odf->setVars('company_name', 'ACME Corporation');
+$odf->setImage('logo', 'path/to/logo.png', -1, 50, 75); // 50mm width, 75mm height
+```
+
+Key points about variables:
+- Variables are specific to ODTPhp, variables are not a feature of the ODT specification
+- Work as simple text replacements in the document
+- Support images through `setImage`, `setImageMm`, and `setImagePixel` functions
+- Can be affected by LibreOffice's invisible metadata when editing the template (see previous topic)
+- Must be surrounded by delimiters (default: `{` and `}`)
+- Can be used anywhere in the document text
+
+#### Custom Properties
+Custom properties are an official ODT feature for storing (usually) metadata about the document:
+```php
+$odf->setCustomProperty('Author', 'John Doe');
+$odf->setCustomProperty('Version', '1.0');
+```
+
+Key points about custom properties:
+- Official ODT feature supported by all ODT-compatible software
+- Stored in the document's meta.xml file
+- Not affected by LibreOffice's invisible metadata
+- Must exist in the document before they can be set
+- Cannot be used with image functions
+- Must be created through the LibreOffice GUI (File > Properties > Custom Properties)
+
+When to use which:
+- Use variables for:
+ * Any text content in the document body
+ * Images and other media
+ * Dynamic content that needs formatting
+ * Repeatable segments
+
+- Use custom properties for:
+ * Small single line text fields: name, address line 1, address line2, postal code, city, ...
+
+
+#### Why does "Catégorie 1" sometimes appear as "Catégorie 1" in the output?
+
+Usually this is a double-encoding problem. When UTF-8 text is encoded again
+as UTF-8, special characters like 'é' can appear as 'é'. This typically
+happens when the text is already in UTF-8 but gets encoded again.
+
+While setting variables you can specify the encoding as needed, e.g. as:
+
+```php
+$categorie->setVars('TitreCategorie', 'Catégorie 1', true, 'UTF-8');
+```
+
+#### The default charset has changed?
+
+One of the "major" changes I made is to put UTF-8 as the default charset when
+setting variables. Before the default was ISO-8859-1, but UTF-8 currently
+makes more sense to me.
+
+I always recommend using UTF-8 internally within the application and
+handling encoding/decoding at the boundaries.
+
+#### How do I upgrade from v1/v2 to v3?
+
+While it is a breaking change, as long as you only use `odtphp` and don't use
+any of its internals you should be fine by just upgrading the odtphp library
+to v3.
+
+If you inherit from Odf or you use some internal things in the odtphp library,
+then all bets are off.
+
+### History
+
+The odtphp project was initially started by Julien Pauli, Olivier Booklage,
+Vincent Brouté and published at http://www.odtphp.com (the website no longer
+exists).
+
+As DXC Technology working for the Flemish government we started using
+the `cybermonde/odtphp` fork ([source](https://github.com/cybermonde/odtphp))
+in a couple of projects to fill in template ODT files with data, then transforming
+the filled-in ODT to PDF using `gotenberg`.
+We ran into a couple of problems with the `cybermonde/odtphp` library for
+which it was easier to just create my own fork, hence `sboden/odtphp`: we
+sometimes generate 50,000 forms daily, and `cybermonde/odtphp` would
+occasionally overwrite outputs when processing a lot of ODT files
+simultaneously (because of non-random random numbers).
+
+Why do I try to keep this "corpse" alive? Simply because I found no
+replacement for it. The projects I work that use odtphp are now (= end 2024) on
+PHP 8.2 moving to PHP 8.3, and some pieces of the original odtphp library
+are starting to spew warnings. During my 2024 Christmas holidays I was
+writing some unit test cases for odtphp, and while testing the AI tool
+"Windsurf", I tried to have Windsurf automatically update odtphp to a newer
+PHP version, and sboden/odtphp v3 is the result of that (after some extra
+manual human changes).
+
+While this fork `sboden/odtphp` is not officially supported, maintenance
+and bug fixes are provided on a best-effort basis. The `sboden/odtphp` library
+is actively used in production applications with planned lifecycles extending
+to at least 2030.
+
+This software is **not** by DXC Technology, else it would have been called
+`dxc/odtphp`. This software is **not** by the Flemish government, else it
+would probably have been called `vo/odtphp`. I have always worked on odtphp
+during my personal time.
+
+### Upgrade plan
+- From v3.0.3 upto v3.2.1:
+ There should be no issues in upgrading sboden/odtphp, only new functionality
+ and some small bugfixes were done.
+
+### Version History
+- v3.2.1 - 24Jul2025: Small edge case fix in Odf::recursiveHtmlspecialchars()
+- v3.2.0 - 24Mar2025: Introduction of customPropertyExists()
+- v3.1.0 - 21Mar2025: Introduction of functions setCustomProperty()/setImageMm()/setImagePixel()
+- v3.0.3 - 29Dec2024: Odtphp version for PHP 8.x
+- v2.2.1 - 07Dec2022: Parallel processing by odtphp does not overwrite outputs
+
+### Disclaimer
+
+This software is provided "as is" without warranty of any kind, either
+expressed or implied. The entire risk as to the quality and performance of
+the software is with you.
+
+In no event will the authors, contributors, or licensors be liable for any
+damages, including but not limited to, direct, indirect, special, incidental,
+or consequential damages arising out of the use or inability to use this
+software, even if advised of the possibility of such damage.
+
+By using this software, you acknowledge that you have read this disclaimer,
+understand it, and agree to be bound by its terms.
+
+
+### Links:
+
+* http://sourceforge.net/projects/odtphp/ Sourceforge Project of the initial library (stale)
+
+[1]: http://vikasmahajan.wordpress.com/2010/12/09/odtphp-bug-solved/
+[2]: https://web.archive.org/web/20120531095719/http://www.odtphp.com/index.php?i=home
+[3]: https://en.wikipedia.org/wiki/OpenDocument_software#Text_documents_.28.odt.29
diff --git a/vendor/sboden/odtphp/composer.json b/vendor/sboden/odtphp/composer.json
new file mode 100755
index 0000000000..66dec65985
--- /dev/null
+++ b/vendor/sboden/odtphp/composer.json
@@ -0,0 +1,45 @@
+{
+ "name": "sboden/odtphp",
+ "description": "ODT document generator (plugin replacement for cybermonde/odtphp)",
+ "keywords": [
+ "odt",
+ "php"
+ ],
+ "license": "GPL-3.0-only",
+ "type": "library",
+ "homepage": "https://github.com/sboden/odtphp",
+ "require": {
+ "php": ">=8.1"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "^1.0",
+ "drupal/coder": "^8.3",
+ "phpunit/phpunit": "^10.4",
+ "scrutinizer/ocular": "^1.9",
+ "symfony/var-dumper": "^6.4"
+ },
+ "autoload": {
+ "psr-4": {
+ "Odtphp\\": "src"
+ },
+ "files": ["lib/pclzip.lib.php"]
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Odtphp\\Test\\": "tests"
+ },
+ "files": ["lib/pclzip.lib.php"]
+ },
+ "config": {
+ "sort-packages": true,
+ "optimize-autoloader": true,
+ "allow-plugins": {
+ "dealerdirect/phpcodesniffer-composer-installer": true
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "2.0-dev"
+ }
+ }
+}
diff --git a/vendor/sboden/odtphp/documentation/odtphp_documentation.pdf b/vendor/sboden/odtphp/documentation/odtphp_documentation.pdf
new file mode 100755
index 0000000000..8e78454f64
Binary files /dev/null and b/vendor/sboden/odtphp/documentation/odtphp_documentation.pdf differ
diff --git a/vendor/sboden/odtphp/examples/form.php b/vendor/sboden/odtphp/examples/form.php
new file mode 100755
index 0000000000..8315cf73f5
--- /dev/null
+++ b/vendor/sboden/odtphp/examples/form.php
@@ -0,0 +1,67 @@
+//////////////////////////////////////////////////////////////
+// ODT Letter Generation Based on a Form //
+// //
+// Laurent Lefèvre - http://www.cybermonde.org //
+// //
+//////////////////////////////////////////////////////////////
+
+// This is a left over example from cybermonde/odtphp, I left it
+// partially in French.
+
+use Odtphp\Odf;
+
+// Make sure you have Zip extension or PclZip library loaded.
+// First : include the library.
+require_once '../vendor/autoload.php';
+
+// base model
+$odf = new Odf("form_template.odt");
+// if nothing has been posted, show the form
+if (!$_POST) {
+?>
+
+
+
+ Form to ODT
+
+
+
+
+
+ tests/src
+
+
+
+
+ src
+
+
+ vendor
+
+
+
+
+
diff --git a/vendor/sboden/odtphp/run-tests.bat b/vendor/sboden/odtphp/run-tests.bat
new file mode 100755
index 0000000000..883007f2a7
--- /dev/null
+++ b/vendor/sboden/odtphp/run-tests.bat
@@ -0,0 +1,8 @@
+@echo off
+
+rem Assuming you're on Windows.
+rem Assuming you have php.exe in your path
+rem
+rem Add option "--debug" to get more output.
+
+php.exe phpunit-runner.php --configuration=phpunit.xml
diff --git a/vendor/sboden/odtphp/run-tests.sh b/vendor/sboden/odtphp/run-tests.sh
new file mode 100755
index 0000000000..53deed6340
--- /dev/null
+++ b/vendor/sboden/odtphp/run-tests.sh
@@ -0,0 +1,7 @@
+#/bin/bash
+
+#
+# Add option "--debug" to get more output.
+#
+
+vendor/bin/phpunit --configuration=phpunit.xml
diff --git a/vendor/sboden/odtphp/src/Attributes/AllowDynamicProperties.php b/vendor/sboden/odtphp/src/Attributes/AllowDynamicProperties.php
new file mode 100755
index 0000000000..d494290f45
--- /dev/null
+++ b/vendor/sboden/odtphp/src/Attributes/AllowDynamicProperties.php
@@ -0,0 +1,18 @@
+
+ */
+ protected array $config = [
+ 'ZIP_PROXY' => PhpZipProxy::class,
+ 'DELIMITER_LEFT' => '{',
+ 'DELIMITER_RIGHT' => '}',
+ 'PATH_TO_TMP' => NULL
+ ];
+
+ /**
+ * Content of the content.xml file.
+ */
+ protected string $contentXml = '';
+
+ /**
+ * Content of the manifest.xml file.
+ */
+ protected string $manifestXml = '';
+
+ /**
+ * Content of the styles.xml file.
+ */
+ protected string $stylesXml = '';
+
+ /**
+ * Content of the meta.xml file.
+ */
+ protected string $metaXml = '';
+
+ /**
+ * Temporary file path.
+ */
+ protected string $tmpfile = '';
+
+ /**
+ * Array of images used in the document.
+ *
+ * @var array
+ */
+ protected array $images = [];
+
+ /**
+ * Template variables.
+ *
+ * @var array
+ */
+ protected array $vars = [];
+
+ /**
+ * Manifest variables for image tracking.
+ *
+ * @var array
+ */
+ protected array $manifestVars = [];
+
+ /**
+ * Document segments.
+ *
+ * @var array
+ */
+ protected array $segments = [];
+
+ /**
+ * Initialize ODT document handling.
+ *
+ * @param string $filename
+ * Path to the ODT template file to process.
+ * @param array $config
+ * Configuration options for document processing.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the ODT file cannot be initialized or processed.
+ */
+ public function __construct(
+ protected readonly string $filename,
+ array $config = [],
+ ) {
+ // Merge and validate configuration.
+ $this->config = $this->mergeAndValidateConfig($config);
+
+ // Set default temporary directory if not provided.
+ if ($this->config['PATH_TO_TMP'] === NULL) {
+ $this->config['PATH_TO_TMP'] = sys_get_temp_dir();
+ }
+
+ // Validate configuration components.
+ $this->validateTemporaryDirectory();
+ $this->validateZipProxy();
+
+ // Initialize properties and process file.
+ $this->initializeProperties();
+ $this->processZipFile();
+ }
+
+ /**
+ * Merge and validate configuration options.
+ *
+ * @param array $config
+ * User-provided configuration.
+ *
+ * @return array
+ * Validated configuration array with default values merged.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * If configuration is invalid or cannot be processed.
+ */
+ private function mergeAndValidateConfig(array $config): array {
+ // Start with default configuration.
+ $mergedConfig = $this->config;
+
+ // Merge user configuration.
+ foreach ($config as $key => $value) {
+ $mergedConfig[$key] = $value;
+ }
+
+ return $mergedConfig;
+ }
+
+ /**
+ * Validate temporary directory configuration.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * If the temporary directory is invalid or inaccessible.
+ */
+ private function validateTemporaryDirectory(): void {
+ $path = $this->config['PATH_TO_TMP'];
+
+ if (!is_string($path)) {
+ throw new OdfException('Temporary directory path must be a string');
+ }
+
+ $path = rtrim($path, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR;
+
+ if (!is_dir($path)) {
+ throw new OdfException('Temporary directory does not exist');
+ }
+
+ if (!is_writable($path)) {
+ throw new OdfException('Temporary directory is not writable');
+ }
+
+ $this->config['PATH_TO_TMP'] = $path;
+ }
+
+ /**
+ * Validate ZIP proxy configuration.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * If the ZIP proxy class is invalid or does not implement the required interface.
+ *
+ * @return void
+ * Validates the ZIP proxy class configuration.
+ */
+ private function validateZipProxy(): void {
+ $zipProxyClass = $this->config['ZIP_PROXY'];
+
+ if (!class_exists($zipProxyClass)) {
+ throw new OdfException("ZIP proxy class does not exist: $zipProxyClass");
+ }
+
+ if (!is_subclass_of($zipProxyClass, ZipInterface::class)) {
+ throw new OdfException("$zipProxyClass must implement ZipInterface");
+ }
+ }
+
+ /**
+ * Initialize object properties with default values.
+ *
+ * @return void
+ * Initializes all internal object properties to their default values.
+ */
+ private function initializeProperties(): void {
+ $this->contentXml = '';
+ $this->manifestXml = '';
+ $this->stylesXml = '';
+ $this->metaXml = '';
+ $this->tmpfile = '';
+ $this->images = [];
+ $this->vars = [];
+ $this->manifestVars = [];
+ $this->segments = [];
+ }
+
+ /**
+ * Process the ZIP file and extract necessary XML contents.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * If the file cannot be processed or XML contents cannot be extracted.
+ *
+ * @return void
+ * Processes the ZIP file and extracts required XML contents.
+ */
+ private function processZipFile(): void {
+ // Validate file existence.
+ if (!file_exists($this->filename)) {
+ throw new OdfException("File '{$this->filename}' does not exist");
+ }
+
+ // Create ZIP handler.
+ $zipHandlerClass = $this->config['ZIP_PROXY'];
+ $this->file = new $zipHandlerClass($this->config['PATH_TO_TMP']);
+
+ // Open ZIP file.
+ if ($this->file->open($this->filename) !== TRUE) {
+ throw new OdfException("Error opening file '{$this->filename}'");
+ }
+
+ // Extract XML contents.
+ $this->extractXmlContents();
+
+ // Close the ZIP file.
+ $this->file->close();
+
+ // Create a temporary copy of the file.
+ $this->createTemporaryFileCopy();
+
+ // Process row segments.
+ $this->moveRowSegments();
+ }
+
+ /**
+ * Extract XML contents from the ZIP file.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * If XML content extraction fails or required files are missing.
+ *
+ * @return void
+ * Extracts and stores XML content from the ODT file.
+ */
+ private function extractXmlContents(): void {
+ // Extract content.xml.
+ $this->contentXml = $this->file->getFromName('content.xml');
+ if ($this->contentXml === FALSE) {
+ throw new OdfException("Error during content.xml extraction");
+ }
+
+ // Extract manifest.xml.
+ $this->manifestXml = $this->file->getFromName('META-INF/manifest.xml');
+ if ($this->manifestXml === FALSE) {
+ throw new OdfException("Error during manifest.xml extraction");
+ }
+
+ // Extract styles.xml.
+ $this->stylesXml = $this->file->getFromName('styles.xml');
+ if ($this->stylesXml === FALSE) {
+ throw new OdfException("Error during styles.xml extraction");
+ }
+
+ // Extract meta.xml.
+ $this->metaXml = $this->file->getFromName('meta.xml');
+ if ($this->metaXml === FALSE) {
+ throw new OdfException("Error during meta.xml extraction");
+ }
+ }
+
+ /**
+ * Create a temporary copy of the file for processing.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * If the temporary file cannot be created or copied.
+ *
+ * @return void
+ * Creates a temporary copy of the ODT file.
+ */
+ private function createTemporaryFileCopy(): void {
+ $this->tmpfile = tempnam($this->config['PATH_TO_TMP'], 'odtphp_');
+ if ($this->tmpfile === FALSE) {
+ throw new OdfException('Error creating temporary file');
+ }
+ copy($this->filename, $this->tmpfile);
+ }
+
+ /**
+ * Delete the temporary file when the object is destroyed.
+ *
+ * @return void
+ * Cleans up temporary files used during processing.
+ */
+ public function __destruct() {
+ if (file_exists($this->tmpfile)) {
+ unlink($this->tmpfile);
+ }
+ }
+
+ /**
+ * Assign a template variable.
+ *
+ * @param string $key
+ * Name of the variable within the template.
+ * @param string $value
+ * Replacement value for the variable.
+ * @param bool $encode
+ * Whether to encode special XML characters for safe XML output.
+ * @param string $charset
+ * Character set encoding of the input value (defaults to UTF-8).
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the variable is not found in the document.
+ *
+ * @return $this
+ * The current ODT object for method chaining.
+ */
+ public function setVars($key, $value, $encode = TRUE, $charset = 'UTF-8'): self {
+ $tag = $this->config['DELIMITER_LEFT'] . $key . $this->config['DELIMITER_RIGHT'];
+ if (strpos($this->contentXml, $tag) === FALSE && strpos($this->stylesXml, $tag) === FALSE) {
+ throw new OdfException("var $key not found in the document");
+ }
+
+ // Handle encoding.
+ $value = $encode ? $this->recursiveHtmlspecialchars($value) : $value;
+
+ // Convert to UTF-8 if not already.
+ if ($charset !== 'UTF-8') {
+ $value = mb_convert_encoding($value, 'UTF-8', $charset);
+ }
+
+ $this->vars[$tag] = str_replace("\n", "]*>(.*)#smU";
+ preg_match_all($reg1, $this->contentXml, $matches);
+ for ($i = 0, $size = count($matches[0]); $i < $size; $i++) {
+ // Check if the current row contains a segment row.*.
+ $reg2 = '#\[!--\sBEGIN\s(row.[\S]*)\s--\](.*)\[!--\sEND\s\\1\s--\]#smU';
+ if (preg_match($reg2, $matches[0][$i], $matches2)) {
+ $balise = str_replace('row.', '', $matches2[1]);
+ // Move segment tags around the row.
+ $replace = [
+ '[!-- BEGIN ' . $matches2[1] . ' --]' => '',
+ '[!-- END ' . $matches2[1] . ' --]' => '',
+ ' '[!-- BEGIN ' . $balise . ' --]' => '[!-- END ' . $balise . ' --]'
+ ];
+ $replacedXML = str_replace(array_keys($replace), array_values($replace), $matches[0][$i]);
+ $this->contentXml = str_replace($matches[0][$i], $replacedXML, $this->contentXml);
+ }
+ }
+ }
+
+ /**
+ * Merge template variables.
+ *
+ * Called automatically for a save operation.
+ *
+ * @return void
+ * Processes and updates the internal XML content with merged variables.
+ */
+ private function parse(): void {
+ $this->contentXml = str_replace(array_keys($this->vars), array_values($this->vars), $this->contentXml);
+ $this->stylesXml = str_replace(array_keys($this->vars), array_values($this->vars), $this->stylesXml);
+ }
+
+ /**
+ * Add the merged segment to the document.
+ *
+ * @param \Odtphp\Segment $segment
+ * The segment to merge.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the segment cannot be merged or has not been set.
+ *
+ * @return $this
+ * The current ODT object instance.
+ */
+ public function mergeSegment(Segment $segment): self {
+ if (!array_key_exists($segment->getName(), $this->segments)) {
+ throw new OdfException($segment->getName() . ' cannot be parsed, has it been set yet?');
+ }
+ $string = $segment->getName();
+ $reg = '@\[!--\sBEGIN\s' . $string . '\s--\](.*)\[!--.+END\s' . $string . '\s--\]@smU';
+ $this->contentXml = preg_replace($reg, $segment->getXmlParsed(), $this->contentXml);
+ foreach ($segment->manifestVars as $val) {
+ // Copy all segment image names into current array.
+ $this->manifestVars[] = $val;
+ }
+ return $this;
+ }
+
+ /**
+ * Display all the current template variables.
+ *
+ * @return string
+ * The formatted string containing all template variables.
+ */
+ public function printVars(): string {
+ return print_r('' . print_r($this->vars, TRUE) . ' ', TRUE);
+ }
+
+ /**
+ * Display the XML content of the file from ODT document as it is at the moment.
+ *
+ * @return string
+ * The XML content of the ODT document.
+ */
+ public function __toString(): string {
+ return $this->contentXml;
+ }
+
+ /**
+ * Display loop segments declared with setSegment().
+ *
+ * @return string
+ * Space-separated list of declared segments.
+ */
+ public function printDeclaredSegments(): string {
+ return '' . print_r(implode(' ', array_keys($this->segments)), TRUE) . ' ';
+ }
+
+ /**
+ * Check if the specified segment exists in the document.
+ *
+ * @param string $segment
+ * The name of the segment to check.
+ *
+ * @return bool
+ * TRUE when segment exists, FALSE otherwise.
+ */
+ public function segmentExists($segment): bool {
+ $reg = "#\[!--\sBEGIN\s$segment\s--](.*?)\[!--\sEND\s$segment\s--]#smU";
+ return preg_match($reg, html_entity_decode($this->contentXml), $m) != 0;
+ }
+
+ /**
+ * Declare a segment in order to use it in a loop.
+ *
+ * @param string $segment
+ * The name of the segment to declare.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the segment cannot be found in the document.
+ *
+ * @return \Odtphp\Segment
+ * The requested segment object for use in a loop.
+ */
+ public function setSegment($segment): Segment {
+ if (array_key_exists($segment, $this->segments)) {
+ return $this->segments[$segment];
+ }
+ $reg = "#\[!--\sBEGIN\s$segment\s--\](.*?)\[!--\sEND\s$segment\s--\]#smU";
+ if (preg_match($reg, html_entity_decode($this->contentXml), $m) == 0) {
+ throw new OdfException("'$segment' segment not found in the document");
+ }
+ $this->segments[$segment] = new Segment($segment, $m[1], $this);
+ return $this->segments[$segment];
+ }
+
+ /**
+ * Save the ODT file to disk.
+ *
+ * @param string|null $file
+ * Name of the desired file. If null, uses the original filename.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the file cannot be saved to disk.
+ *
+ * @return void
+ * Saves the ODT file to the specified location.
+ */
+ public function saveToDisk($file = NULL): void {
+ $this->saveInternal();
+ if ($file === NULL) {
+ $file = $this->filename;
+ }
+ copy($this->tmpfile, $file);
+ }
+
+ /**
+ * Export the file as an attached file via HTTP.
+ *
+ * @param string $name
+ * Optional name for the downloaded file.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the file cannot be exported or sent via HTTP.
+ *
+ * @return void
+ * Sends the ODT file as an HTTP attachment.
+ */
+ public function exportAsAttachedFile($name = ""): void {
+ $this->saveInternal();
+ if (empty($name)) {
+ $name = basename($this->filename);
+ }
+ header('Content-type: application/vnd.oasis.opendocument.text');
+ header('Content-Disposition: attachment; filename="' . $name . '"');
+ readfile($this->tmpfile);
+ }
+
+ /**
+ * Save internal ODT file state.
+ *
+ * @throws \Odtphp\Exceptions\OdfException
+ * When the internal file state cannot be saved.
+ *
+ * @return void
+ * Updates the internal ODT file state with current changes.
+ */
+ private function saveInternal(): void {
+ $this->file->open($this->tmpfile);
+ $this->parse();
+ if (!$this->file->addFromString('content.xml', $this->contentXml) || !$this->file->addFromString('styles.xml', $this->stylesXml)) {
+ throw new OdfException('Error during file export addFromString');
+ }
+ // Find second last newline in the manifest.xml file.
+ $lastpos = strrpos($this->manifestXml, "\n", -15);
+ $manifdata = "";
+
+ // Enter all images description in $manifdata variable.
+ foreach ($this->manifestVars as $val) {
+ $ext = substr(strrchr($val, '.'), 1);
+ $manifdata = $manifdata . '
+ * The complete configuration array.
+ */
+ public function getAllConfig(): array {
+ return $this->config;
+ }
+
+ /**
+ * Returns the temporary working file.
+ *
+ * @return string
+ * The path to the temporary working file.
+ */
+ public function getTmpfile(): string {
+ return $this->tmpfile;
+ }
+
+ /**
+ * Get the pixel to centimeter conversion ratio.
+ *
+ * @return float
+ * The pixel to centimeter conversion ratio.
+ */
+ public function getPixelToCm(): float {
+ return self::PIXEL_TO_CM;
+ }
+
+ /**
+ * Recursive htmlspecialchars.
+ *
+ * @param mixed $value
+ * The value to convert.
+ *
+ * @return mixed
+ * The converted value.
+ */
+ protected function recursiveHtmlspecialchars($value): mixed {
+ if (is_array($value)) {
+ return array_map([$this, 'recursiveHtmlspecialchars'], $value);
+ }
+ else {
+ return htmlspecialchars((string) ($value ?? ''));
+ }
+ }
+
+ /**
+ * Function to set custom properties in the ODT file's meta.xml.
+ *
+ * @param string $key
+ * Name of the variable within the template.
+ * @param string $value
+ * Replacement value for the variable.
+ * @param bool $encode
+ * Whether to encode special XML characters for safe XML output.
+ * @param string $charset
+ * Character set encoding of the input value (defaults to UTF-8).
+ */
+ public function setCustomProperty($key, $value, $encode = TRUE, $charset = 'UTF-8'): self {
+ if (!is_string($key) || !is_string($value)) {
+ throw new OdfException('Key and value must be strings');
+ }
+
+ if ($encode) {
+ $value = htmlspecialchars($value, ENT_QUOTES | ENT_XML1, $charset);
+ }
+
+ // Convert to UTF-8 if not already.
+ if ($charset !== 'UTF-8') {
+ $value = mb_convert_encoding($value, 'UTF-8', $charset);
+ }
+
+ try {
+ // Create the pattern to match the existing custom property.
+ $pattern = '/]*?)meta:name="' . preg_quote($key, '/') . '"([^>]*?)>.*?<\/meta:user-defined>/';
+
+ // Check if property exists and update it.
+ if (preg_match($pattern, $this->metaXml, $matches)) {
+ // Preserve the existing attributes.
+ $attributes = $matches[1] . 'meta:name="' . $key . '"' . $matches[2];
+
+ // Create the replacement custom property with preserved attributes.
+ $replacement = '' . $value . ' ';
+
+ // Replace the property.
+ $this->metaXml = preg_replace($pattern, $replacement, $this->metaXml);
+
+ // Open the temporary file and update meta.xml.
+ if ($this->file->open($this->tmpfile) !== TRUE) {
+ throw new OdfException('Error opening file');
+ }
+
+ if (!$this->file->addFromString('meta.xml', $this->metaXml)) {
+ throw new OdfException('Error updating meta.xml file');
+ }
+
+ $this->file->close();
+ }
+ else {
+ throw new OdfException("Custom property '$key' not found in meta.xml");
+ }
+
+ return $this;
+ }
+ catch (\ValueError $e) {
+ throw new OdfException('Error during metadata operation');
+ }
+ }
+
+ /**
+ * Get the ZIP file handler.
+ *
+ * @return \Odtphp\Zip\ZipInterface
+ * The ZIP file handler.
+ */
+ public function getFile(): ZipInterface {
+ return $this->file;
+ }
+
+ /**
+ * Get the meta XML content.
+ *
+ * @return string
+ * The meta XML content.
+ */
+ public function getMetaXml(): string {
+ return $this->metaXml;
+ }
+
+ /**
+ * Check if a custom property exists in the ODT file.
+ *
+ * @param string $key The name of the custom property to check
+ * @return bool TRUE if the property exists, FALSE otherwise
+ */
+ public function customPropertyExists(string $key): bool
+ {
+ // HTML encode the key for XML comparison
+ $encodedKey = htmlspecialchars($key, ENT_QUOTES | ENT_XML1);
+
+ // Pattern to match custom property with the given name
+ $pattern = '/]*?)meta:name="' . preg_quote($encodedKey, '/') . '"([^>]*?)>/';
+
+ // Check if the pattern exists in metaXml
+ return (bool) preg_match($pattern, $this->metaXml);
+ }
+
+}
diff --git a/vendor/sboden/odtphp/src/Segment.php b/vendor/sboden/odtphp/src/Segment.php
new file mode 100755
index 0000000000..7f2f60ed4e
--- /dev/null
+++ b/vendor/sboden/odtphp/src/Segment.php
@@ -0,0 +1,381 @@
+name = (string) $name;
+ $this->xml = (string) $xml;
+ $this->odf = $odf;
+ $zipHandler = $this->odf->getConfig('ZIP_PROXY');
+ $this->file = new $zipHandler();
+ $this->analyseChildren($this->xml);
+ }
+
+ /**
+ * Returns the name of the segment.
+ *
+ * @return string
+ * The name of the segment.
+ */
+ public function getName(): string {
+ return $this->name;
+ }
+
+ /**
+ * Checks if the segment has children.
+ *
+ * @return bool
+ * TRUE if the segment has children, FALSE otherwise.
+ */
+ public function hasChildren(): bool {
+ return !empty($this->children);
+ }
+
+ /**
+ * Implements the Countable interface.
+ *
+ * @return int
+ * Number of children in the segment.
+ */
+ #[\ReturnTypeWillChange]
+ public function count(): int {
+ return count($this->children);
+ }
+
+ /**
+ * Implements the IteratorAggregate interface.
+ *
+ * @return \RecursiveIteratorIterator
+ * Iterator for the segment's children.
+ */
+ #[\ReturnTypeWillChange]
+ public function getIterator(): \RecursiveIteratorIterator {
+ return new \RecursiveIteratorIterator(new SegmentIterator($this->children), 1);
+ }
+
+ /**
+ * Replace variables of the template in the XML code.
+ *
+ * All the children are also processed.
+ *
+ * @return string
+ * The merged XML content with variables replaced.
+ */
+ public function merge(): string {
+ $this->xmlParsed .= str_replace(array_keys($this->vars), array_values($this->vars), $this->xml);
+ if ($this->hasChildren()) {
+ foreach ($this->children as $child) {
+ $this->xmlParsed = str_replace($child->xml, ($child->xmlParsed == "") ? $child->merge() : $child->xmlParsed, $this->xmlParsed);
+ $child->xmlParsed = '';
+ // Store all image names used in child segments in current segment array.
+ foreach ($child->manifestVars as $file) {
+ $this->manifestVars[] = $file;
+ }
+
+ $child->manifestVars = [];
+ }
+ }
+ $reg = "/\[!--\sBEGIN\s$this->name\s--\](.*)\[!--\sEND\s$this->name\s--\]/smU";
+ $this->xmlParsed = preg_replace($reg, '$1', $this->xmlParsed);
+ $this->file->open($this->odf->getTmpfile());
+ foreach ($this->images as $imageKey => $imageValue) {
+ if ($this->file->getFromName('Pictures/' . $imageValue) === FALSE) {
+ $this->file->addFile($imageKey, 'Pictures/' . $imageValue);
+ }
+ }
+
+ $this->file->close();
+ return $this->xmlParsed;
+ }
+
+ /**
+ * Analyse the XML code to find children segments.
+ *
+ * @param string $xml
+ * XML content to analyse.
+ *
+ * @return $this
+ * The current segment instance.
+ */
+ protected function analyseChildren($xml): self {
+ $reg2 = "#\[!--\sBEGIN\s([\S]*)\s--\](.*)\[!--\sEND\s(\\1)\s--\]#smU";
+ preg_match_all($reg2, $xml, $matches);
+ for ($i = 0, $size = count($matches[0]); $i < $size; $i++) {
+ if ($matches[1][$i] != $this->name) {
+ $this->children[$matches[1][$i]] = new self($matches[1][$i], $matches[0][$i], $this->odf);
+ }
+ else {
+ $this->analyseChildren($matches[2][$i]);
+ }
+ }
+ return $this;
+ }
+
+ /**
+ * Assign a template variable to replace.
+ *
+ * @param string $key
+ * The variable key to replace.
+ * @param string $value
+ * The value to replace the variable with.
+ * @param bool $encode
+ * Whether to HTML encode the value.
+ * @param string $charset
+ * Character set for encoding.
+ *
+ * @throws \Odtphp\Exceptions\SegmentException
+ * If the variable is not found in the segment.
+ *
+ * @return $this
+ * The current segment instance.
+ */
+ public function setVars($key, $value, $encode = TRUE, $charset = 'UTF-8'): self {
+ if (strpos($this->xml, $this->odf->getConfig('DELIMITER_LEFT') . $key . $this->odf->getConfig('DELIMITER_RIGHT')) === FALSE) {
+ throw new SegmentException("var $key not found in {$this->getName()}");
+ }
+ $value = $encode ? htmlspecialchars($value) : $value;
+ $value = ($charset != 'UTF-8') ? mb_convert_encoding($value, 'UTF-8', $charset) : $value;
+ $this->vars[$this->odf->getConfig('DELIMITER_LEFT') . $key . $this->odf->getConfig('DELIMITER_RIGHT')] = str_replace("\n", " $segments
+ * Array of segments to iterate over.
+ */
+ public function __construct(
+ private readonly array $segments,
+ ) {}
+
+ /**
+ * Reset iterator position.
+ */
+ public function rewind(): void {
+ $this->position = 0;
+ }
+
+ /**
+ * Get current segment.
+ */
+ public function current(): Segment {
+ return $this->segments[$this->position];
+ }
+
+ /**
+ * Get current position.
+ */
+ public function key(): int {
+ return $this->position;
+ }
+
+ /**
+ * Move to next segment.
+ */
+ public function next(): void {
+ ++$this->position;
+ }
+
+ /**
+ * Check if current position is valid.
+ */
+ public function valid(): bool {
+ return isset($this->segments[$this->position]);
+ }
+
+ /**
+ * Get total number of segments.
+ */
+ public function count(): int {
+ return count($this->segments);
+ }
+
+}
diff --git a/vendor/sboden/odtphp/src/Zip/PclZipProxy.php b/vendor/sboden/odtphp/src/Zip/PclZipProxy.php
new file mode 100755
index 0000000000..eadc7dc617
--- /dev/null
+++ b/vendor/sboden/odtphp/src/Zip/PclZipProxy.php
@@ -0,0 +1,249 @@
+tmpDir = sys_get_temp_dir() . '/tmpdir_odtphp_' . uniqid(sprintf('%04X%04X%04X%04X%d',
+ mt_rand(0, 65535), mt_rand(0, 65535),
+ mt_rand(0, 65535), mt_rand(0, 65535), $pseudo_pid),
+ TRUE);
+ }
+
+ /**
+ * Open a Zip archive.
+ *
+ * @param string $filename
+ * The name of the archive to open.
+ *
+ * @return bool
+ * TRUE if opening has succeeded.
+ */
+ public function open($filename) {
+ if (TRUE === $this->opened) {
+ $this->close();
+ }
+ $this->filename = $filename;
+ $this->pclzip = new \PclZip($this->filename);
+ if (!file_exists($this->tmpDir)) {
+ if (mkdir($this->tmpDir)) {
+ // Created a new directory.
+ $this->opened = TRUE;
+ return TRUE;
+ }
+ else {
+ // Failed to create a directory.
+ $this->opened = FALSE;
+ return FALSE;
+ }
+ }
+ else {
+ // Directory already existed.
+ $this->opened = FALSE;
+ return FALSE;
+ }
+ }
+
+ /**
+ * Retrieve the content of a file within the archive from its name.
+ *
+ * @param string $name
+ * The name of the file to extract.
+ *
+ * @return string|bool
+ * The content of the file as a string, or FALSE if retrieval fails.
+ */
+ public function getFromName($name) {
+ if (FALSE === $this->opened) {
+ return FALSE;
+ }
+ $name = preg_replace("/(?:\.|\/)*(.*)/", "\\1", $name);
+ $extraction = $this->pclzip->extract(PCLZIP_OPT_BY_NAME, $name, PCLZIP_OPT_EXTRACT_AS_STRING);
+ if (!empty($extraction)) {
+ return $extraction[0]['content'];
+ }
+ return FALSE;
+ }
+
+ /**
+ * Add a file within the archive from a string.
+ *
+ * @param string $localname
+ * The local path to the file in the archive.
+ * @param string $contents
+ * The content of the file.
+ *
+ * @return bool
+ * TRUE if the file has been successfully added.
+ */
+ public function addFromString($localname, $contents) {
+ if (FALSE === $this->opened) {
+ return FALSE;
+ }
+ if (file_exists($this->filename) && !is_writable($this->filename)) {
+ return FALSE;
+ }
+ $localname = preg_replace("/(?:\.|\/)*(.*)/", "\\1", $localname);
+ $localpath = dirname($localname);
+ $tmpfilename = $this->tmpDir . '/' . basename($localname);
+ if (FALSE !== file_put_contents($tmpfilename, $contents)) {
+ $this->pclzip->delete(PCLZIP_OPT_BY_NAME, $localname);
+ $add = $this->pclzip->add($tmpfilename, PCLZIP_OPT_REMOVE_PATH, $this->tmpDir, PCLZIP_OPT_ADD_PATH, $localpath);
+ unlink($tmpfilename);
+ if (!empty($add)) {
+ return TRUE;
+ }
+ }
+ return FALSE;
+ }
+
+ /**
+ * Add a file within the archive from a file.
+ *
+ * @param string $filename
+ * The path to the file we want to add.
+ * @param string|null $localname
+ * The local path to the file in the archive.
+ *
+ * @return bool
+ * TRUE if the file has been successfully added.
+ */
+ public function addFile($filename, $localname = NULL) {
+ if (FALSE === $this->opened) {
+ return FALSE;
+ }
+ if ((file_exists($this->filename) && !is_writable($this->filename))
+ || !file_exists($filename)) {
+ return FALSE;
+ }
+ if (isset($localname)) {
+ $localname = preg_replace("/(?:\.|\/)*(.*)/", "\\1", $localname);
+ $localpath = dirname($localname);
+ $tmpfilename = $this->tmpDir . '/' . basename($localname);
+ }
+ else {
+ $localname = basename($filename);
+ $tmpfilename = $this->tmpDir . '/' . $localname;
+ $localpath = '';
+ }
+ if (file_exists($filename)) {
+ copy($filename, $tmpfilename);
+ $this->pclzip->delete(PCLZIP_OPT_BY_NAME, $localname);
+ $this->pclzip->add($tmpfilename, PCLZIP_OPT_REMOVE_PATH, $this->tmpDir, PCLZIP_OPT_ADD_PATH, $localpath);
+ unlink($tmpfilename);
+ return TRUE;
+ }
+ return FALSE;
+ }
+
+ /**
+ * Close the Zip archive.
+ *
+ * @return bool
+ * TRUE if the archive was closed successfully.
+ */
+ public function close() {
+ if (FALSE === $this->opened) {
+ return FALSE;
+ }
+ $this->pclzip = $this->filename = NULL;
+ $this->opened = FALSE;
+ if (file_exists($this->tmpDir)) {
+ $this->removeDir($this->tmpDir);
+ }
+ return TRUE;
+ }
+
+ /**
+ * Remove directory recursively.
+ *
+ * @param string $dir
+ * The directory to remove.
+ *
+ * @return bool
+ * TRUE if the directory was successfully removed.
+ */
+ private function removeDir($dir): bool {
+ if ($handle = opendir($dir)) {
+ while (FALSE !== ($file = readdir($handle))) {
+ if ($file != '.' && $file != '..') {
+ if (is_dir($dir . '/' . $file)) {
+ $this->removeDir($dir . '/' . $file);
+ rmdir($dir . '/' . $file);
+ }
+ else {
+ unlink($dir . '/' . $file);
+ }
+ }
+ }
+ closedir($handle);
+ }
+ return rmdir($dir);
+ }
+
+}
diff --git a/vendor/sboden/odtphp/src/Zip/PhpZipProxy.php b/vendor/sboden/odtphp/src/Zip/PhpZipProxy.php
new file mode 100755
index 0000000000..a80496c054
--- /dev/null
+++ b/vendor/sboden/odtphp/src/Zip/PhpZipProxy.php
@@ -0,0 +1,122 @@
+zipArchive = new \ZipArchive();
+ }
+
+ /**
+ * Open a Zip archive.
+ *
+ * @param string $filename
+ * The name of the archive to open.
+ *
+ * @return bool
+ * TRUE if opening has succeeded.
+ */
+ public function open($filename) {
+ $this->filename = $filename;
+ return $this->zipArchive->open($filename, \ZIPARCHIVE::CREATE);
+ }
+
+ /**
+ * Retrieve the content of a file within the archive from its name.
+ *
+ * @param string $name
+ * The name of the file to extract.
+ *
+ * @return string|bool
+ * The content of the file as a string, or FALSE if retrieval fails.
+ */
+ public function getFromName($name) {
+ return $this->zipArchive->getFromName($name);
+ }
+
+ /**
+ * Add a file within the archive from a string.
+ *
+ * @param string $localname
+ * The local path to the file in the archive.
+ * @param string $contents
+ * The content of the file.
+ *
+ * @return bool
+ * TRUE if the file has been successfully added.
+ */
+ public function addFromString($localname, $contents) {
+ if (file_exists($this->filename) && !is_writable($this->filename)) {
+ return FALSE;
+ }
+ return $this->zipArchive->addFromString($localname, $contents);
+ }
+
+ /**
+ * Add a file within the archive from a file.
+ *
+ * @param string $filename
+ * The path to the file we want to add.
+ * @param string|null $localname
+ * The local path to the file in the archive.
+ *
+ * @return bool
+ * TRUE if the file has been successfully added.
+ */
+ public function addFile($filename, $localname = NULL) {
+ if ((file_exists($this->filename) && !is_writable($this->filename))
+ || !file_exists($filename)) {
+ return FALSE;
+ }
+ return $this->zipArchive->addFile($filename, $localname);
+ }
+
+ /**
+ * Close the Zip archive.
+ *
+ * @return bool
+ * TRUE if the archive was closed successfully.
+ */
+ public function close() {
+ return $this->zipArchive->close();
+ }
+
+}
diff --git a/vendor/sboden/odtphp/src/Zip/ZipInterface.php b/vendor/sboden/odtphp/src/Zip/ZipInterface.php
new file mode 100755
index 0000000000..7d831de154
--- /dev/null
+++ b/vendor/sboden/odtphp/src/Zip/ZipInterface.php
@@ -0,0 +1,74 @@
+odfPhpZipConfig();
+ $gold_dir = 'gold_phpzip';
+ $type_name = 'PhpZip';
+ }
+ else {
+ $config = $this->odfPclZipConfig();
+ $gold_dir = 'gold_pclzip';
+ $type_name = 'PclZip';
+ }
+
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $odf->setVars('titre',
+ 'PHP: Hypertext Preprocessor');
+
+ $message = "PHP (sigle de PHP: Hypertext Preprocessor), est un langage de scripts libre
+principalement utilisé pour produire des pages Web dynamiques via un serveur HTTP, mais
+pouvant également fonctionner comme n'importe quel langage interprété de façon locale,
+en exécutant les programmes en ligne de commande.";
+
+ $odf->setVars('message', $message, TRUE, 'UTF-8');
+
+ $output_name = __DIR__ . "/files/output/BasicTest1" . $type_name . "Output.odt";
+ // We export the file
+ $odf->saveToDisk($output_name);
+
+ // print("\nComparing files:\n $output_name\n files/$gold_dir/BasicTest1Gold.odt\n");
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/$gold_dir/BasicTest1Gold.odt"));
+
+ unlink($output_name);
+ }
+
+ public function testBasicPclZip1(): void {
+ $this->basic1(self::PCLZIP_TYPE);
+ }
+
+ public function testBasicPhpZip1(): void {
+ $this->basic1(self::PHPZIP_TYPE);
+ }
+
+}
diff --git a/vendor/sboden/odtphp/tests/src/Basic2Test.php b/vendor/sboden/odtphp/tests/src/Basic2Test.php
new file mode 100755
index 0000000000..5e957da507
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/Basic2Test.php
@@ -0,0 +1,54 @@
+odfPhpZipConfig();
+ $gold_dir = 'gold_phpzip';
+ $type_name = 'PhpZip';
+ }
+ else {
+ $config = $this->odfPclZipConfig();
+ $gold_dir = 'gold_pclzip';
+ $type_name = 'PclZip';
+ }
+
+ $input_file = __DIR__ . '/files/input/BasicTest2.odt';
+ $odf = new Odf($input_file, $config);
+
+ $odf->setVars('titre', 'PHP: Hypertext Preprocessor');
+
+ $message = "PHP (sigle de PHP: Hypertext Preprocessor), est un langage de scripts libre
+principalement utilisé pour produire des pages Web dynamiques via un serveur HTTP, mais
+pouvant également fonctionner comme n'importe quel langage interprété de façon locale,
+en exécutant les programmes en ligne de commande.";
+
+ $odf->setVars('message', $message, TRUE, 'UTF-8');
+
+ $odf->setImage('image', __DIR__ . '/files/images/anaska.jpg');
+
+ $output_name = __DIR__ . "/files/output/BasicTest2" . $type_name . "Output.odt";
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/$gold_dir/BasicTest2Gold.odt"));
+
+ unlink($output_name);
+ }
+
+ public function testBasicPclZip2(): void {
+ $this->basic2(self::PCLZIP_TYPE);
+ }
+
+ public function testBasicPhpZip2(): void {
+ $this->basic2(self::PHPZIP_TYPE);
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/BasicTest1.odt b/vendor/sboden/odtphp/tests/src/BasicTest1.odt
new file mode 100755
index 0000000000..05eab715a7
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/BasicTest1.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/ConfigTest.php b/vendor/sboden/odtphp/tests/src/ConfigTest.php
new file mode 100755
index 0000000000..97a232a37e
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/ConfigTest.php
@@ -0,0 +1,45 @@
+expectException(\TypeError::class);
+ $this->expectExceptionMessage('Argument #2 ($config) must be of type array');
+ new Odf(__DIR__ . '/files/input/BasicTest1.odt', 'invalid');
+ }
+
+ public function testCustomDelimiters(): void {
+ $config = array_merge($this->odfPhpZipConfig(), [
+ 'DELIMITER_LEFT' => '[[',
+ 'DELIMITER_RIGHT' => ']]'
+ ]);
+
+ $odf = new Odf(__DIR__ . "/files/input/ConfigTest.odt", $config);
+ $odf->setVars('test_var', 'test value');
+
+ $output_name = __DIR__ . "/files/output/ConfigTestOutput.odt";
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ConfigTestGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testInvalidTempPath(): void {
+ $config = array_merge($this->odfPhpZipConfig(), [
+ 'PATH_TO_TMP' => '/nonexistent/path'
+ ]);
+
+ $this->expectException(OdfException::class);
+ new Odf(__DIR__ . "/files/input/BasicTest1.odt", $config);
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/CustomPropertyExistsTest.php b/vendor/sboden/odtphp/tests/src/CustomPropertyExistsTest.php
new file mode 100644
index 0000000000..2ee263b6cc
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/CustomPropertyExistsTest.php
@@ -0,0 +1,91 @@
+path = __DIR__ . '/files/';
+ }
+
+ /**
+ * Test checking for existing custom properties.
+ */
+ public function testExistingCustomProperties(): void {
+ $odf = new Odf($this->path . 'input/CustomPropertyExistsTest.odt');
+
+ // Test properties that should exist in the template.
+ $this->assertTrue($odf->customPropertyExists('Author'));
+ $this->assertTrue($odf->customPropertyExists('Version'));
+ $this->assertTrue($odf->customPropertyExists('Department'));
+ }
+
+ /**
+ * Test checking for non-existing custom properties.
+ */
+ public function testNonExistingCustomProperties(): void {
+ $odf = new Odf($this->path . 'input/CustomPropertyExistsTest.odt');
+
+ // Test properties that should not exist in the template.
+ $this->assertFalse($odf->customPropertyExists('NonExistentProperty'));
+ $this->assertFalse($odf->customPropertyExists(''));
+ $this->assertFalse($odf->customPropertyExists('Random Property'));
+ }
+
+ /**
+ * Test checking properties with special characters.
+ */
+ public function testSpecialCharacterProperties(): void {
+ $odf = new Odf($this->path . 'input/CustomPropertyExistsTest.odt');
+
+ // Test properties with special characters that should exist.
+ $this->assertTrue($odf->customPropertyExists('Special & Property'));
+ $this->assertTrue($odf->customPropertyExists('Property XML chars'));
+ }
+
+ /**
+ * Test checking properties after setting them.
+ */
+ public function testPropertyExistsAfterSet(): void {
+ $odf = new Odf($this->path . 'input/CustomPropertyExistsTest.odt');
+
+ // Verify property exists before modifying.
+ $this->assertTrue($odf->customPropertyExists('Author'));
+
+ // Modify the property.
+ $odf->setCustomProperty('Author', 'John Doe');
+
+ // Verify property still exists after modifying.
+ $this->assertTrue($odf->customPropertyExists('Author'));
+ }
+
+ /**
+ * Test checking properties with case sensitivity.
+ */
+ public function testCaseSensitiveProperties(): void {
+ $odf = new Odf($this->path . 'input/CustomPropertyExistsTest.odt');
+
+ // Test case sensitivity.
+ $this->assertTrue($odf->customPropertyExists('Author'));
+ $this->assertFalse($odf->customPropertyExists('author'));
+ $this->assertFalse($odf->customPropertyExists('AUTHOR'));
+ }
+}
\ No newline at end of file
diff --git a/vendor/sboden/odtphp/tests/src/EdgeCaseTest.php b/vendor/sboden/odtphp/tests/src/EdgeCaseTest.php
new file mode 100755
index 0000000000..ec09f0c887
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/EdgeCaseTest.php
@@ -0,0 +1,177 @@
+odfPhpZipConfig();
+ $gold_dir = 'gold_phpzip';
+ $type_name = 'PhpZip';
+ }
+ else {
+ $config = $this->odfPclZipConfig();
+ $gold_dir = 'gold_pclzip';
+ $type_name = 'PclZip';
+ }
+
+ switch ($testName) {
+ case 'LargeVariableSubstitution':
+ $input_file = __DIR__ . '/files/input/LargeVariableTest.odt';
+ $output_name = __DIR__ . '/files/output/LargeVariableTest' . $type_name . 'Output.odt';
+ $gold_file = __DIR__ . '/files/' . $gold_dir . '/LargeVariableTestGold.odt';
+
+ $odf = new Odf($input_file, $config);
+
+ // Generate a large text block
+ $largeText = str_repeat("This is a large text block with many repetitions. ", 1000);
+
+ $odf->setVars('large_content', $largeText, true, 'UTF-8');
+
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, $gold_file));
+
+ unlink($output_name);
+ break;
+
+ case 'ComplexSegmentMerging':
+ $input_file = __DIR__ . '/files/input/NestedSegmentTest.odt';
+ $output_name = __DIR__ . '/files/output/NestedSegmentTest' . $type_name . 'Output.odt';
+ $gold_file = __DIR__ . '/files/' . $gold_dir . '/NestedSegmentTestGold.odt';
+
+ $odf = new Odf($input_file, $config);
+
+ // Create a nested data structure
+ $departments = [
+ [
+ 'name' => 'Engineering',
+ 'employees' => [
+ ['name' => 'Alice', 'role' => 'Senior Developer'],
+ ['name' => 'Bob', 'role' => 'Junior Developer']
+ ]
+ ],
+ [
+ 'name' => 'Marketing',
+ 'employees' => [
+ ['name' => 'Charlie', 'role' => 'Marketing Manager'],
+ ['name' => 'David', 'role' => 'Content Strategist']
+ ]
+ ]
+ ];
+
+ $departmentSegment = $odf->setSegment('departments');
+
+ foreach ($departments as $department) {
+ $departmentSegment->setVars('department_name', $department['name']);
+
+ $employeeSegment = $departmentSegment->setSegment('employees');
+
+ foreach ($department['employees'] as $employee) {
+ $employeeSegment->setVars('employee_name', $employee['name']);
+ $employeeSegment->setVars('employee_role', $employee['role']);
+ $employeeSegment->merge();
+ }
+ $departmentSegment->merge();
+ }
+ $odf->mergeSegment($departmentSegment);
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, $gold_file));
+
+ unlink($output_name);
+ break;
+
+ case 'SpecialCharacterEncoding':
+ $input_file = __DIR__ . '/files/input/EncodingTest.odt';
+ $output_name = __DIR__ . '/files/output/EncodingTest' . $type_name . 'Output.odt';
+ $gold_file = __DIR__ . '/files/' . $gold_dir . '/EncodingTestGold.odt';
+
+ $specialCharText = "Special characters: éèà€ñ¿ § ® © µ";
+
+ $odf = new Odf($input_file, $config);
+
+ $odf->setVars('special_chars', $specialCharText, true, 'UTF-8');
+
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, $gold_file));
+
+ unlink($output_name);
+ break;
+
+ case 'AdvancedImageInsertion':
+ $input_file = __DIR__ . '/files/input/ImageTest.odt';
+ $output_name = __DIR__ . '/files/output/AdvancedImageTest' . $type_name . 'Output.odt';
+ $gold_file = __DIR__ . '/files/' . $gold_dir . '/AdvancedImageTestGold.odt';
+
+ $odf = new Odf($input_file, $config);
+
+ // Test different image types and sizes
+ $images = [
+ 'small_png' => __DIR__ . '/files/images/voronoi_sphere.png',
+ 'large_jpg' => __DIR__ . '/files/images/test.jpg',
+ 'transparent_gif' => __DIR__ . '/files/images/circle_transparent.gif'
+ ];
+
+ foreach ($images as $key => $imagePath) {
+ $odf->setImage($key, $imagePath);
+ }
+
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, $gold_file));
+
+ unlink($output_name);
+ break;
+ }
+ }
+
+ public function testLargeVariableSubstitutionPclZip(): void {
+ $this->edgeCase(self::PCLZIP_TYPE, 'LargeVariableSubstitution');
+ }
+
+ public function testLargeVariableSubstitutionPhpZip(): void {
+ $this->edgeCase(self::PHPZIP_TYPE, 'LargeVariableSubstitution');
+ }
+
+ public function testComplexSegmentMergingPclZip(): void {
+ $this->edgeCase(self::PCLZIP_TYPE, 'ComplexSegmentMerging');
+ }
+
+ public function testComplexSegmentMergingPhpZip(): void {
+ $this->edgeCase(self::PHPZIP_TYPE, 'ComplexSegmentMerging');
+ }
+
+ public function testSpecialCharacterEncodingPclZip(): void {
+ $this->edgeCase(self::PCLZIP_TYPE, 'SpecialCharacterEncoding');
+ }
+
+ public function testSpecialCharacterEncodingPhpZip(): void {
+ $this->edgeCase(self::PHPZIP_TYPE, 'SpecialCharacterEncoding');
+ }
+
+ public function testAdvancedImageInsertionPclZip(): void {
+ $this->edgeCase(self::PCLZIP_TYPE, 'AdvancedImageInsertion');
+ }
+
+ public function testAdvancedImageInsertionPhpZip(): void {
+ $this->edgeCase(self::PHPZIP_TYPE, 'AdvancedImageInsertion');
+ }
+
+ /**
+ * Test handling of invalid template files.
+ */
+ public function testInvalidTemplateHandling(): void {
+ $this->expectException(\Odtphp\Exceptions\OdfException::class);
+ $this->expectExceptionMessage("File '" . __DIR__ . "/files/input/NonexistentTemplate.odt' does not exist");
+ new Odf(__DIR__ . '/files/input/NonexistentTemplate.odt');
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/ImageTest.php b/vendor/sboden/odtphp/tests/src/ImageTest.php
new file mode 100755
index 0000000000..fde1ce8292
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/ImageTest.php
@@ -0,0 +1,124 @@
+odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImage('test_image', __DIR__ . "/files/images/voronoi_sphere.png");
+ $output_name = __DIR__ . "/files/output/ImageTestOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizing(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ // This is actually 100cmx100cm of the original image.
+ $odf->setImage('test_image', __DIR__ . "/files/images/test.jpg", -1, 100, 100);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizingMm(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImageMm('test_image', __DIR__ . "/files/images/test.jpg", -1);
+ // 50mm x 50mm of the original image.
+ $odf->setImageMm('small_png', __DIR__ . "/files/images/test.jpg", -1, 50, 50);
+ // 100mm x 100mm of the original image.
+ $odf->setImageMm('large_jpg', __DIR__ . "/files/images/test.jpg", -1, 100, 100);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedMmOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedMmGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizingPixel(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImagePixel('test_image', __DIR__ . "/files/images/test.jpg", -1);
+ // About 50mm x 50mm of the original image in pixels.
+ $odf->setImagePixel('small_png', __DIR__ . "/files/images/test.jpg", -1, 188.97637795, 188.97637795);
+ // About 100mm x 100mm of the original image in pixels.
+ $odf->setImagePixel('large_jpg', __DIR__ . "/files/images/test.jpg", -1, 377.95275591, 377.95275591);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedPixelOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedPixelGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizingMmOffsetIgnored(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImageMm('test_image', __DIR__ . "/files/images/test.jpg", -1);
+ // 50mm x 50mm of the original image.
+ $odf->setImageMm('small_png', __DIR__ . "/files/images/test.jpg", -1, 50, 50, 50, 100);
+ // 100mm x 100mm of the original image.
+ $odf->setImageMm('large_jpg', __DIR__ . "/files/images/test.jpg", -1, 100, 100, 80, 70);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedMmOffsetIgnoredOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedMmOffsetIgnoredGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizingPixelOffsetIgnored(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImagePixel('test_image', __DIR__ . "/files/images/test.jpg", -1);
+ // About 50mm x 50mm of the original image in pixels.
+ $odf->setImagePixel('small_png', __DIR__ . "/files/images/test.jpg", -1, 188.97637795, 188.97637795, 50, 100);
+ // About 100mm x 100mm of the original image in pixels.
+ $odf->setImagePixel('large_jpg', __DIR__ . "/files/images/test.jpg", -1, 377.95275591, 377.95275591, 80, 70);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedPixelOffsetIgnoredOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedPixelOffsetIgnoredGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizingMmOffset(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImageMm('test_image', __DIR__ . "/files/images/test.jpg", 1, 100, 100, 80, 70);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedMmOffsetOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedMmOffsetGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testImageResizingPixelOffset(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $odf->setImagePixel('test_image', __DIR__ . "/files/images/test.jpg", 1, 377.95275591, 377.95275591, 80, 70);
+ $output_name = __DIR__ . "/files/output/ImageTestResizedPixelOffsetOutput.odt";
+ $odf->saveToDisk($output_name);
+ $this->assertFileExists($output_name);
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/ImageTestResizedPixelOffsetGold.odt"));
+ unlink($output_name);
+ }
+
+
+ public function testInvalidImagePath(): void {
+ $config = $this->odfPclZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/ImageTest.odt", $config);
+ $this->expectException(OdfException::class);
+ $odf->setImage('test_image', __DIR__ . "/files/images/nonexistent.png");
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/NullValueRegressionTest.php b/vendor/sboden/odtphp/tests/src/NullValueRegressionTest.php
new file mode 100644
index 0000000000..cc3ff73e17
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/NullValueRegressionTest.php
@@ -0,0 +1,235 @@
+odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // Test the current behavior (after the fix)
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // These calls should not throw any errors after the fix
+ $result = $method->invoke($odf, null);
+ $this->assertEquals('', $result);
+
+ $result = $method->invoke($odf, [null, 'test', null]);
+ $this->assertEquals(['', 'test', ''], $result);
+ }
+
+ /**
+ * Test that demonstrates the integration behavior after the fix.
+ * This shows that setVars and setVariable methods work correctly with null values.
+ */
+ public function testIntegrationBehaviorAfterFix(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // Test that setVars works with null values and encoding enabled
+ $odf->setVars('titre', null, true, 'UTF-8');
+
+ // Test that setVariable works with null values
+ $odf->setVariable('message', null, true);
+
+ // Test that both variables were set (as empty strings after encoding)
+ $this->assertTrue($odf->variableExists('titre'));
+ $this->assertTrue($odf->variableExists('message'));
+ }
+
+ /**
+ * Test that demonstrates the behavior with various edge cases that were problematic before the fix.
+ */
+ public function testEdgeCaseHandlingAfterFix(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test various edge cases that would have caused issues before the fix
+ $edgeCases = [
+ null,
+ [null],
+ [null, null, null],
+ ['test', null, 'value'],
+ [null, 'test', null],
+ [[null], 'test'],
+ ['test', [null]],
+ [[null, 'test'], null],
+ ];
+
+ foreach ($edgeCases as $case) {
+ $result = $method->invoke($odf, $case);
+ // Just verify it doesn't throw an error and returns something
+ $this->assertNotNull($result, "Failed for case: " . var_export($case, true));
+ }
+ }
+
+ /**
+ * Test that demonstrates the behavior with complex nested structures.
+ */
+ public function testComplexNestedStructuresAfterFix(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with complex nested structure containing nulls
+ $complexStructure = [
+ 'users' => [
+ [
+ 'name' => 'John',
+ 'email' => null,
+ 'preferences' => [
+ 'theme' => 'dark',
+ 'notifications' => null
+ ]
+ ],
+ [
+ 'name' => null,
+ 'email' => 'jane@example.com',
+ 'preferences' => null
+ ],
+ null, // This would have been problematic before the fix
+ [
+ 'name' => 'Bob',
+ 'email' => 'bob@example.com',
+ 'preferences' => [
+ 'theme' => null,
+ 'notifications' => true
+ ]
+ ]
+ ],
+ 'settings' => null,
+ 'metadata' => [
+ 'version' => '1.0',
+ 'author' => null,
+ 'tags' => [null, 'important', null]
+ ]
+ ];
+
+ $result = $method->invoke($odf, $complexStructure);
+
+ // Verify the structure is processed correctly
+ $this->assertIsArray($result);
+ $this->assertArrayHasKey('users', $result);
+ $this->assertArrayHasKey('settings', $result);
+ $this->assertArrayHasKey('metadata', $result);
+
+ // Verify null values are converted to empty strings
+ $this->assertEquals('', $result['settings']);
+ $this->assertEquals('', $result['metadata']['author']);
+ }
+
+ /**
+ * Test that demonstrates the behavior with different data types.
+ */
+ public function testDataTypeHandlingAfterFix(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with different data types including null
+ $mixedData = [
+ 'string' => 'test',
+ 'null' => null,
+ 'integer' => 123,
+ 'float' => 123.45,
+ 'boolean_true' => true,
+ 'boolean_false' => false,
+ 'empty_string' => '',
+ 'zero' => 0,
+ 'array_with_nulls' => [null, 'test', null],
+ 'nested_null' => [['deep' => null]]
+ ];
+
+ $result = $method->invoke($odf, $mixedData);
+
+ // Verify all values are processed without errors
+ $this->assertEquals('test', $result['string']);
+ $this->assertEquals('', $result['null']);
+ $this->assertEquals('123', $result['integer']);
+ $this->assertEquals('123.45', $result['float']);
+ $this->assertEquals('1', $result['boolean_true']);
+ $this->assertEquals('', $result['boolean_false']);
+ $this->assertEquals('', $result['empty_string']);
+ $this->assertEquals('0', $result['zero']);
+ $this->assertEquals(['', 'test', ''], $result['array_with_nulls']);
+ $this->assertEquals([['deep' => '']], $result['nested_null']);
+ }
+
+ /**
+ * Test that demonstrates the behavior with HTML special characters and null values mixed.
+ */
+ public function testHtmlSpecialCharsWithNullsAfterFix(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with HTML special characters mixed with null values
+ $htmlWithNulls = [
+ 'safe_text' => 'Normal text',
+ 'null_value' => null,
+ 'html_script' => '',
+ 'html_entities' => '<test>',
+ 'mixed_array' => [
+ 'safe' => 'Safe content',
+ 'null' => null,
+ 'html' => 'Content
',
+ 'empty' => ''
+ ],
+ 'nested_html' => [
+ 'level1' => [
+ 'level2' => [
+ 'content' => 'Paragraph
',
+ 'null_content' => null
+ ]
+ ]
+ ]
+ ];
+
+ $result = $method->invoke($odf, $htmlWithNulls);
+
+ // Verify HTML is properly encoded
+ $this->assertEquals('<script>alert("test")</script>', $result['html_script']);
+ $this->assertEquals('<test>', $result['html_entities']);
+ $this->assertEquals('<div>Content</div>', $result['mixed_array']['html']);
+ $this->assertEquals('<p>Paragraph</p>', $result['nested_html']['level1']['level2']['content']);
+
+ // Verify null values are converted to empty strings
+ $this->assertEquals('', $result['null_value']);
+ $this->assertEquals('', $result['mixed_array']['null']);
+ $this->assertEquals('', $result['nested_html']['level1']['level2']['null_content']);
+ }
+}
\ No newline at end of file
diff --git a/vendor/sboden/odtphp/tests/src/OdtTestCase.php b/vendor/sboden/odtphp/tests/src/OdtTestCase.php
new file mode 100755
index 0000000000..d6295e36ae
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/OdtTestCase.php
@@ -0,0 +1,100 @@
+ \Odtphp\Zip\PhpZipProxy::class,
+ 'DELIMITER_LEFT' => '{',
+ 'DELIMITER_RIGHT' => '}',
+ ];
+ }
+
+ protected function odfPclZipConfig() {
+ return [
+ 'ZIP_PROXY' => \Odtphp\Zip\PclZipProxy::class,
+ 'DELIMITER_LEFT' => '{',
+ 'DELIMITER_RIGHT' => '}',
+ ];
+ }
+
+
+ protected function extractText($filename) {
+ $file_parts = explode('.', $filename);
+ $ext = end($file_parts);
+ if ($ext == 'docx') {
+ $dataFile = "word/document.xml";
+ }
+ else {
+ $dataFile = "content.xml";
+ }
+ $zip = new \ZipArchive;
+ if (TRUE === $zip->open($filename)) {
+ if (($index = $zip->locateName($dataFile)) !== FALSE) {
+ // Index found! Now read it to a string
+ $text = $zip->getFromIndex($index);
+ // Load XML from a string
+ // Ignore errors and warnings
+ $doc = new DOMDocument();
+ $rcode = $doc->loadXML($text,
+ LIBXML_NOENT | LIBXML_XINCLUDE | LIBXML_NOERROR | LIBXML_NOWARNING);
+ // Remove XML formatting tags and return the text
+ return strip_tags($doc->saveXML());
+ }
+ // Close the archive file
+ $zip->close();
+ }
+ // In case of failure return a message
+ return "File not found";
+ }
+
+
+ function odtFilesAreIdentical($file1, $file2)
+ {
+ // Ensure both files exist
+ if (!file_exists($file1)) {
+ throw new Exception("File $file1 does not exist.");
+ }
+
+ if (!file_exists($file2)) {
+ throw new Exception("File $file2 does not exist.");
+ }
+
+ // Open the first .odt file as a ZIP archive and extract content.xml
+ $zip1 = new \ZipArchive;
+ $zip2 = new \ZipArchive;
+
+ if ($zip1->open($file1) !== true) {
+ throw new Exception("Unable to open file: " . $file1);
+ }
+
+ if ($zip2->open($file2) !== true) {
+ $zip1->close();
+ throw new Exception("Unable to open file: " . $file2);
+ }
+
+ // Read the content.xml files from both .odt files
+ $content1 = $zip1->getFromName("content.xml");
+ $content2 = $zip2->getFromName("content.xml");
+
+ // Close the archives
+ $zip1->close();
+ $zip2->close();
+
+ // Compare the contents of content.xml
+ return $content1 === $content2;
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/RecursiveHtmlspecialcharsTest.php b/vendor/sboden/odtphp/tests/src/RecursiveHtmlspecialcharsTest.php
new file mode 100644
index 0000000000..cc0f69ab04
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/RecursiveHtmlspecialcharsTest.php
@@ -0,0 +1,315 @@
+odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // Use reflection to access the protected method
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with null value - should not throw an error and should return empty string
+ $result = $method->invoke($odf, null);
+ $this->assertEquals('', $result);
+ }
+
+ /**
+ * Test that recursiveHtmlspecialchars handles various null-like values correctly.
+ */
+ public function testRecursiveHtmlspecialcharsWithNullLikeValues(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with various null-like values (avoid duplicate keys)
+ $testCases = [
+ null => '',
+ '' => '',
+ '0' => '0', // string key only
+ true => '1',
+ ];
+
+ foreach ($testCases as $input => $expected) {
+ $result = $method->invoke($odf, $input);
+ $this->assertEquals($expected, $result, "Failed for input: " . var_export($input, true));
+ }
+ // Add explicit tests for integer 0 and boolean false
+ $result = $method->invoke($odf, 0);
+ $this->assertEquals('0', $result, "Failed for input: 0 (int)");
+ $result = $method->invoke($odf, false);
+ $this->assertEquals('', $result, "Failed for input: false (bool)");
+ }
+
+ /**
+ * Test that recursiveHtmlspecialchars handles arrays with null values correctly.
+ */
+ public function testRecursiveHtmlspecialcharsWithArrayContainingNull(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with array containing null values
+ $input = ['test', null, 'value', null];
+ $expected = ['test', '', 'value', ''];
+
+ $result = $method->invoke($odf, $input);
+ $this->assertEquals($expected, $result);
+ }
+
+ /**
+ * Test that recursiveHtmlspecialchars handles nested arrays with null values correctly.
+ */
+ public function testRecursiveHtmlspecialcharsWithNestedArrays(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with nested arrays containing null values
+ $input = [
+ 'level1' => [
+ 'level2' => [
+ 'value1' => 'test',
+ 'value2' => null,
+ 'value3' => 'another'
+ ],
+ 'level2b' => null
+ ],
+ 'top_level' => null
+ ];
+
+ $expected = [
+ 'level1' => [
+ 'level2' => [
+ 'value1' => 'test',
+ 'value2' => '',
+ 'value3' => 'another'
+ ],
+ 'level2b' => ''
+ ],
+ 'top_level' => ''
+ ];
+
+ $result = $method->invoke($odf, $input);
+ $this->assertEquals($expected, $result);
+ }
+
+ /**
+ * Test that recursiveHtmlspecialchars properly encodes HTML special characters.
+ */
+ public function testRecursiveHtmlspecialcharsWithSpecialCharacters(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with HTML special characters
+ $input = '';
+ $expected = '<script>alert("test")</script>';
+
+ $result = $method->invoke($odf, $input);
+ $this->assertEquals($expected, $result);
+ }
+
+ /**
+ * Test that setVars method handles null values correctly when encoding is enabled.
+ */
+ public function testSetVarsWithNullValueAndEncoding(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // This should not throw an error even with null value and encoding enabled
+ $odf->setVars('titre', null, true, 'UTF-8');
+
+ // Verify the variable was set (should be empty string after encoding)
+ $this->assertTrue($odf->variableExists('titre'));
+ }
+
+ /**
+ * Test that setVars method handles null values correctly when encoding is disabled.
+ * Note: This test demonstrates that the setVars method needs additional null handling.
+ */
+ public function testSetVarsWithNullValueAndNoEncoding(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // This test shows that setVars needs additional null handling when encoding is disabled
+ // because str_replace() receives null as the third parameter
+ $this->expectException(\TypeError::class);
+ $odf->setVars('titre', null, false, 'UTF-8');
+ }
+
+ /**
+ * Test that setVariable method (alias for setVars) handles null values correctly.
+ */
+ public function testSetVariableWithNullValue(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // This should not throw an error
+ $odf->setVariable('titre', null, true);
+
+ // Verify the variable was set
+ $this->assertTrue($odf->variableExists('titre'));
+ }
+
+ /**
+ * Test integration with actual ODT file processing using null values.
+ */
+ public function testIntegrationWithNullValues(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ // Set various types of values including null
+ // Only use variables that exist in the BasicTest1.odt template
+ $odf->setVars('titre', null, true, 'UTF-8');
+ $odf->setVars('message', 'Normal message', true, 'UTF-8');
+
+ $output_name = __DIR__ . '/files/output/NullValueTestOutput.odt';
+
+ // This should not throw any errors
+ $odf->saveToDisk($output_name);
+
+ // Verify the file was created successfully
+ $this->assertFileExists($output_name);
+
+ // Clean up
+ unlink($output_name);
+ }
+
+ /**
+ * Test that the fix works with both PHPZip and PclZip configurations.
+ */
+ public function testNullValueHandlingWithPclZip(): void {
+ $config = $this->odfPclZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with null value using PclZip configuration
+ $result = $method->invoke($odf, null);
+ $this->assertEquals('', $result);
+ }
+
+ /**
+ * Test edge case with mixed data types in arrays.
+ */
+ public function testMixedDataTypesInArrays(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Test with mixed data types including null
+ $input = [
+ 'string' => 'test',
+ 'null' => null,
+ 'integer' => 123,
+ 'boolean' => true,
+ 'empty_string' => '',
+ 'zero' => 0,
+ 'false' => false
+ ];
+
+ $expected = [
+ 'string' => 'test',
+ 'null' => '',
+ 'integer' => '123',
+ 'boolean' => '1',
+ 'empty_string' => '',
+ 'zero' => '0',
+ 'false' => ''
+ ];
+
+ $result = $method->invoke($odf, $input);
+ $this->assertEquals($expected, $result);
+ }
+
+ /**
+ * Test that the method handles very deep nested arrays correctly.
+ */
+ public function testDeepNestedArrays(): void {
+ $config = $this->odfPhpZipConfig();
+ $input_file = __DIR__ . '/files/input/BasicTest1.odt';
+ $odf = new Odf($input_file, $config);
+
+ $reflection = new ReflectionClass($odf);
+ $method = $reflection->getMethod('recursiveHtmlspecialchars');
+ $method->setAccessible(true);
+
+ // Create a deeply nested array
+ $input = [
+ 'level1' => [
+ 'level2' => [
+ 'level3' => [
+ 'level4' => [
+ 'level5' => [
+ 'value' => null,
+ 'text' => ''
+ ]
+ ]
+ ]
+ ]
+ ]
+ ];
+
+ $expected = [
+ 'level1' => [
+ 'level2' => [
+ 'level3' => [
+ 'level4' => [
+ 'level5' => [
+ 'value' => '',
+ 'text' => '<script>alert("test")</script>'
+ ]
+ ]
+ ]
+ ]
+ ]
+ ];
+
+ $result = $method->invoke($odf, $input);
+ $this->assertEquals($expected, $result);
+ }
+}
\ No newline at end of file
diff --git a/vendor/sboden/odtphp/tests/src/SetCustomPropertyTest.php b/vendor/sboden/odtphp/tests/src/SetCustomPropertyTest.php
new file mode 100644
index 0000000000..9659299584
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/SetCustomPropertyTest.php
@@ -0,0 +1,168 @@
+filename = tempnam(sys_get_temp_dir(), 'odt_test_');
+ copy($sourcePath, $this->filename);
+ $this->odf = new Odf($this->filename);
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ protected function tearDown(): void
+ {
+ parent::tearDown();
+ if (file_exists($this->filename)) {
+ unlink($this->filename);
+ }
+ }
+
+ /**
+ * Test setting a basic custom property.
+ */
+ public function testSetBasicCustomProperty(): void
+ {
+ $this->odf->setCustomProperty('Name', 'Anja');
+ $metaXml = $this->odf->getMetaXml();
+
+ $this->assertStringContainsString('Anja ', $metaXml);
+ $this->assertStringNotContainsString('Sven Boden ', $metaXml);
+ }
+
+ /**
+ * Test setting a date custom property.
+ */
+ public function testSetDateCustomProperty(): void
+ {
+ $this->odf->setCustomProperty('Creation Date', '01/11/9999');
+ $metaXml = $this->odf->getMetaXml();
+
+ $this->assertStringContainsString('01/11/9999 ', $metaXml);
+ $this->assertStringNotContainsString('2025-03-20 ', $metaXml);
+ }
+
+ /**
+ * Test setting custom property with HTML encoding.
+ */
+ public function testSetCustomPropertyWithEncoding(): void
+ {
+ $this->odf->setCustomProperty('Name', '&"\'', TRUE);
+ $metaXml = $this->odf->getMetaXml();
+
+ $this->assertStringContainsString('<test>&"'', $metaXml);
+ }
+
+ /**
+ * Test setting custom property without HTML encoding.
+ */
+ public function testSetCustomPropertyWithoutEncoding(): void
+ {
+ $this->odf->setCustomProperty('Name', '&"\'', FALSE);
+ $metaXml = $this->odf->getMetaXml();
+
+ $this->assertStringContainsString('&"\'', $metaXml);
+ }
+
+ /**
+ * Test setting custom property with invalid input.
+ */
+ public function testSetCustomPropertyWithInvalidInput(): void
+ {
+ $this->expectException(OdfException::class);
+ $this->expectExceptionMessage('Key and value must be strings');
+ $this->odf->setCustomProperty(['invalid'], 'value');
+ }
+
+ /**
+ * Test setting non-existent custom property.
+ */
+ public function testSetNonExistentCustomProperty(): void
+ {
+ $this->expectException(OdfException::class);
+ $this->expectExceptionMessage("Custom property 'NonExistent' not found in meta.xml");
+ $this->odf->setCustomProperty('NonExistent', 'value');
+ }
+
+ /**
+ * Test error handling when meta.xml extraction fails.
+ */
+ public function testMetaXmlExtractionError(): void
+ {
+ // Create a mock zip file without meta.xml
+ $badFile = tempnam(sys_get_temp_dir(), 'bad_odt_');
+ file_put_contents($badFile, 'corrupted content');
+
+ $this->expectException(OdfException::class);
+ $this->expectExceptionMessage("Error opening file '$badFile'");
+
+ // Create a new ODT instance with the bad file - this should throw the exception
+ new Odf($badFile);
+
+ unlink($badFile);
+ }
+
+ /**
+ * Compare output with gold files.
+ */
+ public function goldFileComparison($type): void
+ {
+ if ($type === self::PHPZIP_TYPE) {
+ $config = $this->odfPhpZipConfig();
+ $gold_dir = 'gold_phpzip';
+ $type_name = 'PhpZip';
+ }
+ else {
+ $config = $this->odfPclZipConfig();
+ $gold_dir = 'gold_pclzip';
+ $type_name = 'PclZip';
+ }
+
+ $odf = new Odf(__DIR__ . '/files/input/CustomPropertiesTest.odt', $config);
+ $odf->setCustomProperty('Name', "Snow White");
+ $odf->setCustomProperty('Creation Date', '2100-01-01');
+
+ $output_name = __DIR__ . "/files/output/SetCustomPropertyTest" . $type_name . "Output.odt";
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/$gold_dir/SetCustomPropertyTestGold.odt"));
+ unlink($output_name);
+ }
+
+ /**
+ * Test with PclZip.
+ */
+ public function testSetCustomPropertyPclZip(): void
+ {
+ $this->goldFileComparison(self::PCLZIP_TYPE);
+ }
+
+ /**
+ * Test with PhpZip.
+ */
+ public function testSetCustomPropertyPhpZip(): void
+ {
+ $this->goldFileComparison(self::PHPZIP_TYPE);
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/VariableTest.php b/vendor/sboden/odtphp/tests/src/VariableTest.php
new file mode 100755
index 0000000000..ffcbd9959e
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/VariableTest.php
@@ -0,0 +1,46 @@
+odfPhpZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/VariableTest.odt", $config);
+
+ $this->assertTrue($odf->variableExists('test_var'));
+ $this->assertFalse($odf->variableExists('nonexistent_var'));
+ }
+
+ public function testSpecialCharacterEncoding(): void {
+ $config = $this->odfPhpZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/VariableTest.odt", $config);
+
+ $specialChars = "<>&'\"";
+ $odf->setVars('test_var', $specialChars, true);
+
+ $output_name = __DIR__ . "/files/output/VariableTestOutputSpecialChars.odt";
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/VariableTestSpecialCharsGold.odt"));
+ unlink($output_name);
+ }
+
+ public function testMultilineText(): void {
+ $config = $this->odfPhpZipConfig();
+ $odf = new Odf(__DIR__ . "/files/input/VariableTest.odt", $config);
+
+ $multiline = "Line 1\nLine 2\nLine 3";
+ $odf->setVars('test_var', $multiline, true);
+
+ $output_name = __DIR__ . "/files/output/VariableTestOutputMultiline.odt";
+ $odf->saveToDisk($output_name);
+
+ $this->assertTrue($this->odtFilesAreIdentical($output_name, __DIR__ . "/files/gold_phpzip/VariableTestMultilineGold.odt"));
+ unlink($output_name);
+ }
+}
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/AdvancedImageTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/AdvancedImageTestGold.odt
new file mode 100755
index 0000000000..b0045f69a8
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/AdvancedImageTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/BasicTest1Gold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/BasicTest1Gold.odt
new file mode 100755
index 0000000000..9cda417f2b
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/BasicTest1Gold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/BasicTest2Gold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/BasicTest2Gold.odt
new file mode 100755
index 0000000000..af50d9c969
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/BasicTest2Gold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ConfigTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ConfigTestGold.odt
new file mode 100755
index 0000000000..5fac55e7c4
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ConfigTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/EncodingTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/EncodingTestGold.odt
new file mode 100755
index 0000000000..7243f7a5eb
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/EncodingTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestGold.odt
new file mode 100755
index 0000000000..ad104898b7
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestOutputGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestOutputGold.odt
new file mode 100755
index 0000000000..ad104898b7
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestOutputGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestResizedGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestResizedGold.odt
new file mode 100755
index 0000000000..1e3360f8fa
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestResizedGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestResizedOutputGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestResizedOutputGold.odt
new file mode 100644
index 0000000000..52aaaf2b79
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/ImageTestResizedOutputGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/LargeVariableTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/LargeVariableTestGold.odt
new file mode 100755
index 0000000000..86562d47fa
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/LargeVariableTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/NestedSegmentTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/NestedSegmentTestGold.odt
new file mode 100755
index 0000000000..a87b0072be
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/NestedSegmentTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/SetCustomPropertyTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/SetCustomPropertyTestGold.odt
new file mode 100644
index 0000000000..0f4f54e842
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/SetCustomPropertyTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_pclzip/VariableTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/VariableTestGold.odt
new file mode 100755
index 0000000000..5100ff7ef8
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/files/gold_pclzip/VariableTestGold.odt
@@ -0,0 +1,8 @@
+
+
+
+
+ <>&'"
+
+
+
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/AdvancedImageTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/AdvancedImageTestGold.odt
new file mode 100755
index 0000000000..b0045f69a8
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/AdvancedImageTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/BasicTest1Gold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/BasicTest1Gold.odt
new file mode 100755
index 0000000000..b8645415bd
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/BasicTest1Gold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/BasicTest2Gold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/BasicTest2Gold.odt
new file mode 100755
index 0000000000..af50d9c969
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/BasicTest2Gold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ConfigTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ConfigTestGold.odt
new file mode 100755
index 0000000000..5fac55e7c4
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ConfigTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/EncodingTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/EncodingTestGold.odt
new file mode 100755
index 0000000000..5a7b254df0
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/EncodingTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/EncodingTestPhpGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/EncodingTestPhpGold.odt
new file mode 100755
index 0000000000..7243f7a5eb
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/EncodingTestPhpGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestGold.odt
new file mode 100755
index 0000000000..bbd94b6f1d
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedGold.odt
new file mode 100755
index 0000000000..c91340a197
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmGold.odt
new file mode 100644
index 0000000000..8386e43435
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmOffsetGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmOffsetGold.odt
new file mode 100644
index 0000000000..1e38a38eec
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmOffsetGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmOffsetIgnoredGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmOffsetIgnoredGold.odt
new file mode 100644
index 0000000000..22bfae3d56
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedMmOffsetIgnoredGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelGold.odt
new file mode 100644
index 0000000000..effb5940ba
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelOffsetGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelOffsetGold.odt
new file mode 100644
index 0000000000..1302c56382
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelOffsetGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelOffsetIgnoredGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelOffsetIgnoredGold.odt
new file mode 100644
index 0000000000..22bfae3d56
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/ImageTestResizedPixelOffsetIgnoredGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/LargeVariableTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/LargeVariableTestGold.odt
new file mode 100755
index 0000000000..86562d47fa
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/LargeVariableTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/NestedSegmentTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/NestedSegmentTestGold.odt
new file mode 100755
index 0000000000..a87b0072be
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/NestedSegmentTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/SetCustomPropertyTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/SetCustomPropertyTestGold.odt
new file mode 100644
index 0000000000..a1dd562e02
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/SetCustomPropertyTestGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestGold.odt
new file mode 100755
index 0000000000..5100ff7ef8
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestGold.odt
@@ -0,0 +1,8 @@
+
+
+
+
+ <>&'"
+
+
+
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestMultilineGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestMultilineGold.odt
new file mode 100755
index 0000000000..adabf5af11
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestMultilineGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestSpecialCharsGold.odt b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestSpecialCharsGold.odt
new file mode 100755
index 0000000000..0b65492a7f
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/gold_phpzip/VariableTestSpecialCharsGold.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/anaska.gif b/vendor/sboden/odtphp/tests/src/files/images/anaska.gif
new file mode 100755
index 0000000000..1ea3f0e68a
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/anaska.gif differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/anaska.jpg b/vendor/sboden/odtphp/tests/src/files/images/anaska.jpg
new file mode 100755
index 0000000000..b02b4c4eff
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/anaska.jpg differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/circle_transparent.gif b/vendor/sboden/odtphp/tests/src/files/images/circle_transparent.gif
new file mode 100755
index 0000000000..9a8eeed844
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/circle_transparent.gif differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/mysql.gif b/vendor/sboden/odtphp/tests/src/files/images/mysql.gif
new file mode 100755
index 0000000000..6520883e1d
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/mysql.gif differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/overschot.jpg b/vendor/sboden/odtphp/tests/src/files/images/overschot.jpg
new file mode 100755
index 0000000000..e5bb4ede0f
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/overschot.jpg differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/php.gif b/vendor/sboden/odtphp/tests/src/files/images/php.gif
new file mode 100755
index 0000000000..f352c7308f
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/php.gif differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/test.jpg b/vendor/sboden/odtphp/tests/src/files/images/test.jpg
new file mode 100755
index 0000000000..4e03043e69
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/test.jpg differ
diff --git a/vendor/sboden/odtphp/tests/src/files/images/voronoi_sphere.png b/vendor/sboden/odtphp/tests/src/files/images/voronoi_sphere.png
new file mode 100755
index 0000000000..1685f87466
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/images/voronoi_sphere.png differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/BasicTest1.odt b/vendor/sboden/odtphp/tests/src/files/input/BasicTest1.odt
new file mode 100755
index 0000000000..f1af2afd13
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/BasicTest1.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/BasicTest2.odt b/vendor/sboden/odtphp/tests/src/files/input/BasicTest2.odt
new file mode 100755
index 0000000000..68ae77677b
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/BasicTest2.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/ConfigTest.odt b/vendor/sboden/odtphp/tests/src/files/input/ConfigTest.odt
new file mode 100755
index 0000000000..480ce57de7
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/ConfigTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/CustomPropertiesTest.odt b/vendor/sboden/odtphp/tests/src/files/input/CustomPropertiesTest.odt
new file mode 100644
index 0000000000..e51af98a92
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/CustomPropertiesTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/CustomPropertyExistsTest.odt b/vendor/sboden/odtphp/tests/src/files/input/CustomPropertyExistsTest.odt
new file mode 100644
index 0000000000..6aa978b2c1
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/CustomPropertyExistsTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/EncodingTest.odt b/vendor/sboden/odtphp/tests/src/files/input/EncodingTest.odt
new file mode 100755
index 0000000000..985fcbcce3
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/EncodingTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/ImageTest.odt b/vendor/sboden/odtphp/tests/src/files/input/ImageTest.odt
new file mode 100755
index 0000000000..376df5009d
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/ImageTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/LargeVariableTest.odt b/vendor/sboden/odtphp/tests/src/files/input/LargeVariableTest.odt
new file mode 100755
index 0000000000..5196e2d6f5
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/LargeVariableTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/LargeVariableTest1.odt b/vendor/sboden/odtphp/tests/src/files/input/LargeVariableTest1.odt
new file mode 100755
index 0000000000..e87b3ca071
--- /dev/null
+++ b/vendor/sboden/odtphp/tests/src/files/input/LargeVariableTest1.odt
@@ -0,0 +1 @@
+{large_content}
diff --git a/vendor/sboden/odtphp/tests/src/files/input/NestedSegmentTest.odt b/vendor/sboden/odtphp/tests/src/files/input/NestedSegmentTest.odt
new file mode 100755
index 0000000000..7f477e5dae
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/NestedSegmentTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/input/VariableTest.odt b/vendor/sboden/odtphp/tests/src/files/input/VariableTest.odt
new file mode 100755
index 0000000000..d72bac6f82
Binary files /dev/null and b/vendor/sboden/odtphp/tests/src/files/input/VariableTest.odt differ
diff --git a/vendor/sboden/odtphp/tests/src/files/output/.gitkeep b/vendor/sboden/odtphp/tests/src/files/output/.gitkeep
new file mode 100644
index 0000000000..e69de29bb2