Newest Support Documentation for CB Package Builder

1 year 3 months ago #332335 by jamesmoeller
Where can I find the newest support documentation for CB Package Builder?
I'm using Joomla 4.2.6. 
The YouTube videos pertaining to CB Package Builder look to be quite out-of-date.

Thanks,
Jim

Please Log in to join the conversation.

1 year 3 months ago - 1 year 3 months ago #332338 by krileon
Unfortunately we don't have up to date documentation for it at this time. Feel free to ask any questions you may have here on how to use it. A solid example of it is our downloads page itself and our install from web within CB are all powered by it. All our product pages are also the details feature in package builder. So for example the below page is generated by package builder.

www.joomlapolis.com/community-builder


Kyle (Krileon)
Community Builder Team Member
Before posting on forums: Read FAQ thoroughly + Read our Documentation + Search the forums
CB links: Documentation - Localization - CB Quickstart - CB Paid Subscriptions - Add-Ons - Forge
--
If you are a Professional, Developer, or CB Paid Subscriptions subscriber and have a support issue please always post in your respective support forums for best results!
--
If I've missed your support post with a delay of 3 days or greater and are a Professional, Developer, or CBSubs subscriber please send me a private message with your thread and will reply when possible!
--
Please note I am available Monday - Friday from 8:00 AM CST to 4:00 PM CST. I am away on weekends (Saturday and Sunday) and if I've missed your post on or before a weekend after business hours please wait for the next following business day (Monday) and will get to your issue as soon as possible, thank you.
--
My role here is to provide guidance and assistance. I cannot provide custom code for each custom requirement. Please do not inquire me about custom development.

Please Log in to join the conversation.

1 year 3 months ago - 1 year 3 months ago #332341 by jamesmoeller
Replied by jamesmoeller on topic Newest Support Documentation for CB Package Builder
Folder Location of Downloadable Files:

I would like some clarification regarding the location of the downloadable files. I’m using Joomla 4.2.6, so the menus and specifications are somewhat different than what’s described in the YouTube videos, at least as of 2023-01-10.

The specification of the folder for the downloadable files seems to be a combination of the configuration of CB Package Builder and the settings within the Packages submenu.

So, within Community Builder >> Plugin Management >> CB Package Builder >> Parameters tab >> Downloads tab, the “Root” field seems to specify the default folder within the Joomla root directory where it’s expected that the downloadable files will be stored. For example, if the “Root” field is specified as “folder01” then the full Linux path to that folder will be something like “/home/website/public_html/folder01”

Then, within the Packages submenu, i.e. Community Builder >> Plugin Management >> CB Package Builder-Packages submenu >> Package tab (shown in the attached image), the “Download” field seems to further specify the path and filename of the downloadable file. If the “Download” field is simply specified as the filename of the download, for example, “file01.zip”, then that file should reside in the “/home/website/public_html/folder01” folder. That seems to work fine.

However, the tooltip associated with the “Download” field says that a leading slash can be added to change the folder location of the download file.
Question 1: When a leading slash is added, where is the new location of the download file?
Question 2: Additionally, how is the “Filename” field of the Package tab (see the attached image) used to further specify the download file?
Attachments:

Please Log in to join the conversation.

1 year 3 months ago - 1 year 3 months ago #332342 by jamesmoeller
Replied by jamesmoeller on topic Newest Support Documentation for CB Package Builder
Type Specification of Non-Joomla Downloadable Files:

Additional questions associated with the "Type" setting when setting-up packages.
None of my downloads are associated with Joomla, so I'm using the "Custom" type when setting up packages.
I'm also specifying both a custom Type and a custom Sub-Type. 

First issue, I'm having problems displaying the files of these Types and Sub-Types via a menu item. 
So, for example, if I have two download files, each with the same Type but different Sub-Types, and then I set up a menu item to show both of these files by selecting the Type and then also selecting the two Sub-Types simultaneously in the CB Package Builder Plugin menu item, I receive the error below. 
"0 in_array(): Argument #2 ($haystack) must be of type array, null given" 
Essentially it looks like I can't select two Sub-Types simultaneously when displaying downloads via a menu item. I believe this is also the case if I attempt to select multiple Types simultaneously as well.

Second issue, when I'm able to get the menu item to show the list of downloads (by specifying the same Type and Sub-Type), and then I click on one of the download files to get to the details page, the details page defaults to showing the Joomla compatible versions, even though I've attempted to disable any indication of Joomla version. It almost looks like I'd need to design a custom details display template to get rid of the Joomla version indication. 
 

Please Log in to join the conversation.

1 year 3 months ago #332346 by krileon

Additional questions associated with the "Type" setting when setting-up packages.
None of my downloads are associated with Joomla, so I'm using the "Custom" type when setting up packages.
I'm also specifying both a custom Type and a custom Sub-Type. 

First issue, I'm having problems displaying the files of these Types and Sub-Types via a menu item. 
So, for example, if I have two download files, each with the same Type but different Sub-Types, and then I set up a menu item to show both of these files by selecting the Type and then also selecting the two Sub-Types simultaneously in the CB Package Builder Plugin menu item, I receive the error below. 
"0 in_array(): Argument #2 ($haystack) must be of type array, null given" 
Essentially it looks like I can't select two Sub-Types simultaneously when displaying downloads via a menu item. I believe this is also the case if I attempt to select multiple Types simultaneously as well.

Enable debug mode and maximum error reporting then retry and provide the callstack for the error. Attempted to replicate in my test environments, but am not seeing any errors in my tests.

Second issue, when I'm able to get the menu item to show the list of downloads (by specifying the same Type and Sub-Type), and then I click on one of the download files to get to the details page, the details page defaults to showing the Joomla compatible versions, even though I've attempted to disable any indication of Joomla version. It almost looks like I'd need to design a custom details display template to get rid of the Joomla version indication. 

I assume you mean the CMS selector? Within CB > Package Builder > Parameters > CMS create a custom CMS option there. Example as follows.

Value: custom
Label: Custom

Now assign all your packages to it. Next within CB > Package Builder > Parameters > Packages and CB > Package Builder > Parameters > Presets set "CMS" to "Disable" and "Default CMS" to "Custom". That should deal with suppressing the display of the CMS selector. Additionally within CB > Package Builder > Parameters > Global I recommend setting "Bundle Type" to "ZIP" so it never can package a Joomla installer.

There is a bug with the type icons not showing custom types though and defaulting to Document. Am fixing that bug as we speak. CB Package Builder is of course designed and meant for building Joomla packages, but it can certainly be much more than that and will make whatever changes are necessary to fit outside of that scope so please do let me know what issues you run into in that regard.


Kyle (Krileon)
Community Builder Team Member
Before posting on forums: Read FAQ thoroughly + Read our Documentation + Search the forums
CB links: Documentation - Localization - CB Quickstart - CB Paid Subscriptions - Add-Ons - Forge
--
If you are a Professional, Developer, or CB Paid Subscriptions subscriber and have a support issue please always post in your respective support forums for best results!
--
If I've missed your support post with a delay of 3 days or greater and are a Professional, Developer, or CBSubs subscriber please send me a private message with your thread and will reply when possible!
--
Please note I am available Monday - Friday from 8:00 AM CST to 4:00 PM CST. I am away on weekends (Saturday and Sunday) and if I've missed your post on or before a weekend after business hours please wait for the next following business day (Monday) and will get to your issue as soon as possible, thank you.
--
My role here is to provide guidance and assistance. I cannot provide custom code for each custom requirement. Please do not inquire me about custom development.

Please Log in to join the conversation.

1 year 3 months ago #332348 by jamesmoeller
Replied by jamesmoeller on topic Newest Support Documentation for CB Package Builder
Any insights re my questions pertaining to the directory location(s) of downloadable files?
Thanks.

Please Log in to join the conversation.

Moderators: beatnantkrileon
Time to create page: 0.568 seconds

Facebook Twitter LinkedIn