8c9a853343
Allow admins to set instance settings through a PATCH to /api/v1/instance Update templates to reflect some of the new fields
87 lines
4.0 KiB
Go
87 lines
4.0 KiB
Go
/*
|
|
GoToSocial
|
|
Copyright (C) 2021 GoToSocial Authors admin@gotosocial.org
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
package model
|
|
|
|
import "mime/multipart"
|
|
|
|
// Instance represents the software instance of Mastodon running on this domain. See https://docs.joinmastodon.org/entities/instance/
|
|
type Instance struct {
|
|
// REQUIRED
|
|
|
|
// The domain name of the instance.
|
|
URI string `json:"uri,omitempty"`
|
|
// The title of the website.
|
|
Title string `json:"title,omitempty"`
|
|
// Admin-defined description of the Mastodon site.
|
|
Description string `json:"description"`
|
|
// A shorter description defined by the admin.
|
|
ShortDescription string `json:"short_description"`
|
|
// An email that may be contacted for any inquiries.
|
|
Email string `json:"email"`
|
|
// The version of Mastodon installed on the instance.
|
|
Version string `json:"version"`
|
|
// Primary langauges of the website and its staff.
|
|
Languages []string `json:"languages,omitempty"`
|
|
// Whether registrations are enabled.
|
|
Registrations bool `json:"registrations"`
|
|
// Whether registrations require moderator approval.
|
|
ApprovalRequired bool `json:"approval_required"`
|
|
// Whether invites are enabled.
|
|
InvitesEnabled bool `json:"invites_enabled"`
|
|
// URLs of interest for clients apps.
|
|
URLS *InstanceURLs `json:"urls,omitempty"`
|
|
// Statistics about how much information the instance contains.
|
|
Stats map[string]int `json:"stats,omitempty"`
|
|
// Banner image for the website.
|
|
Thumbnail string `json:"thumbnail"`
|
|
// A user that can be contacted, as an alternative to email.
|
|
ContactAccount *Account `json:"contact_account,omitempty"`
|
|
// What's the maximum allowed length of a post on this instance?
|
|
// This is provided for compatibility with Tusky.
|
|
MaxTootChars uint `json:"max_toot_chars"`
|
|
}
|
|
|
|
// InstanceURLs represents URLs necessary for successfully connecting to the instance as a user. See https://docs.joinmastodon.org/entities/instance/
|
|
type InstanceURLs struct {
|
|
// Websockets address for push streaming.
|
|
StreamingAPI string `json:"streaming_api"`
|
|
}
|
|
|
|
// InstanceStats represents some public-facing stats about the instance. See https://docs.joinmastodon.org/entities/instance/
|
|
type InstanceStats struct {
|
|
// Users registered on this instance.
|
|
UserCount int `json:"user_count"`
|
|
// Statuses authored by users on instance.
|
|
StatusCount int `json:"status_count"`
|
|
// Domains federated with this instance.
|
|
DomainCount int `json:"domain_count"`
|
|
}
|
|
|
|
// InstanceSettingsUpdateRequest is the form to be parsed on a PATCH to /api/v1/instance
|
|
type InstanceSettingsUpdateRequest struct {
|
|
SiteTitle *string `form:"site_title" json:"site_title" xml:"site_title"`
|
|
SiteContactUsername *string `form:"site_contact_username" json:"site_contact_username" xml:"site_contact_username"`
|
|
SiteContactEmail *string `form:"site_contact_email" json:"site_contact_email" xml:"site_contact_email"`
|
|
SiteShortDescription *string `form:"site_short_description" json:"site_short_description" xml:"site_short_description"`
|
|
SiteDescription *string `form:"site_description" json:"site_description" xml:"site_description"`
|
|
SiteTerms *string `form:"site_terms" json:"site_terms" xml:"site_terms"`
|
|
Avatar *multipart.FileHeader `form:"avatar" json:"avatar" xml:"avatar"`
|
|
Header *multipart.FileHeader `form:"header" json:"header" xml:"header"`
|
|
}
|