Create Twig Form Template

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) }}
    
      {{ 'Save'|trans({}, 'Admin.Actions') }}
    
  {{ form_end(form) }}
{% endblock %}

• Always use a single form_widget(form) — see [Twig/CONTEXT.md](../../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_theme option directly on the form (PrestaShop custom option) — usually in the controller when building the form, or in the form type's configureOptions(). 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() }}
  
{% 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](../../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)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jeffsenso
• Source: jeffsenso/prestashop-skills
• License: MIT

Install and usage instructions live in the source repository linked above.