Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Document addon configuration fields for Replicator/Bard sets

Aperta
#1,983 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
25/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
laravel, php
Ambito
documentation

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
PHP
Stelle
133
Fork
405
Merge medio
21h 45m
PR unite (30g)
12

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di statamic/docs

Tutte le issue di statamic/docs

Issue simili

Altre issue su PHP

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.