包简介

Starter theme for Foehn — a modern WordPress framework powered by Tempest.

README 文档

README

A complete WordPress starter theme demonstrating all Føhn features.

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

Quick Start with DDEV

composer create-project studiometa/foehn-starter my-project
cd my-project
ddev start

That's it. DDEV will:

Start PHP 8.5 + MariaDB + nginx
Copy .env.example to .env (with DDEV defaults)
Run composer install (generates web/, symlinks, wp-config.php)
Install WordPress with admin/admin credentials
Activate the starter theme

Open the site: ddev launch Admin panel: ddev launch /wp/wp-admin (admin / admin)

Quick Start without DDEV

composer create-project studiometa/foehn-starter my-project
cd my-project
cp .env.example .env
# Edit .env with your database credentials
composer install

Then point your web server's document root to the web/ directory.

Project Structure

my-project/
├── theme/                      # WordPress theme (versioned)
│   ├── app/
│   │   ├── Blocks/             # ACF blocks
│   │   ├── ContextProviders/   # Context providers
│   │   ├── Controllers/        # Template controllers
│   │   ├── Data/               # DTOs for block context
│   │   ├── Hooks/              # WordPress hooks (actions & filters)
│   │   ├── ImageSizes/         # Custom image sizes
│   │   ├── Menus/              # Navigation menus
│   │   ├── Models/             # Custom post types (Timber models)
│   │   ├── Taxonomies/         # Custom taxonomies
│   │   └── foehn.config.php    # Framework configuration
│   ├── assets/
│   │   ├── js/                 # JavaScript (js-toolkit)
│   │   │   ├── app.js          # Entry point
│   │   │   └── components/     # Custom components
│   │   └── css/                # CSS (Tailwind v4)
│   │       ├── app.css         # Entry point
│   │       ├── base/           # Base styles
│   │       └── components/     # Component styles
│   ├── templates/              # Twig templates
│   │   ├── layouts/            # Base layouts
│   │   ├── pages/              # Page templates
│   │   └── components/         # Reusable components
│   ├── functions.php           # Single boot line
│   └── style.css               # Theme header
│
├── .ddev/                      # DDEV configuration
├── vite.config.js              # Vite build config
├── web/                        # Generated document root (gitignored)
├── .env                        # Environment variables (not needed with DDEV)
├── composer.json               # PHP dependencies
└── package.json                # JS dependencies

What's included

Custom Post Types

Product — with price, sale price, and product categories
Testimonial — with author info and ratings

Custom Taxonomies

ProductCategory — hierarchical, with custom rewrite
ProductTag — flat taxonomy for products

Template Controllers

SingleController — handles all single post/page views
ArchiveController — handles archives, categories, tags
SearchController — search results page
Error404Controller — 404 error page

Hooks

ThemeHooks — theme setup, image sizes, menus

Context Providers

GlobalContextProvider — site info, menus, available on all templates

Built-in Foehn Hooks (via foehn.config.php)

CleanHeadTags — removes unnecessary <head> tags
DisableEmoji — removes emoji scripts/styles
DisableOembed — removes oEmbed discovery
DisableVersionDisclosure — hides WordPress version
DisableXmlRpc — disables XML-RPC + pingback
GenericLoginErrors — hides username enumeration on login
YouTubeNoCookieHooks — converts YouTube embeds to no-cookie variant

Development

Front-end

npm install             # Install JS dependencies
npm run dev             # Start Vite dev server (HMR)
npm run build           # Build for production
npm run lint            # Lint JS, CSS and Twig
npm run fix             # Auto-fix linting issues

DDEV Commands

ddev start              # Start the environment
ddev stop               # Stop the environment
ddev launch             # Open the site in browser
ddev ssh                # SSH into the container
ddev composer install   # Run composer inside the container
ddev wp <command>       # Run WP-CLI commands
ddev describe           # Show URLs and connection info

Without DDEV

# Requirements: PHP 8.5+, Composer 2.x, MySQL/MariaDB

# Development server (via wp-cli)
wp server --docroot=web

# Or configure nginx/apache to point to web/

License

MIT

studiometa/foehn-starter 适用场景与选型建议

studiometa/foehn-starter 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 2 次下载、GitHub Stars 达 1，最近一次更新时间为 2026 年 02 月 10 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「theme」「wordpress」「starter」「tempest」「foehn」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 studiometa/foehn-starter 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 studiometa/foehn-starter 我们能提供哪些服务？

定制开发 / 二次开发

基于 studiometa/foehn-starter 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 studiometa/foehn-starter 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

raugadh/fila-starter 62

Laravel Filament Starter.

bimthebam/silverstripe-theme-bs4base 0

A Bootstrap 4.x base theme for SilverStripe

pmvc-theme/lucency_html 0

Lucency Theme

const-se/selectize-bootstrap4-theme 41

Selectize Theme for Bootstrap 4

jupitern/slim3-skeleton 44

Slim starter / Slim skeleton package to boost your development with Slim framework

3ejoueur/overdog 3

A Craft CMS scaffolding project

studiometa/foehn-starter

包简介

关键字：