users

Documentation

Overview

Package users represents the user resource

Index

• Constants
• func Admins() *query.Query
• func AllowedParams() []string
• func AllowedParamsAdmin() []string
• func Editors() *query.Query
• func Published() *query.Query
• func Query() *query.Query
• func Readers() *query.Query
• func Subscribed() *query.Query
• func Where(format string, args ...interface{}) *query.Query
• type User
  • func Find(id int64) (*User, error)
  • func FindAll(q *query.Query) ([]*User, error)
  • func FindFirst(format string, args ...interface{}) (*User, error)
  • func MockAdmin() *User
  • func MockAnon() *User
  • func New() *User
  • func NewWithColumns(cols map[string]interface{}) *User
  • func (u *User) Admin() bool
  • func (u *User) Anon() bool
  • func (u *User) CanComment() bool
  • func (u *User) CanDownvote() bool
  • func (u *User) CanFlag() bool
  • func (u *User) CanStyle() bool
  • func (u *User) CanSubmit() bool
  • func (u *User) CanUpvote() bool
  • func (u *User) OwnedBy(uid int64) bool
  • func (u *User) Reader() bool
  • func (u *User) RoleDisplay() string
  • func (u *User) RoleID() int64
  • func (u *User) RoleOptions() []helpers.Option
  • func (u *User) UserID() int64

Constants

const (
	// TableName is the database table for this resource
	TableName = "users"
	// KeyName is the primary key value for this resource
	KeyName = "id"
	// Order defines the default sort order in sql for this resource
	Order = "id asc"
)

const (
	Anon   = 0
	Editor = 10
	Reader = 20
	Admin  = 100
)

User roles

Functions

func Admins

func Admins() *query.Query

Admins returns a query which finds all admin users

func AllowedParams

func AllowedParams() []string

AllowedParams returns an array of acceptable params in update

func AllowedParamsAdmin

func AllowedParamsAdmin() []string

AllowedParamsAdmin returns the cols editable by admins

func Editors

func Editors() *query.Query

Editors returns a query which finds all editor users

func Published

func Published() *query.Query

Published returns a query for all users with status >= published.

func Query

func Query() *query.Query

Query returns a new query for users with a default order.

func Readers

func Readers() *query.Query

Readers returns a query which finds all reader users

func Subscribed

func Subscribed() *query.Query

Subscribed returns a query for all users with subscription = True.

func Where

func Where(format string, args ...interface{}) *query.Query

Where returns a new query for users with the format and arguments supplied.

Types

type User

type User struct {
	// resource.Base defines behaviour and fields shared between all resources
	resource.Base

	// status.ResourceStatus defines a status field and associated behaviour
	status.ResourceStatus

	Email        string
	Name         string
	Points       int64
	Role         int64
	Summary      string
	Text         string
	Title        string
	Notification bool
	Subscription bool
	Plan         string

	PasswordHash    string
	PasswordResetAt time.Time
}

User handles saving and retrieving users from the database

func Find

func Find(id int64) (*User, error)

Find fetches a single user record from the database by id.

func FindAll

func FindAll(q *query.Query) ([]*User, error)

FindAll fetches all user records matching this query from the database.

func FindFirst

func FindFirst(format string, args ...interface{}) (*User, error)

FindFirst fetches a single user record from the database using a where query with the format and args provided.

func MockAdmin

func MockAdmin() *User

MockAdmin returns a mock user for testing with Role Admin.

func MockAnon

func MockAnon() *User

MockAnon returns a mock user for testing with Role Anon.

func New

func New() *User

New creates and initialises a new user instance.

func NewWithColumns

func NewWithColumns(cols map[string]interface{}) *User

NewWithColumns creates a new user instance and fills it with data from the database cols provided.

func (*User) Admin

func (u *User) Admin() bool

Admin returns true if this user is an Admin.

func (*User) Anon

func (u *User) Anon() bool

Anon returns true if this user is not a logged in user.

func (*User) CanComment

func (u *User) CanComment() bool

CanComment returns true if this user can comment.

func (*User) CanDownvote

func (u *User) CanDownvote() bool

CanDownvote returns true if this user can downvote.

func (*User) CanFlag

func (u *User) CanFlag() bool

CanFlag returns true if this user can flag.

func (*User) CanStyle

func (u *User) CanStyle() bool

CanStyle returns true if this user can style text in comments/products.

func (*User) CanSubmit

func (u *User) CanSubmit() bool

CanSubmit returns true if this user can submit.

func (*User) CanUpvote

func (u *User) CanUpvote() bool

CanUpvote returns true if this user can upvote.

func (*User) OwnedBy

func (u *User) OwnedBy(uid int64) bool

OwnedBy returns true if this user id owns this user.

func (*User) Reader

func (u *User) Reader() bool

Reader returns true if this user is an Reader.

func (*User) RoleDisplay

func (u *User) RoleDisplay() string

RoleDisplay returns the string representation of the Role status

func (*User) RoleID

func (u *User) RoleID() int64

RoleID returns the user role for auth.

func (*User) RoleOptions

func (u *User) RoleOptions() []helpers.Option

RoleOptions returns an array of Role values for this model (embedders may override this and roledisplay to extend)

func (*User) UserID

func (u *User) UserID() int64

UserID returns the user id for auth.