Admin Functions

Table of Contents

goto :: Supasite Documentation > User's Guide

  1. Main
  2. Installation
  3. User's Guide
  4. Developer's Reference

News Functions

Add News

This is the form for adding the news posts. It's pretty self explanatory...

List News

Obviously, this will list all the news posts in the database, with simple little navigation arrows on it. Though all the posts will be shown, the edit/delete links will only show up if you have the proper privileges. Basically, if you made the post yourself or you are a super user, you will be able to modify it.

Edit News

This is a very similar form to the Add News form, but all the fields are already filled in. If you want to change the date/time codes, you must follow the strict format. Otherwise, the date/time for that post won't work. If you are a super user, you will also be able to change which user "owns" the post. Finally, you can modify the subject, topic, and actual post as you please.

Delete News

You are able to delete news posts, but only to ones you have the privileges to. It will ask you again to confirm the deletion, as nothing will bring the post back.

List Comments

If the post has comments underneath it, you can then view them. The only option available from here is deleting the comments. Again, you must have the proper privileges for that news post before you can delete comments for it.

Add Topics (super user only)

This is where the supasite admins can determine what topics are available, and where its icon is located. The topic_icon field must contain the full path to the icon image file. If you'd like an icon of a topic to show up instead of the topic name, use the %topic_icon% variable in the news template. A path here is all you need, the script will determine the image size and build the IMG tag for you.

List Topics

This lists all the topics, allowing admins to edit or delete them as they choose. Normal users will just see a list of topics.

Build Cache

If a news post or comment is added to the site and the option is turned on in Site Settings, the cached front page will be rebuilt. However, if you do something to modify the site's layout in any other way (such as modifying a template, changing a user's name, etc), use this option to build the cached file manually.

User Functions

Add User (super user only)

This is the basic add user form. You can assign a username, password, email address, and whether they have super user rights or not. Underneath, it shows a quick list of all the registered users on your system. By default, the install script will create one super user account.

List Users (super user only)

This spits out an alphabetic list of all the users on your system, with links to edit their profiles or delete the account altogether. These Edit/Delete functions work just like the Edit/Delete news functions, so I don't see a major need to rehash that.

Profile

Since super users can edit any user they want, the Profile function is mainly for the normal user to update their own info. Only super users can modify their privilege level as well (though, why a super user would want to revoke his/her own rights is beyond me).

Settings Functions

Site Settings

This form should look very familiar to you if you ran the install script. It allows you to set some of the most basic options for Supasite. Refer to the Installation page for more info on these options.

Meta Tag Settings

The purpose of these options is two fold: First, it allows you to set and display meta tags (%meta_tags% in the html template). Second, it sets the header for any XML files you build. This is all important if you want to give out more information about your site. It is not required, and you can turn this function off if you wish.

Template Settings

This is probably the most complex part of Supasite, and is more thoroughly explained in the Templates page. A template is simply an XML file that stores the HTML for the different parts of the site. The site is split into several sections, allowing you to tweak each one individually. The Template Info fields let you specify more information about the template if you wish to save and distribute your work.

At the top you should see two buttons: Load saved template (only if there are saved templates in the [include_path]/files directory) and Save template. This lets you switch among multiple templates quickly and easily. If you wish to save a template, first type a filename into the input field (without any extension, it appends '.xml' to the end for you). Click the button, and it will save it -- if you gave it a valid filename. It checks for illegal characters such as periods ('.'), slashes ('/'), or duplicate filenames to prevent you from overwriting a previously saved template.

Server Stats

On the left, this will give you some simple stats regarding the news. On the right are some common database queries you can run. Usually, these will only need to be run if there's an error in the database and you don't understand the schema. The server stats will fix common problems like: posts with an invalid ID, datetime, username, topic, or comment count.

Database Functions

Manage Modules

This is the basic module manager for Supasite. It lists all modules under the [include_path]/mods directory, displaying whether it's installed or not. From here you can install and uninstall modules as you please.

Backup

This lets you export the database to SQL for an easy restoral, and exports news to the TWML format for transfer to other CMS's

Restore

Here you can restore any SQL files into the database.