集成wagtail-modeltranslation的Wagtail多语言页面区块复制粘贴方案咨询

1. 梳理区块字段类型 #

先明确自定义Block中哪些是文本类字段（需替换翻译），哪些是媒体/配置类字段（直接复用）：

• 文本类：CharBlock、TextBlock、RichTextBlock
• 媒体/配置类：ImageChooserBlock、DocumentChooserBlock、嵌套StreamBlock、IntegerBlock（如滑块数量配置）

2. 给Page模型添加区块复制方法 #

在你的基础Page模型（如BasePage）中添加核心复制逻辑，遍历StreamField区块，保留非文本字段，清空文本字段（或保留原文本待替换）：

from wagtail.models import Page

class BasePage(Page):
    # 你的页面字段定义，示例：
    body = StreamField(...)

    def copy_blocks_to_target_language(self, target_lang):
        # 获取目标语言页面，不存在则创建翻译副本
        target_page, _ = self.get_translation_or_none(target_lang)
        if not target_page:
            target_page = self.copy_for_translation(target_lang)
            target_page.save()

        new_body = []
        for block in self.body:
            # 复制区块基础结构
            copied_block = block.block_type(block.value)
            
            # 遍历区块内字段，区分文本与非文本
            if hasattr(copied_block, 'value'):
                for field_name, field in copied_block.block_definition.fields.items():
                    field_type = field.__class__.__name__
                    text_types = ('CharBlock', 'TextBlock', 'RichTextBlock')
                    
                    if field_type in text_types:
                        # 文本字段清空，留待填写翻译
                        copied_block.value[field_name] = ""
                    else:
                        # 非文本字段直接复用原页面值
                        copied_block.value[field_name] = block.value.get(field_name)

            new_body.append(copied_block)
        
        # 更新目标语言页面的区块内容
        target_page.body = new_body
        target_page.save()
        return target_page

3. 在后台添加复制操作按钮 #

通过Wagtail钩子，在英文页面编辑页添加「复制区块到荷兰语」的操作按钮：

# 在项目的wagtail_hooks.py中
from wagtail import hooks
from wagtail.admin.panels import PageActionsPanel
from django.utils.translation import gettext_lazy as _
from django.urls import reverse

@hooks.register('register_page_action')
def copy_blocks_to_nl_action(page, request):
    # 仅在英文页面显示该按钮
    if page.language_code == 'en':
        return PageActionsPanel(
            page,
            request,
            actions=[
                {
                    'label': _('Copy Blocks to Dutch'),
                    'url': reverse('copy_blocks_to_nl', args=[page.id]),
                    'classname': 'button button-secondary',
                }
            ]
        )

4. 添加路由与视图处理请求 #

配置路由 #

在项目urls.py中添加复制请求的路由：

from django.urls import path
from .views import copy_blocks_to_nl

urlpatterns = [
    # 其他路由
    path('copy-blocks-to-nl/<int:page_id>/', copy_blocks_to_nl, name='copy_blocks_to_nl'),
]

实现视图逻辑 #

在views.py中编写处理复制请求的视图：

from django.shortcuts import redirect
from django.contrib.auth.decorators import login_required
from .models import BasePage

@login_required
def copy_blocks_to_nl(request, page_id):
    page = BasePage.objects.get(id=page_id)
    target_page = page.copy_blocks_to_target_language('nl')
    # 跳转到荷兰语页面的编辑页
    return redirect('wagtailadmin_pages:edit', target_page.id)

5. 处理嵌套区块（可选） #

如果使用了StructBlock、ListBlock等嵌套结构，需递归处理内部字段，修改复制方法中的区块处理逻辑：

def process_block_value(block_value, block_definition):
    processed_value = {}
    for field_name, field in block_definition.fields.items():
        field_type = field.__class__.__name__
        text_types = ('CharBlock', 'TextBlock', 'RichTextBlock')
        
        if field_type in text_types:
            processed_value[field_name] = ""
        elif field_type == 'StructBlock':
            # 递归处理嵌套StructBlock
            processed_value[field_name] = process_block_value(
                block_value.get(field_name),
                field.block_definition
            )
        elif field_type == 'ListBlock':
            # 处理ListBlock中的每个子项
            processed_list = []
            for item in block_value.get(field_name, []):
                processed_list.append(process_block_value(item, field.child_block))
            processed_value[field_name] = processed_list
        else:
            processed_value[field_name] = block_value.get(field_name)
    return processed_value

# 在copy_blocks_to_target_language方法中替换区块处理代码：
copied_value = process_block_value(block.value, block.block_definition)
copied_block = block.block_type(copied_value)
new_body.append(copied_block)

6. 测试验证 #

1. 创建并配置好英文页面的所有区块（含图片、滑块等组件）
2. 在英文页面编辑页点击「Copy Blocks to Dutch」按钮
3. 跳转到荷兰语页面编辑页，确认区块结构完整、非文本组件保留、文本字段为空
4. 仅修改文本字段为荷兰语翻译后保存发布

内容的提问来源于stack exchange，提问作者Thehiddenguy