Gosora is an ultra-fast and secure forum software written in Go that balances usability with functionality.
Go to file
Azareal 93d00b0337 The Advanced Forum Editor is now accessible via the Forum Manager.
Renamed data.sql to mysql.sql
Added a composite primary key to the forums_permissions table.
Moved five more queries to the query generator.
Revamped the query generator. Yesterday's commit was more of a prototype. Still lots to be done to facilitate all the queries.
Added support for simple left joins to the query generator.
Removed .smaller
Fixed an issue with the permissions not saving with the Advanced Forum Editor.

Remind me to keep all generators away from Atom.
2017-06-06 09:47:33 +01:00
experimental Added a custom router which is twice as fast as the old one. 2017-01-03 07:47:31 +00:00
extend Added the plugin system. 2016-12-11 16:06:17 +00:00
images Happy 100th commit! For the 100th commit, I've revamped a good portion of the user interface, and we don't plan on stopping! There's more to come! 2017-05-29 15:52:37 +01:00
install The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
old-images Updated some of the images. More images and work on the theme to come! 2017-05-14 06:56:19 +01:00
pages Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
public The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
query_gen The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
router_gen Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
templates Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
themes The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
uploads Added the profile system. 2016-12-07 09:34:09 +00:00
.gitignore Router Generator WIP 2017-04-12 11:10:36 +01:00
.htaccess Happy 100th commit! For the 100th commit, I've revamped a good portion of the user interface, and we don't plan on stopping! There's more to come! 2017-05-29 15:52:37 +01:00
LICENSE Adding the files. 2016-12-02 07:38:54 +00:00
README.md Happy 100th commit! For the 100th commit, I've revamped a good portion of the user interface, and we don't plan on stopping! There's more to come! 2017-05-29 15:52:37 +01:00
TODO.md Added a custom auto-link parser rather than using a regex. 2017-03-07 07:22:29 +00:00
build-gosora-linux Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
build-gosora-linux-nowebsockets Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
build-nowebsockets.bat Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
build.bat Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
cache.go Topic and user edits should now update the caches. Ditto for topic deletions. 2017-02-15 10:49:30 +00:00
config.go Added the Control Panel Dashboard. 2017-05-07 09:31:41 +01:00
errors.go I'm still working on alerts. I've worked out the client-side UI for Cosmo, the UI will be tweaked for the other themes shortly. The client-side JS also now pulls the alerts from the server. 2017-03-01 11:36:50 +00:00
extend.go The Control Panel is now in the generated routes list. 2017-04-13 16:01:30 +01:00
files.go Added the Control Panel Dashboard. 2017-05-07 09:31:41 +01:00
forum.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
gen_mysql.go The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
gen_router.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
general_test.go Gosora now uses the generated router. There's still a fair bit of work to be done on this, I might turn the switch into a proper parser at some point, as there are a few inefficiencies in it's design. 2017-04-13 10:26:40 +01:00
group.go Happy 100th commit! For the 100th commit, I've revamped a good portion of the user interface, and we don't plan on stopping! There's more to come! 2017-05-29 15:52:37 +01:00
install-gosora-linux Added support for Websockets. 2017-05-11 14:04:43 +01:00
install.bat Added support for Websockets. 2017-05-11 14:04:43 +01:00
last_version.txt Revamped the top navbar. 2017-05-12 14:25:12 +01:00
main.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
mod_routes.go Added support for Websockets. 2017-05-11 14:04:43 +01:00
mysql.go The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
mysql.sql The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
no_websockets.go Added support for Websockets. 2017-05-11 14:04:43 +01:00
pages.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
panel_routes.go The Advanced Forum Editor is now accessible via the Forum Manager. 2017-06-06 09:47:33 +01:00
permissions.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
phrases.go Router Generator WIP 2017-04-12 11:10:36 +01:00
plugin_bbcode.go Happy 100th commit! For the 100th commit, I've revamped a good portion of the user interface, and we don't plan on stopping! There's more to come! 2017-05-29 15:52:37 +01:00
plugin_helloworld.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
plugin_markdown.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
plugin_skeleton.go Added the BBCode plugin. 2017-01-05 14:41:14 +00:00
reply.go Added the lock and unlock moderation action posts. 2017-04-02 14:00:40 +01:00
router.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
routes.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
run-gosora-linux Added pagination for forums. 2017-01-26 13:37:50 +00:00
run-gosora-linux-nowebsockets Added support for Websockets. 2017-05-11 14:04:43 +01:00
run-nowebsockets.bat Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
run.bat Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
setting.go Added the Control Panel Dashboard. 2017-05-07 09:31:41 +01:00
template_forum.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
template_forums.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
template_list.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
template_profile.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
template_topic.go Added the lock and unlock moderation action posts. 2017-04-02 14:00:40 +01:00
template_topic_alt.go Improved the mobile theme for Tempra Mobile. I broke something in the process of doing so, but it shouldn't take too long to make right! 2017-05-13 15:27:42 +01:00
template_topics.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
templates.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
themes.go Happy 100th commit! For the 100th commit, I've revamped a good portion of the user interface, and we don't plan on stopping! There's more to come! 2017-05-29 15:52:37 +01:00
topic.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
update-deps-linux Added support for Websockets. 2017-05-11 14:04:43 +01:00
update-deps.bat Added support for Websockets. 2017-05-11 14:04:43 +01:00
user.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
utils.go Added the query generator. It's a work in progress and in constant flux. 2017-06-05 12:57:27 +01:00
websockets.go Revamped the top navbar. 2017-05-12 14:25:12 +01: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. We're still fairly early in development, so the code-base might change at an incredible rate. We plan to start stabilising it somewhat once we enter alpha.

Azareal's Discord Chat: https://discord.gg/eyYvtTf

If you like this software, please give it a star and give us some feedback :)

If you dislike it, please give us some feedback on how to make it better! We're always looking for feedback. We love hearing your opinions. If there's something missing or something doesn't look quite right, don't worry! We plan to change many things before the alpha!

Features

Basic Forum Functionality. All of the little things you would expect of any forum software. E.g. Moderation, Custom Themes, Avatars, and so on.

Custom Pages. Under development. The Control Panel portion is incomplete, but you can create them by hand today. They're basically html/templates templates in the /pages/ folder.

Emojis. Allow your users to express themselves without resorting to serving tons upon tons of image files.

In-memory static file, forum and group caches. We're pondering over extending this solution over to topics, users, etc.

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. More on this to come.

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

Other modern features like alerts, advanced dashboard, etc.

Dependencies

Go 1.8 - You will need to install this. Pick the .msi, if you want everything sorted out for you rather than having to go around updating the environment settings. 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. You could use something like WNMP / XAMPP which have a little PHP script called PhpMyAdmin for managing MySQL databases or you could install MariaDB directly.

Download the .msi installer from MariaDB and run that. You may want to set it up as a service to avoid running it every-time the computer starts up.

Instructions on how to set MariaDB up on Linux: https://downloads.mariadb.org/mariadb/repositories/

We recommend changing the root password (that is the password for the user 'root'). Remember that password, you will need it for the installation process. Of course, we would advise using a user other than root for maximum security, although that adds additional steps to the process of getting everything setup.

It's entirely possible that your host might already have MySQL, so you might be able to skip this step, particularly if it's a managed VPS or a shared host (contrary to popular belief, it is possible, although the ecosystem in this regard is extremely immature). Or they might have a quicker and easier method of setting up MySQL.

Installation Instructions

Linux

cd to the directory / folder the code is in. In other words, type cd followed by the location of the code and it should jump there.

Run ./install-gosora-linux

Follow the instructions shown on the screen.

Windows

Run install.bat

Follow the instructions shown on the screen.

Run the program

Linux

In the same directory you installed it, you simply have to type: ./run-gosora-linux

Windows

Run run.bat

Updating Dependencies

You can update the dependencies which Gosora relies on by running update-deps.bat on Windows or ./update-deps-linux on Linux. These dependencies do not include Go or MySQL.

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 run run.bat or ./run-gosora-linux twice after changing a template to make sure the templates are compiled properly. We'll be resolving this issue while rolling 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 higher 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.

Images

Tempra Simple Theme

Tempra Simple Topic List

Tempra Simple Mobile

Tempra Cursive Theme

Tempra Conflux Theme

Tempra Conflux Mobile

Tempra Conflux Mobile

Cosmo Conflux Theme

Cosmo Theme

Dependencies

  • Go 1.8

  • MariaDB (or any other MySQL compatible database engine)

  • github.com/go-sql-driver/mysql For interfacing with MariaDB.

  • golang.org/x/crypto/bcrypt For hashing passwords.

  • github.com/shirou/gopsutil For pulling information on CPU and memory usage.

    • github.com/StackExchange/wmi Dependency for gopsutil on Windows.
  • github.com/gorilla/websocket Needed for Gosora's Optional WebSockets Module.

Bundled Plugins

There are several plugins which are bundled with the software by default. These cover various common tasks which aren't common enough to clutter the core with or which have competing implementation methods (E.g. plugin_markdown vs plugin_bbcode for post mark-up).

  • Hello World / Skeleton - Example plugins for helping you learn how to develop plugins.

  • BBCode - A plugin in early development for converting BBCode Tags into HTML.

  • Markdown - An extremely simple plugin for converting Markdown into HTML.

Developers

There are a few things you'll need to know before running the more developer oriented features like the tests or the benchmarks.

The benchmarks are currently being rewritten as they're currently extremely serial which can lead to severe slow-downs when run on a home computer due to the benchmarks being run on the one core everything else is being run on (Browser, OS, etc.) and the tests not taking parallelism into account.