GazetteBuilder 1.0 Documentation

Requirements

WordPress 7.1 or later
PHP 8.3 or later

Installation

Copy or upload GazetteBuilder into the WordPress plugins directory.
Activate it from Plugins.
Flush or refresh permalinks after activation so GazetteBuilder rewrite routes are available.
Open the GazetteBuilder administration screens and configure Entry Types and content.

Entry Types

Entry Types are stored in the gb_entry_kind taxonomy. Index-enabled Entry Types can drive public archives. Configured sort modes include title, release_date, and timeline_sort.

More about Entry Types ->

Entries

Entries are the primary content objects. The plugin registers the gb_entry custom post type. Entries can carry Entry ID, Entry Type, Summary, Campaign Date, Story ID, Sequence Position, Release Date, Timeline Sort, Derived From, Featured Media, and Story display fields.

More about Entries ->

Semantic links

[[Syrtis Major]]

Semantic references are resolved against published, release-eligible GazetteBuilder Entries rather than hard-coded URLs.

Semantic relationships

Relationship declarations use the Relationship Definition’s canonical name followed by the Target Entry.

Located In: Syrtis Major
In District: Residency

When a declaration resolves, the Source Entry can show the forward relationship and the Target Entry can automatically show an inverse listing using the relationship’s configured inverse label.

More about Semantic Relationships ->

Timelines

[gazette_timeline]
[gazette_timeline types="location,event"]
[gazette_timeline min="1889-01-01" max="1889-06-30"]
[gazette_timeline orientation="horizontal"]
[gazette_timeline orientation="vertical"]
[gazette_timeline summary="yes"]

More about Timelines ->

Stories

Stories are built by assigning Entries a shared story_id and sequence position. Story-aware behavior supports landing and continue flow, release-aware visibility, and redirects away from unavailable steps.

Publications & Release Model

Published Entries are visible to readers.
An empty release date is immediately readable.
A future release date withholds an otherwise published Entry until it becomes eligible.
Story Entries can redirect readers until the next released step is reached.

More about the Publications & Release Model ->

ZIP import

Import packages may include Markdown files, media, front matter, Story metadata, timeline sort values, semantic reference data, and relationship declarations.

---
id: LOC-SYRTIS-MAJOR
title: Syrtis Major
entry_kind: location
campaign_date: "1889-01-13"
timeline_sort: "1889-01-13T09:00:00"
status: publish
relationships:
  - "Located In: Western Basin"
---
Syrtis Major is connected to [[The Double]].

More about the ZIP Import function ->

Administration

The current codebase provides administration for Entry Types, Stories, Import, Relationship Definitions, content validation and unresolved references, publication review, Reader Metrics, and site-wide Options.

Scope

Gazette Builder is intended for structured worldbuilding and lore publishing rather than general-purpose blogging or RPG player/GM account management.