2.5.2. Configuring the blocks
From XOOPS Web Application System
Operation Manual Index
Lets have a look at the columns of the blocks table below these three menus.
Column Description Block Description Gives a short description of what the block displays. Title The actual title of the block. This is the title that will be displayed by the block on the pages where the block is visible. Module The module that produces the block, i.e.; that puts the information in the block. Side Left-Center-Right The position of the block. One of the 5 option buttons must be selected for each block. For an easier explanation, we will give a number to each option, as represented on the image below:
Option 1 will display the block at the left end of the page.
Options 2, 3 and 4 represent the central section of the page. If option 3 is selected, the block will be display across the complete width of the central section.
However, if option 2 or 4 is selected, the block will be display across the center left or at the center right. Selecting option 2 or 4 will result in a smaller block then selecting option 3, but it will allow two blocks to be displayed side by side in the central section.
Finally, selecting option 5 will display a block at the right end of the page.
If no blocks are displayed in the right section of the page, the central section will start at the end of the left section and will expand to the end of the page. However, if no block is displayed in the left section, it will not affect the width of the central section and the left section will just be blank. It is, of course, not recommended to leave the left section with no block.
Also, the blocks that are defined with option 3 will always be displayed before the blocks that are defined with options 2 and 4.
Weight The weight is the value used by XOOPS to sort the display order of blocks in a page. The sorting is done by section. This means that the weight of a block in the left section will not affect the order of a block in the right section. The normal page is divided into four sections; The top panel, or banner.
The left hand section, or main navigation bar.
The centre panel, or main page content.
The right panel, or second navigation bar.
The general principle is the following: the higher the number, the lower the block will be. It is indeed exactly like weight in real life: heavier things go down faster. It is useful to input your block weight in 5 or 10 increments. This allows for inserting items later without needing to change other weights.
Visible For a block to be displayed, it has to have its visible property set to Yes. Action This column will be blank if the block cannot be modified. If it can, the word Edit will appear, on which one could click to edit certain parameters of the block. If the block is a Custom block, the Action column will also have the word Delete to permanently delete the block.
Table 2.4. Block Administration