# Download Pages Documentation

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

Complete documentation for all gated content download pages on the Ordio website.

## Overview

The download pages section includes six pages that provide gated content downloads (PDF guides, checklists) with HubSpot form integration for lead generation:
- **Download Index** - Overview page listing all available downloads
- **Lohnabrechnungen Download** - Payroll calendar month guide
- **Onboarding Checklist Download** - Hospitality onboarding checklist
- **Trinkgeld Download** - Tip management guide (cashless hospitality)
- **Zeiterfassung Download** - Time tracking guide
- **Download Success** - Success/thank you page after form submission

All gated download pages require email submission via HubSpot forms before providing download links.

---

## 1. Download Index

### Basic Information

- **Page Name:** Kostenlose Ratgeber & Vorlagen für Unternehmen - Ordio
- **Slug:** download
- **PHP File:** `v2/pages/download_index.php`
- **URL:** `https://www.ordio.com/download`
- **Status:** Published

### Page Structure

#### Hero Section

- **Headline:** "Kostenlose Ratgeber & Vorlagen für Unternehmen"
- **Description:** Overview of available downloads
- **Background:** Dotted pattern background

#### Download Listing Section

**Downloads Displayed:**
- Digitalisierungs-Ratgeber (In 8 Schritten Digital)
- SV-Prüfungs-Checklisten (Sozialversicherung)
- Lohnabrechnungen Kalendermonat Guide
- Zeiterfassung Guide
- Onboarding Checkliste Gastronomie
- Trinkgeld Bargeldlose Gastronomie Guide
- Webinar links

**Download Cards Include:**
- Download preview image
- Download name and description
- Download CTA button
- Content type badges
- Gated content indicator

### Content Strategy

**Purpose:** Download discovery and lead generation

**Key Messages:**
- Free resources
- Expert-developed content
- Industry-specific guides
- Practical checklists

### Technical Implementation

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

### SEO Focus

- **Primary Keywords:** kostenlose downloads, ratgeber, checklisten, webinare, digitalisierung
- **Meta Description:** "Kostenlose Downloads für Unternehmen: Digitalisierungs-Ratgeber, SV-Prüfungs-Checklisten & Live-Webinare. Von Branchenexperten entwickelt."
- **Schema:** WebPage, CollectionPage, BreadcrumbList

---

## 2. Lohnabrechnungen Download

### Basic Information

- **Page Name:** Lohnabrechnungen nach Kalendermonaten: Kostenloser Leitfaden - Ordio
- **Slug:** lohnabrechnungen-kalendermonat
- **PHP File:** `v2/pages/download_lohnabrechnungen.php`
- **URL:** `https://www.ordio.com/download/lohnabrechnungen-kalendermonat`
- **Status:** Published
- **Content Type:** Gated PDF guide

### Page Structure

#### Hero Section

- **Headline:** Guide title and value proposition
- **Description:** Overview of guide content
- **CTA:** "Jetzt kostenlos downloaden" (opens HubSpot form)

#### Content Preview Section

- **Guide Overview:** Key topics covered
- **Benefits:** What readers will learn
- **Visual Preview:** Guide cover/preview image

#### HubSpot Form Section

**Form Integration:**
- Email collection form
- Form submission handling
- Redirect to success page after submission
- Download link delivery

**Form Fields:**
- First name
- Last name
- Email (required)
- Phone (optional)
- Company (optional)

#### Content Sections

- **Why Calendar Months:** Legal requirements explanation
- **Risks:** Consequences of incorrect billing periods
- **Best Practices:** Implementation guidelines
- **FAQ Section:** Common questions

### Content Strategy

**Purpose:** Lead generation and educational content distribution

**Key Messages:**
- Legal compliance guide
- Risk mitigation
- Best practices
- Free expert resource

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
- **HubSpot Integration:**
  - Forms API v3 integration
  - `hubspotutk` cookie handling
  - Form submission via `/form-hs` endpoint
  - Redirect to success page
- **Schema Markup:**
  - `WebPage` schema
  - `DigitalDocument` schema (PDF guide)
  - `BreadcrumbList` schema
- **CSS/Styling:**
  - Collapsible sections (details/summary)
  - Form styling
  - Responsive layout
- **JavaScript:**
  - Alpine.js for form handling
  - Form submission handling
  - Success redirect logic

### SEO Focus

- **Primary Keywords:** lohnabrechnungen kalendermonat, lohnabrechnung gesetzeskonform, abrechnungszeitraum
- **Meta Description:** "Kostenloser Leitfaden: Warum Lohnabrechnungen nach Kalendermonaten erfolgen müssen und welche Risiken falsche Abrechnungszeiträume bergen."
- **Schema:** WebPage, DigitalDocument, BreadcrumbList

---

## 3. Onboarding Checklist Download

### Basic Information

- **Page Name:** Onboarding Checkliste Gastronomie - Kostenloser Download
- **Slug:** onboarding-checkliste-gastronomie
- **PHP File:** `v2/pages/download_onboarding_checklist.php`
- **URL:** `https://www.ordio.com/download/onboarding-checkliste-gastronomie`
- **Status:** Published
- **Content Type:** Gated PDF checklist

### Page Structure

#### Hero Section

- **Headline:** Checklist title and industry focus
- **Description:** Checklist overview and benefits
- **CTA:** "Jetzt kostenlos downloaden" (opens HubSpot form)

#### Checklist Preview Section

- **Checklist Overview:** Items included
- **Industry Focus:** Hospitality-specific content
- **Visual Preview:** Checklist preview image

#### HubSpot Form Section

**Form Integration:**
- Email collection form
- Form submission handling
- Redirect to success page
- Download link delivery

### Content Strategy

**Purpose:** Lead generation and industry-specific resource distribution

**Key Messages:**
- Hospitality-focused checklist
- Practical onboarding tool
- Free resource
- Industry expertise

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
- **HubSpot Integration:**
  - Forms API v3 integration
  - Form submission handling
  - Success redirect
- **Schema Markup:**
  - `WebPage` schema
  - `DigitalDocument` schema (PDF checklist)
  - `BreadcrumbList` schema
- **JavaScript:**
  - Alpine.js for form handling
  - Form submission logic

### SEO Focus

- **Primary Keywords:** onboarding checkliste gastronomie, mitarbeiter onboarding, onboarding vorlage
- **Meta Description:** Checklist-focused description
- **Schema:** WebPage, DigitalDocument, BreadcrumbList

---

## 4. Trinkgeld Download

### Basic Information

- **Page Name:** Trinkgeld Bargeldlose Gastronomie - Kostenloser Leitfaden
- **Slug:** trinkgeld-bargeldlose-gastronomie
- **PHP File:** `v2/pages/download_trinkgeld.php`
- **URL:** `https://www.ordio.com/download/trinkgeld-bargeldlose-gastronomie`
- **Status:** Published
- **Content Type:** Gated PDF guide

### Page Structure

#### Hero Section

- **Headline:** Guide title focusing on cashless tip management
- **Description:** Guide overview and benefits
- **CTA:** "Jetzt kostenlos downloaden" (opens HubSpot form)

#### Content Preview Section

- **Guide Overview:** Key topics covered
- **Industry Focus:** Cashless hospitality
- **Visual Preview:** Guide preview image

#### HubSpot Form Section

**Form Integration:**
- Email collection form
- Form submission handling
- Redirect to success page
- Download link delivery

### Content Strategy

**Purpose:** Lead generation and specialized industry guide distribution

**Key Messages:**
- Cashless tip management
- Hospitality industry focus
- Legal compliance
- Best practices

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
- **HubSpot Integration:**
  - Forms API v3 integration
  - Form submission handling
  - Success redirect
- **Schema Markup:**
  - `WebPage` schema
  - `DigitalDocument` schema (PDF guide)
  - `BreadcrumbList` schema
- **JavaScript:**
  - Alpine.js for form handling
  - Form submission logic

### SEO Focus

- **Primary Keywords:** trinkgeld bargeldlos, trinkgeldverwaltung gastronomie, cashless tips
- **Meta Description:** Guide-focused description
- **Schema:** WebPage, DigitalDocument, BreadcrumbList

---

## 5. Zeiterfassung Download

### Basic Information

- **Page Name:** Zeiterfassung Guide - Kostenloser Download
- **Slug:** zeiterfassung
- **PHP File:** `v2/pages/download_zeiterfassung.php`
- **URL:** `https://www.ordio.com/download/zeiterfassung`
- **Status:** Published
- **Content Type:** Gated PDF guide

### Page Structure

#### Hero Section

- **Headline:** Time tracking guide title
- **Description:** Guide overview and benefits
- **CTA:** "Jetzt kostenlos downloaden" (opens HubSpot form)

#### Content Preview Section

- **Guide Overview:** Key topics covered
- **Benefits:** What readers will learn
- **Visual Preview:** Guide preview image

#### HubSpot Form Section

**Form Integration:**
- Email collection form
- Form submission handling
- Redirect to success page
- Download link delivery

### Content Strategy

**Purpose:** Lead generation and time tracking guide distribution

**Key Messages:**
- Time tracking best practices
- Legal compliance
- Implementation guide
- Free expert resource

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php` (with `$aosScript = "true"`)
  - `../base/header.php`
  - `../base/footer.php`
- **HubSpot Integration:**
  - Forms API v3 integration
  - Form submission handling
  - Success redirect
- **Schema Markup:**
  - `WebPage` schema
  - `DigitalDocument` schema (PDF guide)
  - `BreadcrumbList` schema
- **JavaScript:**
  - Alpine.js for form handling
  - Form submission logic

### SEO Focus

- **Primary Keywords:** zeiterfassung guide, zeiterfassung ratgeber, arbeitszeitgesetz
- **Meta Description:** Guide-focused description
- **Schema:** WebPage, DigitalDocument, BreadcrumbList

---

## 6. Download Success

### Basic Information

- **Page Name:** Download Success - Thank You Page
- **Slug:** download-success
- **PHP File:** `v2/pages/download_success.php`
- **URL:** `https://www.ordio.com/download/success?content={content-piece}`
- **Status:** Published
- **Content Type:** Success/thank you page

### Page Structure

#### Success Message Section

- **Headline:** "Vielen Dank für dein Interesse!"
- **Description:** Confirmation message
- **Download Link:** Direct download link for requested content
- **Content Parameter:** `?content={content-piece}` identifies which download

#### Next Steps Section

- **Additional Resources:** Links to related content
- **CTA Buttons:** Links to product pages, demo booking
- **Social Sharing:** Optional sharing options

### Content Strategy

**Purpose:** Post-download engagement and conversion

**Key Messages:**
- Thank you message
- Download confirmation
- Additional resources
- Product introduction

### Technical Implementation

- **PHP Includes:**
  - `../base/head.php`
  - `../base/header.php`
  - `../base/footer.php`
- **URL Parameters:**
  - `content` - Identifies which download was requested
- **Schema Markup:**
  - `WebPage` schema
  - `BreadcrumbList` schema
- **JavaScript:**
  - Download tracking
  - Analytics events

### SEO Focus

- **Robots:** `noindex, follow` (internal page, not for SEO)
- **Purpose:** Post-download page, not search-optimized

---

## Common Patterns Across Download Pages

### HubSpot Form Integration

**Forms API v3 Pattern:**
```javascript
// Form submission via /form-hs endpoint
fetch('/form-hs', {
    method: 'POST',
    headers: {
        'X-Requested-With': 'XMLHttpRequest'
    },
    body: formData
})

// Include hubspotutk for Forms API v3 context
const hubspotutk = (window.utmTracker && typeof window.utmTracker.getHubspotutk === 'function')
    ? window.utmTracker.getHubspotutk() || ''
    : (document.cookie.match(/(?:^|.*;\s*)hubspotutk\s*=\s*([^;]*).*$/) || [])[1] || '';
formData.append('hubspotutk', hubspotutk);
```

**Form Fields:**
- First name
- Last name
- Email (required)
- Phone (optional)
- Company (optional)

**Success Flow:**
- Form submission → `/form-hs` endpoint
- Success response → Redirect to `/download/success?content={content-piece}`
- Success page → Download link delivery

### Gated Content Pattern

**Content Gating:**
- Email required before download
- HubSpot form integration
- Lead capture and tracking
- Download link delivery post-submission

**Download Delivery:**
- PDF file links
- Direct download after form submission
- Success page with download link
- Content parameter tracking

### Schema Markup Patterns

**Common Schemas:**
- `WebPage` - Page metadata
- `DigitalDocument` - PDF guide/checklist
- `BreadcrumbList` - Navigation
- `CollectionPage` - Index page

### Content Types

**Guides & Ratgeber:**
- Digitalisierungs-Ratgeber
- SV-Prüfungs-Checklisten
- Lohnabrechnungen Kalendermonat Guide
- Zeiterfassung Guide
- Trinkgeld Bargeldlose Gastronomie Guide

**Checklists:**
- Onboarding Checkliste Gastronomie

---

## Maintenance Requirements

- **Update Frequency:** As needed when guides/checklists are updated
- **Dependencies:**
  - HubSpot form IDs
  - PDF file locations
  - Form submission endpoint (`/form-hs`)
- **Validation Checklist:**
  - [ ] Verify all HubSpot forms work correctly
  - [ ] Test form submission flow
  - [ ] Verify download links work after submission
  - [ ] Check success page redirects
  - [ ] Validate PDF file links
  - [ ] Test content parameter handling
  - [ ] Verify schema markup
  - [ ] Check mobile responsiveness
  - [ ] Test UTM parameter tracking
  - [ ] Verify hubspotutk cookie handling

---

## Related Documentation

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