From ee23e0af1dd40872b18c0ac01402fe5d34d0aede Mon Sep 17 00:00:00 2001
From: thomas nares <thomas-nares.ext@prestashop.com>
Date: Tue, 31 Oct 2023 16:00:13 +0100
Subject: [PATCH 1/6] Create page about Hummingbird hook locations

---
 .../concepts/hooks/hooks-hummingbird-theme.md | 130 ++++++++++++++++++
 1 file changed, 130 insertions(+)
 create mode 100644 modules/concepts/hooks/hooks-hummingbird-theme.md

diff --git a/modules/concepts/hooks/hooks-hummingbird-theme.md b/modules/concepts/hooks/hooks-hummingbird-theme.md
new file mode 100644
index 0000000000..3742636a8e
--- /dev/null
+++ b/modules/concepts/hooks/hooks-hummingbird-theme.md
@@ -0,0 +1,130 @@
+---
+title: Hooks on Hummingbird Theme
+weight: 3
+---
+
+# Hooks on Hummingbird Theme
+
+Hummingbird theme introduced a brand new UI for the PrestaShop front office. 
+
+A visual map of hook locations was created by the Design team at PrestaShop. 
+
+{{% notice note %}}
+This page integrates Figma iframes, it may require heavy resources and cause performance issues on slower machines.
+{{% /notice %}}
+
+{{< toc >}}
+
+
+## Home page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15442%26mode%3Ddesign%26t%3DIcCnIO2KXW3WErLh-1" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayAfterTitleTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterTitleTag">}}) |
+| `displayAfterBodyOpeningTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterBodyOpeningTag">}}) |
+| `displayBanner` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBanner">}}) |
+| `displayNav1` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav1">}}) |
+| `displayNav2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav2">}}) |
+| `displayTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayTop">}}) |
+| `displayNavFullWidth` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNavFullWidth">}}) |
+| `displayWrapperTop` | |
+| `displayContentWrapperTop` | |
+| `displayContentWrapperBottom` |  |
+| `displayWrapperBottom` |  |
+| `displayFooterBefore` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterBefore">}}) |
+| `displayFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooter">}}) |
+| `displayMyAccountBlock` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayMyAccountBlock">}}) |
+| `displayFooterAfter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterAfter">}}) |
+| `displayBeforeBodyClosingTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBeforeBodyClosingTag">}}) |
+
+## Category page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15444%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayLeftColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumn">}}) |
+| `displayHeaderCategory` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayHeaderCategory">}}) |
+| `displayFooterCategory` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterCategory">}}) |
+
+## Product page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15447%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductActions">}}) |
+| `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
+| `displayProductButtons` |  |
+| `displayAfterProductThumbs` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterProductThumbs">}}) |
+| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
+| `displayLeftColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumnProduct">}}) |
+| `displayRightColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayRightColumnProduct">}}) |
+| `displayFooterProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterProduct">}}) |
+| `displayCardModalContent` |  |
+| `displayCardModalFooter` |  |
+| `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
+
+## Cart page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15450%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayShoppingCart` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayShoppingCart">}}) |
+| `displayCartExtraProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCartExtraProductActions">}}) |
+| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
+| `displayShoppingCartFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayShoppingCartFooter">}}) |
+| `displayCrossSellingShoppingCart` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCrossSellingShoppingCart">}}) |
+
+## Checkout flow
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15452%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayPersonalInformationTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPersonalInformationTop">}}) |
+| `displayCustomerAccountForm` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountForm">}}) |
+| `displayCheckoutSummaryTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCheckoutSummaryTop">}}) |
+| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
+| `displayBeforeCarrier` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBeforeCarrier">}}) |
+| `displayAfterCarrier` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterCarrier">}}) |
+| `displayPaymentTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentTop">}}) |
+| `displayPaymentByBinaries` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentByBinaries">}}) |
+| `displayPaymentReturn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentReturn">}}) |
+| `displayOrderConfirmation` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderConfirmation">}}) |
+| `displayRightColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayRightColumn">}}) |
+| `displayOrderConfirmation2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderConfirmation2">}}) |
+
+## Contact page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15459%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayContactLeftColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactLeftColumn">}}) |
+| `displayContactRightColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactRightColumn">}}) |
+| `displayContactContent` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactContent">}}) |
+| `displayGDPRContent` |  |
+
+## Connexion page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15461%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayCustomerLoginFormAfter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerLoginFormAfter">}}) |
+| `displayCustomerAccountFormTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountFormTop">}}) |
+| `displayCustomerAccountForm` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountForm">}}) |
+
+## My account
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15463%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayCustomerAccount` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccount">}}) |
+| `displayOrderDetail` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderDetail">}}) |
+| `displayAdditionalCustomerAddressFields` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAdditionalCustomerAddressFields">}}) |

From da7e36e9113b5c48dd7d43a1e22facf74d01453b Mon Sep 17 00:00:00 2001
From: thomas nares <thomas-nares.ext@prestashop.com>
Date: Wed, 1 Nov 2023 15:39:21 +0100
Subject: [PATCH 2/6] Create missing hooks and a page showing figma hummingbird
 hooks

---
 .../concepts/hooks/hooks-hummingbird-theme.md |  8 ++--
 .../displayContentWrapperBottom.md            | 44 +++++++++++++++++++
 .../list-of-hooks/displayContentWrapperTop.md | 44 +++++++++++++++++++
 .../hooks/list-of-hooks/displayPDFInvoice.md  |  0
 .../list-of-hooks/displayWrapperBottom.md     | 32 ++++++++++++++
 .../hooks/list-of-hooks/displayWrapperTop.md  | 32 ++++++++++++++
 6 files changed, 156 insertions(+), 4 deletions(-)
 create mode 100644 modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom.md
 create mode 100644 modules/concepts/hooks/list-of-hooks/displayContentWrapperTop.md
 create mode 100644 modules/concepts/hooks/list-of-hooks/displayPDFInvoice.md
 create mode 100644 modules/concepts/hooks/list-of-hooks/displayWrapperBottom.md
 create mode 100644 modules/concepts/hooks/list-of-hooks/displayWrapperTop.md

diff --git a/modules/concepts/hooks/hooks-hummingbird-theme.md b/modules/concepts/hooks/hooks-hummingbird-theme.md
index 3742636a8e..a1eec81fee 100644
--- a/modules/concepts/hooks/hooks-hummingbird-theme.md
+++ b/modules/concepts/hooks/hooks-hummingbird-theme.md
@@ -29,10 +29,10 @@ This page integrates Figma iframes, it may require heavy resources and cause per
 | `displayNav2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav2">}}) |
 | `displayTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayTop">}}) |
 | `displayNavFullWidth` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNavFullWidth">}}) |
-| `displayWrapperTop` | |
-| `displayContentWrapperTop` | |
-| `displayContentWrapperBottom` |  |
-| `displayWrapperBottom` |  |
+| `displayWrapperTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayWrapperTop">}}) |
+| `displayContentWrapperTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContentWrapperTop">}}) |
+| `displayContentWrapperBottom` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom">}}) |
+| `displayWrapperBottom` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayWrapperBottom">}}) |
 | `displayFooterBefore` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterBefore">}}) |
 | `displayFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooter">}}) |
 | `displayMyAccountBlock` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayMyAccountBlock">}}) |
diff --git a/modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom.md b/modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom.md
new file mode 100644
index 0000000000..23a8ff9f06
--- /dev/null
+++ b/modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom.md
@@ -0,0 +1,44 @@
+---
+Title: displayContentWrapperBottom
+hidden: true
+hookTitle: 'Content wrapper section (bottom)'
+files:
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-both-columns.tpl'
+        file: 'Classic Theme: templates/layouts/layout-both-columns.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-content-only.tpl'
+        file: 'Classic Theme: templates/layouts/layout-content-only.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-full-width.tpl'
+        file: 'Classic Theme: templates/layouts/layout-full-width.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-left-column.tpl'
+        file: 'Classic Theme: templates/layouts/layout-left-column.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-right-column.tpl'
+        file: 'Classic Theme: templates/layouts/layout-right-column.tpl'
+locations:
+    - 'front office'
+type: display
+hookAliases:
+origin: theme
+array_return: false
+check_exceptions: false
+chain: false
+description: 'This hook displays new elements in the bottom of the content wrapper'
+
+---
+
+{{% hookDescriptor %}}
+
+## Call of the Hook in the origin file
+
+```php
+{hook h='displayContentWrapperBottom'}
+```
diff --git a/modules/concepts/hooks/list-of-hooks/displayContentWrapperTop.md b/modules/concepts/hooks/list-of-hooks/displayContentWrapperTop.md
new file mode 100644
index 0000000000..827b6fcfec
--- /dev/null
+++ b/modules/concepts/hooks/list-of-hooks/displayContentWrapperTop.md
@@ -0,0 +1,44 @@
+---
+Title: displayContentWrapperTop
+hidden: true
+hookTitle: 'Content wrapper section (top)'
+files:
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-both-columns.tpl'
+        file: 'Classic Theme: templates/layouts/layout-both-columns.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-content-only.tpl'
+        file: 'Classic Theme: templates/layouts/layout-content-only.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-full-width.tpl'
+        file: 'Classic Theme: templates/layouts/layout-full-width.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-left-column.tpl'
+        file: 'Classic Theme: templates/layouts/layout-left-column.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-right-column.tpl'
+        file: 'Classic Theme: templates/layouts/layout-right-column.tpl'
+locations:
+    - 'front office'
+type: display
+hookAliases:
+origin: theme
+array_return: false
+check_exceptions: false
+chain: false
+description: 'This hook displays new elements in the top of the content wrapper'
+
+---
+
+{{% hookDescriptor %}}
+
+## Call of the Hook in the origin file
+
+```php
+{hook h='displayContentWrapperTop'}
+```
diff --git a/modules/concepts/hooks/list-of-hooks/displayPDFInvoice.md b/modules/concepts/hooks/list-of-hooks/displayPDFInvoice.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/modules/concepts/hooks/list-of-hooks/displayWrapperBottom.md b/modules/concepts/hooks/list-of-hooks/displayWrapperBottom.md
new file mode 100644
index 0000000000..404e4dcfe8
--- /dev/null
+++ b/modules/concepts/hooks/list-of-hooks/displayWrapperBottom.md
@@ -0,0 +1,32 @@
+---
+Title: displayWrapperBottom
+hidden: true
+hookTitle: 'Main wrapper section (bottom)'
+files:
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-both-columns.tpl'
+        file: 'Classic Theme: templates/layouts/layout-both-columns.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/checkout/checkout.tpl'
+        file: 'Classic Theme: templates/checkout/checkout.tpl'
+locations:
+    - 'front office'
+type: display
+hookAliases:
+origin: theme
+array_return: false
+check_exceptions: false
+chain: false
+description: 'This hook displays new elements in the bottom of the main wrapper'
+
+---
+
+{{% hookDescriptor %}}
+
+## Call of the Hook in the origin file
+
+```php
+{hook h='displayWrapperBottom'}
+```
diff --git a/modules/concepts/hooks/list-of-hooks/displayWrapperTop.md b/modules/concepts/hooks/list-of-hooks/displayWrapperTop.md
new file mode 100644
index 0000000000..62c10e5c73
--- /dev/null
+++ b/modules/concepts/hooks/list-of-hooks/displayWrapperTop.md
@@ -0,0 +1,32 @@
+---
+Title: displayWrapperTop
+hidden: true
+hookTitle: 'Main wrapper section (top)'
+files:
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/layouts/layout-both-columns.tpl'
+        file: 'Classic Theme: templates/layouts/layout-both-columns.tpl'
+    -
+        theme: Classic
+        url: 'https://github.com/PrestaShop/classic-theme/blob/develop/templates/checkout/checkout.tpl'
+        file: 'Classic Theme: templates/checkout/checkout.tpl'
+locations:
+    - 'front office'
+type: display
+hookAliases:
+origin: theme
+array_return: false
+check_exceptions: false
+chain: false
+description: 'This hook displays new elements in the top of the main wrapper'
+
+---
+
+{{% hookDescriptor %}}
+
+## Call of the Hook in the origin file
+
+```php
+{hook h='displayWrapperTop'}
+```

From df56e9d4f84c0c0f04fbb5326cc81a0543b54f54 Mon Sep 17 00:00:00 2001
From: thomas nares <thomas-nares.ext@prestashop.com>
Date: Tue, 7 Nov 2023 09:37:40 +0100
Subject: [PATCH 3/6] Create displayPDFTemplate hook

---
 .../list-of-hooks/displayPDF<Template>.md     | 69 +++++++++++++++++++
 .../hooks/list-of-hooks/displayPDFInvoice.md  |  0
 2 files changed, 69 insertions(+)
 create mode 100644 modules/concepts/hooks/list-of-hooks/displayPDF<Template>.md
 delete mode 100644 modules/concepts/hooks/list-of-hooks/displayPDFInvoice.md

diff --git a/modules/concepts/hooks/list-of-hooks/displayPDF<Template>.md b/modules/concepts/hooks/list-of-hooks/displayPDF<Template>.md
new file mode 100644
index 0000000000..832e6bb9f9
--- /dev/null
+++ b/modules/concepts/hooks/list-of-hooks/displayPDF<Template>.md
@@ -0,0 +1,69 @@
+---
+Title: displayPDF<Template>
+hidden: true
+hookTitle: 'Add content to PDF templates'
+files:
+    - 
+        url: 'https://github.com/PrestaShop/PrestaShop/blob/8.1.x/pdf/delivery-slip.tpl'
+        file: 'pdf/delivery-slip.tpl'
+    - 
+        url: 'https://github.com/PrestaShop/PrestaShop/blob/8.1.x/pdf/invoice-b2b.tpl'
+        file: 'pdf/invoice-b2b.tpl'
+    - 
+        url: 'https://github.com/PrestaShop/PrestaShop/blob/8.1.x/pdf/invoice.tpl'
+        file: 'pdf/invoice.tpl'
+    - 
+        url: 'https://github.com/PrestaShop/PrestaShop/blob/8.1.x/pdf/order-return.tpl'
+        file: 'pdf/order-return.tpl'
+    - 
+        url: 'https://github.com/PrestaShop/PrestaShop/blob/8.1.x/pdf/order-slip.tpl'
+        file: 'pdf/order-slip.tpl'
+locations:
+    - 'front office'
+    - 'back office'
+type: display
+hookAliases:
+origin: theme
+array_return: false
+check_exceptions: false
+chain: false
+description: 'Allows to add content in HTML to PDF templates'
+
+---
+
+{{% hookDescriptor %}}
+
+## Call of the Hook in the origin file
+
+```php
+<!-- Hook -->
+{if isset($HOOK_DISPLAY_PDF)}
+    <tr>
+        <td colspan="12" height="30">&nbsp;</td>
+    </tr>
+
+    <tr>
+        <td colspan="12">
+            {$HOOK_DISPLAY_PDF}
+        </td>
+    </tr>
+{/if}
+```
+
+This hook is a dynamic hook, generated in `classes/pdf/HTMLTemplate.php`: 
+
+```php
+$template = ucfirst(str_replace('HTMLTemplate', '', get_class($this)));
+$hook_name = 'displayPDF' . $template;
+
+$this->smarty->assign([
+    'HOOK_DISPLAY_PDF' => Hook::exec(
+        $hook_name,
+        [
+            'object' => $object,
+            // The smarty instance is a clone that does NOT escape HTML
+            'smarty' => $this->smarty,
+        ]
+    ),
+]);
+```
\ No newline at end of file
diff --git a/modules/concepts/hooks/list-of-hooks/displayPDFInvoice.md b/modules/concepts/hooks/list-of-hooks/displayPDFInvoice.md
deleted file mode 100644
index e69de29bb2..0000000000

From d16d4b09f3d601acbc37b2a2265b236c707dd6b9 Mon Sep 17 00:00:00 2001
From: thomas nares <thomas-nares.ext@prestashop.com>
Date: Mon, 13 Nov 2023 16:36:14 +0100
Subject: [PATCH 4/6] create hummingbird pages

---
 .../concepts/hooks/list-of-hooks/_index.md    |  4 ++++
 themes/_index.md                              |  4 ++++
 themes/hummingbird/_index.md                  | 21 +++++++++++++++++++
 .../hummingbird}/hooks-hummingbird-theme.md   |  2 --
 4 files changed, 29 insertions(+), 2 deletions(-)
 create mode 100644 themes/hummingbird/_index.md
 rename {modules/concepts/hooks => themes/hummingbird}/hooks-hummingbird-theme.md (99%)

diff --git a/modules/concepts/hooks/list-of-hooks/_index.md b/modules/concepts/hooks/list-of-hooks/_index.md
index 2f769241e0..355e6228a2 100644
--- a/modules/concepts/hooks/list-of-hooks/_index.md
+++ b/modules/concepts/hooks/list-of-hooks/_index.md
@@ -17,6 +17,10 @@ For example, `actionAdminCustomersFormModifier` is documented as `action<AdminCo
 A regex based search has been implemented, and generic hooks should be matched. However, when you see a controller name or action in the hook name and you can't find it, try searching for a part of the hook name, like `FormModifier`.
 {{% /notice %}}
 
+{{% notice tip %}}
+Looking for available hooks in the front office? [Check out our hook mapping project]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}), which provides a visual representation of hook availability in the Hummingbird theme.
+{{% /notice %}}
+
 ## Search for a hook
 
 <div id="hookFilter" class="quickfilter">
diff --git a/themes/_index.md b/themes/_index.md
index dd461ffc4f..e0839c20bb 100644
--- a/themes/_index.md
+++ b/themes/_index.md
@@ -15,4 +15,8 @@ The default PrestaShop installation offers the neutral "Classic theme", enabling
 
 Several marketplaces are available to get PrestaShop themes. As a graphic designer/front developer, you can put your themes up for sale on this marketplaces.
 
+{{% notice note %}}
+A new theme, Hummingbird, is being developed by the maintainer team. While under develoment, [you can start to discover it here]({{<relref "/8/themes/hummingbird">}}).
+{{% /notice %}}
+
 {{% children /%}}
diff --git a/themes/hummingbird/_index.md b/themes/hummingbird/_index.md
new file mode 100644
index 0000000000..49c02fbade
--- /dev/null
+++ b/themes/hummingbird/_index.md
@@ -0,0 +1,21 @@
+---
+title: Hummingbird Theme
+weight: 5
+---
+
+# Hummingbird Theme
+
+Hummingbird is a PrestaShop theme, created and maintained by the maintainer team. 
+
+Read more informations [about this new theme here](https://build.prestashop-project.org/news/2022/new-theme-announce/).
+
+Want to discover, try or contribute to Hummingbird ? [Github repository](https://github.com/PrestaShop/hummingbird).
+
+{{% notice info %}}
+Please note that Hummingbird is still under development.
+{{% /notice %}}
+
+## Hook visual map for Hummingbird theme
+
+A visual map of hooks on Hummingbird theme has been done, [find more informations here]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}).
+
diff --git a/modules/concepts/hooks/hooks-hummingbird-theme.md b/themes/hummingbird/hooks-hummingbird-theme.md
similarity index 99%
rename from modules/concepts/hooks/hooks-hummingbird-theme.md
rename to themes/hummingbird/hooks-hummingbird-theme.md
index a1eec81fee..75c95a4966 100644
--- a/modules/concepts/hooks/hooks-hummingbird-theme.md
+++ b/themes/hummingbird/hooks-hummingbird-theme.md
@@ -15,7 +15,6 @@ This page integrates Figma iframes, it may require heavy resources and cause per
 
 {{< toc >}}
 
-
 ## Home page
 
 <iframe style="border: 1px solid rgba(0, 0, 0, 0);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15442%26mode%3Ddesign%26t%3DIcCnIO2KXW3WErLh-1" allowfullscreen></iframe>
@@ -57,7 +56,6 @@ This page integrates Figma iframes, it may require heavy resources and cause per
 | --- | --- |
 | `displayProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductActions">}}) |
 | `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
-| `displayProductButtons` |  |
 | `displayAfterProductThumbs` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterProductThumbs">}}) |
 | `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
 | `displayLeftColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumnProduct">}}) |

From 16292acaba03923ef9dd55670010c5abd9215c20 Mon Sep 17 00:00:00 2001
From: Thomas NARES <thomasnares@gmail.com>
Date: Mon, 18 Dec 2023 18:19:57 +0100
Subject: [PATCH 5/6] Apply suggestions from code review

Co-authored-by: Krystian Podemski <kpodemski@users.noreply.github.com>
---
 modules/concepts/hooks/list-of-hooks/_index.md |  2 +-
 themes/hummingbird/_index.md                   | 12 ++++++------
 themes/hummingbird/hooks-hummingbird-theme.md  |  4 ++--
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/modules/concepts/hooks/list-of-hooks/_index.md b/modules/concepts/hooks/list-of-hooks/_index.md
index 355e6228a2..c759d906a9 100644
--- a/modules/concepts/hooks/list-of-hooks/_index.md
+++ b/modules/concepts/hooks/list-of-hooks/_index.md
@@ -18,7 +18,7 @@ A regex based search has been implemented, and generic hooks should be matched.
 {{% /notice %}}
 
 {{% notice tip %}}
-Looking for available hooks in the front office? [Check out our hook mapping project]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}), which provides a visual representation of hook availability in the Hummingbird theme.
+Looking for available hooks in the front office? Check out our [Hook mapping project]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}), which provides a visual representation of hook availability in the Hummingbird theme.
 {{% /notice %}}
 
 ## Search for a hook
diff --git a/themes/hummingbird/_index.md b/themes/hummingbird/_index.md
index 49c02fbade..4f0d3f3ee2 100644
--- a/themes/hummingbird/_index.md
+++ b/themes/hummingbird/_index.md
@@ -5,17 +5,17 @@ weight: 5
 
 # Hummingbird Theme
 
-Hummingbird is a PrestaShop theme, created and maintained by the maintainer team. 
+Hummingbird is a PrestaShop theme that aims to replace Classic as a new default theme for the PrestaShop. 
 
-Read more informations [about this new theme here](https://build.prestashop-project.org/news/2022/new-theme-announce/).
+Read more about Hummingbird [in the announcement of the new theme for PrestaShop](https://build.prestashop-project.org/news/2022/new-theme-announce/).
 
-Want to discover, try or contribute to Hummingbird ? [Github repository](https://github.com/PrestaShop/hummingbird).
+Want to test it? Want to contribute to the project and share the feedback with the team? See [Hummingbird Github repository](https://github.com/PrestaShop/hummingbird).
 
 {{% notice info %}}
-Please note that Hummingbird is still under development.
+Please note that the Hummingbird theme is still under development and is not considered production-ready.
 {{% /notice %}}
 
-## Hook visual map for Hummingbird theme
+## Hook mapping project for the Hummingbird theme
 
-A visual map of hooks on Hummingbird theme has been done, [find more informations here]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}).
+A visual map of hooks for the Hummingbird theme has been created, [find more information about the project here]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}).
 
diff --git a/themes/hummingbird/hooks-hummingbird-theme.md b/themes/hummingbird/hooks-hummingbird-theme.md
index 75c95a4966..d242d589b4 100644
--- a/themes/hummingbird/hooks-hummingbird-theme.md
+++ b/themes/hummingbird/hooks-hummingbird-theme.md
@@ -7,10 +7,10 @@ weight: 3
 
 Hummingbird theme introduced a brand new UI for the PrestaShop front office. 
 
-A visual map of hook locations was created by the Design team at PrestaShop. 
+A visual map of hook locations was created by the Product Design team at PrestaShop. 
 
 {{% notice note %}}
-This page integrates Figma iframes, it may require heavy resources and cause performance issues on slower machines.
+This page embeds Figma views in an iframe, which may slow down your device. To avoid this, please click on the links in the article to open the designs in a new tab.
 {{% /notice %}}
 
 {{< toc >}}

From 2adc70d33a2dae1c8148c226f125a0a9e5dd717e Mon Sep 17 00:00:00 2001
From: thomas nares <thomas-nares.ext@prestashop.com>
Date: Mon, 18 Dec 2023 18:50:19 +0100
Subject: [PATCH 6/6] Split by pages

---
 .../concepts/hooks/list-of-hooks/_index.md    |   2 +-
 themes/hummingbird/_index.md                  |   3 +-
 themes/hummingbird/hooks-hummingbird-theme.md | 128 ------------------
 themes/hummingbird/hooks/_index.md            |  12 ++
 themes/hummingbird/hooks/cartpage.md          |  16 +++
 themes/hummingbird/hooks/categorypage.md      |  13 ++
 themes/hummingbird/hooks/checkoutflow.md      |  23 ++++
 themes/hummingbird/hooks/connexionpage.md     |  14 ++
 themes/hummingbird/hooks/contactpage.md       |  15 ++
 themes/hummingbird/hooks/homepage.md          |  27 ++++
 themes/hummingbird/hooks/myaccount.md         |  14 ++
 themes/hummingbird/hooks/productpage.md       |  21 +++
 12 files changed, 157 insertions(+), 131 deletions(-)
 delete mode 100644 themes/hummingbird/hooks-hummingbird-theme.md
 create mode 100644 themes/hummingbird/hooks/_index.md
 create mode 100644 themes/hummingbird/hooks/cartpage.md
 create mode 100644 themes/hummingbird/hooks/categorypage.md
 create mode 100644 themes/hummingbird/hooks/checkoutflow.md
 create mode 100644 themes/hummingbird/hooks/connexionpage.md
 create mode 100644 themes/hummingbird/hooks/contactpage.md
 create mode 100644 themes/hummingbird/hooks/homepage.md
 create mode 100644 themes/hummingbird/hooks/myaccount.md
 create mode 100644 themes/hummingbird/hooks/productpage.md

diff --git a/modules/concepts/hooks/list-of-hooks/_index.md b/modules/concepts/hooks/list-of-hooks/_index.md
index c759d906a9..7a324c11c5 100644
--- a/modules/concepts/hooks/list-of-hooks/_index.md
+++ b/modules/concepts/hooks/list-of-hooks/_index.md
@@ -18,7 +18,7 @@ A regex based search has been implemented, and generic hooks should be matched.
 {{% /notice %}}
 
 {{% notice tip %}}
-Looking for available hooks in the front office? Check out our [Hook mapping project]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}), which provides a visual representation of hook availability in the Hummingbird theme.
+Looking for available hooks in the front office? Check out our [Hook mapping project]({{<relref "/8/themes/hummingbird/hooks">}}), which provides a visual representation of hook availability in the Hummingbird theme.
 {{% /notice %}}
 
 ## Search for a hook
diff --git a/themes/hummingbird/_index.md b/themes/hummingbird/_index.md
index 4f0d3f3ee2..c1b299d4d0 100644
--- a/themes/hummingbird/_index.md
+++ b/themes/hummingbird/_index.md
@@ -17,5 +17,4 @@ Please note that the Hummingbird theme is still under development and is not con
 
 ## Hook mapping project for the Hummingbird theme
 
-A visual map of hooks for the Hummingbird theme has been created, [find more information about the project here]({{<relref "/8/themes/hummingbird/hooks-hummingbird-theme">}}).
-
+A visual map of hooks for the Hummingbird theme has been created, [find more information about the project here]({{<relref "/8/themes/hummingbird/hooks">}}).
\ No newline at end of file
diff --git a/themes/hummingbird/hooks-hummingbird-theme.md b/themes/hummingbird/hooks-hummingbird-theme.md
deleted file mode 100644
index d242d589b4..0000000000
--- a/themes/hummingbird/hooks-hummingbird-theme.md
+++ /dev/null
@@ -1,128 +0,0 @@
----
-title: Hooks on Hummingbird Theme
-weight: 3
----
-
-# Hooks on Hummingbird Theme
-
-Hummingbird theme introduced a brand new UI for the PrestaShop front office. 
-
-A visual map of hook locations was created by the Product Design team at PrestaShop. 
-
-{{% notice note %}}
-This page embeds Figma views in an iframe, which may slow down your device. To avoid this, please click on the links in the article to open the designs in a new tab.
-{{% /notice %}}
-
-{{< toc >}}
-
-## Home page
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15442%26mode%3Ddesign%26t%3DIcCnIO2KXW3WErLh-1" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayAfterTitleTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterTitleTag">}}) |
-| `displayAfterBodyOpeningTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterBodyOpeningTag">}}) |
-| `displayBanner` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBanner">}}) |
-| `displayNav1` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav1">}}) |
-| `displayNav2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav2">}}) |
-| `displayTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayTop">}}) |
-| `displayNavFullWidth` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNavFullWidth">}}) |
-| `displayWrapperTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayWrapperTop">}}) |
-| `displayContentWrapperTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContentWrapperTop">}}) |
-| `displayContentWrapperBottom` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom">}}) |
-| `displayWrapperBottom` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayWrapperBottom">}}) |
-| `displayFooterBefore` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterBefore">}}) |
-| `displayFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooter">}}) |
-| `displayMyAccountBlock` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayMyAccountBlock">}}) |
-| `displayFooterAfter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterAfter">}}) |
-| `displayBeforeBodyClosingTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBeforeBodyClosingTag">}}) |
-
-## Category page
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15444%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayLeftColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumn">}}) |
-| `displayHeaderCategory` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayHeaderCategory">}}) |
-| `displayFooterCategory` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterCategory">}}) |
-
-## Product page
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15447%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductActions">}}) |
-| `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
-| `displayAfterProductThumbs` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterProductThumbs">}}) |
-| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
-| `displayLeftColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumnProduct">}}) |
-| `displayRightColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayRightColumnProduct">}}) |
-| `displayFooterProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterProduct">}}) |
-| `displayCardModalContent` |  |
-| `displayCardModalFooter` |  |
-| `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
-
-## Cart page
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15450%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayShoppingCart` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayShoppingCart">}}) |
-| `displayCartExtraProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCartExtraProductActions">}}) |
-| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
-| `displayShoppingCartFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayShoppingCartFooter">}}) |
-| `displayCrossSellingShoppingCart` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCrossSellingShoppingCart">}}) |
-
-## Checkout flow
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15452%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayPersonalInformationTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPersonalInformationTop">}}) |
-| `displayCustomerAccountForm` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountForm">}}) |
-| `displayCheckoutSummaryTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCheckoutSummaryTop">}}) |
-| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
-| `displayBeforeCarrier` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBeforeCarrier">}}) |
-| `displayAfterCarrier` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterCarrier">}}) |
-| `displayPaymentTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentTop">}}) |
-| `displayPaymentByBinaries` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentByBinaries">}}) |
-| `displayPaymentReturn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentReturn">}}) |
-| `displayOrderConfirmation` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderConfirmation">}}) |
-| `displayRightColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayRightColumn">}}) |
-| `displayOrderConfirmation2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderConfirmation2">}}) |
-
-## Contact page
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15459%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayContactLeftColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactLeftColumn">}}) |
-| `displayContactRightColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactRightColumn">}}) |
-| `displayContactContent` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactContent">}}) |
-| `displayGDPRContent` |  |
-
-## Connexion page
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15461%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayCustomerLoginFormAfter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerLoginFormAfter">}}) |
-| `displayCustomerAccountFormTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountFormTop">}}) |
-| `displayCustomerAccountForm` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountForm">}}) |
-
-## My account
-
-<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15463%26mode%3Ddev" allowfullscreen></iframe>
-
-| Hook |  |
-| --- | --- |
-| `displayCustomerAccount` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccount">}}) |
-| `displayOrderDetail` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderDetail">}}) |
-| `displayAdditionalCustomerAddressFields` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAdditionalCustomerAddressFields">}}) |
diff --git a/themes/hummingbird/hooks/_index.md b/themes/hummingbird/hooks/_index.md
new file mode 100644
index 0000000000..9b9b00884c
--- /dev/null
+++ b/themes/hummingbird/hooks/_index.md
@@ -0,0 +1,12 @@
+---
+title: Hooks on Hummingbird Theme
+weight: 3
+---
+
+# Hooks on Hummingbird Theme
+
+Hummingbird theme introduced a brand new UI for the PrestaShop front office. 
+
+A visual map of hook locations was created by the Product Design team at PrestaShop. 
+
+{{% children /%}}
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/cartpage.md b/themes/hummingbird/hooks/cartpage.md
new file mode 100644
index 0000000000..5f2ee506d3
--- /dev/null
+++ b/themes/hummingbird/hooks/cartpage.md
@@ -0,0 +1,16 @@
+---
+title: Cart page
+weight: 5
+---
+
+# Cart page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15450%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayShoppingCart` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayShoppingCart">}}) |
+| `displayCartExtraProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCartExtraProductActions">}}) |
+| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
+| `displayShoppingCartFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayShoppingCartFooter">}}) |
+| `displayCrossSellingShoppingCart` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCrossSellingShoppingCart">}}) |
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/categorypage.md b/themes/hummingbird/hooks/categorypage.md
new file mode 100644
index 0000000000..c6197ed078
--- /dev/null
+++ b/themes/hummingbird/hooks/categorypage.md
@@ -0,0 +1,13 @@
+---
+title: Category page
+weight: 3
+---
+# Category page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15444%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayLeftColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumn">}}) |
+| `displayHeaderCategory` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayHeaderCategory">}}) |
+| `displayFooterCategory` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterCategory">}}) |
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/checkoutflow.md b/themes/hummingbird/hooks/checkoutflow.md
new file mode 100644
index 0000000000..1a87e814f0
--- /dev/null
+++ b/themes/hummingbird/hooks/checkoutflow.md
@@ -0,0 +1,23 @@
+---
+title: Checkout flow
+weight: 3
+---
+
+# Checkout flow
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15452%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayPersonalInformationTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPersonalInformationTop">}}) |
+| `displayCustomerAccountForm` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountForm">}}) |
+| `displayCheckoutSummaryTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCheckoutSummaryTop">}}) |
+| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
+| `displayBeforeCarrier` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBeforeCarrier">}}) |
+| `displayAfterCarrier` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterCarrier">}}) |
+| `displayPaymentTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentTop">}}) |
+| `displayPaymentByBinaries` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentByBinaries">}}) |
+| `displayPaymentReturn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayPaymentReturn">}}) |
+| `displayOrderConfirmation` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderConfirmation">}}) |
+| `displayRightColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayRightColumn">}}) |
+| `displayOrderConfirmation2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderConfirmation2">}}) |
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/connexionpage.md b/themes/hummingbird/hooks/connexionpage.md
new file mode 100644
index 0000000000..6dbb4f5270
--- /dev/null
+++ b/themes/hummingbird/hooks/connexionpage.md
@@ -0,0 +1,14 @@
+---
+title: Connexion page
+weight: 3
+---
+
+# Connexion page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15461%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayCustomerLoginFormAfter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerLoginFormAfter">}}) |
+| `displayCustomerAccountFormTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountFormTop">}}) |
+| `displayCustomerAccountForm` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccountForm">}}) |
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/contactpage.md b/themes/hummingbird/hooks/contactpage.md
new file mode 100644
index 0000000000..6aeaa8f716
--- /dev/null
+++ b/themes/hummingbird/hooks/contactpage.md
@@ -0,0 +1,15 @@
+---
+title: Contact page
+weight: 3
+---
+
+# Contact page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15459%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayContactLeftColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactLeftColumn">}}) |
+| `displayContactRightColumn` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactRightColumn">}}) |
+| `displayContactContent` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContactContent">}}) |
+| `displayGDPRContent` |  |
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/homepage.md b/themes/hummingbird/hooks/homepage.md
new file mode 100644
index 0000000000..686a2cf3b7
--- /dev/null
+++ b/themes/hummingbird/hooks/homepage.md
@@ -0,0 +1,27 @@
+---
+title: Home page
+weight: 3
+---
+
+# Home page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15442%26mode%3Ddesign%26t%3DIcCnIO2KXW3WErLh-1" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayAfterTitleTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterTitleTag">}}) |
+| `displayAfterBodyOpeningTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterBodyOpeningTag">}}) |
+| `displayBanner` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBanner">}}) |
+| `displayNav1` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav1">}}) |
+| `displayNav2` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNav2">}}) |
+| `displayTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayTop">}}) |
+| `displayNavFullWidth` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayNavFullWidth">}}) |
+| `displayWrapperTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayWrapperTop">}}) |
+| `displayContentWrapperTop` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContentWrapperTop">}}) |
+| `displayContentWrapperBottom` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayContentWrapperBottom">}}) |
+| `displayWrapperBottom` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayWrapperBottom">}}) |
+| `displayFooterBefore` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterBefore">}}) |
+| `displayFooter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooter">}}) |
+| `displayMyAccountBlock` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayMyAccountBlock">}}) |
+| `displayFooterAfter` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterAfter">}}) |
+| `displayBeforeBodyClosingTag` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayBeforeBodyClosingTag">}}) |
\ No newline at end of file
diff --git a/themes/hummingbird/hooks/myaccount.md b/themes/hummingbird/hooks/myaccount.md
new file mode 100644
index 0000000000..4696b9d58d
--- /dev/null
+++ b/themes/hummingbird/hooks/myaccount.md
@@ -0,0 +1,14 @@
+---
+title: My account
+weight: 3
+---
+
+# My account
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15463%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayCustomerAccount` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayCustomerAccount">}}) |
+| `displayOrderDetail` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayOrderDetail">}}) |
+| `displayAdditionalCustomerAddressFields` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAdditionalCustomerAddressFields">}}) |
diff --git a/themes/hummingbird/hooks/productpage.md b/themes/hummingbird/hooks/productpage.md
new file mode 100644
index 0000000000..24418a67fc
--- /dev/null
+++ b/themes/hummingbird/hooks/productpage.md
@@ -0,0 +1,21 @@
+---
+title: Product page
+weight: 3
+---
+
+# Product page
+
+<iframe style="border: 1px solid rgba(0, 0, 0, 0.1);" width="100%" height="450" src="https://www.figma.com/embed?embed_host=share&url=https%3A%2F%2Fwww.figma.com%2Ffile%2FHKGzVBx5p2JaFrFocGe6p0%2FHook-Cartography%3Ftype%3Ddesign%26node-id%3D128%253A15447%26mode%3Ddev" allowfullscreen></iframe>
+
+| Hook |  |
+| --- | --- |
+| `displayProductActions` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductActions">}}) |
+| `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
+| `displayAfterProductThumbs` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayAfterProductThumbs">}}) |
+| `displayReassurance` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayReassurance">}}) |
+| `displayLeftColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayLeftColumnProduct">}}) |
+| `displayRightColumnProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayRightColumnProduct">}}) |
+| `displayFooterProduct` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayFooterProduct">}}) |
+| `displayCardModalContent` |  |
+| `displayCardModalFooter` |  |
+| `displayProductAdditionalInfo` | [Documentation]({{< relref "/8/modules/concepts/hooks/list-of-hooks/displayProductAdditionalInfo">}}) |
\ No newline at end of file