Шорткод SumToText для Grav CMS предназначен для упрощения процесса публикации денежных сумм прописью с использованием заданной валюты.

Работа шорткода заключается в автоматическом преобразовании денежной суммы, записанной с использование цифр в качестве содержания шорткода, в денежную сумму, записанную текстом.

Примеры использования шорткода Sum to Text

[sumtotext]101.50[/sumtotext]

В результате работы шорткода будет выведена сумма прописью: “сто один рубль 50 копеек”.

Важно! Сумма должна быть набрана цифрами, без пробелов и разделителей разрядов. В качестве десятичного разделителя может использоваться точка или запятая.

Как видно, в качестве валюты по умолчанию, шорткод SumToText использует рубль. При необходимости, пользователем может быть задана иная валюта, при условии, что в качестве разменной единицы используется 1/100 часть базовой валюты. Например:

• доллар (базовая валюта) - цент (1/100 часть базовой валюты);
• евро (базовая валюта) - евроцент (1/100 часть базовой валюты);
• швейцарский франк (базовая валюта) - сантим (1/100 часть базовой валюты).

Для задания собственной валюты, шорткод SumToText использует параметр currency, принимающий в качестве содержания сформированную определённым образом строку:

[sumtotext currency="доллар,доллара,долларов,0,цент,цента,центов,0"]10.10[/sumtotext]

В результате работы шорткода будет выведена сумма прописью: “десять долларов 10 центов”.

Содержание параметра currency:

1. название базовой валюты (именительный падеж единственного числа);
2. название базовой валюты (родительный падеж единственного числа);
3. название базовой валюты (родительный падеж множественного числа);
4. род базовой валюты (0 - мужской; 1 - женский);
5. разменная единица (именительный падеж единственного числа);
6. разменная единица (родительный падеж единственного числа);
7. разменная единица (родительный падеж множественного числа);
8. род разменной единицы (0 - мужской; 1 - женский).

Важно! Соблюдение количества и приведённого порядка следования параметров, описывающих используемую шорткодом валюту, является обязательным. Для разделения параметров должны использоваться запятые.

По умолчанию шорткод SumToText выводит прописью только часть денежной суммы, выраженной базовыми единицами валюты. Для вывода прописью части денежной суммы, выраженной разменными единицами, используется параметр full:

[sumtotext full=true]120.05[/sumtotext]

В результате работы шорткода будет выведена сумма прописью: “сто двадцать рублей пять копеек”.

По умолчанию формируемая шорткодом SumToText сумма прописью состоит из строчных букв. При необходимости начинать сумму прописью с прописной буквы, следует использовать параметр capital:

[sumtotext capital=true]1101.10[/sumtotext]

В результате работы шорткода будет выведена сумма прописью: “Одна тысяча сто один рубль 10 копеек”.

Получить шорткод SumToText