Getting Started

Føhn 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 Føhn?

Traditional WordPress development requires manually registering every hook, post type, and block. It also lacks modern OOP practices like dependency injection and autowiring. Føhn 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 (Føhn):

// 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 and fluent queries
• Taxonomies — #[AsTaxonomy] with hierarchical support
• Views — #[AsContextProvider] and #[AsTemplateController]
• ACF Blocks — #[AsAcfBlock] with FieldsBuilder and Arrayable DTOs
• Native Blocks — #[AsBlock] with Interactivity API support
• Block Patterns — #[AsBlockPattern] with Twig templates
• REST API — #[AsRestRoute] for custom endpoints
• Shortcodes — #[AsShortcode] for shortcode handlers
• Caching — Injectable CacheInterface with tagged cache support
• CLI — #[AsCliCommand] for WP-CLI commands

Requirements

• PHP 8.5+
• WordPress 6.4+
• Composer

Next Steps

1. New project? Start with the Starter Theme — get a full working setup in minutes
2. Existing theme? Follow the Manual Installation guide
3. Learn about Hooks, Post Types, and Query Posts
4. Build ACF Blocks with Arrayable DTOs