Global refactor of themes section by tblivet · Pull Request #2129 · PrestaShop/docs

tblivet · 2026-04-01T10:10:12Z

Questions	Answers
Branch?	9.x
Description?	Full refactor of the themes/ documentation section, Hummingbird-first, restructured into 7 sections. This PR contains major changes and should be reviewed with a local build of the docs. Note: a separate PR has been submitted to exclude CLAUDE.md files from the Hugo build: PrestaShop/devdocs-site#44 Sorry for the size of this PR, the nature of a full section refactor made it impossible to split into smaller atomic pieces without losing coherence.
Fixed ticket?	--
Sponsor company	@PrestaShopCorp

ga-devfront

Initial feedback: I haven't finished the review yet, but this is to be able to start working on the responses/feedback.

ga-devfront

Second part of my review, it's not finished yet.

ga-devfront

Please be consistent

ga-devfront

Please be consistent

ga-devfront

Please remove all —.

kpodemski · 2026-04-29T10:34:32Z

@tblivet I'm reviewing 👌🏻

tblivet · 2026-05-18T07:29:28Z

Hi @kpodemski, did you have time to finish the review? I know it’s a long one 😬

kpodemski

Huge work @tblivet @ga-devfront ! I'm leaving a few comments

kpodemski · 2026-05-19T14:28:53Z


 [getting-started-guide]: https://docs.prestashop-project.org/v.8-documentation/v/english/getting-started
 [system-requirements]: {{< relref "/9/basics/installation/system-requirements" >}}
-[clone-the-repository]: {{< relref "/9/themes/getting-started/setting-up-your-local-environment" >}}


This is used above, right?

kpodemski · 2026-05-19T14:42:40Z

+        description: Add a widget area above the footer
+```
+
+Modules can also register hooks from PHP using `Hook::register('MyCustomHook')`. See [Hooks]({{< relref "/9/modules/concepts/hooks" >}}) in the module documentation for the full module-side API.


Suggested change

Modules can also register hooks from PHP using `Hook::register('MyCustomHook')`. See [Hooks]({{< relref "/9/modules/concepts/hooks" >}}) in the module documentation for the full module-side API.

Modules can also register hooks from PHP using `Hook::registerHook('MyCustomHook')`. See [Hooks]({{< relref "/9/modules/concepts/hooks" >}}) in the module documentation for the full module-side API.

kpodemski · 2026-05-19T14:47:19Z

+```smarty
+{l s='%count% items in your cart' d='Shop.Mytheme' sprintf=['%count%' => $cart.products_count]}
+{l s='Welcome, %firstname% %lastname%!' d='Shop.Mytheme' sprintf=['%firstname%' => $customer.firstname, '%lastname%' => $customer.lastname]}
+```


Suggested change

```smarty

{l s='%count% items in your cart' d='Shop.Mytheme' sprintf=['%count%' => $cart.products_count]}

{l s='Welcome, %firstname% %lastname%!' d='Shop.Mytheme' sprintf=['%firstname%' => $customer.firstname, '%lastname%' => $customer.lastname]}

```

```smarty

{l s='%count% items in your cart' d='Shop.Mytheme' sprintf=['%count%' => $cart.products_count]}

{l s='Welcome, %firstname% %lastname%!' d='Shop.Mytheme' sprintf=['%firstname%' => $customer.firstname, '%lastname%' => $customer.lastname]}

{l

s='We noticed a problem with your order. If you think this is an error, feel free to contact our [1]expert customer support team[/1].'

d='Modules.Wirepayment.Shop' sprintf=['[1]' => "<a class='alert-link' href='{$contact_url}'>", '[/1]' => '</a>']

}

kpodemski · 2026-05-19T14:50:11Z

+
+# Creating a theme from scratch
+
+This page covers creating a minimal, valid PrestaShop 9 theme from scratch. It is the recommended starting point for PrestaShop 9.0, and a useful reference for understanding the required file structure on any 9.x version.


I disagree. It's not a recommended starting point. In our ecosystem, most of the themes derive from the main theme; for v9, it's Hummingbird.

kpodemski · 2026-05-19T15:03:31Z


-{{% children /%}}
+{{% notice note %}}
+The visual maps are embedded from Figma. If an embed does not load, refer to the hook table below it for the same information. The source Figma file is available in the [Hook Cartography project](https://www.figma.com/file/HKGzVBx5p2JaFrFocGe6p0/Hook-Cartography).


It hasn't been updated for a long time, maybe we should mention that we'll try to update it in the future.

tblivet requested review from ingridusta, jolelievre and kpodemski April 1, 2026 10:10

github-actions Bot added the 9.x label Apr 1, 2026

Quetzacoalt91 requested a review from ga-devfront April 1, 2026 10:15

ga-devfront reviewed Apr 8, 2026

View reviewed changes

ga-devfront requested changes Apr 13, 2026

View reviewed changes

tblivet added 21 commits April 16, 2026 14:34

feat: theme refactor

2f5935c

feat: add claude context

c62c10b

feat: add aliases for redirections

49e1f54

feat: improve claude context

76c9d2a

fix: 1

58a23d7

fix: 2

deef5d3

fix: 3

2d8c354

fix: 4

71fbfbf

fix: 5

4f13238

fix: 6

e511256

fix: 7

c3cc00c

fix: 8

d28a6aa

fix: 9

1f93c7d

fix: 10

242fe30

fix: 11

546a22f

fix: 12

e17802d

fix: 13

80bbbbc

fix: 14

d0b8cd7

fix: 15

f7db44c

fix: 16

5b55559

fix: 17

787a52e

tblivet added 15 commits April 16, 2026 14:34

fix: 24

75fe2da

fix: 25

82acafa

fix: 26

955ab43

fix: 27

061060b

fix: 28

f3a039c

fix: 29

8bafe8e

fix: 30

d58b5eb

fix: 31

1f191bb

fix: 32

fe5eb33

fix: 33

f0816c4

fix: 34

772a8bd

fix: 35

5102e44

fix: 36

392119e

fix: 37

ec4b24f

fix: 38

d53a6af

tblivet force-pushed the feat/themes-refactor branch from 40807ec to d53a6af Compare April 16, 2026 12:35

tblivet requested a review from a team April 23, 2026 08:20

tblivet added 2 commits April 23, 2026 14:48

fix: 39

40a0a97

fix: 40

ebdefed

ga-devfront requested changes Apr 23, 2026

View reviewed changes

Comment thread themes/concepts/templates/listing-pages.md Outdated

Comment thread themes/concepts/asset-management.md Outdated

tblivet added 4 commits April 24, 2026 10:06

fix: 41

87b067c

fix: 42

db00327

feat: unify AI context

1abfcc8

feat: unify AI context

71beae5

tblivet requested a review from ga-devfront April 24, 2026 09:24

ga-devfront approved these changes Apr 29, 2026

View reviewed changes

tblivet requested a review from a team April 29, 2026 10:05

kpodemski reviewed May 19, 2026

View reviewed changes

	Modules can also register hooks from PHP using `Hook::register('MyCustomHook')`. See [Hooks]({{< relref "/9/modules/concepts/hooks" >}}) in the module documentation for the full module-side API.
	Modules can also register hooks from PHP using `Hook::registerHook('MyCustomHook')`. See [Hooks]({{< relref "/9/modules/concepts/hooks" >}}) in the module documentation for the full module-side API.


		# Creating a theme from scratch

		This page covers creating a minimal, valid PrestaShop 9 theme from scratch. It is the recommended starting point for PrestaShop 9.0, and a useful reference for understanding the required file structure on any 9.x version.

Conversation

tblivet commented Apr 1, 2026

Uh oh!

ga-devfront left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ga-devfront left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ga-devfront left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ga-devfront left a comment

Choose a reason for hiding this comment

Uh oh!

ga-devfront left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

kpodemski commented Apr 29, 2026

Uh oh!

tblivet commented May 18, 2026

Uh oh!

kpodemski left a comment

Choose a reason for hiding this comment

Uh oh!

kpodemski May 19, 2026

Choose a reason for hiding this comment

Uh oh!

kpodemski May 19, 2026

Choose a reason for hiding this comment

Uh oh!

kpodemski May 19, 2026

Choose a reason for hiding this comment

Uh oh!

kpodemski May 19, 2026

Choose a reason for hiding this comment

Uh oh!

kpodemski May 19, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants