captcha

README

captcha

Middleware captcha provides captcha service for Makross.

Installation

go get -u github.com/insionng/makross/captcha

Getting Help

• API Reference

License

This project is under the MIT License. See the LICENSE file for the full license text.

Documentation

Overview

Package captcha a middleware that provides captcha service for Macross.

Index

• func Captchaer(options ...Options) makross.Handler
• func Version() string
• type Captcha
  • func NewCaptcha(opts ...Options) *Captcha
  • func Store(self *makross.Context) (cpt *Captcha)
  • func (c *Captcha) CreateCaptcha() (string, error)
  • func (c *Captcha) CreateHTML() template.HTML
  • func (c *Captcha) Verify(id string, challenge string) bool
  • func (c *Captcha) VerifyReq(self *makross.Context) bool
• type Image
  • func NewImage(digits []byte, width, height int) *Image
  • func (m *Image) WriteTo(w io.Writer) (int64, error)
• type Options

Functions

func Captchaer

func Captchaer(options ...Options) makross.Handler

Captchaer is a middleware that maps a captcha.Captcha service into the Macross handler chain. An single variadic captcha.Options struct can be optionally provided to configure. This should be register after cache.Cacher.

func Version

func Version() string

Types

type Captcha

type Captcha struct {
	SubURL           string
	URLPrefix        string
	FieldIDName      string
	FieldCaptchaName string
	StdWidth         int
	StdHeight        int
	ChallengeNums    int
	Expiration       int64
	CachePrefix      string
	// contains filtered or unexported fields
}

Captcha represents a captcha service.

func NewCaptcha

func NewCaptcha(opts ...Options) *Captcha

NewCaptcha initializes and returns a captcha with given options.

func Store

func Store(self *makross.Context) (cpt *Captcha)

func (*Captcha) CreateCaptcha

func (c *Captcha) CreateCaptcha() (string, error)

CreateCaptcha create a new captcha id

func (*Captcha) CreateHTML

func (c *Captcha) CreateHTML() template.HTML

CreateHTML tempalte func for output html

func (*Captcha) Verify

func (c *Captcha) Verify(id string, challenge string) bool

Verify direct verify id and challenge string

func (*Captcha) VerifyReq

func (c *Captcha) VerifyReq(self *makross.Context) bool

VerifyReq verify from a request

type Image

type Image struct {
	*image.Paletted
	// contains filtered or unexported fields
}

func NewImage

func NewImage(digits []byte, width, height int) *Image

NewImage returns a new captcha image of the given width and height with the given digits, where each digit must be in range 0-9.

func (*Image) WriteTo

func (m *Image) WriteTo(w io.Writer) (int64, error)

WriteTo writes captcha image in PNG format into the given writer.

type Options

type Options struct {
	// Suburl path. Default is empty.
	SubURL string

	// URL prefix of getting captcha pictures. Default is "/captcha/".
	URLPrefix string

	// Hidden input element ID. Default is "captcha_id".
	FieldIDName string

	// User input value element name in request form. Default is "captcha".
	FieldCaptchaName string

	// Challenge number. Default is 6.
	ChallengeNums int

	// Captcha image width. Default is 240.
	Width int

	// Captcha image height. Default is 80.
	Height int

	// Captcha expiration time in seconds. Default is 600.
	Expiration int64

	// Cache key prefix captcha characters. Default is "captcha_".
	CachePrefix string
}

Options a captcha's options