Skip to content

ecomyseo/prestashop_skills / prestashop-order-hooks

prestashop-order-hooks

Verified

Skill for extending the Admin Order View page (V2) in PrestaShop 8 and 9 using modern hooks.

FileKindSize
SKILL.mdskill md2.7 KB
---
name: prestashop-order-hooks
description: Skill for extending the Admin Order View page (V2) in PrestaShop 8 and 9 using modern hooks.
---

# PrestaShop Order Hooks Skill

This skill explains how to modify and extend the Order View page in the PrestaShop Back Office (modern Symfony implementation).

## 1. Technical Guide

### Adding Buttons to the Toolbar
Use `hookActionGetAdminOrderButtons`.

```php
public function hookActionGetAdminOrderButtons(array $params)
{
    /** @var \PrestaShop\PrestaShop\Core\Action\ActionsBarButtonsCollection $bar */
    $bar = $params['actions_bar_buttons_collection'];

    $bar->add(
        new \PrestaShop\PrestaShop\Core\Action\ActionsBarButton(
            'btn-secondary', 
            ['href' => 'https://example.com'], 
            $this->trans('Custom Action', [], 'Modules.Mymodule.Admin')
        )
    );
}
```

### Displaying Content in Different Sections
- `displayAdminOrderMain`: Large central column.
- `displayAdminOrderSide`: Right sidebar top.
- `displayAdminOrderSideBottom`: Right sidebar bottom.
- `displayAdminOrderTop`: Top of the page (below toolbar).

### Adding New Tabs to the Order Page
- `displayAdminOrderTabLink`: The tab title/link.
- `displayAdminOrderTabContent`: The actual content of the tab.

```php
public function hookDisplayAdminOrderTabLink(array $params)
{
    return $this->context->smarty->fetch($this->local_path.'views/templates/admin/tab_link.tpl');
}

public function hookDisplayAdminOrderTabContent(array $params)
{
    $orderId = (int)$params['id_order'];
    // ... logic
    return $this->fetch('module:mymodule/views/templates/admin/tab_content.tpl');
}
```

## 2. Professional Development Guide

### Using Twig in Hooks
PrestaShop 8/9 prefers Twig for back-office rendering. Access the `twig` service:

```php
public function hookDisplayAdminOrderMain(array $params)
{
    $twig = $this->get('twig');
    return $twig->render('@Modules/mymodule/views/templates/admin/main.html.twig', [
        'orderId' => $params['id_order'],
    ]);
}
```

### Architecture
- **Presenters**: Use dedicated classes to prepare data for the view to keep the module class clean.
- **Repositories**: Use the `doctrine.orm.entity_manager` or a custom repository service to fetch order-related data.

## 3. User Guide

### How to use
The content added via these hooks will automatically integrate with the modern PrestaShop Order interface. Support for dark mode and responsive layouts is handled by the core UI kit.

## Rules & Best Practices
- **Security**: Always cast `id_order` to `(int)`.
- **Namespace**: Use proper namespaces for Presenters and Repositories in `src/`.
- **Translations**: Use the `Modules.[ModuleName].Admin` domain for all back-office translations.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 323kUpdated Claude CodeCodexVerifiedInstall