Akif9748/akf-forum
Akif9748
/
akf-forum
mirror of https://github.com/Akif9748/akf-forum.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A Node.js based forum software
405 Commits 1 Branch 103 Tags 3.1 MiB
JavaScript 59.4%
EJS 31.5%
CSS 9.1%
Go to file
Akif9748 aace4c6fd4 5.6.0 2023-08-25 13:46:04 +03:00
src Added `me` support for ID's 2023-08-25 13:45:55 +03:00
util better folder system 2023-05-25 17:47:54 +03:00
.env.example better discord auth 2023-05-25 17:58:47 +03:00
.eslintrc.json better discord auth 2023-05-25 17:58:47 +03:00
.gitignore fix for cropper 2023-05-26 19:06:02 +03:00
APIDOCS.md Added edit config to web 2022-10-09 22:57:46 +03:00
LICENSE Server side license 2022-08-28 15:45:19 +03:00
README.md Update README.md 2023-08-22 22:42:45 +03:00
config.json.example Delete -forum from forum name 2023-05-26 19:55:45 +03:00
package-lock.json 5.6.0 2023-08-25 13:46:04 +03:00
package.json 5.6.0 2023-08-25 13:46:04 +03:00

README.md

akf-forum

A Node.js based forum software.

Installation

  • Clone or download this repo.
  • Run npm i to install dependencies.
  • Enter your database credentials in .env.
  • Run npm start for run it.
  • Go /setup page for setup your forum.

Extra (If you are not use setup page)

Run node util/reset to reset the database for duplicate key errors, and run node util/admin for give admin perms to first member. Edit config.json for default theme for users, forum name, meta description, character limits, discord auth enabler, global ratelimit etc.

How to install theme:

  • Copy your theme to src/themes folder. Additional note for themes: If a theme has not got any .ejs file, it will use default theme's .ejs files. default theme is in themes folder, named as common.

DISCORD AUTH:

"discord_auth": true in config.json. Add your app secret and app id to .env as DISCORD_SECRET and DISCORD_ID. Create a redirect url in discord developer portal: https://forum_url.com/auth/discord

EMAIL AUTH:

You can configure it. Just edit config.json and .env files. "email_auth": true, "default_user_state": "APPROVAL" in config.json. Add your email credentials to .env as EMAIL_USER and EMAIL_PASS. Add your email domain to .env as EMAIL_SERVICE.

API

Akf-forum has got an API for AJAX (fetch), other clients etc. And, you can learn about API in APIDOCS.md.

And you can use offical API wrapper.

Credits

  • Akif9748 - Project mainteiner, main developer, made old frontend
  • Tokmak - Made new frontend
  • Camroku - Made old stylesheets

Screenshot

Thread Page w/Bootstrap theme

image

TO-DO list

Add used modules etc like: cropper:

https://github.com/akashgiricse/Online-Forum

Backend:

Feature:

  • Profile Message or DM
  • Upload other photos, model for it
  • Edit & download template
  • Banner
  • Add @me support for ids, <%= member.id %>
  • Roles & Permissions
role: "moderator",
permissions: ["see_deleted_message"]

Fixes:

  • Admin deleting other admins.
  • send public to common/public

ETC:

  • Rewrite apidocs
  • Add a feature list to README.md
  • add used open source libraries to README.md

Frontend

Features:

  • change category name
  • Add approval threads page.
  • add support for trans around gravatar and upload photo
  • old contents / titles add to forum interface
  • who liked a message
  • add ban button to user profile

Fixes:

  • BETTER SETUP PAGE: use setup everytime
  • add threads, messages etc. to extra folder
  • add category to thread list page
  • working reset button
  • better pagination
  • text alling center body
  • thread.js unfuction only listener

We used:

https://github.com/akashgiricse/Online-Forum for bootstrap theme.

Major Version History

  • V5: Enchanted Themes
  • V4: Caching
  • V3: New Theme
  • V2: Backend fix, mongoose is fixed. Really big fix.
  • V1: Mongoose added.
  • V0: Birth with quick.db