# WordPress Blog Structure Documentation

**Last Updated:** 2026-01-09

Complete documentation of WordPress blog architecture, structure, and patterns.

## Overview

The Ordio blog is hosted on WordPress CMS and accessible at `https://www.ordio.com/insights/`. This document details the WordPress structure, URL patterns, categories, and technical implementation.

## URL Structure

### Permalink Pattern

WordPress uses a custom permalink structure:

**Pattern:** `https://www.ordio.com/insights/{category}/{post-slug}/`

**Examples:**

- `https://www.ordio.com/insights/lexikon/arbeitsschutzvorschriften-und-programme/`
- `https://www.ordio.com/insights/ratgeber/zeiterfassung-gastronomie-pflicht/`
- `https://www.ordio.com/insights/inside-ordio/ordio-in-neuem-design/`

### URL Components

- **Base:** `/insights/`
- **Category:** One of `lexikon`, `ratgeber`, `inside-ordio`
- **Slug:** Post-specific slug (typically descriptive German terms)

## Category Structure

### Main Categories

The blog uses three main categories:

1. **Lexikon** (54 posts, 54.5%)

   - Encyclopedia/dictionary articles
   - Term definitions and explanations
   - URL pattern: `/insights/lexikon/{slug}/`

2. **Ratgeber** (37 posts, 37.4%)

   - Guide and advice articles
   - How-to guides and best practices
   - URL pattern: `/insights/ratgeber/{slug}/`

3. **Inside Ordio** (8 posts, 8.1%)
   - Company news and updates
   - Product announcements
   - URL pattern: `/insights/inside-ordio/{slug}/`

### Category Characteristics

**Lexikon:**

- Focus: Educational content, definitions
- Typical topics: HR terms, legal concepts, processes
- Average word count: ~1,200 words
- SEO focus: Definition-style content

**Ratgeber:**

- Focus: Practical guidance, how-to content
- Typical topics: Implementation guides, best practices, industry advice
- Average word count: ~1,200 words
- SEO focus: How-to and guide content

**Inside Ordio:**

- Focus: Company updates, product news
- Typical topics: Feature releases, team news, partnerships
- Average word count: ~500 words (shorter, news-style)
- SEO focus: Brand awareness, product updates

## Post Metadata Structure

### Standard WordPress Fields

Each blog post includes:

- **Title:** Post title (displayed in H1 and meta title)
- **Slug:** URL-friendly version of title
- **Publication Date:** ISO 8601 format (e.g., `2023-09-01T10:40:44+00:00`)
- **Last Modified:** Date from sitemap (e.g., `2025-03-31T18:58:44+00:00`)
- **Author:** Post author (if available)
- **Category:** Primary category (lexikon, ratgeber, inside-ordio)
- **Tags:** Additional tags (if used)
- **Featured Image:** Primary image for social sharing and display

### SEO Metadata (Yoast SEO)

Posts include Yoast SEO metadata:

- **Meta Title:** Optimized title (typically includes category and brand)
- **Meta Description:** 155-160 character description
- **Open Graph Tags:** og:title, og:description, og:image, og:url
- **Twitter Card Tags:** twitter:title, twitter:description, twitter:image
- **Schema Markup:** Article schema (if implemented)

### Content Structure

**Typical Post Structure:**

- H1: Post title
- Featured image
- Introduction paragraph
- Main content (H2/H3 headings)
- Conclusion/CTA
- Related articles (if implemented)

## WordPress Features Detected

### Plugins and Features

**Yoast SEO:**

- Confirmed via sitemap generation (`main-sitemap.xsl`)
- Meta title/description optimization
- XML sitemap generation
- Open Graph and Twitter Card support

**WordPress Core Features:**

- Custom permalink structure
- Category taxonomy
- Tag taxonomy (if used)
- Featured images
- Post revisions (implied by lastmod dates)

### Custom Functionality

**Potential Custom Features:**

- Custom post types (if any)
- Custom taxonomies (beyond categories/tags)
- Custom fields (ACF or similar)
- Custom templates for categories

**Note:** Full feature detection requires WordPress admin access or database inspection.

## Author Structure

**Current Status:** Author information extraction pending

**Analysis Needed:**

- Number of authors
- Author distribution across posts
- Author pages (if implemented)
- Author schema markup

## Tag Usage

**Current Status:** Tag extraction pending

**Analysis Needed:**

- Tag frequency
- Tag-to-post mapping
- Tag pages (if implemented)
- Tag SEO value

## Media Library Structure

### Featured Images

**Storage Location:** `/wp-content/uploads/{year}/{month}/`

**Pattern:** Images stored by upload date in WordPress media library

**Examples:**

- `https://www.ordio.com/wp-content/uploads/2023/09/image-name.jpeg`
- `https://www.ordio.com/wp-content/uploads/2024/12/image-name.jpg`

### Image Usage

- **Featured Images:** One per post (for social sharing and display)
- **Content Images:** Embedded in post content
- **Image Optimization:** Unknown (needs analysis)

## Sitemap Structure

### Sitemap Index

**URL:** `https://www.ordio.com/sitemap_index.xml`

**Contains:**

- `post-sitemap.xml` - All blog posts (100 URLs, last updated 2025-11-25)
- `page-sitemap.xml` - Static pages (last updated 2025-04-06)
- `author-sitemap.xml` - Author pages (last updated 2024-10-31)

### Post Sitemap

**URL:** `https://www.ordio.com/post-sitemap.xml`

**Structure:**

- Contains all `/insights/` URLs
- Includes lastmod dates
- Includes featured images (image:image tags)
- Generated by Yoast SEO

## Content Management Constraints

### What Can Be Managed

**From This Codebase:**

- Blog theme files
- Blog header/footer includes
- Blog sidebar widgets
- Blog navigation structure
- Blog template files

**From WordPress CMS:**

- Blog post content
- Blog post titles and meta descriptions
- Blog post internal links
- Blog post schema markup
- Blog post images and media
- Categories and tags

### Migration Implications

**Will Need to Migrate:**

- All post content (HTML/text)
- All metadata (titles, descriptions, dates)
- All featured images
- All internal links
- Category structure
- URL structure (or redirects)

**Can Be Rebuilt:**

- SEO metadata (can regenerate)
- Schema markup (can recreate)
- Internal linking (can improve during migration)

## Technical Details

### WordPress Version

**Unknown:** Requires WordPress admin access or version detection

### Theme

**Unknown:** Requires theme detection or admin access

### Database Structure

**Standard WordPress Tables:**

- `wp_posts` - Post content and metadata
- `wp_postmeta` - Custom fields and metadata
- `wp_terms` - Categories and tags
- `wp_term_relationships` - Post-to-term relationships
- `wp_users` - Authors
- `wp_options` - Settings (including permalink structure)

## Migration Readiness Assessment

### Data Available for Migration

✅ **Available:**

- Post URLs (from sitemap)
- Post titles (scraped)
- Meta titles/descriptions (scraped)
- Publication dates (scraped)
- Featured images (scraped)
- Word counts (estimated)
- Categories (from URLs)

⚠️ **Partially Available:**

- Post content (needs full scraping)
- Internal links (needs extraction)
- Tags (needs extraction)
- Authors (needs extraction)

❌ **Not Available:**

- Database access
- WordPress admin access
- Custom fields
- Post revisions
- Media library metadata

### Migration Data Requirements

**Minimum Required:**

1. Post content (HTML/text)
2. Post metadata (title, date, author)
3. Categories and tags
4. Featured images
5. Internal links

**Nice to Have:**

1. Post revisions
2. Custom fields
3. Media library metadata
4. Author information
5. Comment data (if applicable)

## Related Documentation

- [Blog Categories](BLOG_CATEGORIES.md) - Category breakdown
- [Blog Inventory](BLOG_INVENTORY.md) - Complete post inventory
- [WordPress Features](WORDPRESS_FEATURES.md) - Features analysis
- [Migration Dependencies](MIGRATION_DEPENDENCIES.md) - Migration requirements
- [Migration Strategy](MIGRATION_STRATEGY.md) - Migration planning