cookieJar
Что такое cookieJar?
Набор сниппетов MODX REVO для работы с cookie.
История
cookieJar первое расширение созданное David Pede (davidpede) и выпущенное в 23 апреля, 2014.
Загрузка
Расширение можно скачать в репозитории MODX REVO с помощью менеджера управления пакетами или из репозитория http://modx.com/extras/package/cookiejar.
Исходники и само расширение также доступено на github: https://github.com/tasianmedia/cookiejar.
Ошибки и пожелания
Ошибки, вопросы и пожелания можно сообщить разработчику в github-репозитории, здесь: https://github.com/tasianmedia/cookiejar/issues.
Доступные сниппеты
setCookie
Cниппет setCookie можно вызвать следующим образом (сниппет можно вызывать как в закешированном виде так и в не кешируемом):
[[setCookie]]getCookie
Cниппет getCookie можно вызвать следующим образом (сниппет можно вызывать как в закешированном виде так и в не кешируемом):
[[getCookie]]Доступные параметры
setCookie
| Имя | Описание | По умолчанию |
| name | Имя cookie. | |
| value | Значения cookie. Это значение хранится в браузере клиента, не стоит хранить в ней конфиденциальную информацию. | |
| expires | Время жизни cookie. Это метка должна быть в формате Unix. Можно поставить прошедшую дату что бы очистить cookie. | 0 |
| path | Путь на сервере от куда будет досупна cookie. Используйте `/` что бы сделать cookie доступным в пределах всего домена. | / |
| domain | В этом параметре можно указать домен для которого булет доступна данная cookie. | |
| secure | При 1 указываем что cookie должна быть передана только через безопасное https-соединение. | 0 |
| httponly | При 1 указываем что cookie будут доступны только через http протокол. При этом cookie не будет доступна для языков сценариев, таких как JavaScript. | 0 |
getCookie
| Имя | Описание | По умолчанию |
| name | Имя cookie (обязательно). | |
| tpl | Название чанка, используемый в качестве шаблона . | |
| toPlaceholder | Имя плейсходера который будет использван для вывода полученой cookie. | value |
Примеры
setCookie
Устанавливаем Cookie
[[setCookie?
&name=`foo`
&value=`foobar`
&expires=`0`
]]Установливаем безопасную cookie, сроком действия 1 час:
[[setCookie?
&name=`foo`
&value=`foobar`
&expires=`3600`
&secure=`1`
]]Удалить cookie с именем 'Foo':
[[!setCookie?
&name=`foo`
&expires=`-3600`
]]getCookie
Выводим значение cookie с именем 'Foo':
[[getCookie?
&name=`foo`
]]getCookie
Выводим значение cookie с именем 'Foo', при этом используем чанк 'cookieTpl' в качестве шаблона, а так же назначаем свой плейсхолдер 'cookieValue':
[[getCookie?
&name=`foo`
&tpl=`cookieTpl`
&toPlacholder=`cookieValue`
]]