ecomyseo/prestashop_skills / prestashop-symfony-form
prestashop-symfony-form
VerifiedSkill for creating custom Symfony forms and configuration pages in PrestaShop 8 and 9.
PrestaShop Symfony Form Skill
This skill explains how to build modern back-office forms using Symfony Form component, integrated with PrestaShop's Configuration and Data Provider system.
1. Technical Guide
The Triple-Pattern for Forms
Modern PrestaShop forms often use three classes:
- Type: The form structure (fields).
- DataProvider: Handles loading and saving data for the form.
- DataConfiguration: Specifically for forms that save to the
ps_configurationtable.
Form Type (src/Form/MyCustomType.php)
final class MyCustomType extends TranslatorAwareType
{
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
->add('my_setting', TextType::class, [
'label' => $this->trans('Setting Name', 'Modules.Mymodule.Admin'),
]);
}
}
Data Configuration (src/Form/MyDataConfiguration.php)
This class defines how fields map to Configuration keys.
final class MyDataConfiguration implements DataConfigurationInterface
{
private $configuration;
public function getConfiguration()
{
return [
'my_setting' => $this->configuration->get('MY_MODULE_SETTING'),
];
}
public function updateConfiguration(array $config)
{
$this->configuration->set('MY_MODULE_SETTING', $config['my_setting']);
return []; // errors
}
}
Rendering the Form in a Controller
public function indexAction(Request $request)
{
$formHandler = $this->get('my_module.form.handler');
$form = $formHandler->getForm();
$form->handleRequest($request);
if ($form->isSubmitted() && $form->isValid()) {
$errors = $formHandler->save($form->getData());
if (empty($errors)) {
$this->addFlash('success', $this->trans('Successful update.', 'Admin.Notifications.Success'));
}
}
return $this->render('@Modules/my_module/views/templates/admin/form.html.twig', [
'form' => $form->createView(),
]);
}
2. Professional Development Guide
Services definition (config/services.yml)
services:
my_module.form.type:
class: MyModule\Form\MyCustomType
parent: 'form.type.translatable.aware'
tags:
- { name: form.type }
my_module.form.data_configuration:
class: MyModule\Form\MyDataConfiguration
arguments: ['@prestashop.adapter.legacy.configuration']
my_module.form.data_provider:
class: PrestaShop\PrestaShop\Core\Form\ConfigurableFormDataProvider
arguments:
- '@my_module.form.data_configuration'
- '@prestashop.core.localization.locale.context'
my_module.form.handler:
class: PrestaShop\PrestaShop\Core\Form\FormHandler
arguments:
- '@form.factory'
- '@prestashop.core.hook.dispatcher'
- '@my_module.form.data_provider'
- 'MyModule\Form\MyCustomType'
- 'MyModuleForm' # Hook name suffix
3. User Guide
Advantages
- Automatic validation.
- Consistent UI with PrestaShop core.
- Easy integration with Symfony debug tools.
Rules & Best Practices
- Reuse Core Types: Use
PrestaShopBundle\Form\Admin\Type\*types for standard PrestaShop inputs (switches, translatable inputs, etc.). - Translations: Use
TranslatorAwareTypeto simplify translations inside the Form Type. - CSRF: PrestaShop/Symfony handles CSRF protection automatically if using the FormHandler.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |