Gosora is an ultra-fast and secure forum software written in Go that balances usability with functionality.
Go to file
Azareal 52c8be4173 Variables which are computed multiple times in templates should only be computed once now.
Enabled the Watchdog Goroutine.
Moved a couple of parser tests into their own file.
Eliminated the hard-coded URLs in TestParser()
Refactored the alert system so that a specific actor is only loaded once rather than once for each alert. This isn't a problem in practice due to the user cache, but it might be on high traffic sites.
Don't run HandleServerSync() on single server setups.
Don't load the user in GetTopicUser(), if the topic creator is the current user.
Fixed a bug in the template generator where endloop nodes were being pushed instead of endif ones.
2018-11-22 17:21:43 +10:00
.vscode Refactored the code to follow best standards better. 2017-09-03 05:50:31 +01:00
attachs Added Quick Topic. 2017-10-05 11:20:28 +01:00
backups You can now search for whatever IP you want in the IP Searcher. 2017-09-23 20:57:13 +01:00
cmd Up the default cache capacity. 2018-11-22 15:36:11 +10:00
common Variables which are computed multiple times in templates should only be computed once now. 2018-11-22 17:21:43 +10:00
config Up the default cache capacity. 2018-11-22 15:36:11 +10:00
docs Action posts can now be localised. 2018-10-27 14:55:53 +10:00
experimental Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00
extend Trying to reduce the amount of UserCheck() boilerplate in the routes. 2018-11-12 19:23:36 +10:00
images Pin Docker to 1.10 not the patch version, otherwise things could go horribly wrong. 2018-08-11 22:09:26 +10:00
install We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
langs Action posts can now be localised. 2018-10-27 14:55:53 +10:00
logs You can now disable slugs. 2018-04-03 05:34:07 +01:00
migrations Added the AboutSegment feature, you can see this in use on Cosora, it's a little raw right now, but I'm planning to polish it in the next commit. 2017-11-23 05:37:08 +00:00
old-images Start phasing out Tempra Conflux. 2018-07-30 12:51:22 +10:00
pages Made some minor tweaks. 2017-12-22 03:32:23 +00:00
patcher Fixed the patcher. 2018-10-27 13:55:02 +10:00
public Localised more alert strings. 2018-10-06 23:14:11 +10:00
query_gen We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
router_gen The time it took for the route to be processed is shown in the footer in the Nox Theme for admins now 2018-11-17 12:36:02 +10:00
routes Variables which are computed multiple times in templates should only be computed once now. 2018-11-22 17:21:43 +10:00
schema We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
templates The time it took for the route to be processed is shown in the footer in the Nox Theme for admins now 2018-11-17 12:36:02 +10:00
themes Rewrote the template generator to make it more flexible and easier to debug. 2018-11-18 15:28:27 +10:00
tmpl_client Solve the chicken and the egg problem with the templates. 2018-05-16 21:44:32 +10:00
updater Let's use proper Git for updates for now as Go Git refuses to work properly. 2018-04-04 12:25:34 +01:00
uploads Added the profile system. 2016-12-07 09:34:09 +00:00
.codebeatignore Updated the codebeat and codeclimate config files. 2018-01-21 11:17:43 +00:00
.codeclimate.yml UNSTABLE: Began work on the Nox Theme. 2018-05-27 19:36:35 +10:00
.eslintrc.json Added the init.js file to make certain bits of JS run sooner than others. 2018-08-13 20:34:00 +10:00
.gitignore We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10: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
.travis.yml No point in running tests for Go 1.10 now. 2018-10-27 14:19:18 +10:00
CONTRIBUTING.md Moved the last control panel theme manager route into /routes/panel/ 2018-10-02 14:09:17 +10:00
LICENSE Adding the files. 2016-12-02 07:38:54 +00:00
README.md We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
TODO.md Added a custom auto-link parser rather than using a regex. 2017-03-07 07:22:29 +00:00
build-linux We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
build-linux-nowebsockets We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
build-nowebsockets.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
build.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
build_templates.bat Fixed a bug where it would use the wrong templates for Tempra Simple, Tempra Cursive, and Shadow 2018-03-31 06:25:27 +01:00
database.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
dev-update-linux Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00
dev-update-travis The patcher (schema updating part of the updater) finally works, yay. 2018-04-23 22:08:31 +01:00
dev-update.bat Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00
gen_mssql.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
gen_mysql.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
gen_pgsql.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
gen_router.go The time it took for the route to be processed is shown in the footer in the Nox Theme for admins now 2018-11-17 12:36:02 +10:00
gen_tables.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
general_test.go Greatly reduced the number of w.Write calls in the generated templates. 2018-11-20 09:06:15 +10:00
go.mod We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
go.sum We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
gosora_example.service Update the installation instructions with something a little more hardened. 2018-08-22 21:02:14 +10:00
install-docker We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
install-linux Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00
install.bat Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00
last_version.txt Revamped the top navbar. 2017-05-12 14:25:12 +01:00
main.go Variables which are computed multiple times in templates should only be computed once now. 2018-11-22 17:21:43 +10:00
misc_test.go Variables which are computed multiple times in templates should only be computed once now. 2018-11-22 17:21:43 +10:00
mssql.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
mysql.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
parser_test.go Variables which are computed multiple times in templates should only be computed once now. 2018-11-22 17:21:43 +10:00
pgsql.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
plugin_adventure.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
plugin_bbcode.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
plugin_heythere.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
plugin_markdown.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
plugin_skeleton.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
plugin_test.go Refactored the plugin system to use a hook table. This should help to reduce the probability of data races and strange bugs, as-well as helping to abstract certain details, so future changes are less likely to break things. 2018-10-21 23:54:32 +10:00
pre-run-linux We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
quick-update-linux Added quick-update-linux to fix a few potential issues with running under the gosora user. 2018-08-23 08:12:19 +10:00
rev_templates.go Moved the create statement into the TopicStore. 2017-11-07 22:38:15 +00:00
router.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
routes.go Variables which are computed multiple times in templates should only be computed once now. 2018-11-22 17:21:43 +10:00
run-linux We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
run-linux-nowebsockets We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
run-linux-tests A simple test to see if Gosora builds with the MSSQL Tag. 2018-08-15 17:07:22 +10:00
run-nowebsockets.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
run.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
run_mssql.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
run_tests.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
run_tests_mssql.bat We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
tickloop.go We now use Go 1.11 modules. This should help with build times, deployment and development, although it does mean that the minimum requirement for Gosora has been bumped up from Go 1.10 to Go 1.11 2018-10-27 13:40:36 +10:00
tmpl_stub.go Solve the chicken and the egg problem with the templates. 2018-05-16 21:44:32 +10:00
update-deps-linux Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00
update-deps.bat Reduce the number of go gets and fix Travis. 2018-10-27 14:12:13 +10:00

README.md

Gosora Build Status Azareal's Discord Chat

A super fast forum software written in Go. You can talk to us on our Discord chat!

The initial code-base was forked from one of my side projects, but has now gone far beyond that. We've moved along in a development and the software should be somewhat stable for general use.

Features may break from time to time, however I will generally try to warn of the biggest offenders in advance, so that you can tread with caution around certain commits, the upcoming v0.1 will undergo even more rigorous testing.

File an issue or open a topic on the forum, if there's something you want and you very well might find it landing in the software fairly quickly.

For plugin and theme developers, things are a little dicier, as the internal APIs and ways of writing themes are in constant flux, however some stability in that area should be coming fairly soon.

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 add many, many things in the run up to v0.1!

Features

Standard Forum Functionality. All of the little things you would expect of any forum software. E.g. Common Moderation features, modlogs, theme system, avatars, bbcode parser, markdown parser, report system, per-forum permissions, group permissions and so on.

Custom Pages. There are some rough edges

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 have a slightly more dynamic cache for users and topics.

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

A template engine which compiles templates down to machine code. Over forty times faster than the standard template library html/templates, although it does remove some of the hand holding to achieve this. Compatible with templates written for html/templates, so you don't need to learn any new templating language.

A plugin system. We have a number of APIs and hooks for plugins, however they're currently subject to change and don't cover as much of the software as we'd like yet.

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

Other modern features like alerts, likes, advanced dashboard with live stats (CPU, RAM, online user count, and so on), etc.

Requirements

Go 1.11 or newer - 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

For Ubuntu, you can consult: https://tecadmin.net/install-go-on-ubuntu/ You will also want to run ln -s /usr/local/go/bin/go (replace /usr/local with where ever you put Go), so that go becomes visible to other users.

If you followed the instructions above, you can update to the latest version of Go simply by deleting the /go/ folder and replacing it with a /go/ folder for the latest version of Go.

Git - You may need this for downloading updates via the updater. You might already have this installed on your server, if the git commands don't work, then install this. https://git-scm.com/downloads

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.

You might also want to run mysql_secure_installation to further harden (aka make it more secure) MySQL / MariaDB.

If you're using Ubuntu, you might want to look at: https://www.itzgeek.com/how-tos/linux/ubuntu-how-tos/install-mariadb-on-ubuntu-16-04.html

It's entirely possible that your host already has MySQL installed and ready to go, so you might be able to skip this step, particularly if it's a managed VPS or a shared host. Or they might have a quicker and easier method of setting up MySQL.

How to download

For Linux, you can skip down to the Installation section as it covers this.

On Windows, you might want to try the GosoraBootstrapper, if you can't find the command prompt or otherwise can't follow those instructions. It's just a matter of double-clicking on the bat file there and it'll download the rest of the files for you.

Installation

Consult installation for instructions on how to install Gosora.

Updating

Consult updating for instructions on how to update Gosora.

Running the program

Linux

If you have setup a service, you can run:

./pre-run-linux

service gosora start

You can then, check Gosora's current status (to see if it started up properly) with:

service gosora status

And you can stop it with:

service gosora stop

If you haven't setup a service, you can run ./run-linux, although you will be responsible for finding a way to run it in the background, so that it doesn't close when the terminal does.

One method might be to use: https://serverfault.com/questions/34750/is-it-possible-to-detach-a-process-from-its-terminal-or-i-should-have-used-s

Windows

Run run.bat, e.g. double-clicking on it.

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 hope to fix this issue in the future.

Images

Shadow Theme

Shadow Quick Topic

Tempra Simple Theme

Tempra Simple Topic List

Tempra Simple Mobile

Cosora Prototype WIP

More images in the /images/ folder. Beware though, some of them are really outdated. Also, keep in mind that a new theme is in the works.

Dependencies

These are the libraries and pieces of software which Gosora relies on to function, an "ingredients" list so to speak.

A few of these like Rez aren't currently in use, but are things we think we'll need in the very near future and want to have those things ready, so that we can quickly slot them in.

  • Go 1.11+

  • MariaDB (or any other MySQL compatible database engine). We'll allow other database engines in the future.

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

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

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

  • github.com/Azareal/gopsutil For pulling information on CPU and memory usage. I've temporarily forked this, as we were having stability issues with the latest build.

    • github.com/StackExchange/wmi Dependency for gopsutil on Windows.

    • golang.org/x/sys/windows Also a dependency for gopsutil on Windows. This isn't needed at the moment, as I've rolled things back to an older more stable build.

  • github.com/gorilla/websocket Needed for Gosora's Optional WebSockets Module.

  • github.com/robertkrimen/otto Needed for the upcoming JS plugin type.

    • gopkg.in/sourcemap.v1 Dependency for Otto.
  • github.com/lib/pq For interfacing with PostgreSQL. You will be able to pick this instead of MariaDB soon.

  • ithub.com/denisenkom/go-mssqldb For interfacing with MSSQL. You will be able to pick this instead of MSSQL soon.

  • github.com/bamiaux/rez An image resizer (e.g. for spitting out thumbnails)

    • github.com/esimov/caire The other image resizer, slower but may be useful for covering cases Rez does not. A third faster one we might point to at some point is probably Discord's Lilliput, however it requires a C Compiler and we don't want to add that as a dependency at this time.
  • github.com/fsnotify/fsnotify A library for watching events on the file system.

  • github.com/pkg/errors Some helpers to make it easier for us to track down bugs.

  • More items to come here, our dependencies are going through a lot of changes, and I'll be documenting those soon ;)

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).

  • Hey There / Skeleton / Hey There (JS Version) - 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.

  • Social Groups - An extremely unstable WIP plugin which lets users create their own little discussion areas which they can administrate / moderate on their own.

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.