GoPress Docs
Docs / Admin Overview

Admin Overview

The GoPress admin is a built-in CMS interface for managing content, media, menus, themes, plugins, cache, redirects, mail, users, and system settings.

Main Areas

  • Dashboard β€” overview metrics and recent operation logs.
  • Content β€” core posts and theme-defined content types.
  • Taxonomy β€” categories and tags.
  • System β€” menus, themes, plugins, cache, redirects, media library, mail settings, system settings, and users.

The sidebar is generated from core content types, active theme metadata, plugin capabilities, and registered admin routes.

Content Management

The admin CRUD surface is data-driven. A content type declared in theme.toml can automatically receive list, create, edit, delete, media, taxonomy, sorting, REST, and rewrite behavior depending on its supports and taxonomies settings.

Content list pages include WordPress-style Screen Options. The column checkboxes are generated from the current page's actual columns, including core fields, content meta fields, and taxonomies attached to that content type. The selected columns and items-per-page value are stored per list key and are applied to server-side pagination.

List search is server-side and searches titles only, matching the admin placeholder. Date and taxonomy filters are also generated from the current content type: available months come from existing rows, and the taxonomy dropdown uses the first hierarchical taxonomy attached to the type, falling back to the first taxonomy when no hierarchical taxonomy exists. Search, tabs, date filters, taxonomy filters, and pagination compose into one query so totals and page counts stay accurate.

Settings

System settings are split into website settings and admin settings. Website settings affect the public site, SEO metadata, sitemap, favicon, publish-time timezone, and branding options. The site_icon value is the shared favicon source for all themes. site_timezone is the shared timezone used to parse admin publish-time inputs and format content dates in admin lists and themes; timestamps are stored in UTC. Admin settings control the CMS interface, including the admin language.

Mail Settings

Mail settings are managed on a dedicated system page instead of the general options form. SMTP transport values are saved to the active site's config.toml under [mail]; notification switches and recipient preferences are saved as options. go-mail is the default driver, with a stdlib standard-library branch available.

  • SMTP transport switch β€” when disabled, notification rules stay saved but no mail is delivered.
  • SMTP key β€” mail.mail_key is written only to the site config file. The admin form shows a placeholder when a key exists; leaving the field blank preserves it, and the clear checkbox removes it.
  • Gmail setup β€” use smtp.gmail.com, 587, STARTTLS, the Gmail address as both username and sender, and a Google App Password as the SMTP key.
  • Test email β€” uses the currently saved SMTP settings so operators can verify host, port, encryption, and sender configuration.
  • Contact message notifications β€” the default rule sends an async email when a contact_message is created. Failures are logged and do not block saving the message.

Extension Points

Plugins can add settings pages, content form fields, save handlers, content-list tabs, frontend hook output, SEO overrides, and sitemap transformers without modifying admin core templates directly.