snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)

server/public/pluginapi/experimental/panel/settings/base_setting.go

@@ -0,0 +1,28 @@
+package settings
+
+type baseSetting struct {
+	title       string
+	description string
+	id          string
+	dependsOn   string
+}
+
+func (s *baseSetting) GetID() string {
+	return s.id
+}
+
+func (s *baseSetting) GetTitle() string {
+	return s.title
+}
+
+func (s *baseSetting) GetDescription() string {
+	return s.description
+}
+
+func (s *baseSetting) GetDependency() string {
+	return s.dependsOn
+}
+
+func (s *baseSetting) IsDisabled(foreignValue any) bool {
+	return false
+}

server/public/pluginapi/experimental/panel/settings/bool_setting.go

@@ -0,0 +1,116 @@
+package settings
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/mattermost/mattermost/server/public/model"
+)
+
+type boolSetting struct {
+	baseSetting
+	store SettingStore
+}
+
+// NewBoolSetting creates a new setting input for boolean values
+func NewBoolSetting(id, title, description, dependsOn string, store SettingStore) Setting {
+	return &boolSetting{
+		baseSetting: baseSetting{
+			title:       title,
+			description: description,
+			id:          id,
+			dependsOn:   dependsOn,
+		},
+		store: store,
+	}
+}
+
+func (s *boolSetting) Set(userID string, value any) error {
+	boolValue := false
+	if value == TrueString {
+		boolValue = true
+	}
+
+	err := s.store.SetSetting(userID, s.id, boolValue)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func (s *boolSetting) Get(userID string) (any, error) {
+	value, err := s.store.GetSetting(userID, s.id)
+	if err != nil {
+		return "", err
+	}
+	boolValue, ok := value.(bool)
+	if !ok {
+		return "", errors.New("current value is not a bool")
+	}
+
+	stringValue := FalseString
+	if boolValue {
+		stringValue = TrueString
+	}
+
+	return stringValue, nil
+}
+
+func (s *boolSetting) GetMessageAttachments(userID, settingHandler string, disabled bool) (*model.MessageAttachment, error) {
+	title := fmt.Sprintf("Setting: %s", s.title)
+	currentValueMessage := DisabledString
+
+	actions := []*model.PostAction{}
+	if !disabled {
+		currentValue, err := s.Get(userID)
+		if err != nil {
+			return nil, err
+		}
+
+		currentTextValue := "No"
+		if currentValue == TrueString {
+			currentTextValue = "Yes"
+		}
+		currentValueMessage = fmt.Sprintf("Current value: %s", currentTextValue)
+
+		actionTrue := model.PostAction{
+			Type: model.PostActionTypeButton,
+			Name: "Yes",
+			Integration: &model.PostActionIntegration{
+				URL: settingHandler,
+				Context: map[string]any{
+					ContextIDKey:          s.id,
+					ContextButtonValueKey: TrueString,
+				},
+			},
+		}
+
+		actionFalse := model.PostAction{
+			Type: model.PostActionTypeButton,
+			Name: "No",
+			Integration: &model.PostActionIntegration{
+				URL: settingHandler,
+				Context: map[string]any{
+					ContextIDKey:          s.id,
+					ContextButtonValueKey: FalseString,
+				},
+			},
+		}
+		actions = []*model.PostAction{&actionTrue, &actionFalse}
+	}
+
+	text := fmt.Sprintf("%s\n%s", s.description, currentValueMessage)
+	sa := model.MessageAttachment{
+		Title:    title,
+		Text:     text,
+		Fallback: fmt.Sprintf("%s: %s", title, text),
+		Actions:  actions,
+	}
+
+	return &sa, nil
+}
+
+func (s *boolSetting) IsDisabled(foreignValue any) bool {
+	return foreignValue == FalseString
+}

server/public/pluginapi/experimental/panel/settings/empty_setting.go

@@ -0,0 +1,41 @@
+package settings
+
+import (
+	"fmt"
+
+	"github.com/mattermost/mattermost/server/public/model"
+)
+
+type emptySetting struct {
+	baseSetting
+}
+
+// NewEmptySetting creates a new panel value with no setting attached
+func NewEmptySetting(id, title, description string) Setting {
+	return &emptySetting{
+		baseSetting: baseSetting{
+			id:          id,
+			title:       title,
+			description: description,
+		},
+	}
+}
+
+func (s *emptySetting) GetMessageAttachments(userID, settingHandler string, disabled bool) (*model.MessageAttachment, error) {
+	title := fmt.Sprintf("Setting: %s", s.title)
+	sa := model.MessageAttachment{
+		Title:    title,
+		Text:     s.description,
+		Fallback: fmt.Sprintf("%s: %s", title, s.description),
+	}
+
+	return &sa, nil
+}
+
+func (s *emptySetting) Get(userID string) (any, error) {
+	return nil, nil
+}
+
+func (s *emptySetting) Set(userID string, value any) error {
+	return nil
+}

server/public/pluginapi/experimental/panel/settings/option_setting.go

@@ -0,0 +1,91 @@
+package settings
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/mattermost/mattermost/server/public/model"
+)
+
+type optionSetting struct {
+	baseSetting
+	options []string
+	store   SettingStore
+}
+
+// NewOptionSetting creates a new setting input to select from a dropdown
+func NewOptionSetting(id, title, description, dependsOn string, options []string, store SettingStore) Setting {
+	return &optionSetting{
+		baseSetting: baseSetting{
+			title:       title,
+			description: description,
+			id:          id,
+			dependsOn:   dependsOn,
+		},
+		options: options,
+		store:   store,
+	}
+}
+
+func (s *optionSetting) Set(userID string, value any) error {
+	err := s.store.SetSetting(userID, s.id, value)
+	if err != nil {
+		return err
+	}
+
+	return nil
+}
+
+func (s *optionSetting) Get(userID string) (any, error) {
+	value, err := s.store.GetSetting(userID, s.id)
+	if err != nil {
+		return "", err
+	}
+	valueString, ok := value.(string)
+	if !ok {
+		return "", errors.New("current value is not a string")
+	}
+
+	return valueString, nil
+}
+
+func (s *optionSetting) GetMessageAttachments(userID, settingHandler string, disabled bool) (*model.MessageAttachment, error) {
+	title := fmt.Sprintf("Setting: %s", s.title)
+	currentValueMessage := DisabledString
+
+	actions := []*model.PostAction{}
+	if !disabled {
+		currentTextValue, err := s.Get(userID)
+		if err != nil {
+			return nil, err
+		}
+		currentValueMessage = fmt.Sprintf("Current value: %s", currentTextValue)
+
+		actionOptions := model.PostAction{
+			Type: model.PostActionTypeSelect,
+			Name: "Select an option:",
+			Integration: &model.PostActionIntegration{
+				URL: settingHandler + "?" + s.id + "=true",
+				Context: map[string]any{
+					ContextIDKey: s.id,
+				},
+			},
+			Options: stringsToOptions(s.options),
+		}
+
+		actions = []*model.PostAction{&actionOptions}
+	}
+
+	text := fmt.Sprintf("%s\n%s", s.description, currentValueMessage)
+	sa := model.MessageAttachment{
+		Title:    title,
+		Text:     text,
+		Fallback: fmt.Sprintf("%s: %s", title, text),
+		Actions:  actions,
+	}
+	return &sa, nil
+}
+
+func (s *optionSetting) IsDisabled(foreignValue any) bool {
+	return foreignValue == FalseString
+}

server/public/pluginapi/experimental/panel/settings/read_only_setting.go

@@ -0,0 +1,69 @@
+package settings
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/mattermost/mattermost/server/public/model"
+)
+
+type readOnlySetting struct {
+	baseSetting
+	store SettingStore
+}
+
+// NewReadOnlySetting creates a new panel value that only read from the setting
+func NewReadOnlySetting(id, title, description, dependsOn string, store SettingStore) Setting {
+	return &readOnlySetting{
+		baseSetting: baseSetting{
+			title:       title,
+			description: description,
+			id:          id,
+			dependsOn:   dependsOn,
+		},
+		store: store,
+	}
+}
+
+func (s *readOnlySetting) Get(userID string) (any, error) {
+	value, err := s.store.GetSetting(userID, s.id)
+	if err != nil {
+		return "", err
+	}
+	stringValue, ok := value.(string)
+	if !ok {
+		return "", errors.New("current value is not a string")
+	}
+
+	return stringValue, nil
+}
+
+func (s *readOnlySetting) Set(userID string, value any) error {
+	return nil
+}
+
+func (s *readOnlySetting) GetMessageAttachments(userID, settingHandler string, disabled bool) (*model.MessageAttachment, error) {
+	title := fmt.Sprintf("Setting: %s", s.title)
+	currentValueMessage := DisabledString
+
+	if !disabled {
+		currentValue, err := s.Get(userID)
+		if err != nil {
+			return nil, err
+		}
+		currentValueMessage = fmt.Sprintf("Current value: %s", currentValue)
+	}
+
+	text := fmt.Sprintf("%s\n%s", s.description, currentValueMessage)
+	sa := model.MessageAttachment{
+		Title:    title,
+		Text:     text,
+		Fallback: fmt.Sprintf("%s: %s", title, text),
+	}
+
+	return &sa, nil
+}
+
+func (s *readOnlySetting) IsDisabled(foreignValue any) bool {
+	return foreignValue == FalseString
+}

server/public/pluginapi/experimental/panel/settings/setting.go

@@ -0,0 +1,33 @@
+package settings
+
+import (
+	"github.com/mattermost/mattermost/server/public/model"
+)
+
+const (
+	// ContextIDKey defines the key used in the context to store the ID
+	ContextIDKey = "setting_id"
+	// ContextButtonValueKey defines the key used in the context to store a button value
+	ContextButtonValueKey = "button_value"
+	// ContextOptionValueKey defines the key used in the context to store a selected option value
+	ContextOptionValueKey = "selected_option"
+
+	// DisabledString defines the string used to show that a setting is disabled
+	DisabledString = "Disabled"
+	// TrueString codify the boolean true into a string
+	TrueString = "true"
+	// FalseString codify the boolean false into a string
+	FalseString = "false"
+)
+
+// Setting defines the behavior of each element a the panel
+type Setting interface {
+	Set(userID string, value any) error
+	Get(userID string) (any, error)
+	GetID() string
+	GetDependency() string
+	IsDisabled(foreignValue any) bool
+	GetTitle() string
+	GetDescription() string
+	GetMessageAttachments(userID, settingHandler string, disabled bool) (*model.MessageAttachment, error)
+}

server/public/pluginapi/experimental/panel/settings/store.go

@@ -0,0 +1,7 @@
+package settings
+
+// SettingStore defines the behavior needed to set and get settings
+type SettingStore interface {
+	SetSetting(userID, settingID string, value any) error
+	GetSetting(userID, settingID string) (any, error)
+}

server/public/pluginapi/experimental/panel/settings/utils.go

@@ -0,0 +1,16 @@
+package settings
+
+import (
+	"github.com/mattermost/mattermost/server/public/model"
+)
+
+func stringsToOptions(in []string) []*model.PostActionOptions {
+	out := make([]*model.PostActionOptions, len(in))
+	for i, o := range in {
+		out[i] = &model.PostActionOptions{
+			Text:  o,
+			Value: o,
+		}
+	}
+	return out
+}