joomla/Component-Builder
joomla/Component-Builder
39
23
Fork 11
Code Issues 83 Pull Requests Projects 4 Wiki Activity

Updated 041 Upgrade to JCB v2.5.8 and using the new Admin View and Admin Fields (markdown)

Amigo 2019-08-08 10:01:31 +02:00
parent 67515437c7
commit edb5929631
1 changed files with 21 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
041-Upgrade-to-JCB-v2.5.8-and-using-the-new-Admin-View-and-Admin-Fields.md

@ -74,26 +74,39 @@ Getting back to the Install. Open this Admin View - 'Look', and then install the
[00:12:55](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h12m55s) [00:12:55](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h12m55s)
If that Admin View is opened and then refreshed, the changes will be seen(see video). There is now a Settings Field and as may be seen, all the data has been updated and moved to Sub Form values. The same with Tabs. Going to Field and Conditions, it may also be seen how the new Field and Conditions View looks like. [00:13:32](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h13m32s) Due to many reasons it is not advisable to keep the Sub Form Fields within the Admin View, especially when there are more than 50 Admin Fields, because it causes a tremendous slow down on page load. Taken into consideration that each of these lines are 1 - 13 fields and if you start having a lot of those Fields<<<<<< If that Admin View is opened and then refreshed, the changes will be seen(see video). There is now a Settings Field and as may be seen, all the data has been updated and moved to Sub Form values. The same with Tabs. Going to Field and Conditions, it may also be seen how the new Field and Conditions View looks like. [00:13:32](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h13m32s) Due to many reasons it is not advisable to keep the Sub Form Fields within the Admin View, especially when there are more than 50 Admin Fields, because it causes a tremendous slow down on page load. Taken into consideration that each of these lines, are 1 - 13 fields and the limit is set to 800, which may be a time consuming process to load all that into the page.
which you could have up to 800, [00:14:09](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h14m09s) by the limit we've set, it really takes a long time to load that into the page.
### How The Field And Conditions View Works? ### How The Field And Conditions View Works?
How does it work? Well you could either click on the Edit button - Linked Fields, or the Edit button - Field Conditions to go and edit these and change their values. If you would like to just edit one specific field, you could click on any of these pencil editing links. For example, if I click on 'Name' [00:14:41](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h14m41s) it will ask me whether I've saved all my values in this current view, and yes I just click 'OK'. It will open the Name Field and I can now come in here do any edits that I'd like and then save and close, or just close out again, if you want to get some information. Back into Editing the Admin View area. [00:14:15](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h14m15s)
How does it work? Either click on the Edit button - Linked Fields, or the Edit button - Field Conditions to go and edit these and change their values. If one specific field is edited, click on any of these pencil editing links. For example: If I click on 'Name' it will ask whether I have saved all the values in this current view, and if it has been done; click 'OK'.[00:14:46](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h14m46s) It will open the Name Field and now any edits may be done in here and then save and close, or just close again, if only some information was needed.
### How To Edit Custom Fields ### How To Edit Custom Fields
The same goes with the Custom Fields. I could click on any of those to edit them. Or I could click on this Edit button. [00:15:12](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h15m12s) It will again ask me if I saved all my work, then if I did click 'OK'. Opens those values right here. A nice new tweak we added, is that it only loads the Fields that are linked to this Admin View(Match Field) that you can target the specific Fields [00:15:34](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h15m34s) which makes sense. That Those are the fields that needs to be targeted with this conditional option. [00:15:00](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h15m00s)
Back into Editing the Admin View area. The same applies to the Custom Fields. Click on any of those to edit them or click on this Edit button. It will again ask if I have saved all the work, then if it has been, click 'OK' and it opens these values(See video) . A nice new tweak which had been added, is that it only loads the Fields that are linked to this Admin View(Match Field) so that the specific Fields can be targeted, which makes sense. Those are the fields that needs to be targeted with this conditional option.
### Creating Field - Available ### Creating Field - Available
Then you could also create a field. Creating a field will not necessarily add it to the Admin View, it will just make it available to you, if you were to add it by going to Admin Fields .[00:15:57](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h15m57s) The Edit (Linked Fields)button is the same as 'Edit admin fields conditions for this admin view' but it is a shortcut, because sometimes you might have a lot of fields, and it's a way down there to get to conditions. We added some shortcuts up here. There's also the tutorial on how to use this but the tutorial still was made when we had the old Fields layout. It should still make sense. You just need to keep in mind that things change a little. You could click [00:16:27](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h16m27s) on any of these links to open that area where the fields are now found and make the changes. That's the new Admin Fields. Moving away from Repeatable Fields to start using Sub Forms for all our Repeatable concepts. It's what this upgrade is all about. [00:16:53](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h16m53s) [00:15:42](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h15m42s)
Then a field can also be created . Creating a field will not necessarily add it to the Admin View, it will just make it available to you, if it were added by going to Admin Fields .[00:15:57](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h15m57s) The Edit (Linked Fields)button is the same as 'Edit admin fields conditions for this admin view' but it is a shortcut, because sometimes you might have a lot of fields, and it is way down there to get to conditions. Some shortcuts had been added up here(See video). There is also the tutorial on how to use this but the tutorial still was made when we had the old Fields layout. It should still make sense but just keep in mind that things had changed a little. You could click on any of these links to open that area where the fields are now found and make the changes. [00:16:27](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h16m27s) That is the new Admin Fields.
**To move away from Repeatable Fields to start using Sub Forms for all the Repeatable concepts is what this upgrade is all about.**
### Shortcut Buttons - First Button, Admin Fields - Second Button, Conditions ### Shortcut Buttons - First Button, Admin Fields - Second Button, Conditions
There is one heads up which I know is a little different to how things were done previously. Let me close out of this Admin View. I could just mention this, here(buttons underneath a view) is a shortcut to get to the Admin Fields without opening the Admin View and then opening the Admin Fields. You can click on the right button and it will automatically take you to the Admin Fields. You can make changes [00:17:21](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h17m21s) and it's link to the Look Area or the Look Admin View. The same is true when looking at the Conditions. The second button is for conditions. [00:16:53](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h16m53s)
There is one heads up concerning something that is a little different to how things were done previously. Close and go out of this Admin View. It may be mentioned that here(buttons below a view) is a shortcut to get to the Admin Fields without opening the Admin View and then the Admin Fields. If the right button is used, it will automatically open the Admin Fields. Changes may be made and it is linked to the Look Admin View and it is same with the Conditions. The second button is for conditions.
### Create New Admin View: Adding - Single Record Name, List Record Name, Short Description, System Name ### Create New Admin View: Adding - Single Record Name, List Record Name, Short Description, System Name
[00:17:35](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h17m35s)<<<<<
The thing that has changed is, if you create a new Admin View, you would add the Single Record Name, the List Record Name, the Short Description, the System Name. That's all you need to add [00:17:51](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h17m51s) to save the Admin View for the first time. The Admin View at this stage, cannot be linked to any fields until it has an ID. I might still work on this and try and tune it in a way that when you click the button, and if the Admin View is not saved, it saves it for you. [00:18:15](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h18m15s) I haven't done that yet. At this stage since the admin field doesn't have an ID it's still new, because we haven't clicked save even once. You can't link any Fields to it. What you would naturally do is, add some Name(test) here, then just save it once. Having done that if you go to Fields and Conditions [00:18:57](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h18m57s) it says 'Create'. This button here 'Create' and that one here 'Create admin fields for this admin views' is the same button. You can click on any of them to Create Fields. If you would Create a field, yes I did save everything. You can click on the plus+. There's the first field and you can start adding fields, and tweak them as you would before. [00:19:22](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h19m22s) That's the new Sub Form Fields for Admin Views. That's what this upgrade is all about. I trust that it benefit all of us in the future, and make it more easier for us to transition into Joomla 4. The thing that has changed is, if you create a new Admin View, you would add the Single Record Name, the List Record Name, the Short Description, the System Name. That's all you need to add [00:17:51](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h17m51s) to save the Admin View for the first time. The Admin View at this stage, cannot be linked to any fields until it has an ID. I might still work on this and try and tune it in a way that when you click the button, and if the Admin View is not saved, it saves it for you. [00:18:15](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h18m15s) I haven't done that yet. At this stage since the admin field doesn't have an ID it's still new, because we haven't clicked save even once. You can't link any Fields to it. What you would naturally do is, add some Name(test) here, then just save it once. Having done that if you go to Fields and Conditions [00:18:57](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h18m57s) it says 'Create'. This button here 'Create' and that one here 'Create admin fields for this admin views' is the same button. You can click on any of them to Create Fields. If you would Create a field, yes I did save everything. You can click on the plus+. There's the first field and you can start adding fields, and tweak them as you would before. [00:19:22](https://www.youtube.com/watch?v=YaycQcsMpOs&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=00h19m22s) That's the new Sub Form Fields for Admin Views. That's what this upgrade is all about. I trust that it benefit all of us in the future, and make it more easier for us to transition into Joomla 4.