feat(mail): one admin record per mail template with a locale switcher

Gap G-35-1 (supersedes D-05), tracer slice:
- postcard: migration 202611130001_mail_template_base_code (base_code
  column and index); SyncIndex writes base_code; EnsureLocaleRows creates
  the <template>-<locale> rows of locales that ship no file; TemplateBase
  and Catalog.TemplateFor; send, preview and validation resolve a missing
  <template>-<locale> to the locale's customization, else the base's
  customization, else the base file. Names with their own file send as
  before.
- cabana: mail locales are the translator's plus the TranslationWriter's
  enabled locales; sync ensures the locale rows and re-syncs when the
  locale set changes; record lookups admit fallback-locale rows; the
  record title is the base code; RecordMeta.LocaleVariants
  (RecordLocaleVariant) on the show and update responses.
- admin: LocaleVariantSwitcher in the update form header, from
  meta.localeVariants, behind the unsaved-changes confirm.
- tests: TestMailOverrideSmoke/locale_fallback,
  TestMailScreensSmoke/locales, LocaleVariantSwitcher.test.ts.
This commit is contained in:
Jakub Zych
2026-11-13 20:29:42 +01:00
parent 9afe95ccef
commit 52c9c7eb18
22 changed files with 920 additions and 63 deletions

View File

@@ -107,6 +107,26 @@ describe('FormView mail footer actions and meta.deletable', () => {
expect(absent.wrapper.find('[data-action="delete"]').exists()).toBe(true)
})
it('shows the locale switcher from meta.localeVariants when there are two or more', async () => {
const two = await mountApp(
'/summercms/cabana/mailtemplates/7',
routes({
[`GET ${RECORD}`]: mailRecord({
localeVariants: [
{ id: 7, locale: '', label: 'Default', states: [], current: true },
{ id: 9, locale: 'de', label: 'de', states: ['Customized'], current: false },
],
}),
}),
)
const select = two.wrapper.find<HTMLSelectElement>('header select[data-locale-variant]')
expect(select.exists()).toBe(true)
expect(select.findAll('option').map((option) => option.text())).toEqual(['Default', 'de — Customized'])
const none = await mountApp('/summercms/cabana/mailtemplates/7', routes())
expect(none.wrapper.find('[data-locale-variant]').exists()).toBe(false)
})
it('toasts 403 and 409 paths from record actions', async () => {
const forbidden = await mountApp(
'/summercms/cabana/mailtemplates/7',

View File

@@ -0,0 +1,75 @@
import { afterEach, beforeEach, describe, expect, it } from 'vitest'
import { enableAutoUnmount, flushPromises, mount } from '@vue/test-utils'
import { defineComponent, h } from 'vue'
import { createMemoryHistory, createRouter } from 'vue-router'
import LocaleVariantSwitcher from '../../src/components/form/LocaleVariantSwitcher.vue'
import { setBundle } from '../../src/app/i18n'
import { resetState } from '../helpers'
const variants = [
{ id: 7, locale: '', label: 'Default', states: [], current: true },
{ id: 9, locale: 'de', label: 'de', states: ['Customized', 'File changed'], current: false },
{ id: 8, locale: 'en', label: 'en', states: [], current: false },
]
const Stub = defineComponent({ render: () => h('div') })
async function mountSwitcher(allow: () => boolean) {
const router = createRouter({
history: createMemoryHistory(),
routes: [{ path: '/:vendor/:plugin/:controller/:id', name: 'update', component: Stub }],
})
router.beforeEach((_to, from) => (from.matched.length === 0 ? true : allow()))
await router.push('/summercms/cabana/mailtemplates/7')
const wrapper = mount(LocaleVariantSwitcher, {
props: { variants },
global: { plugins: [router] },
attachTo: document.body,
})
return { wrapper, router }
}
beforeEach(() => {
resetState()
setBundle({ 'backend::lang.form.locale_variant': { other: 'Language' } }, 'en')
})
afterEach(() => {
document.body.innerHTML = ''
})
enableAutoUnmount(afterEach)
describe('LocaleVariantSwitcher', () => {
it('is a labelled select of the variants with their states, the current one selected', async () => {
const { wrapper } = await mountSwitcher(() => true)
const select = wrapper.find<HTMLSelectElement>('select[data-locale-variant]')
expect(select.exists()).toBe(true)
const label = wrapper.find('label')
expect(label.text()).toBe('Language')
expect(label.attributes('for')).toBe(select.attributes('id'))
expect(wrapper.findAll('option').map((option) => option.text())).toEqual([
'Default',
'de — Customized, File changed',
'en',
])
expect(select.element.value).toBe('7')
})
it('opens the chosen version on the same route', async () => {
const { wrapper, router } = await mountSwitcher(() => true)
await wrapper.find('select').setValue('9')
await flushPromises()
expect(router.currentRoute.value.params.id).toBe('9')
expect(router.currentRoute.value.path).toBe('/summercms/cabana/mailtemplates/9')
})
it('puts the selection back when the navigation is refused', async () => {
const { wrapper, router } = await mountSwitcher(() => false)
const select = wrapper.find<HTMLSelectElement>('select')
await select.setValue('8')
await flushPromises()
expect(router.currentRoute.value.params.id).toBe('7')
expect(select.element.value).toBe('7')
})
})