PDF GLPI plugin

This plugin allow you to select and export informations of an equipment to PDF file.

• equipment types from GLPI
• equipment types from some plugins
• additional data from some plugins
• one or many object(s) in a file

Instalación en otra máquina

Esta es una versión personalizada del plugin PDF para GLPI 11.0.x. Antes de instalarla, compruebe que la instancia de destino usa PHP 8.2 o superior y una versión de GLPI comprendida entre 11.0.0 y 11.0.99. No la instale sobre GLPI 10 ni sobre una versión posterior a GLPI 11 sin antes validar la compatibilidad.

Los pasos siguientes suponen que GLPI está instalado en /var/www/glpi y que su usuario administrador se llama glpi. Ajuste ambas rutas/nombres a su instalación.

1. Ponga GLPI en mantenimiento o realice la operación en una ventana de mantenimiento, y haga una copia de seguridad de su base de datos y de los archivos de GLPI.

2. Clone este repositorio (o copie una exportación completa) dentro de la carpeta de plugins, con el nombre de directorio exacto pdf:

   cd /var/www/glpi/plugins
   git clone https://github.com/angelmq152/GLPI-PDF-report.git pdf

   Si se transfiere mediante rsync, scp o un archivo comprimido, copie todo el contenido del repositorio, incluido vendor/. Las dependencias PHP ya se distribuyen en ese directorio, por lo que Composer no es necesario en el servidor de destino.

3. Asegure que el propietario y los permisos del árbol coinciden con los del resto de plugins de la instalación. Por ejemplo, si el servicio web se ejecuta como www-data:

   chown -R www-data:www-data /var/www/glpi/plugins/pdf
   find /var/www/glpi/plugins/pdf -type d -exec chmod 755 {} \;
   find /var/www/glpi/plugins/pdf -type f -exec chmod 644 {} \;

4. Desde la raíz de GLPI, instale y active el plugin. El comando de instalación crea sus tablas de configuración, preferencias y permisos:

   cd /var/www/glpi
   php bin/console plugin:install pdf --username=glpi
   php bin/console plugin:activate pdf

   Alternativamente, un superadministrador puede instalarlo y activarlo desde Configuración > Plugins en la interfaz web.

5. Inicie sesión como superadministrador y conceda el derecho PDF export a los perfiles que deban generar PDFs. Revise también Configuración > General > PDF para escoger la moneda, el texto final y, opcionalmente, el logo del plugin Branding (requiere Branding 3.0 o posterior).

6. Compruebe el resultado abriendo un activo y usando la acción masiva de exportación PDF. Si el plugin no aparece en la lista, revise que el nombre del directorio sea exactamente pdf, que se hayan ejecutado ambos comandos de consola y los registros de GLPI.

Exportación desatendida (opcional)

El plugin incluye una exportación por consola y la acción automática PdfExport. En Configuración > General > PDF configure:

• Carpeta de destino: debe existir o poder crearse y ser escribible por el usuario que ejecuta el cron. Si se deja vacía, se usa files/_pdf-export dentro del directorio de datos de GLPI.
• Elementos por PDF, los tipos de elementos que se exportarán (vacío = todos), la cuenta de GLPI cuyos permisos se aplicarán y cuántas ejecuciones antiguas se conservarán (0 conserva todas).

La cuenta configurada debe existir y tener acceso a las entidades y tipos que se pretenden exportar. Ejecute primero una prueba limitada:

cd /var/www/glpi
php bin/console plugins:pdf:export --list
php bin/console plugins:pdf:export --itemtype=Computer --limit=5

Para ejecutar la exportación completa:

php bin/console plugins:pdf:export --all

Cada ejecución crea un directorio con marca de tiempo y un manifest.txt con los SHA-256 de los PDFs generados. La acción automática se instala desactivada; actívela en Configuración > Acciones automáticas, configure su frecuencia y asegúrese de que el cron de GLPI se ejecute en modo externo (CLI). No se ejecuta desde peticiones web.

Actualización y reversión

Antes de actualizar, respalde la base de datos y el directorio actual del plugin. Sustituya el contenido de plugins/pdf por la nueva versión, incluido vendor/, y vuelva a cargar la página de plugins o ejecute el comando de instalación con --force para aplicar las migraciones:

cd /var/www/glpi
php bin/console plugin:install pdf --username=glpi --force
php bin/console plugin:activate pdf

No borre el plugin desde el sistema de archivos mientras siga instalado: desactívelo y desinstálelo primero desde GLPI. La desinstalación elimina las tablas de configuración y preferencias del plugin, por lo que requiere una copia de seguridad si se quiere conservar esa configuración.

Unattended export (local fork)

Settings live in Setup > General > PDF: destination folder, items per PDF file, the GLPI account whose rights the export uses, the itemtypes in scope (empty = all), and how many past runs to keep.

Each run writes a timestamped folder holding its PDFs and a manifest.txt with the SHA-256 of every file.

From the console:

php bin/console plugins:pdf:export --list          # exportable itemtypes
php bin/console plugins:pdf:export --all           # everything in scope
php bin/console plugins:pdf:export -t Supplier     # one itemtype
php bin/console plugins:pdf:export --all --keep-all  # do not prune old runs

Scheduled: enable the PdfExport automatic action in Setup > Automatic actions and set its frequency there. It only runs in external (CLI) cron mode.

Download

Releases can be donwloaded on GitHub.

Documentation

We maintain a detailed documentation.

Contact

For notices about major changes and general discussion of pdf, subscribe to the /r/glpi subreddit. You can also chat with us via @glpi on Telegram.

Professional Services

The GLPI Network services are available through our Partner's Network. We provide special training, bug fixes with editor subscription, contributions for new features, and more.

Obtain a personalized service experience, associated with benefits and opportunities.

Contributing

• Open a ticket for each bug/feature so it can be discussed
• Follow development guidelines
• Refer to GitFlow process for branching
• Work on a new branch on your own fork
• Open a PR that will be reviewed by a developer

Copying

• Code: you can redistribute it and/or modify it under the terms of the GNU General Public License (AGPL-3.0).