# Templates Pages Documentation

**Last Updated:** 2026-02-15

Complete documentation for all template pages on the Ordio website.

## Labor Law Values

Template pages display Mindestlohn, Minijob-Grenze, and Midijob-Bereich. These values change yearly (typically 01.01.). **Single source of truth:** `docs/content/LABOR_LAW_VALUES_2026.md`

When updating labor law values, update: templates_template.php, templates_index.php, `v2/systems/excel-template-generator/data/template-formulas/public-data.json`, and `v2/systems/excel-template-generator/data/template-faqs.json` (FAQ content for dienstplan/schichtplan).

## Overview

The templates pages section includes:

- **Templates Index** - Overview page listing all available templates
- **Dienstplan Template** - Excel template for Dienstplan (shift planning), served by `templates_template.php?template_id=dienstplan-excel-vorlage` (generator-driven)
- **Schichtplan Template** - Excel template for Schichtplan (shift schedule), served by `templates_template.php?template_id=schichtplan-excel-vorlage` (generator-driven)
- **Template Generator** - Dynamic template generator/editor page (`templates_template.php`)

Dienstplan and Schichtplan were migrated from dedicated PHP files to the generator-driven system in 2026-02. All template pages integrate with HubSpot forms for lead generation. Generator templates use pre-generated .xlsx from `v2/api/download-template.php`.

---

## 1. Templates Index

### Basic Information

- **Page Name:** Kostenlose Vorlagen für Arbeitsorganisation und Planung - Ordio
- **Slug:** vorlagen
- **PHP File:** `v2/pages/templates_index.php`
- **URL:** `https://www.ordio.com/vorlagen`
- **Status:** Published

### Page Structure

#### Hero Section

- **Headline:** "Kostenlose Vorlagen für Arbeitsorganisation und Planung"
- **Description:** Overview of available templates
- **Background:** Dotted pattern background

#### Template Listing Section

**Templates Displayed:**

- Dienstplan Excel Vorlage
- Schichtplan Excel Vorlage

**Template Cards Include:**

- Template preview image
- Template name and description
- Download CTA button
- Tags/categories
- Legal compliance badges

#### Features Section

- Template customization options
- Export formats (Excel, PDF, CSV)
- Legal compliance information
- Free download emphasis

### Content Strategy

**Purpose:** Template discovery and lead generation

**Key Messages:**

- Free templates
- Legal compliance (ArbZG)
- Easy customization
- Multiple export formats

### Technical Implementation

- **PHP Includes:**
  - `../data/templates_index_data.php` (template data)
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
- **Schema Markup:**
  - `WebPage` schema
  - `CollectionPage` schema
  - `ItemList` schema (template list)
  - `BreadcrumbList` schema
- **CSS/Styling:**
  - Dotted background pattern
  - Template card grid layout
  - Responsive design
- **JavaScript:** AOS enabled

### SEO Focus

- **Primary Keywords:** vorlagen, kostenlose templates, arbeitsorganisation, planung, personalverwaltung
- **Meta Description:** "Entdecke kostenlose Vorlagen für Arbeitsorganisation, Planung und Personalverwaltung. Professionelle Templates für dein Unternehmen - sofort verfügbar."
- **Schema:** WebPage, CollectionPage, ItemList, BreadcrumbList

---

## 2. Dienstplan Template

### Basic Information

- **Page Name:** Dienstplan Vorlage Excel: Kostenlos & rechtssicher - Ordio
- **Slug:** dienstplan-excel-vorlage
- **PHP File:** `v2/pages/templates_template.php` (template_id=dienstplan-excel-vorlage)
- **URL:** `https://www.ordio.com/vorlagen/dienstplan-excel-vorlage`
- **Status:** Published

### Page Structure

#### Hero Section

- **Badge:** "Vorlagen"
- **Headline:** "Dienstplan Vorlage Excel **kostenlos**"
- **Subheadline:** "rechtssicher & ArbZG-konform"
- **Description:** Template overview and benefits
- **CTAs:**
  - Primary: "Kostenlos downloaden" (opens HubSpot form)
  - Trust badges: "100% kostenlos", "Rechtssicher", "XLSX Format"

#### Template Customizer Section

**Customization Options:**

- Employee names input
- Date range selection
- Shift types configuration
- Working hours settings
- Legal compliance checks (ArbZG, Mindestlohn, Minijob-Grenzen)

**Visual Preview:**

- Excel template preview
- Interactive customization interface
- Real-time preview updates

#### Features Section

**Key Features:**

- ArbZG compliance (Arbeitszeitgesetz)
- Mindestlohn 12,82€ integration
- Minijob-Grenzen checks
- Automatic calculations
- Export formats: Excel (.xlsx), PDF, CSV

#### FAQ Section

- Accordion-style FAQ display
- Common questions about template usage
- Legal compliance questions
- Technical questions

#### How-To Section

- Step-by-step instructions
- HowTo schema markup
- Visual guides
- Best practices

### Content Strategy

**Purpose:** Lead generation and template distribution

**Key Messages:**

- Free and legal-compliant
- Easy to customize
- Multiple export formats
- ArbZG compliant

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
  - HubSpot form includes
- **CSS:**
  - `/v2/css/templates-pages.min.css` (dedicated stylesheet)
- **Schema Markup:**
  - `WebPage` schema
  - `DigitalDocument` schema (Excel template)
  - `HowTo` schema (usage instructions)
  - `BreadcrumbList` schema
- **JavaScript:**
  - Alpine.js for template customizer
  - Excel export functionality (SheetJS/xlsx)
  - PDF export functionality
  - CSV export functionality
  - HubSpot form integration
- **Performance Optimizations:**
  - DNS prefetch for CDN resources
  - Lazy loading for export libraries
  - Preconnect for fonts

### SEO Focus

- **Primary Keywords:** dienstplan vorlage excel, dienstplan excel vorlage, dienstplan vorlage kostenlos, arbeitszeitgesetz
- **Meta Description:** "Kostenlose Dienstplan Excel Vorlage. Rechtssicher nach ArbZG, Mindestlohn 13,90€, Minijob-Grenzen. Export als Excel - jetzt kostenlos downloaden!"
- **Schema:** WebPage, DigitalDocument, HowTo, BreadcrumbList

---

## 3. Schichtplan Template

### Basic Information

- **Page Name:** Schichtplan Excel Vorlage: Kostenlos & rechtssicher erstellen - Ordio
- **Slug:** schichtplan-excel-vorlage
- **PHP File:** `v2/pages/templates_template.php` (template_id=schichtplan-excel-vorlage)
- **URL:** `https://www.ordio.com/vorlagen/schichtplan-excel-vorlage`
- **Status:** Published

### Page Structure

#### Hero Section

- **Badge:** "Vorlagen"
- **Headline:** "Schichtplan Vorlage Excel **kostenlos**"
- **Subheadline:** "rechtssicher & ArbZG-konform"
- **Description:** Template overview and benefits
- **CTAs:**
  - Primary: "Kostenlos downloaden" (opens HubSpot form)
  - Trust badges: "100% kostenlos", "Rechtssicher", "XLSX Format"

#### Template Customizer Section

**Customization Options:**

- Employee names input
- Date range selection
- Shift models (3-Schicht, 24-Stunden, etc.)
- Working hours settings
- Legal compliance checks

**Visual Preview:**

- Excel template preview
- Interactive customization interface
- Real-time preview updates

#### Features Section

**Key Features:**

- ArbZG compliance
- Multiple shift models
- Mindestlohn integration
- Minijob-Grenzen checks
- Export formats: Excel (.xlsx), PDF, CSV

#### FAQ Section

- Accordion-style FAQ display
- Shift planning questions
- Legal compliance questions
- Technical questions

#### How-To Section

- Step-by-step instructions
- HowTo schema markup
- Visual guides
- Best practices for shift planning

### Content Strategy

**Purpose:** Lead generation and template distribution

**Key Messages:**

- Free and legal-compliant
- Multiple shift models
- Easy customization
- Multiple export formats

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
  - HubSpot form includes
- **CSS:**
  - `/v2/css/templates-pages.min.css` (dedicated stylesheet)
- **Schema Markup:**
  - `WebPage` schema
  - `DigitalDocument` schema (Excel template with multiple formats)
  - `HowTo` schema (usage instructions)
  - `BreadcrumbList` schema
- **JavaScript:**
  - Alpine.js for template customizer
  - Excel export functionality
  - PDF export functionality
  - CSV export functionality
  - HubSpot form integration
- **Performance Optimizations:**
  - DNS prefetch for CDN resources
  - Lazy loading for export libraries

### SEO Focus

- **Primary Keywords:** schichtplan vorlage excel, schichtplan excel vorlage, schichtplan vorlage kostenlos, 3 schichtplan, 24 stunden schichtplan
- **Meta Description:** "Kostenlose Schichtplan Excel Vorlage. Rechtssicher nach ArbZG, Mindestlohn 12,82€, Minijob-Grenzen. Export als Excel/PDF/CSV - jetzt downloaden!"
- **Schema:** WebPage, DigitalDocument, HowTo, BreadcrumbList

---

## 4. Template Generator

### Basic Information

- **Page Name:** Template Generator (Dynamic)
- **Slug:** template-generator
- **PHP File:** `v2/pages/templates_template.php`
- **URL:** Dynamic (supports `?template_id=` parameter)
- **Status:** Published

### Page Structure

#### Dynamic Template Loading

**Template ID System:**

- Supports query parameter: `?template_id={template-slug}`
- Default fallback: `dienstplan-excel-vorlage`
- Template registry validation
- Error handling and fallback

#### Configuration System

**Config Files:**

- `v2/config/template-page-config.php` - Template configuration
- `v2/config/template-meta-generator.php` - Meta tag generation
- `v2/config/template-schema-generator.php` - Schema generation
- `v2/config/template-cta-config.php` - CTA configuration

**Template Metadata:**

- Template ID validation
- Template config loading
- Excel visual data loading
- FAQ loading
- Alpine.js component name generation

#### Hero Configuration

**Dynamic Hero Setup:**

- Badge: "Vorlagen"
- Title: From template config
- Title highlight: "kostenlos"
- Subtitle: "rechtssicher & ArbZG-konform"
- Description: From template config
- CTA: "Kostenlos downloaden"
- Trust badges: Dynamic badges

#### Template Customizer

**Alpine.js Component:**

- Dynamically generated component name
- Template form state management
- HubSpot form integration
- Export functionality
- Error handling

### Content Strategy

**Purpose:** Flexible template generation system

**Key Features:**

- Dynamic template loading
- Configurable templates
- Reusable template system
- Centralized configuration

### Technical Implementation

- **PHP Includes:**
  - `../config/template-page-config.php`
  - `../config/template-meta-generator.php`
  - `../config/template-schema-generator.php`
  - `../config/template-cta-config.php`
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
- **CSS:**
  - `/v2/css/templates-pages.min.css`
- **Schema Markup:**
  - Dynamically generated via `template-schema-generator.php`
  - WebPage schema
  - DigitalDocument schema
  - HowTo schema
- **JavaScript:**
  - Alpine.js component registration
  - Dynamic component name generation
  - Template form handling
  - Export functionality
  - HubSpot integration

### SEO Focus

- **Dynamic Meta Tags:** Generated via `template-meta-generator.php`
- **Schema:** Dynamically generated per template
- **Purpose:** Flexible SEO optimization per template type

---

## Common Patterns Across Template Pages

### HubSpot Integration

**Form Integration:**

- Lead capture forms
- Email collection
- Template download gating
- Form submission handling

**Form Fields:**

- First name
- Last name
- Email
- Phone (optional)

### Export Functionality

**Supported Formats:**

- Excel (.xlsx) - Primary format
- PDF - Secondary format
- CSV - Alternative format

**Export Libraries:**

- SheetJS/xlsx (Excel generation)
- jsPDF (PDF generation)
- Custom CSV generation

### Legal Compliance

**Compliance Features:**

- ArbZG (Arbeitszeitgesetz) compliance
- Mindestlohn 12,82€ integration
- Minijob-Grenzen checks
- Automatic legal validation

### Template Customization

**Customization Options:**

- Employee names
- Date ranges
- Shift types/models
- Working hours
- Legal parameters

**Visual Preview:**

- Real-time preview
- Excel-like interface
- Interactive editing
- Validation feedback

### Schema Markup Patterns

**Common Schemas:**

- `WebPage` - Page metadata
- `DigitalDocument` - Template file
- `HowTo` - Usage instructions
- `BreadcrumbList` - Navigation
- `CollectionPage` - Index page

### Performance Optimizations

**Optimization Strategies:**

- DNS prefetch for CDN resources
- Lazy loading for export libraries
- Minified CSS (`templates-pages.min.css`)
- Conditional script loading
- Image optimization

---

## Maintenance Requirements

- **Update Frequency:** As needed when templates change or legal requirements update
- **Dependencies:**
  - Template configuration files (`v2/config/template-*.php`)
  - Template data files (`v2/data/templates_index_data.php`)
  - HubSpot form IDs
  - Export libraries (CDN)
- **Validation Checklist:**
  - [ ] Verify all template download links work
  - [ ] Test HubSpot form integration
  - [ ] Validate Excel/PDF/CSV exports
  - [ ] Check legal compliance information (ArbZG, Mindestlohn)
  - [ ] Verify schema markup with Google Rich Results Test
  - [ ] Test template customizer functionality
  - [ ] Verify mobile responsiveness
  - [ ] Check export library CDN links
  - [ ] Validate Alpine.js component registration
  - [ ] Test template generator dynamic loading

---

## Related Documentation

- **[Templates Pages Inventory](TEMPLATES_PAGES_INVENTORY.md)** - Complete list of all template pages
- **[Cursor Rules](../../../../.cursor/rules/templates-pages.mdc)** - Cursor AI rules for templates pages
- **[Download Pages](../download-pages/)** - Related download pages
- **[Tools Pages](../../../guides/tools-pages/)** - Related tools pages