Getting Started

Foehn is a modern WordPress framework powered by Tempest Framework. It brings attribute-based auto-discovery to WordPress development, eliminating boilerplate code for hooks, post types, blocks, and more.

Why Foehn?

Traditional WordPress development requires manually registering every hook, post type, and block. It also lacks modern OOP practices like dependency injection and autowiring. Foehn changes this with PHP 8 attributes and a powerful DI container:

Before (Traditional WordPress):

// functions.php - scattered registrations
add_action('init', function () {
    register_post_type('product', [
        'public' => true,
        'label' => 'Products',
        'has_archive' => true,
        // ... 20 more lines
    ]);
});

add_action('after_setup_theme', function () {
    add_theme_support('post-thumbnails');
});

add_filter('excerpt_length', fn () => 30);

After (Foehn):

// app/Models/Product.php
#[AsPostType(name: 'product', singular: 'Product', plural: 'Products', hasArchive: true)]
final class Product extends Post {}

// app/Hooks/ThemeHooks.php
final class ThemeHooks
{
    // Dependencies are autowired
    public function __construct(
        private readonly MyService $service,
    ) {}

    #[AsAction('after_setup_theme')]
    public function setupTheme(): void
    {
        add_theme_support('post-thumbnails');
    }

    #[AsFilter('excerpt_length')]
    public function excerptLength(): int
    {
        return 30;
    }
}

Features

• Hooks — #[AsAction] and #[AsFilter] for WordPress hooks
• Post Types — #[AsPostType] with Timber integration
• Taxonomies — #[AsTaxonomy] with hierarchical support
• Views — #[AsViewComposer] and #[AsTemplateController]
• ACF Blocks — #[AsAcfBlock] with FieldsBuilder
• Native Blocks — #[AsBlock] with Interactivity API support
• Block Patterns — #[AsBlockPattern] with Twig templates
• REST API — #[AsRestRoute] for custom endpoints
• Shortcodes — #[AsShortcode] for shortcode handlers
• CLI — #[AsCliCommand] for WP-CLI commands

Requirements

• PHP 8.4+
• WordPress 6.4+
• Composer

Next Steps

1. Install Foehn
2. Learn about Hooks
3. Create Post Types
4. Build ACF Blocks