From 78e6d1c9acdc38222a60a9c183f62b3a6da5afb6 Mon Sep 17 00:00:00 2001 From: Amigo <49749100+aamigo@users.noreply.github.com> Date: Wed, 25 Sep 2019 19:44:49 +0200 Subject: [PATCH] Updated 064 How to install jcb packages (markdown) --- 064-How-to-install-jcb-packages.md | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/064-How-to-install-jcb-packages.md b/064-How-to-install-jcb-packages.md index b63ea4a..491f202 100644 --- a/064-How-to-install-jcb-packages.md +++ b/064-How-to-install-jcb-packages.md @@ -17,8 +17,25 @@ Once you're on Backup Local Data First page and you have yourself exported a JCB [00:02:28](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h02m28s) -A tutorial is provided to show you how to do that. Explaining why we will do things the way we do them. The fact is that everybody will then have access to that package in this area. You can then also get free keys for the VDM packages. In the past you have to pay for them. We have decided in [00:02:55](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h02m55s) an initiative to show all of you exactly how JCB can work and function. We have decided to give these packages away asking you to follow few steps in supporting us by forking starring or watching these packages in their specific repositories on GitHub. If you need more guidance about this [00:03:22](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h03m22s) you can just click on that link. They'll show you exactly what you need to do. Once you've the key for that specific package, you can come and select that package. It only relate to some of the packages at this point. Which is the first [00:03:38](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h03m38s) prominent Component Builder itself. I would suspect that would be your first choice as well. Once you've selected the package you simply can click on Get Package [00:03:53](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h03m53s) that is been taken from GitHub and brought to your developing environment. In doing so it will run a validation on the integrity of the package, because there are checksums in place. [00:04:09](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h04m09s) You will need to validate the checksum manually. The way you do that, it'll show you the checksum that was used to evaluate the package integrity. Since it's passed, the validation you will know that this checksum is the one that you need to see if you open [00:04:26](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h04m26s) this link 'https://raw.githubusercontent.com'. Opening this link will also reveal a checksum, but at this time you will be seeing a verification By Digi Cert. +A tutorial is provided to show you how to do that. Explaining why we will do things the way we do them. The fact is that everybody will then have access to that package in this area. You can then also get free keys for the VDM packages. In the past you have to pay for them. We have decided in [00:02:55](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h02m55s) an initiative to show all of you exactly how JCB can work and function. We have decided to give these packages away asking you to follow few steps in supporting us by forking starring or watching these packages in their specific repositories on GitHub. If you need more guidance about this [00:03:22](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h03m22s) you can just click on that link. They'll show you exactly what you need to do. Once you've the key for that specific package, you can come and select that package. It only relate to some of the packages at this point. Which is the first [00:03:38](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h03m38s) prominent Component Builder itself. I would suspect that would be your first choice as well. Once you've selected the package you simply can click on Get Package [00:03:53](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h03m53s) that is been taken from GitHub and brought to your developing environment. In doing so it will run a validation on the integrity of the package, because there are checksums in place. [00:04:09](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h04m09s) You will need to validate the checksum manually. The way you do that, it'll show you the checksum that was used to evaluate the package integrity. Since it's passed, the validation you will know that this checksum is the one that you need to see if you open [00:04:26](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h04m26s) this link 'https://raw.githubusercontent.com'. Opening this link will also reveal a checksum, but at this time you will be seeing a verification By Digi Cert. It must be at least this(see video) part of the URL must be correct. [00:04:46](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h04m46s) This will vary from package to package, but it should have the package name. This should correspond to the value you see here. That little bit of manual effort is all you need to do to be sure that the package that you have now in your position [00:05:04](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h05m04s) is the original authentic package that we have distributed. At this point you're all good to go. All you need now is to take the key that we have sent you and add it to the key area. + +### Choose Merge - Change In Package / Force Local Update Works Only If Merge Is Selected + +[00:05:19](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h05m19s) + +Now you will need to make a choice whether you want to, if the JCB already is installed on your system, maybe it's the second time you doing this, then you might not want to Merge it, you might want to have it be like a clone. Like a second instance of JCB it will literally create all the fields and all the views and all the linked concepts again. Where as if you choose Merge, and there is a change in the package which is newer, then the version you have will update [00:05:53](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h05m53s) that version. If you want to Force to update it, you will say Yes up here. The Force Local Update only works if you select Merge. + +### See All Import Information + +[00:06:05](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h06m05s) + +Then there's also See All Import Information. If it is the first time that you're importing a package, it might be ideal to check this Yes. It'll show you everything that it does, every field it adds, but it will not show your names or shows your IDs. A lot of it will be like that it doesn't make sense to see anyway. At the very bottom of the list, it shows you that files that has moved and this is what you need to see. You will need to see the files that is moved into your system. Specially if it's not a package that we are providing or someone else that is being validated through the community. [00:06:44](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h06m44s) But it's someone that you've imported through a URL or through a package from you distributor package you received, or from a directory. Then you most certainly want to see all import info because you want to make sure that what they told you is what you get and that's what that little feature is all about. + +### Component Being Imported + +[00:07:04](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h07m04s) + +Then there is also the Component that is Being Imported should show, the same as the one you saw before we have the package. Those of you that have used this area multiple times, you will know that you're able to add multiple components into one package. It's just because we at VDM are distributing one component at a time. That's why there's only one component in the package. In a greater perspective [00:07:32](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h07m32s) you can import a backup package. That would be then everything that you have done. In my case all the components I've build are zipped in a backup patch package. I can import all of those into JCB at once. At the moment I've tested it up to at least 20 components, which takes a while but it gets there. ????? - -It must be at least This part of the URL Must be correct [00:04:46](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h04m46s) Up There This will vary from package to package But it should have the package name here And this should correspond To the value you to See here And that little bit of manual effort Is all you need to do To be sure that the package that you have now got In your position [00:05:04](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h05m04s) Is the original authentic package that we have distributed So at this point you're all good to go all you need now Is to take the key that we have sent you And to add it here To the key area like so Now you need to make a choice Whether you want to if the JCB already is installed on your system maybe it's the second time you doing this Then you might not want to merge you might want to have it be like a clone [00:05:33](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h05m33s) I like a second instance of JCB it will literally Then create all the fields and all the views And all the linked Concepts Again Where is if you choose merge And There is a change in the package which is newer Then the version you have it will Actually update [00:05:53](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h05m53s) That version If you wanna force it To update it You will say yes up here The force local update really Only Works If you selected merge Then there's also show all import information Which if it is the first time that you're importing package It might be ideal to to check this yes Because it'll show you literally everything that it does every field it adds [00:06:20](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h06m20s) But it will not show your names or shows your IDs a lot of it will be like ok that doesn't make sense To see anyway But at the very bottom of the list It shows you that Files that is moved and this is what you need to see You need to see the files that is moved Into your system Specially if it's not a package that we are providing Or someone else that is being Sort of validated through the community [00:06:44](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h06m44s) But it's someone that you've Imported through a URL Or through a package from you Distributor package you received Or from a directory Then you most certainly wanna see all import info Because you wanna make sure that what they told you is what you get and that's what that little feature is all there About Then there is also the component that is being imported should show [00:07:08](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h07m08s) Here the same as the one you saw before we got the package Now those of you that have used this area multiple times You will know That you're actually able to add Multiple components into one package It's just because we at VBM Are distributing one component at a time That's why there's only one component in the package But in in Integrated perspective [00:07:32](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h07m32s) You can actually import a backup package Right here And that would be Then everything That you have done So in my case all the components I've build are actually zipped in a backup patch package And I can import all of those into JCB at once at the moment I've tested it up to at least 20 components which is It takes a while but it and actually gets there Ok so at this point [00:07:59](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h07m59s) Everything looks fine And you can click continue This depending on the size of the component All the size of package Might take longer and shorter And I would just suggest that you wait it out Take a sip Coffee or something It it does take a while because literally at this point It is updating the IDs [00:08:21](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h08m21s) Everyone One at a time So with every field the IDs are being updated with Every view and everywhere that ID in any other ID is being used anywhere across the component Everything is dynamically being updated During this process And So as you can expect it is a lot of Compilation Lot of algorithm [00:08:41](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h08m41s) Lot of things happening under the hood And therefore does take a little bit longer than You might expect Because the ID is changed And the way we in export the package Is literally Just taking a photocopy of the package as it is in the JCB where it was Develop Or when it resides And when you imported we now recreate and remap every ID [00:09:05](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h09m05s) To ensure that it remains functional although basically all it's identifiers have changed Ok so just wait and in the moment it will show you that it's been successful But it does take a while Once it's done You get this Longest especially if it was JCB Which you've imported I mean it's a long list It has over 1000 field so [00:09:32](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h09m32s) You can anticipate a long scroll I'm gonna grab this thing here and drag it And it goes and goes and goes And it's Huge But they're very much at the bottom you start seeing different things Like the files every little file that has been Imported [00:09:50](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h09m50s) And that's really helpful If you are importing a package From a developer which you do not No or You're not absolutely sure you can Trust The now you must check Every one of these Fields that they are legitimately related to this component And that it is actually what you anticipated [00:10:09](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h10m09s) Or expected And you can also Therefore go look at these folders They are all related The custom folder At the moment as we scroll and now here Are some Folders that are related to the administrator VDM compiler Yes This is in the compiler so there's a lot of files for the [00:10:31](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h10m31s) compiler Joomla 3 Then for the helper this This little thing here is just like a Spacer really By which we sort of Create the string And so there you get all the files that have been moved into place and low and behold There is component builder the fully mapped Package [00:10:51](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h10m51s) In your system And that's really as simple as it is to get The component that You need Fully mapped Into your system And as you can see All it's Views are correctly mapped in here And if you open any of those views [00:11:07](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h11m07s) you'll again see that all it's fields Are also Correctly Mapped And You do realize that every one of these Fields their IDs have changed And even The fields They again Have field types [00:11:23](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h11m23s) And even those Might have changed The field types Itself And so Down to the very Smallest detail we've tried To make sure that every little thing All across the board is remapped [00:11:37](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h11m37s) And You know Fixed so that your component is again Fully Active and stable ready for further development Ok so that is the quick tutorial on how to import a JCB package into JCB. Ok thanks for watching. + Ok so at this point [00:07:59](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h07m59s) Everything looks fine And you can click continue This depending on the size of the component All the size of package Might take longer and shorter And I would just suggest that you wait it out Take a sip Coffee or something It it does take a while because literally at this point It is updating the IDs [00:08:21](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h08m21s) Everyone One at a time So with every field the IDs are being updated with Every view and everywhere that ID in any other ID is being used anywhere across the component Everything is dynamically being updated During this process And So as you can expect it is a lot of Compilation Lot of algorithm [00:08:41](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h08m41s) Lot of things happening under the hood And therefore does take a little bit longer than You might expect Because the ID is changed And the way we in export the package Is literally Just taking a photocopy of the package as it is in the JCB where it was Develop Or when it resides And when you imported we now recreate and remap every ID [00:09:05](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h09m05s) To ensure that it remains functional although basically all it's identifiers have changed Ok so just wait and in the moment it will show you that it's been successful But it does take a while Once it's done You get this Longest especially if it was JCB Which you've imported I mean it's a long list It has over 1000 field so [00:09:32](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h09m32s) You can anticipate a long scroll I'm gonna grab this thing here and drag it And it goes and goes and goes And it's Huge But they're very much at the bottom you start seeing different things Like the files every little file that has been Imported [00:09:50](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h09m50s) And that's really helpful If you are importing a package From a developer which you do not No or You're not absolutely sure you can Trust The now you must check Every one of these Fields that they are legitimately related to this component And that it is actually what you anticipated [00:10:09](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h10m09s) Or expected And you can also Therefore go look at these folders They are all related The custom folder At the moment as we scroll and now here Are some Folders that are related to the administrator VDM compiler Yes This is in the compiler so there's a lot of files for the [00:10:31](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h10m31s) compiler Joomla 3 Then for the helper this This little thing here is just like a Spacer really By which we sort of Create the string And so there you get all the files that have been moved into place and low and behold There is component builder the fully mapped Package [00:10:51](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h10m51s) In your system And that's really as simple as it is to get The component that You need Fully mapped Into your system And as you can see All it's Views are correctly mapped in here And if you open any of those views [00:11:07](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h11m07s) you'll again see that all it's fields Are also Correctly Mapped And You do realize that every one of these Fields their IDs have changed And even The fields They again Have field types [00:11:23](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h11m23s) And even those Might have changed The field types Itself And so Down to the very Smallest detail we've tried To make sure that every little thing All across the board is remapped [00:11:37](https://www.youtube.com/watch?v=PGmEoliopv8&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h11m37s) And You know Fixed so that your component is again Fully Active and stable ready for further development Ok so that is the quick tutorial on how to import a JCB package into JCB. Ok thanks for watching.