Rust webserver for embeddable comments
Go to file
Pascal Engélibert 5deba2fdb1
Api & JS client
2023-01-11 22:56:32 +01:00
client Api & JS client 2023-01-11 22:56:32 +01:00
locales feat: edit approval 2022-12-29 22:46:21 +01:00
src Api & JS client 2023-01-11 22:56:32 +01:00
templates feat: edit approval 2022-12-29 22:46:21 +01:00
.gitignore Initial commit 2022-10-15 15:32:57 +02:00
Cargo.lock Api & JS client 2023-01-11 22:56:32 +01:00
Cargo.toml Api & JS client 2023-01-11 22:56:32 +01:00
LICENSE Initial commit 2022-10-15 15:32:57 +02:00
README.md started implementing API 2023-01-08 01:26:33 +01:00
rustfmt.toml Initial commit 2022-10-15 15:32:57 +02:00

README.md

webcomment

Rust webserver for comments, that you can easily embed in a website.

Early development, not safe for production yet (see milestones)

Features

  • List and post comments by topic (e.g. each article in your blog is a topic)
  • Admin approval
  • Admin notification on new comment via Matrix
  • Embedded one-file webserver
  • Customizable Tera templates
  • Comment frequency limit per IP
  • i18n
  • Petnames! (anonymous comment authors get a funny random name)
  • Designed for privacy and moderation

Use

webcomment init

# This adds an admin password to the config (password are hashed)
webcomment psw

# edit ~/.config/webcomment/config.toml

webcomment start

Each topic is accessible at /t/<topic_name>.

Admin login is accessible at /admin. Once authenticated, you can see the pending comments on the topic pages.

Matrix

If enabled, a message can be sent to a Matrix room (private or public) on every new comment.

The account must have joined the room for Webcomment to be able to send messages to it.

Moderation

New comments are not public before being approved by the administrator (by default).

Privacy

Uses no cookie, no unique user identifier. At each mutation (i.e. new comment or edition), the client IP address is stored for a limited duration (configurable) only for antispam to work. (antispam can be disabled) The client IP address is also stored for each pending comment, but it is removed as soon as the comment gets approved.

However, keep in mind that if a reverse proxy (or any other intermediate tool) is used, IP addresses and other metadata may be logged somewhere.

API

/api/post_comment /api/comments_by_topic /api/edit_comment /api/remove_comment /api/get_comment /api/admin/approve_comment /api/admin/remove_comment

License

CopyLeft 2022-2023 Pascal Engélibert (why copyleft?)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.