Шорткод random для GetSimple CMS предназначен для вывода случайного фрагмента текста в содержании страницы.

Работа шорткода заключается в автоматическом выборе случайного элемента из правильно сформированной CSV (Comma-Separated Values) строки, переданной в качестве содержания шорткода.

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

[random]яблоко,груша,слива[/random] - использование шорткода с разделителем по умолчанию;
[random delimeter=;]яблоко;груша;слива[/random] - использование шорткода с заданным разделителем.

Шорткод random принимает следующие параметры:

• delimeter - необязательный параметр, задаёт разделитель элементов, используемый в переданной CSV строке. По умолчанию принимает значение ,;
• enclosure - необязательный параметр, задаёт символ ограничителя поля, используемый в переданной CSV строке. По умолчанию принимает значение ";
• escape - необязательный параметр, задаёт экранирующий символ, используемые в переданной CSV строке. По умолчанию принимает значение \.

Все перечисленные параметры шорткода соответствуют аналогичным параметрам PHP функции str_getcsv.

Важно! С целью соблюдения корректности, следует отметить, что при использовании собственного разделителя, правильно говорить о строке формата DSV (Delimiter-Separated Values), так как, согласно спецификации RFC 4180, формат CSV подразумевает использование разделителя , (запятой).