admin

package
v0.0.0-...-ea25219 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 30, 2015 License: MIT Imports: 27 Imported by: 0

README

Introduction

Qor admin provide easy-to-use interface for data management.

Quick example

Use 35 lines of code to setup & run Qor admin.

package main

import (
  "net/http"

  "github.com/jinzhu/gorm"
  _ "github.com/mattn/go-sqlite3"
  "github.com/qor/qor"
  "github.com/qor/qor/admin"
)

type User struct {
  gorm.Model
  Name string
}

type Product struct {
  gorm.Model
  Name        string
  Description string
}

func main() {
  DB, _ := gorm.Open("sqlite3", "demo.db")
  DB.AutoMigrate(&User{}, &Product{})

  Admin := admin.New(&qor.Config{DB: &DB})
  Admin.AddResource(&User{}, &admin.Config{Menu: []string{"User Management"}})
  Admin.AddResource(&Product{}, &admin.Config{Menu: []string{"Product Management"}})

  mux := http.NewServeMux()
  Admin.MountTo("/admin", mux)
  http.ListenAndServe(":9000", mux)
}

// TODO: add screenshot after QOR admin UI finished go run main.go and visit localhost:9000/admin to see the result !

You can view qor example for a more detailed configuration example.

Features

  • CRUD of any resource
  • Search and filtering
  • Authentication
  • Authorization(detail)
  • Custom actions
  • Customizable view
  • Rich editor
  • Image crop
  • Integrate-able with Publish
  • Integrate-able with l10n
  • JSON API supported
  • Extendable

Documentation

https://github.com/theplant/qor3/wiki

Documentation

Index

Constants

View Source 
const (
	DEFAULT_PAGE_COUNT = 20
)
View Source 
const (
	VISIBLE_PAGE_COUNT = 8
)

Variables

View Source 
var DefaultHandler = func(name string, value string, scope *gorm.DB, context *qor.Context) *gorm.DB {
	lastIndex := strings.LastIndex(name, "_")
	operation := name[lastIndex+1 : len(name)]
	column := name[0:lastIndex]

	switch operation {
	case "cont":
		return scope.Where(fmt.Sprintf("%v ILIKE ?", scope.NewScope(nil).Quote(column)), "%"+value+"%")
	case "eq":
		return scope.Where(fmt.Sprintf("%v = ?", scope.NewScope(nil).Quote(column)), value)
	case "gt":
		return scope.Where(fmt.Sprintf("%v > ?", scope.NewScope(nil).Quote(column)), value)
	case "gteq":
		return scope.Where(fmt.Sprintf("%v >= ?", scope.NewScope(nil).Quote(column)), value)
	case "lt":
		return scope.Where(fmt.Sprintf("%v < ?", scope.NewScope(nil).Quote(column)), value)
	case "lteq":
		return scope.Where(fmt.Sprintf("%v <= ?", scope.NewScope(nil).Quote(column)), value)
	}
	return scope
}
View Source 
var Root, _ = os.Getwd()

Functions

func Equal 

func Equal(a, b interface{}) bool

func RegisterViewPath 

func RegisterViewPath(path string) error

Types

type Action 

type Action struct {
	Name   string
	Metas  []string
	Handle func(scope *gorm.DB, context *qor.Context) error
	Inline bool
}

type Admin 

type Admin struct {
	Config *qor.Config
	I18n   I18n
	// contains filtered or unexported fields
}

func New 

func New(config *qor.Config) *Admin

func (*Admin) AddMenu 

func (admin *Admin) AddMenu(menu *Menu)

func (*Admin) AddResource 

func (admin *Admin) AddResource(value interface{}, config ...*Config) *Resource

func (Admin) GetMenu 

func (admin Admin) GetMenu(name string) *Menu

func (Admin) GetMenus 

func (admin Admin) GetMenus() []*Menu

func (*Admin) GetResource 

func (admin *Admin) GetResource(name string) *Resource

func (*Admin) GetResources 

func (admin *Admin) GetResources() []*Resource

func (*Admin) GetRouter 

func (admin *Admin) GetRouter() *Router

func (*Admin) MountTo 

func (admin *Admin) MountTo(prefix string, mux *http.ServeMux)

func (*Admin) NewContext 

func (admin *Admin) NewContext(w http.ResponseWriter, r *http.Request) *Context

func (*Admin) NewResource 

func (admin *Admin) NewResource(value interface{}, config ...*Config) *Resource

func (*Admin) RegisterFuncMap 

func (admin *Admin) RegisterFuncMap(name string, fc interface{})

func (*Admin) ServeHTTP 

func (admin *Admin) ServeHTTP(w http.ResponseWriter, req *http.Request)

func (*Admin) SetAuth 

func (admin *Admin) SetAuth(auth Auth)

type AssetManager 

type AssetManager struct {
	ID   int
	File media_library.FileSystem `media_library:"URL:/system/assets/{{primary_key}}/{{filename_with_hash}}"`
}

func (*AssetManager) InjectQorAdmin 

func (*AssetManager) InjectQorAdmin(res *Resource)

type Auth 

type Auth interface {
	GetCurrentUser(*Context) qor.CurrentUser
	LoginURL(*Context) string
	LogoutURL(*Context) string
}

type Config 

type Config struct {
	Name       string
	Menu       []string
	Invisible  bool
	Permission *roles.Permission
	Themes     []string
	PageCount  int
}

type Context 

type Context struct {
	*qor.Context
	*Searcher
	Flashs      []Flash
	Resource    *Resource
	Admin       *Admin
	CurrentUser qor.CurrentUser
	Result      interface{}
	Content     template.HTML
}

func (*Context) AllMetas 

func (context *Context) AllMetas(resources ...*Resource) []*Meta

func (*Context) CheckResourcePermission 

func (context *Context) CheckResourcePermission(permission roles.PermissionMode) bool

func (*Context) EditMetas 

func (context *Context) EditMetas(resources ...*Resource) []*Meta

func (*Context) Execute 

func (context *Context) Execute(name string, result interface{})

func (*Context) Flash 

func (context *Context) Flash(message, typ string)

func (*Context) FlashNow 

func (context *Context) FlashNow(message, typ string)

func (*Context) GetFlashes 

func (context *Context) GetFlashes() []Flash

func (*Context) GetResource 

func (context *Context) GetResource(name string) *Resource

func (*Context) GetScopes 

func (context *Context) GetScopes() (scopes []string)

func (*Context) HasCreatePermission 

func (context *Context) HasCreatePermission(permissioner permissioner) bool

func (*Context) HasDeletePermission 

func (context *Context) HasDeletePermission(permissioner permissioner) bool

func (*Context) HasReadPermission 

func (context *Context) HasReadPermission(permissioner permissioner) bool

func (*Context) HasUpdatePermission 

func (context *Context) HasUpdatePermission(permissioner permissioner) bool

func (*Context) IndexMetas 

func (context *Context) IndexMetas(resources ...*Resource) []*Meta

func (*Context) IsIncluded 

func (context *Context) IsIncluded(value interface{}, primaryKey interface{}) bool

func (*Context) IsNewRecord 

func (context *Context) IsNewRecord(value interface{}) bool

func (*Context) JavaScriptTag 

func (context *Context) JavaScriptTag(name string) template.HTML

func (*Context) LinkTo 

func (context *Context) LinkTo(text interface{}, link interface{}) template.HTML

func (*Context) LoadThemeJavaScripts 

func (context *Context) LoadThemeJavaScripts() template.HTML

func (*Context) LoadThemeStyleSheets 

func (context *Context) LoadThemeStyleSheets() template.HTML

func (*Context) LogoutURL 

func (context *Context) LogoutURL() string

func (*Context) NewMetas 

func (context *Context) NewMetas(resources ...*Resource) []*Meta

func (*Context) NewResourceContext 

func (context *Context) NewResourceContext(name ...string) *Context

func (*Context) NewResourcePath 

func (context *Context) NewResourcePath(value interface{}) string

func (*Context) Pagination 

func (context *Context) Pagination() *[]Page

Keep VISIBLE_PAGE_COUNT's pages visible, exclude prev and next link Assume there are 12 pages in total. When current page is 1 [current, 2, 3, 4, 5, 6, 7, 8, next] When current page is 6 [prev, 2, 3, 4, 5, current, 7, 8, 9, 10, next] When current page is 10 [prev, 5, 6, 7, 8, 9, current, 11, 12] If total page count less than VISIBLE_PAGE_COUNT, always show all pages

func (*Context) PatchCurrentURL 

func (context *Context) PatchCurrentURL(params ...interface{}) (patchedURL string, err error)

PatchCurrentURL is a convinent wrapper for qor/utils.PatchURL

func (*Context) PatchURL 

func (context *Context) PatchURL(url string, params ...interface{}) (patchedURL string, err error)

PatchURL is a convinent wrapper for qor/utils.PatchURL

func (*Context) PrimaryKeyOf 

func (context *Context) PrimaryKeyOf(value interface{}) interface{}

func (*Context) RT 

func (context *Context) RT(resource *Resource, key string, values ...interface{}) string

func (*Context) Render 

func (context *Context) Render(name string, results ...interface{}) template.HTML

func (*Context) RenderForm 

func (context *Context) RenderForm(value interface{}, metas []*Meta) template.HTML

func (*Context) RenderMeta 

func (context *Context) RenderMeta(writer *bytes.Buffer, meta *Meta, value interface{}, prefix []string)

func (*Context) ResourcePath 

func (context *Context) ResourcePath() string

Resource

func (*Context) SetResource 

func (context *Context) SetResource(res *Resource) *Context

func (*Context) ShowMetas 

func (context *Context) ShowMetas(resources ...*Resource) []*Meta

func (*Context) StyleSheetTag 

func (context *Context) StyleSheetTag(name string) template.HTML

func (*Context) T 

func (context *Context) T(key string, values ...interface{}) string

func (*Context) UrlFor 

func (context *Context) UrlFor(value interface{}, resources ...*Resource) string

func (*Context) ValueOf 

func (context *Context) ValueOf(value interface{}, meta *Meta) interface{}

type Filter 

type Filter struct {
	Name       string
	Operations []string
	Handler    func(name string, value string, scope *gorm.DB, context *qor.Context) *gorm.DB
}

type Flash 

type Flash struct {
	Type    string
	Message string
}

type Handle 

type Handle func(c *Context)

type Handler 

type Handler struct {
	Path   *regexp.Regexp
	Handle Handle
}

type I18n 

type I18n interface {
	Scope(scope string) I18n
	T(locale string, key string, args ...interface{}) string
}

type Injector 

type Injector interface {
	InjectQorAdmin(*Resource)
}
type Menu struct {
	Name      string
	Link      string
	Ancestors []string
	// contains filtered or unexported fields
}
func (menu *Menu) GetSubMenus() []*Menu

type Meta 

type Meta struct {
	Name   string
	Alias  string
	Label  string
	Type   string
	Valuer func(interface{}, *qor.Context) interface{}
	// TODO: should allow Setter to return error, at least have a place to register
	Setter        func(resource interface{}, metaValue *resource.MetaValue, context *qor.Context)
	Metas         []resource.Metaor
	Resource      resource.Resourcer
	Collection    interface{}
	GetCollection func(interface{}, *qor.Context) [][]string
	Permission    *roles.Permission
	// contains filtered or unexported fields
}

func (*Meta) GetFieldName 

func (meta *Meta) GetFieldName() string

func (*Meta) GetMetas 

func (meta *Meta) GetMetas() []resource.Metaor

func (*Meta) GetName 

func (meta *Meta) GetName() string

func (*Meta) GetResource 

func (meta *Meta) GetResource() resource.Resourcer

func (*Meta) GetSetter 

func (meta *Meta) GetSetter() func(resource interface{}, metaValue *resource.MetaValue, context *qor.Context)

func (*Meta) GetValuer 

func (meta *Meta) GetValuer() func(interface{}, *qor.Context) interface{}

func (*Meta) HasPermission 

func (meta *Meta) HasPermission(mode roles.PermissionMode, context *qor.Context) bool

type Middleware 

type Middleware struct {
	Handler func(*Context, *Middleware)
	// contains filtered or unexported fields
}

func (Middleware) Next 

func (middleware Middleware) Next(context *Context)

type Page 

type Page struct {
	Page       int
	Current    bool
	IsPrevious bool
	IsNext     bool
}

type Pagination 

type Pagination struct {
	Total       int
	Pages       int
	CurrentPage int
	PrePage     int
}

type Resource 

type Resource struct {
	resource.Resource

	Config *Config
	Metas  []*Meta

	SearchHandler func(keyword string, context *qor.Context) *gorm.DB
	// contains filtered or unexported fields
}

func (*Resource) Action 

func (res *Resource) Action(action *Action)

func (*Resource) AllMetas 

func (res *Resource) AllMetas() []*Meta

func (*Resource) AllowedMetas 

func (res *Resource) AllowedMetas(attrs []*Meta, context *Context, roles ...roles.PermissionMode) []*Meta

func (*Resource) ConvertObjectToMap 

func (res *Resource) ConvertObjectToMap(context qor.Contextor, value interface{}, kind string) interface{}

func (*Resource) Decode 

func (res *Resource) Decode(contextor qor.Contextor, value interface{}) (errs []error)

func (*Resource) EditAttrs 

func (res *Resource) EditAttrs(columns ...string)

func (*Resource) EditMetas 

func (res *Resource) EditMetas() []*Meta

func (*Resource) Filter 

func (res *Resource) Filter(filter *Filter)

func (Resource) GetAdmin 

func (res Resource) GetAdmin() *Admin

func (*Resource) GetMeta 

func (res *Resource) GetMeta(name string) *Meta

func (*Resource) GetMetas 

func (res *Resource) GetMetas(_attrs ...[]string) []resource.Metaor

func (*Resource) HasPermission 

func (res *Resource) HasPermission(mode roles.PermissionMode, context *qor.Context) bool

func (*Resource) IndexAttrs 

func (res *Resource) IndexAttrs(columns ...string)

func (*Resource) IndexMetas 

func (res *Resource) IndexMetas() []*Meta

func (*Resource) Meta 

func (res *Resource) Meta(meta *Meta)

func (*Resource) NewAttrs 

func (res *Resource) NewAttrs(columns ...string)

func (*Resource) NewMetas 

func (res *Resource) NewMetas() []*Meta

func (*Resource) Scope 

func (res *Resource) Scope(scope *Scope)

func (*Resource) SearchAttrs 

func (res *Resource) SearchAttrs(columns ...string) []string

func (*Resource) ShowAttrs 

func (res *Resource) ShowAttrs(columns ...string)

func (*Resource) ShowMetas 

func (res *Resource) ShowMetas() []*Meta

func (Resource) ToParam 

func (res Resource) ToParam() string

func (Resource) UseTheme 

func (res Resource) UseTheme(theme string) []string

type ResourceNamer 

type ResourceNamer interface {
	ResourceName() string
}

type Router 

type Router struct {
	Prefix string
	// contains filtered or unexported fields
}

func (*Router) Delete 

func (r *Router) Delete(path string, handle Handle)

func (*Router) Get 

func (r *Router) Get(path string, handle Handle)

func (*Router) Post 

func (r *Router) Post(path string, handle Handle)

func (*Router) Put 

func (r *Router) Put(path string, handle Handle)

func (*Router) Use 

func (r *Router) Use(handler func(*Context, *Middleware))

type Scope 

type Scope struct {
	Name    string
	Label   string
	Handle  func(*gorm.DB, *qor.Context) *gorm.DB
	Default bool
}

type Searcher 

type Searcher struct {
	*Context

	Pagination Pagination
	// contains filtered or unexported fields
}

func (*Searcher) Filter 

func (s *Searcher) Filter(name, query string) *Searcher

func (*Searcher) FindMany 

func (s *Searcher) FindMany() (interface{}, error)

func (*Searcher) FindOne 

func (s *Searcher) FindOne() (interface{}, error)

func (*Searcher) Page 

func (s *Searcher) Page(num int) *Searcher

func (*Searcher) PrePage 

func (s *Searcher) PrePage(num int) *Searcher

func (*Searcher) Scope 

func (s *Searcher) Scope(names ...string) *Searcher

func (*Searcher) WithPagination 

func (s *Searcher) WithPagination() *Searcher

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.