Foehn Installer

Composer plugin that generates the WordPress web root for Føhn projects.

Note This package is part of the Føhn Framework monorepo. Please report issues and submit pull requests in the main repository.

On composer install and composer update, this plugin automatically:

1. Creates the web/ directory structure (document root)
2. Generates web/wp-config.php (loads config from config/ directory)
3. Generates web/index.php (WordPress front controller)
4. Symlinks theme/ → web/wp-content/themes/{name}
5. Symlinks mu-plugins/ → web/wp-content/mu-plugins/_custom
6. Generates the mu-plugin loader

composer require studiometa/foehn-installer

Configure via extra.foehn in your project's composer.json:

{
  "extra": {
    "foehn": {
      "web-dir": "web",
      "wp-dir": "wp",
      "theme-dir": "theme",
      "theme-name": "my-theme",
      "mu-plugins-dir": "mu-plugins",
      "config-dir": "config"
    }
  }
}

All options are optional and have sensible defaults.

web/                            ← Document root (nginx/apache)
├── index.php                   ← Generated front controller
├── wp-config.php               ← Generated configuration
├── wp/                         ← WordPress core (via composer)
└── wp-content/
    ├── themes/
    │   └── my-theme → ../../theme/
    ├── plugins/                ← Composer-managed plugins
    ├── mu-plugins/
    │   ├── 00-loader.php       ← Generated loader
    │   └── _custom → ../../mu-plugins/
    └── uploads/

MIT