Конвертація HTML зображень у вкладення

Цей модуль надає функціонал для конвертації зображень з HTML полів у вкладення Odoo. Він може обробляти як base64-кодовані зображення, так і зовнішні URL-адреси зображень, роблячи їх доступними як вкладення Odoo та оновлюючи HTML-вміст відповідно.

Основні можливості включають:

Автоматична конвертація зовнішніх зображень та base64-кодованих зображень у вкладення
Налаштовувана система завдань для обробки конкретних моделей та полів
Маркування вкладень для відстеження та керування
Очищення невикористаних зображень-вкладень
Підтримка як пакетної обробки, так і обробки окремих записів

Налаштування

Налаштування модуля просте:

Перейдіть до Налаштування -> Технічне -> HTML зображення у вкладення
Створіть нове завдання, вказавши:
- Назва: Ідентифікатор завдання
- Модель: Цільова модель, що містить HTML поля
- HTML поле: Цільове поле, що містить зображення для обробки
Натисніть "Створити рядки" для генерації рядків обробки
Використовуйте кнопку "Виконати" для обробки окремих рядків або "Виконати все" для пакетної обробки

Технічні деталі

Модуль складається з кількох ключових компонентів:

1. Обробка HTML зображень

Модуль обробляє два типи зображень у HTML-вмісті:

Base64-кодовані зображення: Зображення, вбудовані безпосередньо в HTML за допомогою data URL
```
<img src="data:image/jpeg;base64,/9j/4AAQSkZJRg...">
```
Зовнішні зображення: Зображення, на які посилаються через URL
```
<img src="https://example.com/image.jpg">
```

2. Реалізація міксину

Модуль надає клас-міксин, який може бути успадкований будь-якою моделлю, що потребує обробки зображень:

class MyModel(models.Model):
    _name = 'my.model'
    _inherit = ['kw.html.image2attachment.mixin']
    
    description = fields.Html()

3. Автоматична обробка

Зображення автоматично обробляються під час:

Створення запису (метод create)
Оновлення запису (метод write)
Пакетної обробки через систему завдань

4. Керування зображеннями

Модуль надає інструменти для:

Конвертації зображень у вкладення Odoo
Оновлення HTML-вмісту з URL-адресами вкладень
Маркування вкладень для відстеження
Очищення невикористаних вкладень

Приклади використання

1. Пряме використання моделі

Для моделей, що успадковують міксин:

# Зображення будуть автоматично оброблені
record = env['my.model'].create({
    'description': '<img src="data:image/jpeg;base64,...">'
})

# Оновлення вмісту з новими зображеннями
record.write({
    'description': '<img src="https://example.com/image.jpg">'
})

2. Використання системи завдань

Для обробки існуючих записів:

Створіть завдання для цільової моделі та поля
Згенеруйте рядки обробки

Виконайте обробку:

# Обробка одного рядка
task_line.action_execute()

# Обробка всіх рядків
task.action_execute_all()

3. Ручна обробка

Ви також можете обробляти зображення вручну:

# Отримання інструменту обробки
tool = env['kw.html_image2attachment.tool']

# Обробка конкретного запису
tool.process_record(record, 'description')

# Очищення невикористаних зображень
tool.clean_unused_images(record)

Посібник з інтеграції

1. Успадкування міксину

Щоб додати обробку зображень до вашої моделі:

# models/my_model.py
from odoo import models, fields

class MyModel(models.Model):
    _name = 'my.model'
    _inherit = ['mail.thread', 'kw.html.image2attachment.mixin']
    
    name = fields.Char()
    description = fields.Html()  # HTML поле, яке буде оброблятися
    other_html_field = fields.Html()  # Інше HTML поле
    
    # Опціонально: Перевизначте html_fields для вказівки полів для обробки
    @property
    def html_fields(self):
        return ['description', 'other_html_field']

2. Міграційний скрипт

Для обробки існуючих записів під час оновлення модуля створіть міграційний скрипт:

# migrations/16.0.1.1.0/post-migrate.py
from odoo import api, SUPERUSER_ID

def migrate(cr, version):
    if not version:
        return
        
    env = api.Environment(cr, SUPERUSER_ID, {})
    
    # Отримання всіх моделей, що успадковують kw.html.image2attachment.mixin
    IrModel = env['ir.model']
    models = IrModel.search([
        ('inherited_model_ids.model', '=', 'kw.html.image2attachment.mixin')
    ])
    
    # Обробка кожної моделі
    tool = env['kw.html_image2attachment.tool']
    for model in models:
        if not model.model in env:
            continue
            
        Model = env[model.model]
        records = Model.search([])
        
        # Маркування вкладень для кожного запису
        for record in records:
            tool.mark_attachments(record)
            
        # Комміт після кожної моделі, щоб уникнути довгих транзакцій
        env.cr.commit()

3. Структура директорій

Ваш модуль повинен мати таку структуру:

my_module/
├── __init__.py
├── __manifest__.py
├── models/
│   ├── __init__.py
│   └── my_model.py
└── migrations/
    └── 16.0.1.1.0/
        └── post-migrate.py

4. Залежності в маніфесті

Додайте залежність у маніфесті вашого модуля:

# __manifest__.py
{
    'name': 'My Module',
    'version': '16.0.1.1.0',
    'depends': [
        'base',
        'kw_html_image2attachment',
    ],
    # ...
}

Модуль можна скачати на маркеті за посиланням

https://apps.odoo.com/apps/modules/16.0/kw_html_image2attachment

в Огляди модулів