Skip to content

jeffsenso/prestashop-skills / skills/prestashop-module-development/ps9-core-ai/Component/Forms/skills/create-form-type

create-form-type

Verified

Create the Symfony form type for an entity's add/edit form. Covers standard field types, translatable fields, money fields, file uploads, and choice providers. For multi-tab layout with NavigationTabType, see create-form-tab-layout. Trigger: "create form type for {Domain}".

create-form-type

Read @.ai/Component/Forms/CONTEXT.md for form conventions (base classes, data flow, service registration).

1. Root form type

Create src/PrestaShopBundle/Form/Admin/{Section}/{Domain}/{Domain}Type.php:

  • Extend TranslatorAwareType (provides $this->trans()) or AbstractType for simple forms
  • buildForm(): add all fields for the entity
  • configureOptions(): set defaults as needed
  • Form types define structure and validation only — no knowledge of commands/queries

Reference: src/PrestaShopBundle/Form/Admin/Improve/International/Tax/TaxType.php (simple), src/PrestaShopBundle/Form/Admin/Sell/Catalog/Manufacturer/ManufacturerType.php (with image)

2. Standard field types

PS field conceptSymfony/PS typeNotes
TextTextTypeStandard input
Boolean toggleSwitchType (PS-specific)On/off switch
Select with static optionsChoiceTypeInline choices array
Select with dynamic optionsChoiceType + ChoiceProviderSee section 5
Textarea / HTMLTextareaType or FormattedTextareaType

3. Translatable fields

For multilingual fields (entity has _lang table):

->add('name', TranslatableType::class, [
    'type' => TextType::class,
    'options' => ['constraints' => [new NotBlank()]],
])
  • TranslatableType renders one input per active shop language
  • Submitted data: ['name' => [1 => 'English', 2 => 'French']]
  • Map to command's setLocalizedNames() setter in the DataHandler

For translatable textareas: wrap TextareaType or FormattedTextareaType.

4. Money / price fields

For monetary fields (see Forms/CONTEXT.md for decimal scale convention):

  • Static currency: MoneyType::class with 'currency' => $defaultCurrencyIsoCode
  • Multi-currency: PS-specific AmountType if available
  • Use appropriate transformers to convert between form display and storage

5. Choice providers

For select fields with dynamic options from DB:

  • Create {Domain}{Field}ChoiceProvider.php implementing ChoiceProviderInterface
  • Inject repository or DBAL connection
  • getChoices(): array — return ['Label' => value] array
  • Inject into the form type and pass as choices option

Reference: src/Core/Form/ChoiceProvider/ (61+ existing providers)

6. File upload fields

For image/logo uploads (see Forms/CONTEXT.md for file upload conventions):

  • Add FileType::class with 'mapped' => false, 'required' => false
  • Add File constraint with allowed MIME types
  • Display existing image in the edit template via custom Twig block

Rules

Conventions (base classes, file uploads, choice providers, NavigationTabType) are in Forms/CONTEXT.md. Skill-specific reminders:

  • Add Symfony validation constraints directly on form fields (NotBlank, Length, Regex)
  • For multi-tab layout, use the create-form-tab-layout skill instead
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall