Writing /home/kusabax/domains/kusabax.org/public_html/wiki/data/cache/d/de4759ee23f3d96b3a58181a8e8f14c3.i failed
Unable to save cache file. Hint: disk full; file permissions; safe_mode setting.
Writing /home/kusabax/domains/kusabax.org/public_html/wiki/data/cache/d/de4759ee23f3d96b3a58181a8e8f14c3.metadata failed
Writing /home/kusabax/domains/kusabax.org/public_html/wiki/data/cache/d/de4759ee23f3d96b3a58181a8e8f14c3.i failed
Unable to save cache file. Hint: disk full; file permissions; safe_mode setting.
Writing /home/kusabax/domains/kusabax.org/public_html/wiki/data/cache/d/de4759ee23f3d96b3a58181a8e8f14c3.xhtml failed

Administration Guide

This guide will eventually cover everything in the menu of manage.php

Site Administration

Add Announcement

Announcements are shown to all staff when they log in. They can be an easy way to communicate what needs to be done.

Posting a new Announcement
  1. In the subject field, type a subject for the announcement.
  2. In the big text box, type what you want it to say. HTML is allowed.
  3. Click Add.
  4. Your announcement should now show up.
Editing an existing Announcement
  1. On the main announcement page, scroll down until you see the list of announcements.
  2. Find the announcement that you would like to change, and click the 'Edit' link to the right of it.
  3. Change what you want to change.
  4. Click 'Edit'
  5. Your modifications should now be done.
Delete an existing Announcement
  1. On the main announcement page, scroll down until you see the list of announcements.
  2. Find the announcement that you would like to change, and click the 'Delete' link to the right of it.
  3. A pop up should appear, asking if you are sure you want to delete it. Click 'Yes.'
  4. The announcement should now be deleted.

News is shown to all users when they come to your site. It can be used to communicate things like updates, staff changes, etc. It works exactly the same as the announcements.

FAQ & Rules

One thing that Kusaba X adds is an easier way to add FAQ and Rules entries. Instead of reading from a static HTML file like vanilla Kusaba, Kusaba X reads the entries from a MySQL database. They both work the same as the announcements do.


The blotter appears on the top of every board. It can be used as a way to communicate urgent announcements that might be missed on the home page.

Adding a Blotter Entry
  1. Go to the Blotter page

Disk Space Used

Disk space used simply tells you how much disk space each board, and the boards as a total use.


  1. Navigate to the Staff section of manage.php
  2. To add a new staff member, use the forms at the top of the page
    1. Username is the name that the staff member will log in with
    2. Password is the password that the staff member will have
    3. Type is the type of staff member they will be:
      1. Administrator means they will have full access to every function on the manage page.
      2. Moderator is a step down from administrator. Moderators can delete posts and ban IPs and md5 hashes, as well as sticky or lock threads, and modpost.
      3. Janitors are a step down from mods. They can delete posts but not ban users.
    4. Once you have added a staff member, you should probably edit them to allow them to moderate boards.
  3. To edit a staff member, click the 'edit' link on the same row as their name in the staff list.
  4. To delete a staff member, click the 'x' link on the same row as their name in the staff list.


The modlog is a quick and easy way to see the recent activity that your staff has done.

Ban Proxy List

The Ban Proxy List page allows you to upload a .txt file containing IPs of known proxies. A list of Tor proxies is located here: http://www.torproxylist.com/plain.php

SQL Query

The SQL Query page allows you to query your database. That's pretty much all there is to it.


The cleanup page goes through your database, and looks for things that should not be there. Examples are orphan replies (Replies that belonged to a deleted thread), unused images, and posts that were deleted over a week ago.

Boards Administration

Add Board

Delete Board

Word Filter

Move Thread

Search Posts

View Deleted Thread

Edit Filetypes

Edit Embeds

Edit Sections

Rebuild all HTML files


Board Options

Manage Stickies

Manage Locked Threads

Delete Thread/Post


View Reports

View/Add/Remove Bans

Delete All Posts By IP

Recently Uploaded Images

Managing Boards

  1. To add a board, navigate to the Add Board section of manage.php
    1. Directory is the place that the board will be inside of your kusaba root directory, ie: for ”/b/” you would put “b” (without quotes). Do not put slashes or other non-alphanumeric characters in this field
    2. Description is the name of the board, ie: For /b/ you would put “Random” (without quotes).
    3. First post ID is the number that the first post will have.
  2. To delete a board, navigate to the Delete Board section of manage.php.
    1. Select the Directory of the board you want to delete from the drop-down box
    2. Click the delete button.
  3. To edit the options on a particular board, navigate to the Board Options section of manage.php
    1. Select which board you plan to edit from the drop-down box and click the Go button.
    2. After changing options, select the Update button at the bottom of the page


  1. Navigate to the News section of manage.php
  2. To add a news post, fill out the forms at the top of the page (making sure to add proper html) and click “add”
  3. To edit or delete an existing news post, click the relevant link in the Edit/Delete column in the news list

Bans and Deletions

  1. Log in to manage.php
  2. Now, when browsing boards (that you moderate), you will see D & B links next to each post (If you have javascript enabled). Clicking the D will delete the post, while clicking the B will bring you to the ban page to ban the poster. Clicking the & will delete the post and bring you to the ban page to ban the poster.
  3. You can also navigate to the Delete Thread/Post section of manage.php and type in the thread or post ID there.
  4. On the ban page, there are many options:
    1. IP: Put the IP or IP range here.
    2. Allow Read: Whether or not to allow the poster to continue reading the boards while banned. (Your httpd must support .htaccess for no-read bans)
    3. Type: Whether the ban is a single IP or an IP range ban
    4. Boards: Which boards to ban the poster from
    5. Seconds: How many seconds to ban the poster for. You can use the quick links next to the field to quickly fill in preset amounts of time (You must have Javascript enabled).
    6. Reason: The reason you are banning the poster. HTML is not escaped.
    7. Add Ban: Click this when you are done filling out the fields
  5. Also on the ban page is the ban list:
    1. The first 15 bans of each type are always displayed. To display all the bans, select “Display all bans” from the bottom of the list.
    2. To delete a ban, Select the x next to it.
  6. Another way to delete and ban posts, particularly useful in a flood situation is MultiDelBan™
    1. Navigate to a board. (be sure you are logged in)
    2. Select the Checkboxes next to the posts you wish to delete (or delete and ban)
    3. Scroll to the bottom of the page
    4. If you wish to ban the users that posted the selected posts, select the ban checkbox and fill out a reason. Be warned, these will be permanent bans from all boards.
    5. Click the MultiDelBan button to delete/ban all posts/users.

Stickies and Locked Threads

Stickies are threads which remain at the top of the first page of a board automatically. They will not expire or be bumped off the page unless a moderator or administrator deletes them. To sticky a thread, you can either modpost in it with the right flags, or you can navigate to the manage stickies section of manage.php:

  1. Navigate to the Manage Stickies section of manage.php.
  2. Select which board you want to sticky the thread from with the drop-down box.
  3. Type in the Thread ID that you want to sticky.
  4. Click Sticky

Locked threads are threads which cannot be replied to except by staff members. To lock a thread you can either modpost in it with the correct flags, or you can navigate to the Manage Locked Threads section of manage.php

  1. To manage locked threads, repeat the above but navigate instead to the Locked Threads section.


Wordfilters are things which filter the messages which are posted on your boards. For instance, you could wordfilter “moo” to “baa”, and every instance of moo in posters's messages would be changed to baa.

  1. To manage wordfilters, navigate to the Wordfilter section of manage.php
    1. To add a wordfilter, type the word you want replaced in the Word field
    2. Type the word you want it to be replaced with in the Replaced By field
    3. Select which boards you want this wordfilter to filter messages on.
      1. The “Is Regex” Checkbox is an advanced feature to allow for highly customized wordfilters
        1. It uses the preg_replace() function of php, so check php.net for proper syntax
          1. Using Regex wordfilters can be dangerous, and may render it impossible to post on your site. Be careful when activating these filters
      2. To delete or edit a wordfilter, select the “edit” or “delete” links in the list of wordfilters.

Misc. Administrative Tools

  1. Posting Rates
    1. This will show you the number of threads, replies, and total posts made by your users on each of your boards in the past hour.
  2. Check for new version
    1. This will show your version of kusaba, as well as the most recent version of kusaba available on www.kusaba.org.
  3. Disk space used
    1. Currently Broken
  4. View Deleted Thread
    1. Currently Broken
  5. Cleanup
    1. Deletes images in board directories which are not used
  6. Search Posts
    1. Currently Broken
  7. Modlog
    1. Allows you to view previous actions done by staff.
  8. Edit Filetypes
    1. Allows you to add nonstandard filetypes for users to upload to imageboards.
  9. Edit Sections
    1. Allows you to edit the sections used for menu.php (the navigation menu)
  10. SQL Query
    1. Allows you to execute a mysql query from the kusaba manage page
  11. Ban proxy list
    1. Allows you to upload a list of proxies and automatically bans them
  12. Rebuild all HTML files
    1. Rebuilds the cached html piles
    2. Useful to use after changing board options or upgrading kusaba to refresh boards
  13. APC
    1. Allows you to view the Alternative PHP Cache statistics
  14. Module settings
    1. Allows you to change the settings of individual module settings-
administration_guide.txt · Last modified: 2008/11/12 16:01 by harrison
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki