Skip to content

phase/Blargboard

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
css
 
 
 
 
 
 
img
 
 
js
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Blargboard

Board software written in PHP. Uses MySQL for storage.

This is a modified version of StapleButter's original Blargboard. StapleButter gave up on the project, and I'm just making edits to it.

Blargboard is based off ABXD. ABXD is made by Dirbaio, Nina, GlitchMr & co, and was originally Kawa's project. ABXD is also dead.

This board follows the Acmlmboard concept. If you don't know Acmlmboard, you don't know what you're missing.


Requirements

Blargboard requires PHP 5.3/7.0.

There is no exact requirement for MySQL, but make sure to have a recent version.

Your host must allow external PHP connections from cURL for IP checking, Gist/Pastebin tags, and other things.

Everything else is provided in the package.


How to install and use

PHP and MySQL knowledge isn't required to use Blargboard but is a plus.

Installing MySQL

Install a MySQL server through your package manager. You should create a root user and password. Remember these.

sudo apt install mysql-server

Create a database for Blargboard to use.

phase$ mysql -u root -p
Enter password:
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 7
Server version: 5.7.12-0ubuntu1 (Ubuntu)

Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> CREATE DATABASE blargboard;
Query OK, 1 row affected (0.01 sec)

mysql> exit
Bye

Installing the board

Browse to your board's install.php (http://my.board.for.example/install.php) and follow the instructions.

If everything went fine, browse to your freshly installed board and configure it. If not, let us know.

We recommend you take some time and make your own board themes and banner to give your board a truly unique feel. If you have HTML knowledge, you can even edit the templates to change your board's look more in-depth.

DO NOT TRY USING THE PROVIDED PLUGINS. They haven't be adapted to the newer Blargboard codebase yet. Some may work, but others may break parts of your board.


How to update your board

Download the most recent Blargboard package (be it an official release or a Git package).

Copy the files over your existing board's files.

Make sure to not overwrite/delete the config directory, especially config/salt.php! Lose that one and you'll have fun resetting everyone's passwords. Everything else is safe to overwrite. Be careful to not lose any changes you have made, though.

Once that is done, run update.php (http://my.board.for.example/update.php) to update the board's database structure.

Depending on the versions, your update may involve running extra scripts to fix certain things. Make sure to follow those instructions.

Updating from Blargboard 1.0 isn't covered.


Features

  • Flexible permission system
  • Plugin system
  • Templates (in the works, about 80% done)
  • URL rewriting, enables human-readable forum and thread URLs for public content (requires code editing to enable it as of now)
  • Post layouts
  • more Acmlmboard feel
  • typical messageboard features

Coders and such, who like to hack new features in their software, may think that the use of templates in Blargboard gets in their way. Well uh, can't please everybody. I tried to do my best at separating logic and presentation. Besides, the use of templates actually makes the code nicer. Just look at the first few revisions and see how much duplicate logic is powering the mobile layout, for example. Templates allowed to get rid of all that madness.

As of now, there are no official releases for this, and the ABXD database installer hasn't been adapted to Blargboard's database structure yet. Thus, when updating your Blargboard copy, you need to check for changes to database.sql and modify your database's structure accordingly.


Board owner's tips

http://board.example/?page=makelr -> regenerates the L/R tree used for forum listings and such. Use if some of your forums are showing up in wrong places.

http://board.example/?page=editperms&gid=X -> edit permissions for group ID X.

http://board.example/?page=secgroups -> assign secondary groups to a user.

How to add groups: add to the usergroups table via PMA

  • type: 0 for primary groups, 1 for secondary
  • display: 0 for normal group, 1 for group listed as staff, -1 for hidden group
  • rank: a user may not mess with users of higher ranks no matter his permissions

How to add/remove secondary groups to someone: add to/remove from the secondarygroups table via PMA (or use ?page=secgroups for adding)

  • userid: the user's ID
  • groupid: the group's ID. Do not use the ID of a primary group!

WARNING: when banning someone, make sure that the secondary groups' permissions won't override the banned group's permissions. If that happens, you'll need to delete the secondarygroups assignments for the user.

How to (insert action): first look into your board's admin panel, settings panel, etc... then if you still can't find, ask us. But please don't be a noob and ask us about every little thing.


TODO List

  • redirect pages (ex.com/user/1 => ex.com/?page=user)
  • improve the permission editing interfaces
  • merge/split threads a la phpBB (albeit without the shitty interface)
  • support multiple password hashing methods? (for importing from other board softwares, or for those who feel SHA256 with per-user salt isn't enough) (kinda addressed via login plugins)
  • download page
  • new badges
  • new icons
  • low priority: change/remove file headers? most of the original files still say 'AcmlmBoard XD'

Blargboard is provided as-is, with no guarantee that it'll be useful or even work. I'm not responsible if it explodes in your face. Use that thing at your own risk.


Have fun.

blarg

About

Edits to a board software from the 60s.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published