Open matks opened 3 years ago
@jolelievre I think you worked on Tabs at some point, when you wanted to make them usable with Symfony. If you have a good understanding of the inner working of the Back Office menu, it would be absolutely outstanding if you could submit a documentation PR π
Part of the content is in https://devdocs.prestashop.com/1.7/development/architecture/modern/controller-routing/#security because tabs are mapped to controllers and are linked to authorization
Also https://devdocs.prestashop.com/1.7/modules/concepts/controllers/admin-controllers/tabs/ explains a lot of things about it
This also seems to be done by you @matks
Hi @kpodemski unfortunately no I think you refer to something else π’ . I documented the collapsable right sidebar that contains documentation
but the other elements of the BO menu navigation bar are not documented yet.
I mean this bar:
@matks do you think we need a lot of details about it? those are basically registered Tab
s:
https://devdocs.prestashop.com/1.7/modules/concepts/controllers/admin-controllers/tabs/#tabs-registration
π€
@matks do you think we need a lot of details about it? those are basically registered
Tab
s: https://devdocs.prestashop.com/1.7/modules/concepts/controllers/admin-controllers/tabs/#tabs-registrationπ€
This page is great to explain "how to use the Tabs system to add links for my module in the menu bar" π but it does not explain the inside of the menu bar inner working. How is it built? Is the content cached? When I create a new BO page, how does it "automatically" appear on the left?
So we have the "how to use it" π that is great, what I think would be interesting is also the "how it is built inside".
That however is for 2 different audiences.
"How to use it" is probably useful for module developers who want to add links in the menu.
"How it is built inside" would be useful for people who maintain and improve the menu: the project maintainers and prestashop contributors.
Imagine if tomorrow a contributor says "hello! I am motivated to help improve the menu bar because I noticed bug 92796 that impacts it, can you give me a quick link to doc so I can learn how it's built and I now where to explore"
@matks alright π now I understand the purpose
We need a page that explains how the Menu Navigation bar of the Back Office is built. We need to explain what labels are. It would be in
PrestaShop 1.7 > Core Reference > Components > Back Office Menu
.Page
PrestaShop 1.7 > Modules > Extension concepts > Controllers > Admin controllers > Adding module links in the back-office side menu
explains how to add items in the menu.Here is a draft