jeffsenso/prestashop-skills / skills/prestashop-module-development/ps9-core-ai/Component/Twig/skills/create-twig-form-template
create-twig-form-template
VerifiedCreate the Twig template for the add/edit form page. Renders the Symfony form, save buttons, and optional form theme overrides for custom field rendering. Trigger: "create form template for {Domain}".
create-twig-form-template
Read @.ai/Component/Twig/CONTEXT.md for template conventions (layout, flash messages, routes, form themes).
1. Form template
Create src/PrestaShopBundle/Resources/views/Admin/{Section}/{Domain}/form.html.twig:
{% extends '@PrestaShop/Admin/layout.html.twig' %}
{% block content %}
{{ form_start(form) }}
{{ form_widget(form) }}
<button type="submit" class="btn btn-primary">
{{ 'Save'|trans({}, 'Admin.Actions') }}
</button>
{{ form_end(form) }}
{% endblock %}
- Always use a single
form_widget(form)— see Twig/CONTEXT.md for why (module hook compatibility) - The same template typically serves both create and edit — the controller passes different form data
- For file uploads, add
enctype="multipart/form-data"(see CONTEXT.md)
Reference: src/PrestaShopBundle/Resources/views/Admin/Improve/International/Tax/ (simple), src/PrestaShopBundle/Resources/views/Admin/Sell/Catalog/Manufacturer/ (with image)
2. Form theme overrides (only if needed)
When specific fields need custom rendering beyond Symfony defaults:
- Preferred: set the
form_themeoption directly on the form (PrestaShop custom option) — usually in the controller when building the form, or in the form type'sconfigureOptions(). Symfony picks up the theme automatically; no{% form_theme %}directive needed in the Twig file. - Fallback: use the Twig directive when the override is template-specific:
{% form_theme form 'Admin/{Section}/{Domain}/{domain}_theme.html.twig' %} - Override the field block:
{% block _{field_id}_widget %}...{% endblock %} - Common case: image preview next to upload field with a "Remove" checkbox
Form themes are scoped to this form only — no global side effects.
3. JS asset inclusion
If the form needs JavaScript (for initComponents or Vue):
{% block javascripts %}
{{ parent() }}
<script src="{{ asset('themes/new-theme/public/{domain}.bundle.js') }}"></script>
{% endblock %}
The asset path must match the webpack entry name.
Rules
Conventions (layout, path(), single form_widget(form), NavigationTabType auto-rendering, file upload enctype, form theme block naming, JS asset inclusion) are in Twig/CONTEXT.md. Skill-specific reminders:
- Form theme overrides should be minimal — Symfony's default rendering handles most cases
- CSRF token is included automatically by
form_end(form)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |