Шорткод 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 подразумевает использование разделителя ,
(запятой).