Some problems with translation (localization) of forms

Thank you, Miloš! This helps!

@Nicolas_K

Iam thinking about this not translated validation rule error message:

$form->addEmail('form_email', 'Email*:')
		->addRule($form::EMAIL, 'Eine gültige Email-Adresse bitte')	// This is ignored - english warning instead!

All validation rule error messages should be translated by the Form translator. The reason why this was not translated is may be a bug in implementation of Email input in Nette Forms. The Email input created with a):

$form->addEmail('form_email', 'Email*:')

has the validation rule:

->addRule($form::EMAIL, ....')

implemented by default, so there is a “potential conflict” between the default email validation and your rule with your error message.

Try to go this way b):

$form->addText('form_email', 'Email*:')
		->setHtmlAttribute('type', 'email')
		->addRule($form::EMAIL, 'Eine gültige Email-Adresse bitte')

or try c) just like standard textbox:

$form->addText('form_email', 'Email*:')
		->setHtmlAttribute('type', 'email')
		->addRule($form::EMAIL, 'Eine gültige Email-Adresse bitte')

because Nette Forms have very sofisticated email validation and there is not much bnenefit from using addEmail() which produces html input type email with HTML5 validation, which anyway the javascript of Nette Forms switch off ;).

Last edited by m.brecher (2023-03-23 16:44)

@mbrecher

Thank you again, Miloš!

I will try with addText() .
(Actually still fighting with the translator, but there are little successes…)
BTW: there is no difference between b) and c) – is it?
BTW 2: mostly I'm on the ride with my VPN – sometimes sunny Croatia, sometimes rainy Ireland, seldom Switzerland… ;)

Many thanks and Ahoi!

@Nicolas_K

BTW: there is no difference between b) and c) – is it?

Yes, I dont remember what I want to write in c) but b) should be OK

My first translator looks like this, may be it can help you to create your own translator:

<?php

declare(strict_types=1);

namespace App\Model;

use Nette\Database\Explorer;
use Nette\Utils\Strings;

class Translator implements \Nette\Localization\Translator
{
    public const DefaultLanguage = 'cs';

    private const MaxLength = 100;

    private string $lang;

    public function __construct( private Explorer $database )
    {}

    public function setLang(string $lang)
    {
        $this->lang = $lang;
    }

    public function translate(mixed $source, mixed ...$parameters): string
    {
        $source = Strings::truncate($source, self::MaxLength);
        if(!$source || $this->lang === self::DefaultLanguage){
            return $source;
        }
        return $this->tryGetTranslation($source);
    }

    private function tryGetTranslation(string $source): string
    {
        [$registered, $result] = $this->getTranslation($source);
        if($result){
            return $result;
        }
        if(!$registered){
            $this->registerTranslation($source);
        }
        return preg_replace('~[^ ]~', '*', $source);
    }

    private function getTranslation(string $source): array
    {
        $defaultColumn = 'text_'.self::DefaultLanguage;
        $translatedColumn = 'text_'.$this->lang;
        $translation = $this->database->table('template_text')->where($defaultColumn.' ?', $source)->fetch();
        $registered = (bool)$translation;
        $result = $translation?->{$translatedColumn};
        return [$registered, $result];
    }

    private function registerTranslation(string $source): void
    {
        $defaultColumn = 'text_'.self::DefaultLanguage;
        $this->database->table('template_text')->insert([$defaultColumn => $source]);
    }
}

The translations are stored in database table:

-- Adminer 4.8.1 MySQL 8.0.17 dump

SET NAMES utf8;
SET time_zone = '+00:00';
SET foreign_key_checks = 0;
SET sql_mode = 'NO_AUTO_VALUE_ON_ZERO';

SET NAMES utf8mb4;

DROP TABLE IF EXISTS `template_text`;
CREATE TABLE `template_text` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `text_cs` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_czech_ci DEFAULT '',
  `text_de` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_czech_ci DEFAULT '',
  `date_created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `date_edited` timestamp NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `text_cs` (`text_cs`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_czech_ci;


-- 2023-03-29 02:16:58

It works very simply: if the language is default, no sql query is made, the text from template is shipped, if another language the query into database is made, if no translation in database are found it returns ******* instead of the text to the html output. After adding new text into template/form the translator registers in database new text to be translated. Than you should go into the table and by hand fill the translations. After than it works. I have deployed this translator on real very simple webpage and works 100%.

Notice: The query into database are made via Nette\Database\Explorer ;)

Last edited by m.brecher (2023-03-29 04:24)

Hi @Nicolas_K ,

For textareas you can use placeholders too, and those are translated, right? Why to use setDefaultValue, which set the value, when you need a hint for it?

So, instead of

$form->addTextArea('form_hint', 'Mitteilung:', 40, 3)
	->setDisabled()
	->setDefaultValue("Hier steht was zur Erläuterung");

use

$form->addTextArea('form_hint', 'Mitteilung:', 40, 3)
	->setDisabled()
	->setHtmlAttribute('placeholder', 'Hier steht was zur Erläuterung');