README.md

permacookie

Sends a cookie to the browser that will "permanently" identify that visitor.

Usage

Defines a ring middleware function at ring.middleware.permacookie/wrap-permacookie.

Your usage might resemble:

    `(ns mine.core
      (:use [compojure.core]
            [ring.adapter.jetty]
            [ring.middleware.cookies]
            [ring.middleware.permacookie]))
    (defroutes webservice
      (GET "/" [] (fn [req] {:body (str "You are: " (:visitor-id req))})))
    (def app (-> (var webservice)
                 (wrap-permacookie {:name "nifty"})
                 wrap-cookies))
    (run-jetty #'app {:port 2000})`

This middlware places a permanent cookie on the visitor's browser, with a unique identifier. That identifier is then made available through the :visitor-id key on the request map which is available to handlers.

Installation

For lein, in your project.clj:

    [org.clojars.cvillecsteele/ring-permacookie-middleware "1.4.0"]

License

Copyright (C) 2010 Colin Steele ([email protected])

Distributed under the Eclipse Public License, the same as Clojure.