# Configuration

PlainSpeak Accessible Geospatial Companion is configured from the WordPress administration screen.

This document describes the administrator settings available in the plugin.

## Display and Behavior

### Theme

Controls the visual theme used by the companion display.

Available options:

* Auto
* Light
* Dark

Auto uses the plugin default styling and may respond to visitor device or browser appearance preferences when supported. Use Light or Dark to force the companion display.

### After Query Scroll Behavior

Controls what happens after results load.

Available options include staying in place or scrolling back to the control area.

Staying in place is the least disruptive default.

## Dataset Header

### Dataset Title

Main heading shown above the accessible status tool.

### Dataset Description

Short plain-language description shown below the heading.

## Data Source

### Feature Layer URL

The public ArcGIS REST FeatureServer layer URL used by PlainSpeak.

## Explore Controls

### Geography Label

Label used for the selectable detail-area.

Examples:

* County
* District
* Region
* Service Area

### Name Field

Feature layer attribute field used to populate the selection list.

### Select Placeholder

Placeholder text shown before a detail-area is selected.

## Rollup Summary Action

### Rollup Label

Label used for the rollup-area summary action.

Examples:

* Statewide
* Regionwide
* Overall

## Category Cards

Category cards map feature layer numeric fields to status cards.

Each category includes:

### Field

Feature layer numeric field used for summary values.

### Label

User-facing category label displayed on the status card.

### Unit Label

Text describing the reported unit.

### Description

Plain-language description of the category.

Unused category slots may be left blank.

## Total Card

### Total Unit Label

Text used to describe the total value.

### Total Description

Plain-language description displayed for the total card.

## Status and Interface Text

### Results Heading

Heading shown above the results.

### Detail Action Label

Button label used to request detail-area results.

### Rollup Action Label

Button label used to request rollup-area results.

### Return Detail Label Template

Template used for the return-to-detail-area action.

Supports {location}, which is replaced with the selected detail-area name.

### Source Information

Text shown after the fixed `Source:` label on the frontend.

### Updated Text

Text describing when the data was last updated.

### Show Product Attribution

Controls whether `Accessible Geospatial Companion by Lewis Rowley` is shown below the tool.

## Initial State Text

### Initial Instruction Text

Instruction shown before the visitor selects a detail-area.

### Initial Status

Initial status message shown before results are loaded.

## Preview Panel

### Preview Title

General title for the preview panel.

### Detail Preview Title Template

Title template used for detail-area preview images.

Supports {location}, which is replaced with the selected detail-area name.

### Rollup Preview Title

Title shown for the rollup-area preview image.

### Placeholder Caption

Caption shown before a detail-area is selected.

### Placeholder Alt Text

Alternative text for the placeholder preview image.

### Preview Base URL

Folder URL containing preview images.

### Rollup Preview Image Filename

Filename for the rollup-area preview image.

Example:

`statewide-california.jpg`

Place this file in the preview images folder.

### Placeholder Image URL

Image URL used before a detail-area is selected.

### Fallback Image URL

Image URL shown when a location-specific preview image is not available.

## Interactive Application

### Application URL

Optional URL to an interactive application or data exploration resource.

### Application Link Text

Text used for the interactive application link.

### Application Note

Plain-language note explaining the purpose and limitations of the interactive application.

The interactive application is optional. The page provides the accessible status summary.

## CSS Customization

PlainSpeak exposes CSS variables that can be overridden from the theme Customizer or site CSS.

Recommended pattern:
```css
.plaincomp {
  --plaincomp-custom-accent: red;
  --plaincomp-custom-accent-soft: #fedbe4;
}
```

Result context card example:

```css
.plaincomp .plaincomp__result-context-card {
  background: #fedbe4;
  border-left-color: red;
}
```
## Preview Image Paths

For preview image settings, use WordPress uploads paths beginning with `wp-content/`.

Example Preview Base URL:

```text
wp-content/uploads/2026/06/
```

PlainSpeak quietly normalizes `/wp-content/...` and `./wp-content/...` to `wp-content/...` when settings are saved.

`Media Library Workflow`
Upload images to Media Library.
e.g.
county-sonoma.jpg
county-alameda.jpg
statewide-california.jpg
placeholder-california.png

Get the URL path for files uploaded, using the wordpress Media Library.
Example:

https://example.com/wp-content/uploads/2026/06/county-sonoma.jpg
pattern: https://example.com/wp-content/uploads/YYYY/MM/image-name.filetype

Configure
Enter into Preview Base URL:
e.g. wp-content/uploads/2026/06/

