Gosora is an ultra-fast and secure forum software written in Go that balances usability with functionality.
Go to file
Azareal 381ce3083a 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.
Refactored the code to use switches instead of if blocks in some places.
Refactored the Dashboard to make it easier to add icons to it like I did with Cosora.
You can now use maps in transpiled templates.
Made progress on Cosora's footer.
Swapped out the ThemeName property in the HeaderVars struct for a more general and flexible Theme property.
Added the colstack CSS class to make it easier to style the layouts for the Control Panel and profile.
Renamed the FStore variable to Forums.
Renamed the Fpstore variable to FPStore.
Renamed the Gstore variable to Groups.
Split the MemoryTopicStore into DefaultTopicStore and MemoryTopicCache.
Split the MemoryUserStore into DefaultUserStore and MemoryUserCache.
Removed the NullUserStore, SQLUserStore, and SQLTopicStore.
Added the NullTopicCache and NullUserCache.
Moved the Reload method out of the TopicCache interface and into the TopicStore one.
Moved the Reload method out of the UserCache interface and into the UserStore one.
Added the SetCache and GetCache methods to the TopicStore and UserStore.
Added the BypassGetAll method to the WordFilterMap type.
Renamed routePanelSetting to routePanelSettingEdit.
Renamed routePanelSettingEdit to routePanelSettingEditSubmit.
Moved the page titles into the english language pack.
Split main() into main and afterDBInit to avoid code duplication in general_test.go
Added the ReqIsJson method so that we don't have to sniff the headers every time.
Added the LogStore interface.
Added the SQLModLogStore and the SQLAdminLogStore.
Refactored the phrase system to use getPhrasePlaceholder instead of hard-coding the string to return in a bunch of functions.
Removed a redundant rank check.
Added the GuildStore to plugin_guilds.
Added the about_segment_title and about_segment_body settings.
Refactored the setting system to use predefined errors to make it easier for an upstream caller to filter out sensitive error messages as opposed to safe errors.
Added the BypassGetAll method to the SettingMap type.
Added the Update method to the SettingMap type.
BulkGet is now exposed via the MemoryUserCache.
Refactored more logs in the template transpiler to reduce the amount of indentation.
Refactored the tests to take up fewer lines.
Further improved the Cosora theme's colours, padding, and profiles.
Added styling for the Control Panel Dashboard to the Cosora Theme.
Reduced the amount of code duplication in the installer query generator and opened the door to certain types of auto-migrations.
Refactored the Control Panel Dashboard to reduce the amount of code duplication.
Refactored the modlog route to reduce the amount of code duplication and string concatenation.
2017-11-23 05:37:08 +00: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
common 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
experimental Added Quick Topic. 2017-10-05 11:20:28 +01:00
extend 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
images More work on Cosora, we have a screenshot of it up now, although it's super experimental at the moment. 2017-10-30 09:57:08 +00:00
install 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
langs 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
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 Removed the images for Cosmo from /images/, it's very saddening to see it go :( 2017-09-22 03:21:17 +01:00
pages Added the ability to compile templates down to Pure Go code. 2016-12-16 10:37:42 +00:00
public Did a bit of refactoring on the template system. 2017-11-06 16:24:45 +00:00
query_gen 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
router_gen 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
schema 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
templates 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
themes 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
uploads Added the profile system. 2016-12-07 09:34:09 +00:00
.codebeatignore Added the Rez Image Resizer as a dependency to be used later. 2017-11-10 00:16:15 +00:00
.eslintrc.json Mostly a mid-way technical commit to make reading diffs easier on me. 2017-10-14 08:39:22 +01:00
.gitignore Added Quick Topic. 2017-10-05 11:20:28 +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
.travis.yml Hmmm, maybe this? 2017-10-31 00:53:00 +00:00
LICENSE Adding the files. 2016-12-02 07:38:54 +00:00
README.md 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
TODO.md Added a custom auto-link parser rather than using a regex. 2017-03-07 07:22:29 +00:00
alerts.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
build-linux Added support for desktop notifications. 2017-08-17 12:13:49 +01:00
build-linux-nowebsockets Added support for desktop notifications. 2017-08-17 12:13:49 +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
config.go Converted more queries over to the new OO builder syntax. 2017-11-12 03:29:05 +00:00
database.go 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
gen_mssql.go 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
gen_mysql.go 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
gen_pgsql.go 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
gen_router.go 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
gen_tables.go More work on Cosora, we have a screenshot of it up now, although it's super experimental at the moment. 2017-10-30 09:57:08 +00:00
general_test.go 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
install-linux Added the Rez Image Resizer as a dependency to be used later. 2017-11-10 00:16:15 +00:00
install.bat Added the Rez Image Resizer as a dependency to be used later. 2017-11-10 00:16:15 +00:00
last_version.txt Revamped the top navbar. 2017-05-12 14:25:12 +01:00
main.go 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
member_routes.go 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
misc_test.go 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
mod_routes.go 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
mssql.go I've revamped the query generator to reduce the number of globals, this'll help us split up the software and plugins in the future. 2017-11-05 09:55:34 +00:00
mysql.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
no_websockets.go Revamped Tempra Conflux. 2017-09-13 16:09:13 +01:00
panel_routes.go 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
pgsql.go Renamed a few querygen structs. 2017-11-12 05:25:04 +00:00
plugin_bbcode.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
plugin_guilds.go 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
plugin_heythere.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
plugin_markdown.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
plugin_skeleton.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
plugin_test.go Did a bit of refactoring on the template system. 2017-11-06 16:24:45 +00:00
rev_templates.go Moved the create statement into the TopicStore. 2017-11-07 22:38:15 +00:00
router.go Finished moving the files into the subpackage, this should open more doors to us. 2017-11-11 04:06:16 +00:00
routes.go 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
run-linux Added support for desktop notifications. 2017-08-17 12:13:49 +01:00
run-linux-nowebsockets Added support for desktop notifications. 2017-08-17 12:13:49 +01:00
run-linux-tests Hmmm, maybe this? 2017-10-31 00:53:00 +00: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 Replaced most of the uses of fmt with log. 2017-08-13 12:22:34 +01:00
run_mssql.bat Mostly a mid-way technical commit to make reading diffs easier on me. 2017-10-14 08:39:22 +01:00
run_tests.bat Continued the work on Cosora. 2017-10-21 01:27:47 +01:00
run_tests_mssql.bat Continued the work on Cosora. 2017-10-21 01:27:47 +01:00
template_forum.go 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
template_forums.go 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
template_guilds_guild_list.go 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
template_list.go 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
template_profile.go 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
template_topic.go 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
template_topic_alt.go 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
template_topics.go 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
update-deps-linux Added the Rez Image Resizer as a dependency to be used later. 2017-11-10 00:16:15 +00:00
update-deps.bat Added the Rez Image Resizer as a dependency to be used later. 2017-11-10 00:16:15 +00:00
websockets.go 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

README.md

Gosora 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're still fairly early in development, so the code-base might change at an incredible rate. We plan to stop making as many breaking changes once we release the first alpha.

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. Common Moderation features, modlogs, theme system, avatars, bbcode parser, markdown parser, report system, per-forum permissions, group permissions 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 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 thirty times faster than html/templates, although it does remove some of the hand holding to achieve this. 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, likes, advanced dashboard with live stats (CPU, RAM, online user count, and so on), etc.

Dependencies

Go 1.9 - 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.

Advanced Installation

An example of running the commands directly on Windows.

Linux is similar, however you might need to use cd and mv a bit more like in the shell files due to the differences in go build across platforms. Additionally, Linux doesn't require StackExchange/wmi or ``/x/sys/windows`

git clone https://github.com/Azareal/Gosora

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

go get -u golang.org/x/crypto/bcrypt

go get -u github.com/StackExchange/wmi

go get -u github.com/Azareal/gopsutil

go get -u github.com/gorilla/websocket

go get -u gopkg.in/sourcemap.v1

go get -u github.com/robertkrimen/otto

go get -u github.com/lib/pq

go get -u github.com/denisenkom/go-mssqldb


go generate

go build ./router_gen

router_gen.exe

go build ./query_gen

query_gen.exe

go build -o gosora.exe

go build ./install

install.exe

gosora.exe

I'm looking into minimising the number of go gets for the advanced build and to maybe remove the platform and database engine specific dependencies if possible for those who don't need them.

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

Shadow Theme

Shadow Quick Topic

Tempra Simple Theme

Tempra Simple Topic List

Tempra Simple Mobile

Tempra Cursive Theme

Tempra Conflux Theme

Tempra Conflux Mobile

Cosora Prototype WIP

More images in the /images/ folder. Beware though, some of them are really outdated.

Dependencies

  • Go 1.9

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

  • 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/go-ego/riot A search engine library.

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