Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Document addon configuration fields for Replicator/Bard sets

未关闭
#1,983 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
25/100
Issue 类型
文档
描述清晰度
基本清楚
活跃度
冷清
技术栈
laravel, php
领域
documentation

调研方向

The API is proposed in statamic/cms#15422, a draft that is not merged, so the docs cannot be verified against shipped code yet. Read that PR for Statamic\Fieldtypes\Sets::appendSetConfigField() and appendSetConfigFields(), then cover the checklist in the issue body. Done means a docs page that separates set configuration from per-block fields and includes single, grouped and multiple-field examples, and wait for the API to be accepted before finalising.

由索引模型根据 Issue 内容生成。

描述

Companion tracking issue for the proposed API in statamic/cms#15422. The PR is a draft and has not been merged.

The change adds Statamic\Fieldtypes\Sets::appendSetConfigField($handle, $config) and appendSetConfigFields($fields) to register native configuration fields in the Edit Set stack for Replicator and Bard.

Documentation should distinguish reusable set configuration in a blueprint/fieldset from fields stored on individual content blocks. For example, an addon can register an editorial note or a native group of guidance fields. The values are saved alongside that set's native configuration.

Suggested coverage once the API is accepted:

  • Register fields during a service provider's boot phase, using keyed native field definitions.
  • Single-field and multiple-field examples, including a group for namespaced nested configuration.
  • Native preprocessing, metadata, validation, and processing apply. Validation is enforced when applying/saving the containing field.
  • Edit Set's Confirm button updates the containing field editor; save the field and blueprint/fieldset to persist changes.
  • Native set keys are reserved. Use addon-specific handles.
  • Existing custom metadata remains intact when its addon is not registered.

The extension is generic; no AI-specific settings are added to core.

主要语言
PHP
星标
133
派生
405
平均合并
21 小时 45 分钟
30 天内合并 PR
12

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

statamic/docs 的其他 Issue

查看 statamic/docs 的全部 Issue

相似的 Issue

更多 PHP Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。