Confusing - Not Sure which zip file to use

[murugappanrm]

When i tried to download the framework, i get 2 zip files: (1) astroid-framework-2.6.4.zip (2) astroid-package-v2.6.4.Framework-Template.zip

I am not which one to use. All the documentation says is that install the zip file. I am using Joomla 4.2.8 with PHP 8.1.12 under Cpanel. When i installed the (1) above, the installation was completed but nothing was shown in the styles or modules. What is the difference between the two and which one should i use?

[sonvnn]

Hi @murugappanrm ,

1. astroid-framework-2.6.4.zip is core framework. It's using for Joomla-update server only.
2. astroid-package-v2.6.4.Framework-Template.zip is Template package includes Framework + Template.

If you want install on a fresh site. You should use option 2. Please let me know if you have any question.

Best Regards, Sonny

[murugappanrm]

Hi @sonvnn ,

I installed the latest version of the Framework 2.6.4 unfortunately the documentation is outdated and none of them seem to match the version for Joomla 4. Example, the tutorial says "copy the template" whereas Joomla 4.2.8 does not have it but it has "create child template". Another example, the documentation on "Layout Manager for Dummies" shows editing of the Hero Section which does not exist the installed template. and many of the parameters do not match. These will not go well with newbies.

As a newbie and introduced by a very learned friend, i feel that the framework does have potentials but with outdated documentation and tutorial, i am not sure it will get much audience. It may face the same fate as PHPR and Joomshapers SPPage Builder 4. Please forgive me for being truthful but i prefer giving honest feedback and learn from mistakes.

Additionally, i would like to use SPPage Builder addons in the framework and i could not find much help.

Please review my needs and assist. Thank you in advance.

[Chacapamac]

@murugappanrm , Appreciate your input!

Yes, the “Child Template” ability is pretty new to Joomla and Astroid just follow right behind Joomla to offer the possibility when many other big framework are still with the possibility or have no date when it will be possible.

This possibility take flight with Joomla 4.1 and Astroid 2.6.0 UP

I agree that work need to be done on the documentation and the “Child Template” possibility is an important point.

Additionally, i would like to use SPPage Builder addons in the framework and i could not find much help. These Builders are All really complex and sometimes don’t even use the Joomla core structure for their products.

— I think you should refer to their documentation and test how it work in Astroid, everybody here will be happy to help you if you have problems.

I’m working on an extensive tutorial on the Joomla/Astroid Child Template ability now that I will be happy to give to Astroid because they are simply the best framework for Joomla today.

Just a note to clarify the Child Template and the Duplicate template abilities: You said:

the tutorial says "copy the template" whereas Joomla 4.2.8 does not have it but it has "create child template"

• Joomla 4.2.8 still have the ability to copy (duplicate a template)

• You create a “Child Template” here STEP 1

STEP 2

[murugappanrm]

@Chacapamac

I did exactly as you have advised. Its just the documentation is seriously in need of update to reflect the Asteroid version. Try some of the video tutorials and many of them do not match the latest version of Astroid, especially the parameters when i tried to customize. That is my problem and is still is a problem with Joomshaper as well. I hope you understand the problem newbies to Astroid would have in the adoption.

Btw, the tutorial suggest we delete the parent template but that does not work with Joomla 4.2. It does not allow the deletion as the child still need the parent to inherit and apply its own changes as override. That is what cause my confusion but later i figured that out -- PHP OOP concept.

[Chacapamac]

@murugappanrm — Thanks for your comments We are aware for the documentation and will work toward it. Everybody here is also welcome to help.

Btw, the tutorial suggest we delete the parent template but that does not work with Joomla 4.2. It does not allow the deletion as the child still need the parent to inherit and apply its own changes as override.

Yes, this is how “Child Template” work. I didn’t try, but it make sens that you cannot delete a Parent Template if Childs of that Template exist.

Please, Can you point me to that Tutorial? We can start with this one to update....

[murugappanrm]

@Chacapamac

The tutorial link is https://astroidframe.work/support/documentations/getting-started/creating-a-basic-astroid-template

[Chacapamac]

You absolutely right @murugappanrm Thanks! This documentation is not even talking about the “Child Template” Ability. Anyway, I personally never delete the Original Template of a Copy because You always Need the Original to troubleshoot your Template Copy customization.

I take care to Redo this important documentation and will make a video tutorial for this as it is basic to help Astroid users start new website the right way by using the New “Child Template” ability or using the old way by a simple copy of the “Original” Template.

If you want I will contact You to see the new article/documentation to see if it’s clear.

Good Day!

[murugappanrm]

@Chacapamac

I will be very happy to assist in any way i can. Please do contact me. Thank you. Great Job!

[Chacapamac]

Great, I will open a Discussion under your Github Profile.

Good Day!

[TheYuru]

Hey ! I have the same problem.. @Chacapamac Je ne sais pas comment faire marcher Astroid

[Chacapamac]

@TheYuru
We just revise the documentation, see https://docs.astroidframe.work/

You can also pass by the main website —> https://astroidframe.work/

Can you be more precise on your problem working with Astroid?

[TheYuru]

In Joomla 4 there is no "Copy" as Joomla 3, we can use the function "Duplicate" or create a "Child Template". My problem is that i don't know how to make it work

[lexman1958]

@Chacapamac @TheYuru

I am using Joomla Version 4.2.9 and Astroid Zero version 2.6.4 (both latest). The documentation still does not match the installation.

This is screen-cap of the installed version:

This is the screen-cap of the documentation:

There are many areas in the documentation that do not match with the documentation and it will be extremely difficult to understand the framework. We may have to defer using this framework until these have been reviewed and updated. I will update the people who recommended the framework to us as well.

[Chacapamac]

@lexman1958

There are many areas in the documentation that do not match with the documentation and it will be extremely difficult to understand the framework.

Remember, that like Joomla, everything work with contributors that give their time to the project. — We know that the documentation need to be updated and we are working on that right now! — You are welcome to help!

As to understand the framework, lot of the existing documentation are still helpful and Astroid is one of the most, if not the most straightforward framework to work with.

We may have to defer using this framework until these have been reviewed and updated. I will update the people who recommended the framework to us as well. — For sure you are welcome to use any other Joomla framework out there. — I already personally work on the part of the documentation that you have problem with (installation). We are actually setting the final system to show and work on the documentation will be are worked on. You can see the first draft of it here —> https://docs.astroidframe.work/ — — This is also available by the main website —> https://astroidframe.work/ —> Support —> Documentation

I already show you the overview of creating a copy/duplicate a Template Layout and how to Create a Child Template in this post in this discussion —> in https://github.com/templaza/astroid-framework/issues/296#issuecomment-1452443590

If you have something specific you don’t understand, I will be happy to help if you specify what you want to know.

- If you want to dive deeper into Joomla Child Templates https://magazine.joomla.org/all-issues/may-2022/a-deep-dive-into-joomla-child-templates

- If you want a fast video overview how to create one https://www.youtube.com/watch?v=_3cUTEUvczk

Good Day to All!

[Chacapamac]

@TheYuru

Hey ! I have the same problem.. @Chacapamac Je ne sais pas comment faire marcher Astroid

Je vais essayer de vous aidé The Yuru • Pouvez-vous être plus spécifique sur le ou les problèmes que vous avez.

• Peut-être il serait plus facile pour moi de vous aider si j’ouvre une nouvelle discussion pour avoir une aide plus personnalisée, quand pensez-vous?