FAIR

Federated and Independent Repositories

Relatura Directory Optimizer

Plugin Banner

Relatura Directory Optimizer

by relatura

Download
Description

Relatura Directory Optimizer helps WordPress directory owners optimize and normalize listing data into consistent, structured formats using deterministic and AI-assisted normalization.

Directory websites already contain valuable business and service information. Relatura adds a structured normalization layer on top of your existing content, without requiring you to rebuild your site or overwrite your original data.

Instead of rewriting posts, Relatura generates normalized field values based on your configured mappings and stores them separately as post meta. Your original listing content remains intact.

This creates a consistent internal representation of your directory data, helping standardize formatting and improve structured consistency across listings.

Why Normalization Matters

Directory data is often inconsistent:

  • Phone numbers formatted differently
  • Mixed capitalization
  • Extra whitespace or hidden characters
  • Inconsistent address structures
  • Unstructured contact fields

Relatura uses AI-powered normalization to standardize mapped listing fields into predictable, consistent formats.

The result is optimized listings backed by a structured normalization layer.

Scan First. Then Optimize.

Relatura introduces a safe, scan-first workflow.

Scan
Preview normalization results without writing data. Scan is read-only and allows administrators to review how mapped fields would be normalized.

Optimize Listings
Generate normalized field values using AI and store them internally as structured post meta. Original listing content and custom fields remain unchanged.

This approach provides transparency, control, and safety.

Core Features

  • Field mapping from directory data to a normalized schema
  • AI-powered normalization via secure external processing
  • Scan (read-only preview mode)
  • Optimize Listings (stores normalized outputs separately)
  • Execution summaries and per-listing normalized field storage
  • Structured normalization layer stored independently from original data
  • Compatible with directory-style custom post types

Relatura focuses on directory data normalization and structured consistency. It is not a traditional SEO plugin.

Relatura is currently in early live beta. Limits and features may evolve as we gather feedback.

External services

Relatura Directory Optimizer connects to external APIs to provide AI-powered normalization features and backend connectivity checks.

Some advanced normalization features require external API connectivity.

1) Relatura API (https://api.relatura.com)
Used for: Backend connectivity checks and proxying AI normalization requests through a secure backend.

Data sent: install/site identifier, optional site URL, plugin version, text submitted for normalization, and technical request metadata (such as timestamps and request IDs).
When sent: When an administrator initiates Optimize Listings (normalization) or views relevant backend status pages.
Why sent: To securely process normalization requests without exposing provider API keys in the WordPress installation.

Service provider: Relatura (api.relatura.com)
Terms: https://api.relatura.com/terms.html
Privacy: https://api.relatura.com/privacy.html

2) OpenAI API (https://api.openai.com)
Used for: AI text normalization when Optimize Listings (normalization) actions are run.

Data sent: The text content selected by the administrator for optimization (normalization) such as listing fields, along with limited contextual metadata required to associate the result to the correct listing.
When sent: Only when an administrator initiates Optimize Listings (normalization)
Why sent: To generate normalized text output using OpenAI’s API.

Service provider: OpenAI
Terms: https://openai.com/policies/row-terms-of-use/
Privacy: https://openai.com/policies/row-privacy-policy/

3) Anthropic API (https://api.anthropic.com)
Used for: AI text normalization in future supported releases when Anthropic is enabled.

Data sent: The text content selected by the administrator for optimization (normalization) such as listing fields, along with administrator-selected settings/context required to generate a normalized result. This may include small metadata such as a field/key name and internal identifiers needed to associate the result to the correct item.
When sent: Only when an administrator initiates Optimize Listings (normalization) and Anthropic is selected/configured.
Why sent: To generate normalized text output using Anthropic’s API.

Service provider: Anthropic
Terms: https://www.anthropic.com/legal/consumer-terms
Privacy: https://www.anthropic.com/legal/privacy

Anthropic provider settings may appear in the interface but are currently experimental / not active.

  1. Upload the plugin folder to /wp-content/plugins/
  2. Activate the plugin through the WordPress admin
  3. Configure directory field mappings
  4. Run Scan to preview normalization results
  5. Run Optimize Listings to generate normalized structured field values (stored separately)
  1. Scan detects messy directory listing data and shows deterministic cleanup before changes are applied.

    Scan detects messy directory listing data and shows deterministic cleanup before changes are applied.

  2. Optimize Listings previews cleaned canonical values before saving them.

    Optimize Listings previews cleaned canonical values before saving them.

  3. Optimized values stored in canonical format for AI-ready directory data.

    Optimized values stored in canonical format for AI-ready directory data.

  4. Settings page showing backend connection status and health diagnostics.

    Settings page showing backend connection status and health diagnostics.

Does this plugin require an external service?

Yes.

Relatura requires external API connectivity to perform AI-powered normalization.

Does this plugin modify my data automatically?

No.

Relatura does not alter your original listing content.

Scan is read-only and previews how mapped fields would be normalized.

When you run Optimize Listings, Relatura generates normalized field values and stores them separately as post meta. Your original posts and custom fields remain unchanged.

Does Relatura output schema markup or JSON-LD to the frontend?

No.

Relatura stores normalized directory data internally as post meta. It does not automatically inject JSON-LD or structured data into the frontend.

0.2.2

  • Introduced deterministic field mapping suggestions on the Field Mapping page.
  • Suggestions are generated using field-name heuristics and require explicit user acceptance.
  • Existing mappings are never overwritten.
  • Improves onboarding by reducing manual mapping configuration.

0.2.1

  • Improved Scan UX when listings are already well structured
  • Improved Optimize guidance when field mappings are missing
  • Improved diff behavior by automatically showing unchanged rows when no changes are detected
  • Fix: Optimize preview table now uses a consistent sample listing across all fields

0.2.0

  • Introduced deterministic optimization pipeline for directory listing fields
  • Scan / Optimize / Apply workflow now produces consistent canonical results
  • Canonical optimized values stored for title, description, phone, phone extension, email, and URL
  • Deterministic optimization works locally without requiring the backend service
  • Improved backend messaging and diagnostics for clearer installation status
  • Updated screenshots and documentation to reflect the new optimization workflow

0.1.2

  • Introduced Scan-first workflow for safer preview of normalization results
  • Updated UI terminology from “Normalize” to “Optimize”
  • Improved result labeling and execution summaries
  • Added fallback handling when field mappings are incomplete
  • Refined activation and first-run admin UX clarity

0.1.1

  • Fix: Corrected WordPress.org release packaging (ensures latest code is distributed).

0.1.0

  • Initial release
Back to top