// NO PROD JSON API (bucket B — feed is a DataTables render payload or // {"html":...}, not data) — mock until backend (see PROD_API_INVENTORY.md) // Represents: GET /languages/ · LanguagesController — see docs/ISYSTEM_REFERENCE.md §Batch 3 "Languages" /* ==================================================================== LANGUAGES — Settings ▾ rebuild (Batch 3), Hrs* shell ==================================================================== Three surfaces behind one sidebar entry, exactly as the real platform splits them (list → translate grid → raw-PHP editor). This file loads after HostSettings.jsx, so its `SetLanguages` replaces the legacy stub. Traceability (all line cites are LanguagesController.php unless noted): · Page GET /languages/ routes/admin.php:1328-1330 · index:52 (unnamed route — array syntax, so the surrounding Route::name('admin.') prefix attaches no name) · Rows GET /languages/getLanguagesTable admin.php:1332 · :419 · Form GET /languages/form/ admin.php:1336 · languageForm:517 · Save POST /languages/saveLanguage/ admin.php:1340 · saveLanguage:667 · Translate GET /languages/translate/{lang_id} admin.php:1344 · showTransalte:128 (method-name typo is in the source) · Save tr. POST /languages/saveTranslation/{id} admin.php:1347 · :545 · Code GET /languages/code/{lang_id} admin.php:1350 · showCode:170 · Save code POST /languages/saveCode/{id} admin.php:1353 · :621 · Seed GET /languages/generateDefaultLang/ admin.php:1356 · :102 · Delete GET /languages/delete/{id}/ admin.php:1608 · delete:731 · Google GET /translateByGoogle/ admin.php:1656 · :317 POST /translateByGoogleBatch/ admin.php:1660 · :353 · Blade admin/languages/index.blade.php · forms/language.blade.php · translate.blade.php · code.blade.php · JS public/js/pages/languages/ajax.js PERMISSION HONESTY (surfaced in the page Tip, not hidden): the sidebar entry renders only for `isadmin()` (SUPER_ADMIN, user_level 0 — sidebar.blade.php:522, utils.php:528) inside a Settings ▾ dropdown gated `isadmin() || isSkinAdmin() || $enable_agents_operators`. Server side ONLY `delete()` re-checks isadmin() (:732). saveLanguage / showTransalte / saveTranslation / showCode / saveCode / generateDefaultLang carry NO role check at all — any authenticated 2FA'd BO user of any level can reach them by URL, and saveCode writes arbitrary PHP to disk. // Faithful absences (nothing added — brief §3): no KPIs, no export, no bulk actions, no per-row status column (the list is ID / Name / Translate / Actions and nothing else, controller L57), no create/update audit columns (`addedByUser`/`updatedByUser` are not fillable and are never written). `LanguagesController::stati()` (:408 — 0 "Disabled" / 1 "Active") and `tipologieLanguages()` (:503) are dead code on this screen and are not used here either. // // Known-bug divergences — evident intent implemented (CLAUDE.md policy): 1. Edit form prefills `flagicon` with `$row->locale` (forms/language.blade.php:48). Here the field shows the row's real flagicon. // 2. Reset: ajax.js binds a `#kt_reset` handler to an element the blade never renders, so filters can only be cleared by hand. A working Reset is wired here. // 3. The `Translate` column header is clickable but the server order switch only knows `id` and `name` (:449-467), so clicking it silently falls back to `languages.id ASC`. The cell renders `languages.name`, so here the header sorts by name. // 4. Nested-key display bug: for array-valued lang entries the target-side textarea is prefilled with the EN source value, not the target's own sub-translation (translate.blade.php:164-183) — so re-saving reverts nested translations to English. Here nested rows show the target's own saved value. // 5. `saveTranslation`'s `str_replace("'", "'", $val)` is a no-op (it replaces an apostrophe with itself) and nothing escapes `"`, so a typed double quote can corrupt the generated PHP file. This build escapes quotes on save and flags affected rows while typing. // 6. `saveLanguage`'s create path discards `Language::create($datip)->id` and echoes back the (empty) request id (:719-722). The new row here carries its real id. // 7. The `Edit php` link on the translate page sits next to the "EN" heading but opens the TARGET language's file. Placed on the target column here, labelled with the target language. // Surfaced but NOT silently fixed (real behaviour the operator must know): · saveTranslation regenerates the whole PHP file and `continue`s past empty scalar values, so blank targets are DROPPED from the file and fall back at runtime. The save confirmation counts them. · getLanguages()/getLanguageData() cache for 24h (`languages_list`, `language_data:{locale}`) and neither saveLanguage nor delete calls Cache::forget — new/edited/deleted languages can take up to 24h to appear in the pickers. Every save says so. // · The translate grid can only ever show keys that exist in storage/lang/en/.php. Keys referenced by admin screens but missing from the EN file (backend.deleted_users, backend.cost, backend.limit_day, sport.bet_tax …) never appear here, so they cannot be added from this screen at all — only through the raw-PHP editor. // · Missing/unknown language id on translate/code/save endpoints answers a bare `die()` — a blank 200, not a 404. // · index.blade.php pulls TinyMCE 5.0.16 from cdnjs although nothing on the page uses an editor, and languageForm passes an unused $max_images = 6. // · generateDefaultLang is routed and live, but its UI link is commented out (code.blade.php:37-40). It is rendered here inside the code editor, explicitly marked, because the endpoint exists and is reachable. Label policy: `backend.languages`, `backend.settings`, `backend.actions`, `backend.id`, `backend.insert_name`, `backend.active`, `backend.disabled` all resolve in the committed seed (public/default-lang/en/backend.php), so those labels are real. The rest of this screen is hardcoded in the blades — "Translate", the Backend/Frontend/Subcategories tab labels, "Translate all" and "Translate language" in English; the modal title ("Nuovo language"), the edit tooltip ("Modifica"), the validation errors ("Compila il campo code / locale / flag icon") and the fallback alert ("Errore sconosciuto") in Italian. Operator-facing English is written for the Italian ones — label inferred. UNCLEAR (recorded, not invented away): · No language seeder exists; production's `languages` rows are uncommitted data. The 13 rows below are the prototype's own observed set (carried over from the legacy SetLanguages). HostSkins.jsx:103 hardcodes a DIFFERENT 13 (adds Arabic + Română, drops Polski + Nederlands) for the SEO-content tabs, which the real SeoContentBlockController builds from this very table — the two lists should be reconciled once production data is known. · `flagicon` and `locale` values are not committed anywhere; the shapes used here (svg filename / underscore locale) are plausible, not verified. · frontend.php key names are representative — the reference records the file's size (~194 keys) but not its contents. ==================================================================== */ const { useState: hslUseState, useMemo: hslUseMemo } = React; const hslToast = (m, detail) => window.PAYBO?.emitToast && window.PAYBO.emitToast({ id: `hsl-${Date.now()}-${Math.floor(Math.random() * 1e6)}`, tx_id: m, amount: 0, currency: "HOST", player: "Languages", reason: detail || "Prototype state only \u2014 not persisted.", }); /* Deterministic PRNG (mulberry32) — mock state renders identically each load. */ const hslRng = pbRng; // was a local copy of mulberry32 — see pbRng in src/data.jsx /* languages.addedTime / updateTime are bigint unix ints (migration 2026_06_24_155202_create_languages_table). Not list columns — carried for shape only, and deliberately shown nowhere. */ const hslUnix = (y, m, d, h, mi) => Math.floor(new Date(y, m - 1, d, h, mi).getTime() / 1000); /* ------------------------------------------------------------------ `languages` rows. Columns mirror the migration; `bcw_ok` / `sa_ok` / `novus_ok` and the timestamps are carried because the table really has them, and are deliberately rendered nowhere — the real form has no field for any of them (see the SUGGESTION in the header). ------------------------------------------------------------------ */ /* ---------- the row source ------------------------------------------------ Was thirteen invented languages with hand-written unix timestamps. Now `locales`, live. isystem's `languages` table carries novus_ok / bcw_ok / sa_ok as three boolean columns, so supporting a fourth integration meant a migration. Here that is locale_integration_support, keyed by (locale_code, integration_code), which is why this maps a set of codes into the three flags the screen shows rather than reading three columns. A fourth integration is a row, not a schema change. */ const hslSupports = (row, code) => (row.support || []).some(x => x.integration_code === code); const hslRow = (l) => ({ id: l.id, name: l.name, code: l.code, locale: l.bcp47, flagicon: l.flag_icon, backend: l.enabled_backend ? 1 : 0, frontend: l.enabled_frontend ? 1 : 0, novus_ok: hslSupports(l, "novus") ? 1 : 0, bcw_ok: hslSupports(l, "bcw") ? 1 : 0, sa_ok: hslSupports(l, "savagetech") ? 1 : 0, addedTime: l.created_at ? Math.floor(Date.parse(l.created_at) / 1000) : null, updateTime: l.updated_at ? Math.floor(Date.parse(l.updated_at) / 1000) : null, }); /* ------------------------------------------------------------------ Translate-grid tabs. showTransalte (:151-162) exposes exactly these three; the other nine lang files are editable only through the raw-PHP editor (getLanguageFiles :75-100). ------------------------------------------------------------------ */ const HSL_TABS = [ { key: "backend", label: "Backend", file: "backend.php" }, { key: "frontend", label: "Frontend", file: "frontend.php" }, { key: "subcategories", label: "Subcategories", file: "subcategories.php" }, ]; /* EN source = storage/lang/en/.php. Every backend key below is a real key documented in the reference (it resolves in the committed seed public/default-lang/en/backend.php). `report_periods` illustrates an array-valued entry: the reference documents the nested-prefill bug (translate.blade.php:164-183) but does not enumerate which backend keys are arrays, so this group is representative of the SHAPE, not verified. frontend keys are representative too (see UNCLEAR in the header). subcategories is EMPTY on purpose: no subcategories.php seed exists anywhere in the repo even though config/langfiles.php:6 and this screen's third tab both expect one. */ const HSL_EN = { backend: [ ["id", "ID"], ["name", "Name"], ["actions", "Actions"], ["languages", "Languages"], ["settings", "Settings"], ["deposit_methods", "Deposit methods"], ["insert_name", "Insert name"], ["active", "Active"], ["disabled", "Disabled"], ["language", "Language"], ["skin", "Skin"], ["status", "Status"], ["value", "Value"], ["print", "Print"], ["created_by", "Created by"], ["creation_date", "Creation date"], ["redeem_by", "Redeem by"], ["redeem_date", "Redeem date"], ["vouchers", "Vouchers"], ["voucher_code", "Voucher code"], ["voucher_pending", "Pending"], ["voucher_redeemed", "Redeemed"], ["voucher_canceled", "Canceled"], ["request_status_pending", "Pending"], ["cancelled_by_customer", "Canceled by the customer"], ["insert_amount", "Insert amount"], ["invalid_amount", "Invalid amount"], ["min_amount", "Minimum amount"], ["max_amount", "Maximum amount"], ["insufficient_funds", "Insufficient funds"], ["all_selections", "All selections"], ["enter_voucher_code", "Enter the voucher code"], ["wrong_voucher_code", "Wrong voucher code"], ["voucher_not_exists", "Voucher does not exist"], ["report_periods", { day: "Day", week: "Week", month: "Month", year: "Year" }], ], frontend: [ ["login", "Login"], ["register", "Register"], ["logout", "Log out"], ["balance", "Balance"], ["deposit", "Deposit"], ["withdraw", "Withdraw"], ["my_account", "My account"], ["promotions", "Promotions"], ["live_casino", "Live Casino"], ["sports", "Sports"], ["search_games", "Search games"], ["show_more", "Show more"], ["forgot_password", "Forgot your password?"], ["contact_us", "Contact us"], ["terms", "Terms & Conditions"], ], subcategories: [], }; /* Real file sizes from the reference's committed-seed table (§Language / i18n #3): wc -l and the approximate `=>` count per file. Shown in the code editor's status bar so the operator sees how much of the file the demo buffer represents. */ const HSL_FILES = [ { key: "backend", label: "Backend", file: "backend.php", lines: 876, keys: 857, tab: true }, { key: "frontend", label: "Frontend", file: "frontend.php", lines: 198, keys: 194, tab: true }, { key: "subcategories", label: "Subcategories", file: "subcategories.php", lines: 0, keys: 0, tab: true, noSeed: true }, { key: "validation", label: "Validation", file: "validation.php", lines: 171, keys: 117 }, { key: "sport", label: "Sport", file: "sport.php", lines: 65, keys: 60 }, { key: "email", label: "Email", file: "email.php", lines: 29, keys: 25 }, { key: "passwords", label: "Passwords", file: "passwords.php", lines: 22, keys: 5 }, { key: "pagination", label: "Pagination", file: "pagination.php", lines: 19, keys: 2 }, { key: "commissions", label: "Commissions", file: "commissions.php", lines: 14, keys: 9 }, { key: "auth", label: "Auth", file: "auth.php", lines: 9, keys: 5 }, { key: "financial", label: "Financial", file: "financial.php", lines: 7, keys: 2 }, { key: "bonus", label: "Bonus", file: "bonus.php", lines: 4, keys: 1 }, ]; /* Framework catalogues reproduced verbatim (auth / passwords / pagination are Laravel 8 defaults, so these ARE the real strings); validation is a real excerpt kept short — it is the file that carries nested arrays. The rest are representative of shape and marked as such in the editor status bar. */ const HSL_STATIC_SRC = { auth: [ ["failed", "These credentials do not match our records."], ["password", "The provided password is incorrect."], ["throttle", "Too many login attempts. Please try again in :seconds seconds."], ], passwords: [ ["reset", "Your password has been reset!"], ["sent", "We have emailed your password reset link!"], ["throttled", "Please wait before retrying."], ["token", "This password reset token is invalid."], ["user", "We can't find a user with that email address."], ], pagination: [ ["previous", "« Previous"], ["next", "Next »"], ], validation: [ ["accepted", "The :attribute must be accepted."], ["email", "The :attribute must be a valid email address."], ["required", "The :attribute field is required."], ["unique", "The :attribute has already been taken."], ["size", { numeric: "The :attribute must be :size.", file: "The :attribute must be :size kilobytes.", string: "The :attribute must be :size characters.", array: "The :attribute must contain :size items." }], ], sport: [ ["bet_tax", "Bet tax"], ["coupon", "Coupon"], ["stake", "Stake"], ["odds", "Odds"], ["potential_win", "Potential win"], ["cashout", "Cashout"], ], email: [ ["subject_welcome", "Welcome to :skin"], ["subject_reset", "Reset your password"], ["greeting", "Hello :name,"], ["regards", "Regards,"], ], commissions: [ ["profile", "Commission profile"], ["period", "Period"], ["payout", "Payout"], ], financial: [ ["transfer_in", "Transfer in"], ["transfer_out", "Transfer out"], ], bonus: [ ["bonus_expired", "Your bonus has expired."], ], }; /* ------------------------------------------------------------------ Two separate pools, on purpose: · HSL_MT — what the Google Translate endpoint would hand back. Keys with no entry model the documented ok:false path (quota / dead key / bad pair): translateByGoogle logs to the `google_translate` channel and the client leaves the field UNTOUCHED rather than clobbering it with English. This demo build has no API key wired, so every miss takes that branch honestly instead of faking a translation. · coverage — how much of the pool is already saved in storage/lang/{code}/backend.php. The rest starts empty (outlined red, exactly like translate.blade.php). ------------------------------------------------------------------ */ const HSL_MT = { it: { id: "ID", name: "Nome", actions: "Azioni", languages: "Lingue", settings: "Impostazioni", deposit_methods: "Metodi di deposito", insert_name: "Inserisci il nome", active: "Attivo", disabled: "Disattivato", language: "Lingua", skin: "Skin", status: "Stato", value: "Valore", print: "Stampa", created_by: "Creato da", creation_date: "Data di creazione", redeem_by: "Riscattato da", redeem_date: "Data di riscatto", vouchers: "Voucher", voucher_code: "Codice voucher", voucher_pending: "In attesa", voucher_redeemed: "Riscattato", voucher_canceled: "Annullato", request_status_pending: "In attesa", cancelled_by_customer: "Annullato dal cliente", insert_amount: "Inserisci l'importo", invalid_amount: "Importo non valido", min_amount: "Importo minimo", max_amount: "Importo massimo", insufficient_funds: "Fondi insufficienti", all_selections: "Tutte le selezioni", enter_voucher_code: "Inserisci il codice voucher", wrong_voucher_code: "Codice voucher errato", voucher_not_exists: "Il voucher non esiste", "report_periods.day": "Giorno", "report_periods.week": "Settimana", "report_periods.month": "Mese", "report_periods.year": "Anno", login: "Accedi", register: "Registrati", logout: "Esci", balance: "Saldo", deposit: "Deposita", withdraw: "Preleva", my_account: "Il mio account", promotions: "Promozioni", live_casino: "Casinò Live", sports: "Sport", search_games: "Cerca giochi", show_more: "Mostra altro", forgot_password: "Password dimenticata?", contact_us: "Contattaci", terms: "Termini e condizioni", }, es: { id: "ID", name: "Nombre", actions: "Acciones", languages: "Idiomas", settings: "Configuración", deposit_methods: "Métodos de depósito", insert_name: "Introduce el nombre", active: "Activo", disabled: "Desactivado", language: "Idioma", skin: "Skin", status: "Estado", value: "Valor", print: "Imprimir", created_by: "Creado por", creation_date: "Fecha de creación", redeem_by: "Canjeado por", redeem_date: "Fecha de canje", vouchers: "Vouchers", voucher_code: "Código de voucher", voucher_pending: "Pendiente", voucher_redeemed: "Canjeado", voucher_canceled: "Cancelado", request_status_pending: "Pendiente", cancelled_by_customer: "Cancelado por el cliente", insert_amount: "Introduce el importe", invalid_amount: "Importe no válido", min_amount: "Importe mínimo", max_amount: "Importe máximo", insufficient_funds: "Fondos insuficientes", all_selections: "Todas las selecciones", enter_voucher_code: "Introduce el código de voucher", wrong_voucher_code: "Código de voucher incorrecto", voucher_not_exists: "El voucher no existe", "report_periods.day": "Día", "report_periods.week": "Semana", "report_periods.month": "Mes", "report_periods.year": "Año", login: "Iniciar sesión", register: "Registrarse", logout: "Cerrar sesión", balance: "Saldo", deposit: "Depositar", withdraw: "Retirar", my_account: "Mi cuenta", promotions: "Promociones", live_casino: "Casino en vivo", sports: "Deportes", search_games: "Buscar juegos", show_more: "Ver más", forgot_password: "¿Olvidaste tu contraseña?", contact_us: "Contáctanos", terms: "Términos y condiciones", }, pt: { id: "ID", name: "Nome", actions: "Ações", languages: "Idiomas", settings: "Definições", active: "Ativo", disabled: "Desativado", status: "Estado", value: "Valor", print: "Imprimir", skin: "Skin", language: "Idioma", vouchers: "Vouchers", voucher_code: "Código de voucher", voucher_pending: "Pendente", voucher_redeemed: "Resgatado", voucher_canceled: "Cancelado", login: "Entrar", register: "Registar", logout: "Sair", balance: "Saldo", deposit: "Depositar", withdraw: "Levantar", promotions: "Promoções", sports: "Desporto", }, de: { id: "ID", name: "Name", actions: "Aktionen", languages: "Sprachen", settings: "Einstellungen", active: "Aktiv", disabled: "Deaktiviert", status: "Status", value: "Wert", print: "Drucken", skin: "Skin", language: "Sprache", vouchers: "Gutscheine", voucher_code: "Gutscheincode", login: "Anmelden", register: "Registrieren", logout: "Abmelden", balance: "Guthaben", deposit: "Einzahlen", withdraw: "Auszahlen", promotions: "Aktionen", sports: "Sport", }, fr: { id: "ID", name: "Nom", actions: "Actions", languages: "Langues", settings: "Paramètres", active: "Actif", disabled: "Désactivé", status: "Statut", value: "Valeur", print: "Imprimer", skin: "Skin", language: "Langue", vouchers: "Bons", voucher_code: "Code du bon", login: "Connexion", register: "S'inscrire", logout: "Déconnexion", balance: "Solde", deposit: "Dépôt", withdraw: "Retrait", promotions: "Promotions", sports: "Sports", }, tr: { id: "ID", name: "Ad", actions: "İşlemler", languages: "Diller", settings: "Ayarlar", active: "Aktif", disabled: "Devre dışı", status: "Durum", value: "Değer", print: "Yazdır", skin: "Skin", language: "Dil", login: "Giriş", register: "Kayıt ol", logout: "Çıkış", balance: "Bakiye", deposit: "Para yatır", withdraw: "Para çek", sports: "Spor", }, pl: { id: "ID", name: "Nazwa", actions: "Akcje", languages: "Języki", settings: "Ustawienia", active: "Aktywny", disabled: "Wyłączony", status: "Status", value: "Wartość", print: "Drukuj", login: "Zaloguj się", register: "Zarejestruj się", balance: "Saldo", sports: "Sport", }, nl: { name: "Naam", actions: "Acties", languages: "Talen", settings: "Instellingen", active: "Actief", disabled: "Uitgeschakeld", status: "Status", value: "Waarde", print: "Afdrukken", login: "Inloggen", register: "Registreren", balance: "Saldo", sports: "Sport", }, zh: { name: "名称", actions: "操作", languages: "语言", settings: "设置", active: "启用", disabled: "禁用", status: "状态", value: "数值", print: "打印", login: "登录", register: "注册", balance: "余额", sports: "体育", }, hu: { name: "Név", actions: "Műveletek", languages: "Nyelvek", settings: "Beállítások", active: "Aktív", disabled: "Letiltva", status: "Állapot", value: "Érték", print: "Nyomtatás", login: "Belépés", register: "Regisztráció", balance: "Egyenleg", sports: "Sport", }, }; /* pt_br and br are Portuguese variants — same pool. `br` duplicates pt_br in the languages table (see UNCLEAR); it is left with zero coverage so the "nothing translated yet" path is reachable. */ HSL_MT.pt_br = HSL_MT.pt; HSL_MT.br = HSL_MT.pt; /* How much of the pool is already on disk, per language code. */ const HSL_COVERAGE = { it: 1, es: 1, pt: 0.7, de: 0.6, fr: 0.5, tr: 0.45, pl: 0.35, nl: 0.3, zh: 0.25, hu: 0.2, pt_br: 0.55, br: 0 }; /* Flatten an EN tab into rows: { key, path, label, src, parent } — `path` is the POST name saveTranslation receives (translations[key] or translations[parent][subkey]); `label` is the key as altnome() normalizes it for the textarea id (utils.php:115). */ const hslFlatten = (tab) => { const out = []; (HSL_EN[tab] || []).forEach(([key, val]) => { if (val && typeof val === "object") { out.push({ key, path: key, src: null, group: true }); Object.keys(val).forEach(sub => out.push({ key: sub, path: `${key}.${sub}`, src: val[sub], parent: key })); } else { out.push({ key, path: key, src: val }); } }); return out; }; /* What storage/lang/{code}/.php already holds. English is its own source, so the target column equals the EN column there. */ const hslDiskFor = (lang, tab) => { const rows = hslFlatten(tab).filter(r => !r.group); const out = {}; if (lang.code === "en") { rows.forEach(r => { out[r.path] = r.src; }); return out; } const pool = HSL_MT[lang.code] || {}; const cov = HSL_COVERAGE[lang.code] || 0; const rng = hslRng(0x1a5 + lang.id * 977); rows.forEach(r => { const mt = pool[r.path]; out[r.path] = (mt && rng() < cov) ? mt : ""; }); return out; }; /* PHP buffer for the code editor. saveCode writes the buffer VERBATIM, so this is a source view, not a form. */ const hslPhpEscape = (s) => String(s).replace(/\\/g, "\\\\").replace(/'/g, "\\'"); const hslPhpSource = (pairs) => { if (!pairs || !pairs.length) return ""; const body = pairs.map(([k, v]) => { if (v && typeof v === "object") { const inner = Object.keys(v).map(sk => ` '${sk}' => '${hslPhpEscape(v[sk])}',`).join("\n"); return ` '${k}' => [\n${inner}\n ],`; } return ` '${k}' => '${hslPhpEscape(v)}',`; }).join("\n"); return ` { if (fileKey === "subcategories") return ""; if (fileKey === "backend" || fileKey === "frontend") { const disk = hslDiskFor(lang, fileKey); const pairs = (HSL_EN[fileKey] || []).map(([k, v]) => { if (v && typeof v === "object") { const sub = {}; Object.keys(v).forEach(sk => { const t = disk[`${k}.${sk}`]; if (t) sub[sk] = t; }); return Object.keys(sub).length ? [k, sub] : null; } const t = disk[k]; return t ? [k, t] : null; // empty values are dropped by saveTranslation }).filter(Boolean); return hslPhpSource(pairs); } if (lang.code !== "en") return ""; return hslPhpSource(HSL_STATIC_SRC[fileKey] || []); }; const hslLineCount = (s) => (s ? s.split("\n").length : 0); /* Rows the save endpoint would drop (`continue` on empty scalars). */ const hslBlankCount = (vals) => Object.keys(vals).filter(k => !String(vals[k] || "").trim()).length; /* A typed " corrupts the generated PHP file today (see divergence 5). */ const hslHasQuote = (v) => /["\\]/.test(String(v || "")); /* ================================================================== Modal shell — the real screen uses the generic generaModalGestione() → admin/utils/modal.blade.php wrapper. ================================================================== */ const HslModal = ({ title, sub, onClose, children, footer }) => (
e.stopPropagation()}>
{title}
{sub &&
{sub}
}
{children}
{footer &&
{footer}
}
); /* ================================================================== Create / edit form — GET /languages/form/ then POST /languages/saveLanguage/ Fields exactly as forms/language.blade.php: name, code, locale_code (→ languages.locale), flagicon, backend, frontend. Inline validation only — saveLanguage :684-714 has no uniqueness, format or length rule. ================================================================== */ const HslFormModal = ({ row, onClose, onSave }) => { const isNew = !row; const [d, setD] = hslUseState(() => ({ name: row ? row.name : "", code: row ? row.code : "", /* forms/language.blade.php:48 prefills this input with $row->locale. Evident intent implemented — the row's real flagicon (divergence 1). */ flagicon: row ? row.flagicon : "", locale: row ? row.locale : "", backend: row ? !!row.backend : true, frontend: row ? !!row.frontend : true, })); const [err, setErr] = hslUseState({}); const set = (k, v) => { setD(x => ({ ...x, [k]: v })); setErr(e => ({ ...e, [k]: null })); }; const submit = () => { /* Real messages: backend.insert_name ("Insert name") for name, then the hardcoded Italian "Compila il campo code / locale / flag icon". English written here — label inferred. */ const e = {}; if (!d.name.trim()) e.name = "Insert name"; if (!d.code.trim()) e.code = "Fill in the code field"; if (!d.locale.trim()) e.locale = "Fill in the locale field"; if (!d.flagicon.trim()) e.flagicon = "Fill in the flag icon field"; setErr(e); if (Object.keys(e).length) return; onSave({ ...d, name: d.name.trim(), code: d.code.trim(), locale: d.locale.trim(), flagicon: d.flagicon.trim() }); }; const field = (k, label, placeholder, tip) => (
set(k, e.target.value)} /> {err[k] &&
{err[k]}
}
); return ( } >
{field("name", "Name", "English", "languages.name — shown in the list and used as the Translate link label.")} {field("code", "Code", "en", <>Written to languages.code. This is the folder name under storage/lang/ that the translate grid and the raw-PHP editor write into, and the value POST /setLanguage/{code} stores in the applocale session key.)} {field("locale", "Locale code", "en_US", <>Posted as locale_code, stored to languages.locale (varchar 10). Used as the cache key suffix in getLanguageData() (language_data:{locale}).)} {field("flagicon", "Flag icon", "united-kingdom.svg", <>Rendered by the admin topbar language picker. On the real edit form this input is prefilled with the locale instead of the flag icon — fixed here, see the file header.)}
set("backend", v)} onLabel="Active" offLabel="Disabled" size="sm" />
set("frontend", v)} onLabel="Active" offLabel="Disabled" size="sm" />
Saving does not bust the 24h languages_list / language_data:{locale} caches, so a new or renamed language can take up to a day to show up in the pickers.
); }; /* Delete — the real row action is a plain GET behind the shared deleteConfirm() JS confirm, and it is the ONLY endpoint on this screen that re-checks isadmin() server-side. */ const HslDeleteModal = ({ row, onClose, onConfirm }) => ( } >

Delete {row.name} ({row.code}) from the languages table?

The row goes away, but storage/lang/{row.code}/ stays on disk untouched, and the 24h language caches are not flushed — the language can keep appearing in pickers for up to a day. This is also the only action on this screen the server re-checks isadmin() for.
); /* ================================================================== Translate grid — GET /languages/translate/{id}?tab=backend|frontend|subcategories Left: EN source (read-only). Right: target textareas, empty ones outlined red. Per-row Translate (hidden when the target IS English), Translate all in chunks of 50, and a Save that posts the whole key set. ================================================================== */ const HslTranslate = ({ lang, tab, onTab, onBack, onCode }) => { const rows = hslUseMemo(() => hslFlatten(tab), [tab]); const [vals, setVals] = hslUseState(() => hslDiskFor(lang, tab)); const [dirty, setDirty] = hslUseState(false); /* Re-seed when the tab or language changes (the real page is a full reload). */ const [seen, setSeen] = hslUseState(`${lang.id}:${tab}`); if (seen !== `${lang.id}:${tab}`) { setSeen(`${lang.id}:${tab}`); setVals(hslDiskFor(lang, tab)); setDirty(false); } const isEn = lang.code === "en"; const scalars = rows.filter(r => !r.group); const filled = scalars.filter(r => String(vals[r.path] || "").trim()).length; const missing = scalars.length - filled; const quoted = scalars.filter(r => hslHasQuote(vals[r.path])).length; const pool = HSL_MT[lang.code] || {}; const set = (path, v) => { setVals(x => ({ ...x, [path]: v })); setDirty(true); }; /* GET /translateByGoogle — services.google_translate.key. A miss models the documented ok:false branch: the field is left untouched, never clobbered with the English source. cleanTranslation() also repairs %s/%d placeholders Google mangles, which is why they survive here. */ const translateOne = (r) => { const mt = pool[r.path]; if (!mt) { hslToast("Translation failed — field left untouched", `translateByGoogle answered ok:false for "${r.path}" (no API key wired in this build; on the platform this is quota, a dead key or an unsupported pair). The error goes to the google_translate log channel and the client deliberately leaves your text alone instead of overwriting it with English.`); return; } set(r.path, mt); }; const translateAll = () => { const targets = scalars.filter(r => !String(vals[r.path] || "").trim()); if (!targets.length) { hslToast("Nothing to translate", "Every key on this tab already has a value."); return; } const next = { ...vals }; let ok = 0; targets.forEach(r => { if (pool[r.path]) { next[r.path] = pool[r.path]; ok++; } }); setVals(next); setDirty(true); const chunks = Math.ceil(scalars.length / 50); // ×50 per POST — stays under Google's 128-segment limit hslToast(`Translate all — ${ok} of ${targets.length} filled`, `POST /translateByGoogleBatch in ${chunks} chunk${chunks === 1 ? "" : "s"} of 50 keys. ${targets.length - ok} key${targets.length - ok === 1 ? "" : "s"} came back ok:false and were left untouched (see the google_translate log channel).`); }; const save = () => { const blanks = hslBlankCount(Object.fromEntries(scalars.map(r => [r.path, vals[r.path]]))); setDirty(false); hslToast(`Saved ${HSL_TABS.find(t => t.key === tab).file} for ${lang.name}`, `POST /languages/saveTranslation/${lang.id} regenerates storage/lang/${lang.code}/${tab}.php from scratch. ${blanks} empty key${blanks === 1 ? " was" : "s were"} skipped and dropped from the file — those labels fall back at runtime.${quoted ? ` ${quoted} value${quoted === 1 ? " contains" : "s contain"} a quote or backslash; escaped on write (the live endpoint does not — see the file header).` : ""} Translations are live immediately: the runtime lang path is storage/lang/.`); }; return ( <>
{lang.name} {lang.code} {lang.backend ? "Backend active" : "Backend disabled"} {lang.frontend ? "Frontend active" : "Frontend disabled"}
{HSL_TABS.map(t => ( ))}
{tab === "subcategories" && rows.length === 0 ? (
No English source to translate
The grid iterates storage/lang/en/subcategories.php, and no subcategories.php seed exists anywhere in the platform — public/default-lang/en/ ships the other eleven files but not this one, even though config/langfiles.php and this tab both expect it. Until someone writes the English file (only the raw-PHP editor can), this tab has nothing to show for any language.
) : ( <>
{scalars.length} keys {filled} translated {missing} empty {quoted > 0 && {quoted} with quotes} {dirty && unsaved changes}
{!isEn && }
Save posts every key on this tab and regenerates the file from scratch — empty values are skipped, so clearing a box deletes that key and the label falls back to the raw {tab}.{key} string at runtime. Keys that are missing from the English file never appear here at all and can only be added through the raw-PHP editor. {isEn && <> This is the English file: the two columns read from the same source, and the per-row Translate links are hidden (the real page hides them whenever the target code is en).}
Key
English source storage/lang/en/{tab}.php
{lang.name} storage/lang/{lang.code}/{tab}.php {/* Real placement is next to the EN heading although it opens the TARGET file (divergence 7). */}
{rows.map(r => r.group ? (
{r.key} array — sub-keys post as translations[{r.key}][…]
) : (
{r.parent ? r.key : r.path} {!String(vals[r.path] || "").trim() && }
{/* originale_, normalized by altnome() (utils.php:115) */}