blubbizmb/wwwconf

Exported from https://code.google.com/archive/p/wwwconf/ for the further development.

wwwconf - fast engine for tree-structured forums (boards).

Exported from https://code.google.com/archive/p/wwwconf/ for the further development.

License: GNU GPL v3.

Main goals:

• Fast rendering of all pages.
• Minimal list of dependencies and low footprint (resource usage).
• Compatibility with "special" clients - it must work even without JS and it shouldn't behave badly under such conditions.
• Unicode characters shouldn't be able to break things and should be supported as much as possible.

Disclaimer: this is a legacy software written in C with random bits in C++. Most of the development was focused on premature optimizations. Code quality was (and still is) quite low. You've been warned.

Building from source.

Due to bad usage of C types currently only 32-bit little-endian platforms are supported.

Other requirements: Make, C++ compiler (both GCC and Clang are tested) and UNIX-like environment. Native Win32 support didn't worth the efforts to support it and was dropped long ago, use Cygwin or similar libraries if you really need it.

For 32-bit Debian (and its derivatives) you should install libc6-dev and g++, clang is also a good choice. For 64-bit Debian you'd need libc6-dev-i386 (or libc6-dev:i386 if you've added i386 architecture) and g++-multilib or clang.

I hope you've got the idea in case you are using one of the other OSes. Now you can just run make and get two binaries:

• dbtool - CLI tool for operations with the custom DB.
• index.cgi - forum engine itself, it requires CGI-compliant HTTP server.

Testing and running.

As it was already mentioned, CGI-compliant HTTP server is required. You can choose Nginx + uwsgi (or fcgi-wrap), Lighttpd, Boa, etc...

Here's a simple way to get started (don't forget to install uwsgi-core):

# create initial database
./dbtool -n
# (optional step) create user 'Admin' with password 'AdminPass':
./dbtool -aa Admin AdminPass
# run single uwsgi worker (no master process) in CGI mode, bind it to port 7542.
uwsgi-core --plugins http,cgi --http-socket :7542 --cgi . --cgi-allowed-ext .cgi --http-socket-modifier1 9 --check-static static

Then you can go to http://127.0.0.1:7542/index.cgi to see a working board.