PHP项目Bolt CMS与内容类型

wen PHP项目 2026-07-24 144

Bolt CMS 内容类型详解

Bolt CMS 是一个灵活的 PHP 内容管理系统，其核心优势在于可自定义的内容类型系统，以下是对 Bolt CMS 内容类型的深入解析：

PHP项目Bolt CMS与内容类型

基本概念

在 Bolt CMS 中，内容类型（Content Types）定义了站点上不同内容的结构和字段，默认包含：

Pages - 标准页面
Entries - 博客/文章
Blocks - 块内容（可重复使用的组件）
Users - 用户管理

类型配置

在 Bolt CMS 5.x 中，内容类型通过 YAML 配置文件定义（位于 config/packages/bolt/content_types.yaml）：

# config/packages/bolt/content_types.yaml
products:
    name: Products
    singular_name: Product
    slugs:
        - products
        - product
    fields:
        title:
            type: text
            label: Product Name
        description:
            type: textarea
            label: Description
        price:
            type: number
            label: Price
        category:
            type: select
            label: Category
            values:
                - Electronics
                - Clothing
                - Books
        images:
            type: image
            label: Product Images
            multiple: true
    taxonomy:
        - tags
        - categories
    default_status: published
    allow_duplicates: false

支持的主要字段类型

字段类型	用途	示例
`text`	单行文本	标题、名称
`textarea`	多行文本	描述、简介
`html`	富文本编辑器
`image`	图片上传	缩略图、特色图片
`number`	数字	价格、数量
`date`	日期选择	发布日期
`datetime`	日期时间	活动时间
`select`	下拉选择	分类、状态
`checkbox`	复选框	功能开关
`radio`	单选按钮	性别、选项
`relationship`	关联其他内容	相关文章
`geolocation`	地理位置	地址坐标
`video`	视频	YouTube/Vimeo嵌入
`file`	文件上传	PDF、文档

类型示例

1 新闻/博客文章

articles:
    name: Articles
    singular_name: Article
    fields:
        title:
            type: text
        slug:
            type: slug
            uses: title
        content:
            type: html
        author:
            type: relationship
            contenttype: users
        publish_date:
            type: datetime
        featured_image:
            type: image
        tags:
            type: taxonomylist
    taxonomy:
        - tags
        - categories

2 事件日历

events:
    name: Events
    singular_name: Event
    fields:
        title:
            type: text
        start_date:
            type: datetime
        end_date:
            type: datetime
        venue:
            type: text
        description:
            type: textarea
        map:
            type: geolocation
        capacity:
            type: number
            label: Max Capacity

内容类型关系

Bolt 支持内容类型之间的关联：

fields:
    related_posts:
        type: relationship
        contenttype: articles
        multiple: true
        label: Related Articles
    main_category:
        type: select
        relationship: true
        contenttype: categories

内容类型扩展

1 模板绑定

products:
    # ...
    record_template: 'product.twig'
    listing_template: 'products.twig'
    record_route: '/product/{slug}'
    listing_route: '/products'

2 权限控制

articles:
    roles:
        create: ['admin', 'editor']
        edit: ['admin', 'editor']
        publish: ['admin']
        delete: ['admin']

前端使用方法

在 Twig 模板中访问内容类型：

{# 获取所有产品 #}
{% set products = record.related('products') %}
{# 遍历产品 #}
{% for product in products %}
    <div class="product">
        <h2>{{ product.title }}</h2>
        <p>{{ product.description|excerpt(200) }}</p>
        <p>Price: ${{ product.price }}</p>
        {% if product.image %}
            <img src="{{ product.image|thumbnail(300, 200) }}" alt="{{ product.title }}">
        {% endif %}
    </div>
{% endfor %}

高级特性

1 条件字段

fields:
    content_type:
        type: select
        values:
            standard: Standard Article
            gallery: Gallery Post
            video: Video Post
    # 仅当选择 "gallery" 时显示的字段
    gallery_images:
        type: image
        multiple: true
        condition: 'content_type == "gallery"'

2 自定义验证

fields:
    email:
        type: text
        validate:
            - email
    price:
        type: number
        validate:
            - min: 0
            - max: 10000