Просмотр кода страницы Кодирование переменных

{{#seo:
|title=Кодирование переменных
|titlemode=append
|keywords=планфикс, шаблоны, документы, переменные, кодирование переменных
|description=Кодирование переменных
}}

К [[Переменные в шаблонах документов | переменным]] в ПланФиксе можно применять различные функции. Одна из них:

 '''::encode=url'''

Допустим у вас стоит задача сформировать ссылку, при клике на которую будут передаваться определенные дополнительные параметры из задачи, например, название обучающего курса. Ссылка будет выглядеть так:

 <pre>https://site-course.com/forms/about-course/?course_name={{Задача.Источник ЛИД'а}}</pre>


Но если название курса будет содержать недопустимые символы, данные из ссылки передадутся некорректно. Например, ссылка с таким названием курса:

 Акция "Обучись видеомонтажу всего за 1 месяц бесплатно" (2020)


Будет выглядеть вот так:

 <pre>https://site-course.com/forms/about-course/?course_name=Акция</pre>


Так происходит, потому что ссылка содержит русские символы, пробелы и специальные символы, которые недопустимы при её формировании. Все такие символы необходимо кодировать. Для этого к переменным добавляется функция '''::encode=url'''. 

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

<pre>https://site-course.com/forms/about-course/?course_name={{Задача.Источник ЛИД'а::encode=url}}</pre>


А сформированная ссылка после применения кодирования будет выглядеть уже так:

<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"><nowiki>https://</nowiki>site-course.com/forms/about-course/?course_name=%D0%90%D0%BA%D1%86%D0%B8%D1%8F%20%22%D0%9E%D0%B1%D1%83%D1%87%D0%B8%D1%81%D1%8C%20%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE%D0%BC%D0%BE%D0%BD%D1%82%D0%B0%D0%B6%D1%83%20%D0%B2%D1%81%D0%B5%D0%B3%D0%BE%20%D0%B7%D0%B0%201%20%D0%BC%D0%B5%D1%81%D1%8F%D1%86%20%D0%B1%D0%B5%D1%81%D0%BF%D0%BB%D0%B0%D1%82%D0%BD%D0%BE%22%20%282020%29</div>


Таким образом название курса в ссылке будет передано без потерь.


== Важно ==
*Все переменные при вставке в URL url-кодируются, поэтому в переменную нельзя добавлять URL целиком. Переменную можно использовать в качестве параметров ссылки:

<div style="display: block; padding: 1em; margin: 0 0 10px; font-size: 13px; line-height: 1.65; color: black; word-wrap: break-word; background-color: #f9f9f9; border: 1px solid #ddd; border-radius: 4px;"><nowiki>https://</nowiki>mysite.com/?param1='''<nowiki>{{Variable_1}}</nowiki>'''&param2='''<nowiki>{{Variable_2}}</nowiki>'''</div>


== Перейти ==
*[[Переменные в шаблонах документов]]
*[[Шаблоны документов]]
*[[Документы]]