# BW Babel — Schema Markup Made Simple

**Version:** 3.0.0-babel  
**Status:** Phase 1 Foundation (Services Layer Complete)

## What is BW Babel?

BW Babel is a modern schema markup plugin for WordPress that unifies structured data for AI systems and search engines.

Like the Tower of Babel, your content speaks in many voices. **Babel ensures everyone understands.**

## Features

### Organization Schema
- Business identity and contact information
- Multiple business type support
- Organization logo and media handling

### Multi-Location Support
- Manage multiple business locations
- Per-location contact info and hours
- Service area definitions
- Geographic coordinates

### People & Team Management
- Author/team member management
- Automatic team detection and assignment
- Author box rendering on posts
- Author archive redirect to team pages

### Content Schema
- 15+ schema types supported (Article, Product, Event, etc.)
- Per-post type schema mapping
- Post FAQ support with FAQPage schema
- Breadcrumb JSON-LD
- Sitelinks search box

### Advanced Features
- Rooms/Accommodations support for hospitality
- Team survey workflow (public form + admin queue)
- Configuration export/import
- Schema caching with health monitoring
- Conflict detection with other schema plugins

## Getting Started

1. **Activate the plugin** at Dashboard → Plugins
2. **Navigate to Babel** menu (top level)
3. **Configure Organization** with your business details
4. **Set up Locations** if you have multiple offices
5. **Configure Authors/Team** if using team feature

## Documentation

- **[Phase 1 Build Progress](docs/BABEL-BUILD.md)** — Current development status
- **[Refactoring Plan](../../../BW_SCHEMA_PLUGIN_REFACTOR_PLAN.md)** — Full project plan
- **[CLAUDE.md](CLAUDE.md)** — Developer guide for Claude Code

## Architecture

**Phase 1: Foundation (In Progress)**
- Services layer for business logic
- Form builder for declarative forms
- Page classes for modular admin pages

**Phase 2: Dashboard**
- Modern admin dashboard
- Top-level menu reorganization
- At-a-glance status overview

**Phase 3: Settings Pages**
- Redesigned organization page
- Locations & rooms management
- People & team settings
- Content configuration

**Phase 4: Post Metabox**
- Tabbed metabox design
- Improved FAQ editor
- Live schema preview

**Phase 5: Survey Management**
- Improved moderation workflow
- Spam filtering
- Notifications

## Development

This is a fresh plugin built from scratch with modern WordPress practices:
- Service layer pattern (testable, reusable)
- Declarative form definitions
- Modular page classes
- Comprehensive documentation

See [docs/BABEL-BUILD.md](docs/BABEL-BUILD.md) for detailed architecture notes.

## Compatibility

- **WordPress:** 6.0+
- **PHP:** 7.4+
- **Dependencies:** None (uses WordPress APIs only)

## License

GPLv2 or later

## About

**BW Babel** is developed by Bowden Works as a modern replacement for the legacy schema markup system in `bw-ai-schema-pro`.

This plugin focuses on simplicity, discoverability, and modern admin UX inspired by Yoast SEO's approach.