Gosora is an ultra-fast and secure forum software written in Go that balances usability with functionality.
Go to file
Azareal e47450d372 Added the theme system.
You can now switch between themes in the Control Panel.
The Alternate Post Layout teased in various screenshots and bits of inaccessible code is now the Tempra Conflux theme, while the original post layout is the Tempa Simple theme.
Dramatically increased the speed at which the static files are served.
Added a benchmark for static files.
Eliminated the name parameter in various custom page structs.
Added the TopicsPage struct for the /topics/ route.
Added the ForumPage struct for the /forum/{id} route.
Added the ForumsPage struct for the /forums/ route.
The static file route now serves 404s when a file doesn't exist instead of nearly crashing the server.
Reduced the number of unnecessary allocations on some of the routes.
Added gradients to Tempra Conflux.
Added position: sticky; to the userinfo blocks in Tempra Conflux.
Added a notice on the generated template files.
2017-01-01 15:45:43 +00:00
experimental Added the theme system. 2017-01-01 15:45:43 +00:00
extend Added the plugin system. 2016-12-11 16:06:17 +00:00
images Added the theme system. 2017-01-01 15:45:43 +00:00
old-images Added the User Editor. 2016-12-23 12:35:22 +00:00
pages Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
public Added the theme system. 2017-01-01 15:45:43 +00:00
templates Added the theme system. 2017-01-01 15:45:43 +00:00
themes Added the theme system. 2017-01-01 15:45:43 +00:00
uploads Added the profile system. 2016-12-07 09:34:09 +00:00
.gitignore Added the profile system. 2016-12-07 09:34:09 +00:00
LICENSE Adding the files. 2016-12-02 07:38:54 +00:00
README.md Added an alternate topic layout. This might serve as the foundation of a second theme. You'll be able to switch between the two with ease once the theme system is in. 2016-12-26 04:44:07 +00:00
build.bat Added the forum cache. The rest of the code now uses it instead than firing queries on every request. 2016-12-06 10:26:48 +00:00
config.go Added the Group Permissions system. 2016-12-21 02:30:32 +00:00
data.sql Added the theme system. 2017-01-01 15:45:43 +00:00
errors.go Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
extend.go Added the theme system. 2017-01-01 15:45:43 +00:00
files.go Static files are now served from memory. This feature's a little experimental, so it will need a lot of testing i.i 2016-12-05 07:21:17 +00:00
forum.go Added the theme system. 2017-01-01 15:45:43 +00:00
general_test.go Added the theme system. 2017-01-01 15:45:43 +00:00
gosora-linux Added the plugin system. 2016-12-11 16:06:17 +00:00
gosora.exe Added the theme system. 2017-01-01 15:45:43 +00:00
group.go Added the theme system. 2017-01-01 15:45:43 +00:00
main.go Added the theme system. 2017-01-01 15:45:43 +00:00
mod_routes.go Added the theme system. 2017-01-01 15:45:43 +00:00
mysql.go Added the theme system. 2017-01-01 15:45:43 +00:00
pages.go Added the theme system. 2017-01-01 15:45:43 +00:00
plugin_helloworld.go Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
plugin_markdown.go Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
plugin_skeleton.go Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
reply.go Added the plugin system. 2016-12-11 16:06:17 +00:00
router.go Added the User Editor. 2016-12-23 12:35:22 +00:00
routes.go Added the theme system. 2017-01-01 15:45:43 +00:00
run.bat Added the plugin system. 2016-12-11 16:06:17 +00:00
setting.go Added the User Editor. 2016-12-23 12:35:22 +00:00
template_forum.go Added the theme system. 2017-01-01 15:45:43 +00:00
template_forums.go Added the theme system. 2017-01-01 15:45:43 +00:00
template_profile.go Added the theme system. 2017-01-01 15:45:43 +00:00
template_topic.go Added the theme system. 2017-01-01 15:45:43 +00:00
template_topic_alt.go Added the theme system. 2017-01-01 15:45:43 +00:00
template_topics.go Added the theme system. 2017-01-01 15:45:43 +00:00
templates.go Added the theme system. 2017-01-01 15:45:43 +00:00
templates_old.go Added the User Editor. 2016-12-23 12:35:22 +00:00
themes.go Added the theme system. 2017-01-01 15:45:43 +00:00
todo Adding the files. 2016-12-02 07:38:54 +00:00
topic.go Added URL tags & the settings system. 2016-12-09 13:46:29 +00:00
user.go Added the User Editor. 2016-12-23 12:35:22 +00:00
utils.go Static files are now served from memory. This feature's a little experimental, so it will need a lot of testing i.i 2016-12-05 07:21:17 +00:00

README.md

Gosora

A super fast forum software written in Go.

The initial code-base was forked from one of my side projects, but has now gone far beyond that.

Discord Server: https://discord.gg/eyYvtTf

Features

Basic Forum Functionality

Custom Pages. Under development.

Emojis

In-memory static file, forum and group caches.

A profile system including profile comments and moderation tools for the profile owner.

A template engine which compiles templates down into machine code. Over ten times faster than html/templates. Compatible with templates written for html/templates, you don't need to learn any new templating language.

A plugin system. Under development.

A responsive design. Looks good on mobile phones, tablets, laptops, desktops and more!

Dependencies

Go 1.7. The programming language this program is written in, and the compiler which it requires. You will need to install this. https://golang.org/doc/install

MySQL Database. You will need to setup a MySQL Database somewhere. A MariaDB Database works equally well, and is much faster than MySQL. If you're curious about how to install this, you might want to try the WNMP or XAMPP bundles on Windows. Instructions on how to do so on Linux: https://downloads.mariadb.org/mariadb/repositories/

Installation Instructions

Run the following commands:

go get github.com/go-sql-driver/mysql

go install github.com/go-sql-driver/mysql

go get golang.org/x/crypto/bcrypt

go install golang.org/x/crypto/bcrypt

Tweak the config.go file and put your database details in there. Import data.sql into the same database. Comment out the first line (put /* and */ around it), if you've already made a database, and don't want the script to generate it for you.

Set the password column of your user account in the database to what you want your password to be. The system will encrypt your password when you login for the first time.

Add -u after go get to update those libraries, if you've already got them installed.

Run the program

Linux

cd to the directory / folder the code is in.

go build

./gosora

Windows

Open up cmd.exe

cd to the directory / folder the code is in. E.g. cd /Users/Blah/Documents/gosora

go build

./gosora.exe

Alternatively, you could run the run.bat batch file on Windows.

We're also looking into ways to distribute ready made executables for Windows. While this is not a complicated endeavour, the configuration settings currently get built with the rest of the program for speed, and we will likely have to change this.

With the introduction of the new settings system, we will begin moving some of the less critical settings out of the configuration file, and will likely have a config.xml or config.ini in the future to store the critical settings in.

You might have to go build, run the executable, and then go build and then run the executable again to make sure the templates are compiled properly. We'll be resolving this issue while we roll out the new compiled templates system to the rest of the routes.

Several important features for saving memory in the templates system may have to be implemented before the new compiled template system is rolled out to every route. These features are coming fairly soon, but not before the other more high priority items.

How do I install plugins?

For the default plugins like Markdown and Helloworld, you can find them in the Plugin Manager of your Control Panel. For ones which aren't included by default, you will need to drag them from your /extend/ directory and into the / directory (the root directory of your Gosora installation, where the executable and most of the main Go files are).

You will then need to recompile Gosora in order to link the plugin code with Gosora's code. For plugins not written in Gosora (e.g. JavaScript), you do not need to move them from the /extend/ directory, they will automatically show up in your Control Panel ready to be installed.

Experimental plugins aka the ones in the /experimental/ folder (e.g. plugin_sendmail) are similar but different. You will have to move native plugins (ones written in Go) to the root directory of your installation and will have to move experimental plugins written in other languages into the /extend/ directory.

We're looking for ways to clean-up the plugin system so that all of them (except the experimental ones) are housed in /extend/, however we've encountered some problems with Go's packaging system. We plan to fix this issue in the future.

TO-DO

Oh my, you caught me right at the start of this project. There's nothing to see here yet, asides from the absolute basics. You might want to look again later!

More moderation features.

Add a simple anti-spam measure.

Add an alert system.

Add per-forum permissions to finish up the foundations of the permissions system.

Add a better plugin system. E.g. Allow for plugins written in Javascript and ones written in Go. Also, we need to add many, many, many more plugin hooks.

Implement a faster router.

Add a friend system.

Add more administration features.

Add more features for improving user engagement.

Add a widget system.