Este módulo extiende el addon fs_image para admitir la creación y el almacenamiento de miniaturas para imágenes. Este módulo es un módulo técnico y no está pensado para que lo instalen los usuarios finales. Solo proporciona un mixin para que lo usen otros módulos y un modelo para almacenar las miniaturas.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Este módulo técnico permite a Odoo generar y almacenar versiones en miniatura redimensionadas de las imágenes adjuntas a los registros, y mostrarlas en el formulario de adjuntos y en un menú dedicado.
Este es un módulo técnico pensado para ser usado por otros módulos en lugar de ser configurado directamente por usuarios finales. Proporciona un "mixin" reutilizable (un bloque de construcción) que otros módulos pueden añadir a sus propios modelos para que esos modelos puedan producir miniaturas a partir de una imagen.
Qué hace:
- Para una imagen dada, puede crear copias redimensionadas en los tamaños solicitados (ancho y alto) y almacenarlas como registros fs.thumbnail vinculados al ir.attachment original.
- Las miniaturas se nombran usando un nombre base más el ancho y el alto, y el nombre base se limpia (slugified) para que la misma imagen y el mismo nombre base siempre correspondan al mismo conjunto de miniaturas.
- Puede buscar miniaturas existentes para una imagen y crear solo los tamaños que faltan, evitando duplicados.
- El formato de salida se puede forzar mediante el parámetro del sistema fs_image_thumbnail.resize_format; de lo contrario, se mantiene el formato de la imagen original.
Dónde aparece en Odoo: - Un menú "Fs Image Thumbnails" bajo el menú de almacenamiento abre una lista y un formulario de todas las miniaturas almacenadas. - El formulario de adjunto incorpora una sección "Thumbnails" que lista las miniaturas vinculadas a ese adjunto. - La búsqueda y la agrupación están disponibles por nombre, nombre base, tipo mime y adjunto.
Reglas de negocio y comportamientos: - Una imagen debe estar adjunta a un adjunto antes de que se puedan generar miniaturas; de lo contrario, se genera un error. - Cuando se pasan varias imágenes a la vez, se debe proporcionar un nombre base; de lo contrario, se genera un error. - Las miniaturas se eliminan automáticamente cuando se elimina su adjunto original. - Los usuarios normales solo pueden leer miniaturas; la creación la realiza el sistema.
Depende de
Lo necesitan otros módulos
Modelos y campos (3)
- fs.thumbnail · modelo nuevo
- ir.attachment · amplía un modelo existentethumbnail_ids (Thumbnails)
- fs.image.thumbnail.mixin · modelo nuevoname, size_x (X size), size_y (Y size), mimetype, base_name (The base name of the thumbnail image (without extension)), attachment_id (Attachment)
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.
Fuentes · Odoo 18.0
Confirmado el 2026-11-03 en la rama 18.0 de OCA/storage.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Este addon proporciona una forma cómoda de obtener y crear miniaturas de imágenes si no existen. Toda la lógica está implementada por el modelo abstracto fs.image.thumbnail.mixin. El método principal es get_or_create_thumbnails, que acepta una instancia de FSImageValue, una lista de tamaños de miniatura y un nombre base.
Cuando se llama al método, comprobará si la miniatura existe para los tamaños y el nombre base dados. Si no es así, la creará.
El modelo fs.thumbnail proporcionado por este addon es una implementación concreta del modelo abstracto fs.image.thumbnail.mixin. La motivación para implementar toda la lógica en un modelo abstracto es permitir a los desarrolladores crear sus propios modelos de miniaturas. Esto podría ser útil si desea almacenar las miniaturas en un almacenamiento diferente, ya que puede especificar el almacenamiento a utilizar por modelo en la vista de formulario fs.storage.
Crear / recuperar miniaturas es tan sencillo como:
from odoo.addons.fs_image.fields import FSImageValue
# create an attachment with a image file
attachment = self.env['ir.attachment'].create({
'name': 'test',
'datas': base64.b64encode(open('test.png', 'rb').read()),
'datas_fname': 'test.png',
})
# create a FSImageValue instance for the attachment
image_value = FSImageValue(attachment)
# get or create the thumbnails
thumbnails = self.env['fs.thumbnail'].get_or_create_thumbnails(image_value, sizes=[(800,600), (400, 200)], base_name='my base name')Si tiene un modelo con un campo FSImage, la llamada a get_or_create_thumbnails es aún más sencilla:
from odoo import models
from odoo.addons.fs_image.fields import FSImage
class MyModel(models.Model):
_name = 'my.model'
image = FSImage('Image')
my_record = cls.env['my.model'].create({
'image': open('test.png', 'rb'),
})
# get or create the thumbnails
thumbnails = record.image.get_or_create_thumbnails(my_record.image,
sizes=[(800,600), (400, 200)], base_name='my base name')Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.