Help for Aimeos

what is partial and subparts?

I want a brief explanation of how components work under the hood.

https://imgur.com/RSeLVE7 - first arrow pointing is a component, that's understandable.
what is the second one? is a partial or a subpart?

what I'd like to understand is what are these line doing here? https://i.imgur.com/yUur2US.png

first of all, Thanks for the amazing product.
it works like a charm, but to get into is time-consuming.

It feels like, your docs are not fully explaining all aspects of the software.
for example, you guys have to write a post of component implementation and overwriting.

and I see we can use Aimeos with the blade too. But to get started, we have to kinda understand how it(view rendering, controllers, and models too) works.
list of articles(posts) if you decide to write
1. how to create custom controller and use existing components with blade views(this sounds kinda unusual components require specific templates, IMHO.).

2. overwriting and implementing components/subparts
3. routes vs pages. while reading the doc-tion I got multiple times, maybe my English was not enought to figure out, maybe you guys wrote the docs like in a rush, so no one can understand at first glance.

one plus is forum. but that's not good enought in these times IMHO.

parmonov98 wrote: ↑10 Oct 2020, 10:06 what is partial and subparts?

Partials are "includes", i.e. you can include a template into another but you have to pass the data to the template.
Sub-parts are sub-components with own "controller" logic that can fetch data themselves.

parmonov98 wrote: ↑10 Oct 2020, 10:06 I want a brief explanation of how components work under the hood.

Please read these articles:
- https://aimeos.org/docs/latest/frontend ... omponents/
- https://aimeos.org/docs/latest/frontend ... omponents/
- https://aimeos.org/docs/latest/frontend ... -subparts/

There are also more articles explaining the available components there.

parmonov98 wrote: ↑10 Oct 2020, 10:06 https://imgur.com/RSeLVE7 - first arrow pointing is a component, that's understandable.
what is the second one? is a partial or a subpart?

The "Catalog" directory isn't a component, it's only a grouping for the components inside.
The second arrow points to a component which has a factory and a client class.

parmonov98 wrote: ↑10 Oct 2020, 10:06 what I'd like to understand is what are these line doing here? https://i.imgur.com/yUur2US.png

"$this->get(...)" returns the data assigned to the view while "$this->config(...)" offers access to the configuration and "$this->param()" to the request parameter. Using the "$list..." values, you can build URLs using "$this->url()" (which is the long way) and the shorter way is using "$this->link('client/html/catalog/lists/url')".

You can find all available view helpers and how they are used here:
https://aimeos.org/docs/latest/infrastr ... w-helpers/

parmonov98 wrote: ↑10 Oct 2020, 10:06 first of all, Thanks for the amazing product.
it works like a charm, but to get into is time-consuming.

It feels like, your docs are not fully explaining all aspects of the software.
for example, you guys have to write a post of component implementation and overwriting.

Thanks. Aimeos is no simple shopping cart but a full-featured e-commerce framework comparable to Magento in terms of features. The complete Aimeos source code is about 300k lines of code and thus, it will take a bit to get into it.

We haven't explained the difference between partials and subparts up to now because the concept of partials is also known in many other systems and subparts are already explained in the docs. As you may notice, your questions can be answered easily by pointing you to the relevant articles in the documentation so the main problem is that you didn't find them yourself. I also guess, we will always have to answer questions in the forum because for most developers it's easier than reading through all the documentation we have.

parmonov98 wrote: ↑10 Oct 2020, 10:06 and I see we can use Aimeos with the blade too. But to get started, we have to kinda understand how it(view rendering, controllers, and models too) works.
1. how to create custom controller and use existing components with blade views(this sounds kinda unusual components require specific templates, IMHO.).

You can use Blade templates instead of the PHP templates everywhere. Just replace the existing template with your own Blade template:
https://aimeos.org/docs/latest/laravel/ ... -templates

parmonov98 wrote: ↑10 Oct 2020, 10:06 2. overwriting and implementing components/subparts

Already there.

parmonov98 wrote: ↑10 Oct 2020, 10:06 3. routes vs pages. while reading the doc-tion I got multiple times, maybe my English was not enought to figure out, maybe you guys wrote the docs like in a rush, so no one can understand at first glance.

We assume that developers are familiar with basic laravel stuff like routing and how to create a page. Thus, we didn't explained that again.

parmonov98 wrote: ↑10 Oct 2020, 10:06 one plus is forum. but that's not good enought in these times IMHO.

We would love to get more concrete feedback and contributions to the docs and you are warmly invited to make Aimeos better
https://github.com/aimeos/aimeos-docs