URL Params v2.5

Плагин URL Params WordPress позволяет вам получить доступ к параметрам URL-адреса в строке запроса URL-адреса.

Плагин даже позволяет вам указать значение по умолчанию в коротком коде, если параметр не установлен, поэтому, если вы хотите сказать "Hello, FirstName", а FirstName не установлено, это может сказать что-то вроде "Hello, Friend!"

Чтобы указать параметр URL-адреса резервной копии, введите несколько параметров, разделенных запятыми. Плагин будет проверять каждый параметр по порядку, пока не будет найден соответствующий, и вернет его. Если не удастся найти ни один из перечисленных вами параметров, будет возвращено значение по умолчанию. Например, вы можете указать [urlparam param="FirstName, First, name" default="Friend" /] для проверки FirstName, и если не найдено, то FirstName, если не найдено, то имя, а если нет, то просто вернуть "Friend".

Если параметром является дата, вы также можете указать параметр dateformat, используя формат даты, удобный для PHP, например [urlparam param="somedate" dateformat="F Js" /]. Обратите внимание, что PHP возвращает даты только в английском формате, независимо от настроек локали.

Это замечательно, если у вас есть персонализированные ссылки, например, от Infusionsoft или Keap, поскольку они позволяют персонализировать целевую страницу, указав имя человека.

Вы также можете использовать это для предварительного заполнения полей формы для людей на основе строки запроса. Например, если в URL-адресе передается их имя, ваша целевая страница может приветствовать зрителя по имени и предварительно заполнить его имя в форме.

Использование

Используйте URL-адрес короткого кода с необязательным параметром "default". Например, [urlparam param="FirstName" /] или [urlparam param="FirstName" default="Friend"/].

Для условного контента используйте [ifurlparam][/ifurlparam]. Например, [ifurlparam param="FirstName"]Эй, я вас знаю, [urlparam param="FirstName"]![/ifurlparam] приветствует известных посетителей, но ничего не отображает пользователям без имени в строке запроса.

Если вы хотите отображать контент, когда значение НЕ существует, вы можете установить пустое значение в [ifurlparam]. Например, [ifurlparam param="FirstName" пустой="1"]Добро пожаловать на сайт, посетитель![/ifurlparam] приветствует посетителей без имени в строке запроса, но ничего не отображает для посетителей с именем в строке запроса.

Если вы хотите показывать контент только посетителям с определенным значением в строке запроса, вы можете установить его в [ifurlparam]. Например, [ifurlparam param="FirstName" is="Bob"]Привет, Боб![/ifurlparam] будет приветствовать только посетителей, у которых для параметра FirstName установлено значение Bob.

Если вы хотите, чтобы urlparam возвращал атрибут HTML, например, для использования при предварительной настройке значения ввода или скрытых полей ввода, передайте необязательный параметр attr. Вы можете установить атрибут значения для поля ввода, например: <input type="text" name="firstname" [urlparam attr="value" param="FirstName"]> или вы можете установить атрибут src для тега изображения, например: <img [urlparam attr="src" param="imgurl"]>

Если вы хотите, чтобы urlparam возвращал весь HTML-тег, например, при создании поля ввода, передайте необязательный параметр htmltag. Например, [urlparam htmltag="input" type="text" name="firstname" id="first" attr="value" param="FirstName" default="Bob" /] создаст что-то вроде <input type="text" name="firstname" id="first" value="Bob" />

Безопасность

Чтобы защитить ваш сайт от отраженного межсайтового скриптинга, мы очищаем выходные данные с помощью esc_html(), который предотвращает передачу и отображение любых HTML-тегов. Это не позволит кому-либо передать, например, javascript и выполнить его на вашем сайте.

Начиная с автоматического обновления безопасности WordPress 4.2.3, вы больше не можете включать короткие коды в атрибуты HTML. До этого обновления WordPress вы могли установить значение поля следующим образом: <input type="text" name="firstname" value="[urlparam param="FirstName"]">. Теперь вам нужно установить его следующим образом: <input type="text" name="firstname" [urlparam attr="value" param="FirstName"]> или [urlparam htmltag="input" type="text" name="firstname" attr="value" param="FirstName" /]. Если вы все еще используете этот шорткод по-старому, к сожалению, WordPress просто не будет обрабатывать шорткод и вернет полный текст шорткода необработанным.

Чтобы непривилегированные пользователи (например, участники) не использовали этот короткий код для того, чтобы привилегированные пользователи (например, администраторы) случайно выполнили произвольный JavaScript с помощью атрибутов HTML (например, onclick, onmouseover и т. д.), теги и атрибуты HTML очищаются.

Если вам действительно необходимо установить определенные очищенные теги или атрибуты, на свой страх и риск вы можете вручную разрешить их на странице параметров URL-адресов в разделе "Настройки".