reputation

README

Reputation

This YAGPDB plugin adds a reputation system.

Provides the +/giverep, rep and toprep commands.

Documentation

Index

• Constants
• Variables
• func CanModifyRep(conf *models.ReputationConfig, sender, receiver *dstate.MemberState) error
• func CheckSetCooldown(conf *models.ReputationConfig, senderID int64) (bool, error)
• func ClearCooldown(guildID, senderID int64) error
• func CmdGiveRep(parsed *dcmd.Data) (interface{}, error)
• func DefaultConfig(guildID int64) *models.ReputationConfig
• func DelRep(ctx context.Context, gid int64, userID int64) error
• func GetConfig(ctx context.Context, guildID int64) (*models.ReputationConfig, error)
• func GetUserStats(guildID, userID int64) (score int64, rank int, err error)
• func HandleGetReputation(w http.ResponseWriter, r *http.Request) interface{}
• func HandleLeaderboardJson(w http.ResponseWriter, r *http.Request) interface{}
• func HandleLogsJson(W http.ResponseWriter, r *http.Request) interface{}
• func HandlePostReputation(w http.ResponseWriter, r *http.Request) (templateData web.TemplateData, err error)
• func HandleResetReputation(w http.ResponseWriter, r *http.Request) (templateData web.TemplateData, err error)
• func IsAdmin(gs *dstate.GuildState, member *dstate.MemberState, ...) bool
• func KeyCooldown(guildID, userID int64) string
• func ModifyRep(ctx context.Context, conf *models.ReputationConfig, guildID int64, ...) (err error)
• func RegisterPlugin()
• func SetRep(ctx context.Context, gid int64, senderID, userID int64, points int64) error
• type LeaderboardEntry
  • func DetailedLeaderboardEntries(guildID int64, ranks []*RankEntry) ([]*LeaderboardEntry, error)
• type Plugin
  • func (p *Plugin) AddCommands()
  • func (p *Plugin) BotInit()
  • func (p *Plugin) InitWeb()
  • func (p *Plugin) LoadServerHomeWidget(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)
  • func (p *Plugin) PluginInfo() *common.PluginInfo
• type PostConfigForm
  • func (p PostConfigForm) RepConfig() *models.ReputationConfig
• type RankEntry
  • func TopUsers(guildID int64, offset, limit int) ([]*RankEntry, error)
• type UserError
  • func (b UserError) Error() string

Constants

const DBSchema = `` /* 3623-byte string literal not displayed */

Variables

var (
	ErrMissingRequiredGiveRole    = UserError("You don't have any of the required roles to give points")
	ErrMissingRequiredReceiveRole = UserError("Target don't have any of the required roles to receive points")

	ErrBlacklistedGive    = UserError("Blacklisted from giving points")
	ErrBlacklistedReceive = UserError("Blacklisted from receiving points")
	ErrCooldown           = UserError("You're still on cooldown")
)

var (
	ErrUserNotFound = errors.New("User not found")
)

Functions

func CanModifyRep

func CanModifyRep(conf *models.ReputationConfig, sender, receiver *dstate.MemberState) error

Returns a user error if the sender can not modify the rep of receiver Admins are always able to modify the rep of everyone

func CheckSetCooldown

func CheckSetCooldown(conf *models.ReputationConfig, senderID int64) (bool, error)

CheckSetCooldown checks and updates the reputation cooldown of a user, it returns true if the user was not on cooldown

func ClearCooldown

func ClearCooldown(guildID, senderID int64) error

func CmdGiveRep

func CmdGiveRep(parsed *dcmd.Data) (interface{}, error)

func DefaultConfig

func DefaultConfig(guildID int64) *models.ReputationConfig

func DelRep

func DelRep(ctx context.Context, gid int64, userID int64) error

func GetConfig

func GetConfig(ctx context.Context, guildID int64) (*models.ReputationConfig, error)

func GetUserStats

func GetUserStats(guildID, userID int64) (score int64, rank int, err error)

func HandleGetReputation

func HandleGetReputation(w http.ResponseWriter, r *http.Request) interface{}

func HandleLeaderboardJson

func HandleLeaderboardJson(w http.ResponseWriter, r *http.Request) interface{}

func HandleLogsJson

func HandleLogsJson(W http.ResponseWriter, r *http.Request) interface{}

func HandlePostReputation

func HandlePostReputation(w http.ResponseWriter, r *http.Request) (templateData web.TemplateData, err error)

func HandleResetReputation

func HandleResetReputation(w http.ResponseWriter, r *http.Request) (templateData web.TemplateData, err error)

func IsAdmin

func IsAdmin(gs *dstate.GuildState, member *dstate.MemberState, config *models.ReputationConfig) bool

func KeyCooldown

func KeyCooldown(guildID, userID int64) string

func ModifyRep

func ModifyRep(ctx context.Context, conf *models.ReputationConfig, guildID int64, sender, receiver *dstate.MemberState, amount int64) (err error)

func RegisterPlugin

func RegisterPlugin()

func SetRep

func SetRep(ctx context.Context, gid int64, senderID, userID int64, points int64) error

Types

type LeaderboardEntry

type LeaderboardEntry struct {
	*RankEntry
	Username string `json:"username"`
	Bot      bool   `json:"bot"`
	Avatar   string `json:"avatar"`
}

func DetailedLeaderboardEntries

func DetailedLeaderboardEntries(guildID int64, ranks []*RankEntry) ([]*LeaderboardEntry, error)

type Plugin

type Plugin struct{}

func (*Plugin) AddCommands

func (p *Plugin) AddCommands()

func (*Plugin) BotInit

func (p *Plugin) BotInit()

func (*Plugin) InitWeb

func (p *Plugin) InitWeb()

func (*Plugin) LoadServerHomeWidget

func (p *Plugin) LoadServerHomeWidget(w http.ResponseWriter, r *http.Request) (web.TemplateData, error)

func (*Plugin) PluginInfo

func (p *Plugin) PluginInfo() *common.PluginInfo

type PostConfigForm

type PostConfigForm struct {
	Enabled                 bool
	EnableThanksDetection   bool
	PointsName              string `valid:",50"`
	Cooldown                int    `valid:"0,86401"` // One day
	MaxGiveAmount           int64
	MaxRemoveAmount         int64
	RequiredGiveRoles       []int64 `valid:"role,true"`
	RequiredReceiveRoles    []int64 `valid:"role,true"`
	BlacklistedGiveRoles    []int64 `valid:"role,true"`
	BlacklistedReceiveRoles []int64 `valid:"role,true"`
	AdminRoles              []int64 `valid:"role,true"`
}

func (PostConfigForm) RepConfig

func (p PostConfigForm) RepConfig() *models.ReputationConfig

type RankEntry

type RankEntry struct {
	Rank   int   `json:"rank"`
	UserID int64 `json:"user_id"`
	Points int64 `json:"points"`
}

func TopUsers

func TopUsers(guildID int64, offset, limit int) ([]*RankEntry, error)

type UserError

type UserError string

func (UserError) Error

func (b UserError) Error() string