CLASS="CHAPTER" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" >

Chapter 4. Back end structure: administrator view

Table of Contents
The administration functions
The Preferences Page

The administration page is reached by calling the page admin.php (www.yoursite.com/admin.php) and carrying out the login procedure inserting your user and password. (Remember that the normal users should not login from the page admin.php but from the appropriate module).

Once logged in, the administrator finds an interface that lists all the areas which can be acted upon (see Figure 4-1). If the administrator is a superadmin, he may work on all the areas of the site, if instead he is an administrator with limited powers he will see the links relative to the areas on which he is allowed to work. Through the preferences configuration we will be able to decide whether to display icons or just a textual interface. According to our choice either a textual or an icon administration interface will appear. Figure 4-1 shows the interface with the icons, as you can see.

Figure 4-1. Administration panel

Administration panel

Remember that when you write new administration modules you must also create the corresponding icon, otherwise, when in visual administration mode, only the textual link corresponding to your module will appear and you won't be able to click it.

In order to set up the graphical administration mode you must go to the preferences section and set up in "graphical options" the "graphical menu in administration" option to "yes".

The administration functions

Function "add article":

It is the function that adds a new article to the News module. The options offered are many and will be analyzed here for one (see Figure 4-2):

Function "Backup DB":

It is the function that allows us to create a backup file that contains both structure and content of the PHP-Nuke database. This is very useful in case our data gets lost. Once we click on "Backup DB", we will have to wait for the server to create the file. Waiting time varies from a few seconds to some minutes in the case of a large database. Once created, we will be asked to download the file. Remember to keep your backup in a safe place!

Function "Blocks":

It's a very important function because it allows us to control the left and right columns of our portal. The scheme is presented with a list of the blocks that we have created, we can then activate, deactivate or edit them changing their position and order and assigning them permissions. We can in fact decide if a block should be visible by all, only by the registered users, or only the administrator. We can also make the block visible only in a specific language.

Please note: This info is also present in Chapter 8

The PHP-Nuke blocks can be of 3 different types:

In order to create a new block that will be added to the list of available blocks, we must scroll down the page and position ourselves on "add block".

The title field is a common element for all and will be compiled in.

Remember that before publishing a block a preview will be shown to us.

Content Manager:

This function allowes us to add new categories and new content inside the content section. It is very similar to the articles but with less functions. A noteworthy feature is the possibility to add the tag

<! -- pagebreak -- > 

in order to create a multipage article.

Downloads:

It creates categories, subcategories and adds files to the download area. For security reasons, the system does not allow file uploads via HTTP, only their linking through their HTTP address. If for example the file files.zip is found in the directory files of our site, we would have to link it as www.oursite.com/files/file.zip. This allows us to link external resources also.

Edit Administrators:

Enables us to add new administrators, defining their access levels. Besides having a super administrator it is in fact possible to activate only partial functions for the various administrators.

Edit Users:

From here it is possible to manually add new users and to modify existing ones, choosing their profile by typing the nickname in the appropriate form.

Encyclopedia:

Allows the creation of multiple word lists (choosing also the language), after having created an encyclopedia we can proceed to the insertion of terms.

Ephemerids:

Allows the insertion of recurrent events choosing the date and inserting a description.

FAQ:

Allows the creation of the main FAQ categories and all related questions/answers.

Splatt Forum:

The management of the forum is divided in 4 areas:

HTTP Referrers:

It displays the origin of the last accesses to the site.

Messages:

It creates a central block in the Home Page in order to send selective messages to the users. The messages can be sent to only registered users, to non-registered users, to the administrator or one may carry out a selection by language.

Modules:

Allows the management of the modules installed. The modules can be activated, deactivated or be assigned read permissions. A module can be world-readable, readable only by the registered users, or only the administrator.

Newsletter:

the PHP-Nuke administrator can send a newsletter to the registered users who have consented to receive them or send them to all the registered users. Attention to spam!

Optimize DB:

Optimizes the data increasing database speed.

Preferences:

This subject will be treated in the Section called The Preferences Page.

Book Reviews:

It allows us to insert book reviews. In every book review it is possible to cast a vote, a link relative to the subject and finally an image that represents the content.

Section Manager:

it manages the sections and contents thereof. It is possible to associate an image to the section subject, just as it is in the topics. It is possible to add articles to the sections selecting the aproppriate category through a radio button, to divide long texts using the <! -- pagebreak -- > tag and to edit or cancel already added sections.

Articles:

Manages articles inserted by third parties. It is the moderation area of the News module that we have already analyzed in this section.

Survey/Polls:

Creates a new survey for the site, edits or cancels old ones. It is possible to insert up to 10 different answers to every survey. In the context of the creation of the survey it is possible, on the same page, to publish a news article that announces its creation.

Topics:

Allows you to create new topics and the association, through a pop-up menu, of corresponding images.

Links:

Allows us to edit links published by others, create categories for archiving the links, eliminate links, see user messages informing us of any broken links through an interface very similar to the downloads section and add new links.

Logout/Exit:

Exits from the administration area rendering the cookie invalid. It is good practice to login logout after having finished working with PHP-Nuke. For security reasons.