OdooWiki OCA HUB

Fs Image Thumbnail

fs_image_thumbnail folder_open OCA/storage open_in_new
Sin categoría Licencia: AGPL-3

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.0

Este 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.

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-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Este 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.

info

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.