Skip to content

019 Adding Site Views to a Component

Amigo edited this page Jun 20, 2019 · 10 revisions

ADDING SITE VIEWS TO A COMPONENT

Using Sermon Distributor As Example

Let's look at adding admin views and site views to component builder's component. We will look at the different switches and the features installed for you. First, login. Open component builder under component builder, then go to components. 00:00:25

Settings - Views

Open Sermon Distributor and go to settings. There you'll see a place for admin views. (We already illustrated adding the admin views.) There's custom admin views and site views. Click on add custom admin view. There aren't any added to the component; sermon distributor does not have custom admin views. 00:01:01

Adding Site Views Important Glitch

Then site views. It has quite a few. You might open it and see some of the buttons are not selected. Although you selected and saved it previously it doesn't show. This is a glitch in Joomla's own JavaScript. 00:01:25 Re-open. (For now admin view has the same issue.) Close and open it again, and it will all be selected. Keep a look out for this; if you make changes and save it with those buttons unchecked, it will not include those values since it will be stored as null and you might get unexpected results. 00:01:56 Unfortunately this is not something I can change at the stage.

Site View Options(Menu-Metadata-Default View-Access)

Go to site view. 00:02:21 Close it and open it again. Everything is selected. It has four options. Select the site views and add as many as you like.

  • Menu

Add menu means that this site view will be added to the add menu aspect of Joomla. 00:02:46 Go to create menu and to add menu item. There is a select Type; if you click on it there is list articles, etc. If you say yes you'll create an XML file which allows Joomla to notice that your component needs to be in the list. 00:03:12

  • Metadata

Add metadata means that this page will make use of the metadata being passed to it. Usually this means that in your model where you've set up your data, a metadata is in the 'items' array or in the 'this' array by the global setting or via the actual item. 00:03:47 If you set yes here, and did not set up the data in the in the model correctly, it won't work. Click yes here. (See video.) Try your best to set up the data in the model, then compile and look in the view .html.php file to see how it grabs the meta data. It will still add the script needed to load the metadata into the document. If it doesn't grab it correctly, you'd see it too. 00:04:22

  • Default View

You can only have one default view. (Don't click more than one.). The default view is effective so that when you make a change and the system doesn't know where you want to go it throws you back to the default view. 00:04:53 Default view can either be your site default view being home page or, if you are in this component, on preachers, for example.

  • Access

Let's say some of these views you set don't have public user or access, for example, to sermon. If you try to access the page, the system throws you back to the default view, and gives a message that you don't have access. That's what the default view is primarily used for at the moment. It can become more useful as we continue to improve Component Builder. 00:05:37

Add access makes sure that a user has certain access rights. In an item you can set the access rights and the view rights. It has multiple implementations. One is access groups, the other is groups. If you want access on this specific view to be monitored, tick that and Component Builder will ensure the access table is there. 00:06:10

After creating the site view this is how you can add it. Check it and see how it works. 00:06:32

Clone this wiki locally