Firok Fax

Appearance

Числа и суммы прописью (Кнопка «✨ Wylicz») ​

Firok Fax включает встроенный движок перевода чисел и денежных сумм в слова с учётом грамматики и склонений валют.

1. Как это работает ​

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

  • Число: 23.50
  • Пропись (Польский): dwadzieścia trzy złote 50/100
  • Пропись (Украинский): двадцять три злоті 50/100

Вместо ручного ввода текста пользователю достаточно нажать кнопку «✨ Wylicz» / «✨ Вычислить» прямо внутри поля ввода, и система автоматически сформирует правильную строку.

2. Настройка в визуальном редакторе ​

  1. Откройте редактирование нужного шаблона.
  2. В блоке полей найдите или добавьте текстовое поле (string или textarea), в котором должна быть пропись (например, stawka_pl).
  3. Отметьте галочку «Wyliczaj ze słowami (liczba słownie)».
  4. Задайте параметры:
    • Pole źródłowe (Исходное числовое поле): выберите числовое поле из списка (например, stawka_liczba).
    • Język słownie (Язык прописи):
      • Polski (PL) — польский
      • Ukraiński (UK) — украинский
      • Rosyjski (RU) — русский
      • Angielski (EN) — английский
      • Niemiecki (DE) — немецкий
    • Waluta (Валюта):
      • PLN (złoty / złote / złotych)
      • UAH (hrywna / hrywny / hrywien)
      • EUR (euro / cent)
      • USD (dolar / cent)
      • Brak waluty (без названия денежной единицы)
    • Format zapisu (Формат записи):
      • 00/100 (с дробной частью): dwadzieścia trzy złote 50/100
      • Pełne słowa (полностью словами): dwadzieścia trzy złote pięćdziesiąt groszy
      • Tylko liczba słownie (только число): dwadzieścia trzy

3. Пример в JSON-схеме шаблона ​

В файле content/documents/umowa-zlecenie.json конфигурация выглядит следующим образом:

json
{
  "key": "stawka_liczba",
  "label": "Stawka godzinowa brutto, PLN",
  "type": "number",
  "required": true
},
{
  "key": "stawka_pl",
  "label": "Stawka słownie w języku polskim",
  "type": "string",
  "required": true,
  "computed": {
    "type": "number-to-words",
    "sourceKey": "stawka_liczba",
    "language": "pl",
    "currency": "PLN",
    "format": "fractionalCents"
  }
},
{
  "key": "stawka_ukr",
  "label": "Stawka słownie w języku ukraińskim",
  "type": "string",
  "required": true,
  "computed": {
    "type": "number-to-words",
    "sourceKey": "stawka_liczba",
    "language": "uk",
    "currency": "PLN",
    "format": "fractionalCents"
  }
}

4. Склонения и правила языка ​

Движок автоматически применяет правила склонения славянских языков:

  • Польский:
    • 1 złoty
    • 2, 3, 4 złote (а также 22, 23, 24 złote...)
    • 5..21 złotych (а также 12, 13, 14 złotych...)
  • Украинский:
    • 1 злотий / гривня
    • 2, 3, 4 злоті / гривні
    • 5..20 злотих / гривень
  • Копейки / Гроши: при формате fractionalCents копейки всегда нормализуются к виду 00/100 (например, 5 $\rightarrow$ 05/100, 50 $\rightarrow$ 50/100, целое число $\rightarrow$ 00/100).