v1 state

realmPkgPath

gRealmPath

RealmLink

RequiredAccountAmount

Notice

Help

gListedBoardsByID

// string(id) -> \*boards.Board

gInviteRequests

// string(board id) -> \*bptree.BPTree(address -> time.Time)

gBannedUsers

// string(board id) -> \*bptree.BPTree(address -> time.Time)

gLocked

TODO: Refactor globals in favor of a cleaner pattern

gBoards

gBoardsSequence

gPerms

initRealmPermissions

initRealmPermissions returns the default realm permissions.

getInviteRequests

getInviteRequests returns invite requests for a board.

getBannedUsers

getBannedUsers returns banned users within a board.

mustGetBoardByName

mustGetBoardByName returns a board or panics when it's not found.

mustGetBoard

mustGetBoard returns a board or panics when it's not found.

getThread

getThread returns a board thread.

getReply

getReply returns a thread comment or reply.

mustGetThread

mustGetThread returns a thread or panics when it's not found.

mustGetReply

mustGetReply returns a reply or panics when it's not found.

mustGetPermissions

parseRealmPath

DefaultFlaggingThreshold

DefaultFlaggingThreshold defines the default number of flags that hides flaggable items.

gFlaggingThresholds

// string(board ID) -> int

flagItem

flagItem adds a flag to a post. Returns whether flag count threshold is reached and post can be hidden. Panics if flag count threshold was already reached.

getFlaggingThreshold

dateFormat

padLeft

padZero

indentBody

indentForeignBody

indentForeignBody is the single "render a user body" operation: it sandboxes the body in a \<gno-foreign> block, indents it like indentBody, AND charges one unit against the per-render budget — so wrapping and budget-accounting can't drift apart (the \*int signals the mutation). The body renders inside the sandbox: its block structure (headings, blockquotes, lists, columns, alerts) is contained and cannot hijack realm chrome, so boards no longer needs the write-time markdown blacklist. The opener survives the "> " comment indentation at any depth (goldmark strips the "> " prefix before the block parser runs).

summaryOf

userLink

getRoleBadge

Board

Safe view types are defined in the hub extensions package and re-exported here so callers can keep using them via this realm.

Comment

Safe view types are defined in the hub extensions package and re-exported here so callers can keep using them via this realm.

Flag

Safe view types are defined in the hub extensions package and re-exported here so callers can keep using them via this realm.

Member

Safe view types are defined in the hub extensions package and re-exported here so callers can keep using them via this realm.

Thread

Safe view types are defined in the hub extensions package and re-exported here so callers can keep using them via this realm.

GetBoard

GetBoard returns a safe board.

GetThread

GetThread returns a safe board thread.

GetComment

GetComment returns a safe thread comment.

GetBoards

GetBoards returns a list with all boards. To reverse iterate use a negative count.

GetThreads

GetThreads returns a list with threads of a board. To reverse iterate use a negative count.

GetMembers

GetMembers returns a list with the members of a board. To reverse iterate use a negative count.

GetReposts

GetReposts returns a list with repost of a board thread. To reverse iterate use a negative count.

GetFlags

GetFlags returns a list with thread or comment moderation flags. To reverse iterate use a negative count. Thread flags are returned when \`commentID\` is zero, or comment flags are returned otherwise.

GetComments

GetComments returns a list with all thread comments and replies. To reverse iterate use a negative count. Top level comments can be filtered by checking \`Comment.ParentID\`, replies always have a parent comment or reply, while comments have no parent.

GetReplies

GetReplies returns a list with top level comment replies. To reverse iterate use a negative count.

getBoardThread

getBoardThread returns a board thread from their IDs.

getComment

getComment returns a thread comment from their IDs.

BoardMeta

BoardMeta defines a type for board metadata.

ThreadMeta

ThreadMeta defines a type for thread metadata.

RoleOwner

List of Boards2 member roles.

RoleAdmin

List of Boards2 member roles.

RoleModerator

List of Boards2 member roles.

RoleGuest

List of Boards2 member roles.

PermissionCustom

PermissionCustom defines an initial value for custom board permissions. When a board defines custom permissions it must starts from a value greater or equal than PermissionCustom. Custom permissions definition example: const ( PermissionCustom1 boards.Permission = iota + boards2.PermissionCustom PermissionCustom2 PermissionCustom3 )

PermissionBoardCreate

List of Boards2 permissions.

PermissionBoardFlaggingUpdate

List of Boards2 permissions.

PermissionBoardFreeze

List of Boards2 permissions.

PermissionBoardRename

List of Boards2 permissions.

PermissionMemberInvite

List of Boards2 permissions.

PermissionMemberInviteRevoke

List of Boards2 permissions.

PermissionMemberRemove

List of Boards2 permissions.

PermissionPermissionsUpdate

List of Boards2 permissions.

PermissionRealmHelpChange

List of Boards2 permissions.

PermissionRealmLock

List of Boards2 permissions.

PermissionRealmNotice

List of Boards2 permissions.

PermissionAccountRequiredAmountChange

List of Boards2 permissions.

PermissionReplyCreate

List of Boards2 permissions.

PermissionReplyDelete

List of Boards2 permissions.

PermissionReplyFlag

List of Boards2 permissions.

PermissionRoleChange

List of Boards2 permissions.

PermissionThreadCreate

List of Boards2 permissions.

PermissionThreadDelete

List of Boards2 permissions.

PermissionThreadEdit

List of Boards2 permissions.

PermissionThreadFlag

List of Boards2 permissions.

PermissionThreadFreeze

List of Boards2 permissions.

PermissionThreadRepost

List of Boards2 permissions.

PermissionUserBan

List of Boards2 permissions.

PermissionUserUnban

List of Boards2 permissions.

createBasicBoardPermissions

createOpenBoardPermissions

validateBasicBoardCreate

validateBasicBoardCreate validates PermissionBoardCreate. Expected \`args\` values: 1. Caller address 2. Board name 3. Board ID 4. Is board listed 5. Is board open

validateBasicBoardRename

validateBasicBoardRename validates PermissionBoardRename. Expected \`args\` values: 1. Caller address 2. Board ID 3. Current board name 4. New board name

validateBasicMemberInvite

validateBasicMemberInvite validates PermissionMemberInvite. Expected \`args\` values: 1. Caller address 2. Board ID 3. Invites

validateBasicRoleChange

validateBasicRoleChange validates PermissionRoleChange. Expected \`args\` values: 1. Caller address 2. Board ID 3. Member address 4. Role

checkBoardNameIsNotAddress

checkBoardNameBelongsToAddress

validateOpenBoardRename

validateOpenBoardRename validates PermissionBoardRename. Expected \`args\` values: 1. Caller address 2. Board ID 3. Current board name 4. New board name

validateOpenMemberInvite

validateOpenMemberInvite validates PermissionMemberInvite. Expected \`args\` values: 1. Caller address 2. Board ID 3. Invites

validateOpenRoleChange

validateOpenRoleChange validates PermissionRoleChange. Expected \`args\` values: 1. Caller address 2. Board ID 3. Member address 4. Role

validateOpenThreadCreate

validateOpenThreadCreate validates PermissionThreadCreate. Expected \`args\` values: 1. Caller address 2. Board ID 3. Thread ID 4. Title 5. Body

validateOpenReplyCreate

validateOpenReplyCreate validates PermissionReplyCreate. Expected \`args\` values: 1. Caller address 2. Board ID 3. Thread ID 4. Parent ID 5. Reply ID 6. Body

checkAccountHasAmount

MaxBoardNameLength

MaxThreadTitleLength

MaxThreadBodyLength

MaxReplyLength

reBoardName

SetHelp

SetHelp sets or updates boards realm help content.

SetRequiredAccountAmount

SetRequiredAccountAmount sets the required account amount to interact as a non member with open boards. Amount must be given as ugnot. The amount requirement is not applied to members that were invited to an open board.

SetPermissions

SetPermissions sets a permissions implementation for boards2 realm or a board.

SetRealmNotice

SetRealmNotice sets a notice to be displayed globally within the realm. An empty message removes the realm notice.

GetBoardIDFromName

GetBoardIDFromName searches a board by name and returns its ID.

BoardCount

BoardCount returns the total number of boards.

CreateBoard

CreateBoard creates a new board. Listed boards are included in the realm's list of boards. Open boards allow anyone to create threads and comment.

RenameBoard

RenameBoard changes the name of an existing board. A history of previous board names is kept when boards are renamed. Because of that boards are also accessible using previous name(s).

CreateThread

CreateThread creates a new thread within a board.

CreateReply

CreateReply creates a new comment or reply within a thread. The value of \`replyID\` is only required when creating a reply of another reply.

CreateRepost

CreateRepost reposts a thread into another board.

DeleteThread

DeleteThread deletes a thread from a board. Threads can be deleted by the users who created them or otherwise by users with special permissions.

DeleteReply

DeleteReply deletes a reply from a thread. Replies can be deleted by the users who created them or otherwise by users with special permissions. Soft deletion is used when the deleted reply contains sub replies, in which case the reply content is replaced by a text informing that reply has been deleted to avoid deleting sub-replies.

EditThread

EditThread updates the title and body of a thread. Threads can be updated by the users who created them or otherwise by users with special permissions.

EditReply

EditReply updates the body of a comment or reply. Replies can be updated only by the users who created them.

RemoveMember

RemoveMember removes a member from the realm or a board. Board ID is only required when removing a member from board.

IsMember

IsMember checks if a user is a member of the realm or a board. Board ID is only required when checking if a user is a member of a board.

HasMemberRole

HasMemberRole checks if a realm or board member has a specific role assigned. Board ID is only required when checking a member of a board.

ChangeMemberRole

ChangeMemberRole changes the role of a realm or board member. Board ID is only required when changing the role for a member of a board.

assertMemberAddressIsValid

assertUserAddressIsValid

assertBoardExists

assertBoardIsNotFrozen

assertIsValidBoardName

assertThreadIsNotFrozen

assertNameIsNotEmpty

assertTitleIsValid

assertBodyIsNotEmpty

assertBoardNameNotExists

assertThreadExists

assertReplyExists

assertThreadIsVisible

assertReplyIsVisible

assertThreadBodyIsValid

assertReplyBodyIsValid

assertMembersUpdateIsEnabled

BanDay

Constants for different banning periods.

BanWeek

Constants for different banning periods.

BanYear

Constants for different banning periods.

Ban

Ban bans a user from a board for a period of time. Only invited guest members and external users can be banned. Banning board owners, admins and moderators is not allowed.

Unban

Unban unbans a user from a board.

IsBanned

IsBanned checks if a user is banned from a board.

assertAddressIsValid

assertUserIsNotBanned

SetFlaggingThreshold

SetFlaggingThreshold sets the number of flags required to hide a thread or comment. Threshold is only applicable within the board where it's setted.

GetFlaggingThreshold

GetFlaggingThreshold returns the number of flags required to hide a thread or comment within a board.

FlagThread

FlagThread adds a new flag to a thread. Flagging requires special permissions and hides the thread when the number of flags reaches a pre-defined flagging threshold.

FlagReply

FlagReply adds a new flag to a comment or reply. Flagging requires special permissions and hides the comment or reply when the number of flags reaches a pre-defined flagging threshold.

FreezeBoard

FreezeBoard freezes a board so no more threads and comments can be created or modified.

UnfreezeBoard

UnfreezeBoard removes frozen status from a board.

IsBoardFrozen

IsBoardFrozen checks if a board has been frozen.

FreezeThread

FreezeThread freezes a thread so thread cannot be replied, modified or deleted. Fails if board is frozen.

UnfreezeThread

UnfreezeThread removes frozen status from a thread. Fails if board is frozen.

IsThreadFrozen

IsThreadFrozen checks if a thread has been frozen. Returns true if board is frozen.

setBoardReadonly

setThreadReadonly

Invite

Invite contains a user invitation.

InviteMember

InviteMember adds a member to the realm or to a board. A role can optionally be specified to be assigned to the new member.

InviteMembers

InviteMembers adds one or more members to the realm or to a board. Board ID is only required when inviting a member to a specific board.

RequestInvite

RequestInvite request to be invited to a board.

AcceptInvite

AcceptInvite accepts a board invite request.

RevokeInvite

RevokeInvite revokes a board invite request.

inviteMembers

assertInviteRequestExists

assertNoDuplicatedInvites

LockRealm

LockRealm locks the realm making it readonly. WARNING: Realm can't be unlocked once locked. Realm can also be locked without locking realm members. Realm members can be locked when locking the realm or afterwards. This is relevant for two reasons, one so that members can be modified after the lock. The other is for realm owners, who can delete threads and comments after the lock.

IsRealmLocked

IsRealmLocked checks if boards realm has been locked.

AreRealmMembersLocked

AreRealmMembersLocked checks if realm members have been locked.

assertRealmIsNotLocked

assertRealmMembersAreNotLocked

pageSizeDefault

pageSizeReplies

pageSizeFlat

maxRenderedBodies

maxRenderedBodies caps user bodies wrapped in \<gno-foreign> per page render, kept a margin under gnoweb's per-render foreign-block cap (foreign.MaxBlocksPerRender, sourced from chain/markdown so it can't drift from the renderer). On reaching it the tree stops descending and shows a truncation notice instead of letting the renderer blank comments past the cap. The margin absorbs the OP, repost source bodies, and chrome. Computed lazily (a func, not a package-level var) so it tracks the native cap across chain upgrades: a var initializer runs once at realm-init and persists, freezing a stale value if the underlying MaxBlocksPerRender ever changes; recomputing per render re-reads it.

sortToggleLink

sortToggleLink builds the asc/desc sort-toggle link for path. The label names the DESTINATION order (what you get by clicking), not the order you're currently viewing, and ?page= is reset since page N of one order is a different slice in the other. It reports whether the CURRENT order is descending, so callers can drive their own (signed-count or reverse-iterate) pagination. Other query params (e.g. flat=1) are preserved.

menuManageBoard

createBoardURI

adminUsersURI

helpURI

Render

renderHelp

renderBoardsList

renderBoardListMenu

renderCreateBoard

renderMembers

renderInvites

renderBannedUsers

infoAlert

rolesToString

menuURL

getCurrentMenu

renderBoard

renderSubMenu

renderSubMenu renders a sub-menu with a distinct visual pattern.

renderBoardMenu

renderInviteMember

renderPost

renderPost renders a post and (unless it's a leaf or capped) its replies. desc is the page's sort order, forwarded so a comment's nested inline children (renderSubReplies) match the order of the view they appear in. It is unused for the top-level/re-root call (path != "" routes to renderTopLevelReplies, which derives the order from the path); those callers pass false.

renderPostContent

renderPostInner

renderSourcePost

renderFlagPost

renderFlaggingReasonsPost

renderReplyPost

renderReply

newClampedPager

newClampedPager builds a pager, clamping an out-of-range, zero, negative, or malformed ?page= to the last valid page instead of erroring. pager.New rejects page==0, page>pageCount, and non-numeric pages with ErrInvalidPageNumber, which the callers would otherwise surface as a panic (aborting the whole render) or an error page in place of the list. A NEGATIVE page is not rejected by pager.New (it only checks ==0 and >pageCount), so it must be caught here too — otherwise it renders a broken "page -N of M" picker with both arrows disabled. Triggers on a stale deep link after deletions, or a hand-edited URL.

renderTopLevelReplies

renderSubReplies

renderEditReply

maxFlatIndentDepth

maxFlatIndentDepth caps the blockquote nesting in the flat comment view so deep reply chains stay readable; comments deeper than this still render, just at the capped indent.

renderThread

renderThreadFlat

renderThreadFlat renders every comment in the thread as a single flat, depth-indented, paginated list backed by ThreadMeta.AllReplies (the index that already holds every reply at every depth). Unlike the recursive threaded view — which bounds work with the render budget and truncates a large subtree — this view is reachable to the very last comment: each comment renders one \<gno-foreign> block (no recursion), so a fixed page size (pageSizeFlat) plus the OP stays well under the budget regardless of nesting, and the pager always advances. ?order=desc shows newest first, so its page 1 is the latest comments.

flatIndent

flatIndent returns the blockquote indent for a reply in the flat view, derived from its depth below the thread root (depth 1 = a direct reply to the thread), capped at maxFlatIndentDepth.

renderThreadSummary