XOOPS Operations Guide
  • Introduction
  • GENERAL PRINCIPLES
    • The XOOPS Core
    • Modules
    • Blocks
    • Users and Groups
    • Content
    • Language Files
    • Themes and Templates
  • The Admin Interface
    • Logging
      • As Site Administrator
      • As Registered User
      • Incorrect Login Procedure
      • Logging Out
    • Control panel home
      • Some preliminaries before we get started in the admin area
        • JavaScript
        • Cache
    • Working with the new Admin GUI (en/book/our Dashboard)
      • Help Functions
    • Avatars
      • Adding avatars
      • Edit and delete Avatars
      • System Avatars
      • Custom Avatars
    • Banners
      • What are they?
      • Current active banners
      • Add new banner
      • Editing banners
      • Finished banners
      • Advertising clients
      • Add new client
    • Blocks
      • Overview
      • Editing/Configuring a block
      • Adding custom blocks
      • Cloning a block
    • Comments
      • Overview
      • Manage comments
    • Groups Overview
      • The different sets of rights
      • Edit members of this group
      • Creating a new group
    • Image Manager
      • Adding image categories
      • Editing and deleting images and categories
      • Adding image files through the control panel
      • Accessing the image manager from the user side
    • Mail Users
    • Maintenance
    • Modules
      • Acquiring a module
        • Module origins
        • Ancillary files
        • Copyrights and GPL notices
      • Uploading the module
        • Preparing the module files for upload to a remote server
        • Using FTP or browser file uploader
        • Upload the module package
        • Setting file/directory permissions
      • Installing the module
      • Setting module visibility and menu order
      • Configuring module settings and options
        • Renaming module
        • Display and position options for the module
      • Setting user access rights for a module
    • Preferences
      • General Settings
      • User Info Settings
      • Meta Tags and Footer
      • Word Censoring Options
      • Search Options
      • Mail Setup
      • Authentication Options
      • System Module Settings
    • Smilies
      • Using smilies
      • Adding and editing smilies
    • Templates
      • The default template set
      • Cloning and downloading template sets
      • Editing templates
      • Uploading a new template set
    • User Ranks
    • Users Management
    • Feedback
  • About XOOPS CMS
Powered by GitBook
On this page
  1. The Admin Interface
  2. Blocks

Editing/Configuring a block

PreviousOverviewNextAdding custom blocks

Last updated 6 years ago

Each block provided by XOOPS or its modules has three options:

Icon

Function

Visible on/off

Edit

Clone

When we click on the “Edit” icon, this will display the detail properties of the block and allow editing of some of these:

Here are the properties and their descriptions:

Field

Description

Name

This is the name of the block. It cannot be modified here.

Block Type

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; 1-The top panel, or banner. 2- The left hand section, or main navigation bar. 3- The centre panel, or main page content 4- 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’.

Visible in

This property sets the pages where the block will be displayed. In addition to all the modules, the combo box items have ‘Top Page’ and ‘All Pages’. The ‘Top Page’ will display the block only in the top page; the ‘All Pages’ will display the block in every page of the site. Selecting multiple, non-consecutive pages is possible by holding “Ctrl” on keyboard.

Title

This is the title that will be displayed in the webpage for the block.

Content

If this is a Custom Block that you’ve added, you can enter the content here (e.g. HTML or PHP code), otherwise you’ll have a link to the Template Manager where you can modify the template.

Options

Many blocks have options that can be set to fully customize the block. As the options are different for each block, we will not detail each one of them here.

Cache lifetime

Cache lifetime is a useful feature for making a site run faster. If a block has fixed content that is unlikely to change on a regular basis, it is possible to instruct the browser to call the content from cache, rather than from the server. This is particularly effective if graphics are part of the content. Use the settings here to determine how long this content should be held in cache before returning to server fed data.

Groups

Select which groups you want this block to be visible for

Table 2: Block Editing

In Custom Blocks you have also a Delete option:

The position of the block. One of the eight ‘options’ must be selected for each block. For an easier explanation you can see the image below: Figure 12 Blocks Position 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 “Center Block Center” will always be displayed before the blocks that are defined with options “Center Block Left” and “Center Block Right”.

img_54.jpg
img_54.jpg
img_54.jpg
img_54.jpg
img_54.jpg
img_54.jpg
img_54.jpg
img_54.jpg