splent-feature-comments 0.1.0__tar.gz

splent_feature_comments-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+# Compiled frontend bundles
+recursive-include src/splent_io/splent_feature_comments/assets/dist *.js *.css *.map
+
+# Jinja templates (feature views + hook fragments)
+recursive-include src/splent_io/splent_feature_comments/templates *.html
+
+# Alembic migration config and scripts
+recursive-include src/splent_io/splent_feature_comments/migrations *.py *.ini *.mako

splent_feature_comments-0.1.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: splent_feature_comments
+Version: 0.1.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown

splent_feature_comments-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=80.3.1", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "splent_feature_comments"
+version = "0.1.0"
+readme = "README.md"
+requires-python = ">=3.13"
+
+dependencies = [
+
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["*.tests", "*.tests.*"]
+
+[tool.splent]
+cli_version = "1.11.0"
+
+# ── Feature Contract (auto-generated) ────────────────────────────────────────
+# Do not edit manually — re-run `splent feature:contract --write` to refresh.
+[tool.splent.contract]
+description = "comments feature"
+
+[tool.splent.contract.provides]
+routes     = ["/admin/comments", "/admin/comments/<int:comment_id>/approve", "/admin/comments/<int:comment_id>/delete", "/comments/<int:post_id>"]
+blueprints = []
+models     = ["Comment"]
+commands   = ["hello"]
+hooks      = ["layout.authenticated_sidebar", "post.comments"]
+services   = ["CommentsService"]
+signals    = ["comment-created", "comment-submitting"]
+translations = []
+docker     = []
+
+[tool.splent.contract.requires]
+features = []
+env_vars = []
+signals  = []
+
+[tool.splent.contract.extensible]
+services  = ["CommentsService"]
+templates = ["comments/admin/list.html", "comments/index.html", "comments/thread.html"]
+models    = ["Comment"]
+hooks     = ["layout.authenticated_sidebar", "post.comments"]
+routes    = false

splent_feature_comments-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

splent_feature_comments-0.1.0/src/splent_feature_comments.egg-info/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: splent_feature_comments
+Version: 0.1.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown

splent_feature_comments-0.1.0/src/splent_feature_comments.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+MANIFEST.in
+pyproject.toml
+src/splent_feature_comments.egg-info/PKG-INFO
+src/splent_feature_comments.egg-info/SOURCES.txt
+src/splent_feature_comments.egg-info/dependency_links.txt
+src/splent_feature_comments.egg-info/top_level.txt
+src/splent_io/splent_feature_comments/__init__.py
+src/splent_io/splent_feature_comments/commands.py
+src/splent_io/splent_feature_comments/config.py
+src/splent_io/splent_feature_comments/forms.py
+src/splent_io/splent_feature_comments/hooks.py
+src/splent_io/splent_feature_comments/models.py
+src/splent_io/splent_feature_comments/repositories.py
+src/splent_io/splent_feature_comments/routes.py
+src/splent_io/splent_feature_comments/seeders.py
+src/splent_io/splent_feature_comments/services.py
+src/splent_io/splent_feature_comments/signals.py
+src/splent_io/splent_feature_comments/assets/dist/splent_feature_comments.bundle.js
+src/splent_io/splent_feature_comments/assets/dist/splent_feature_comments.bundle.js.map
+src/splent_io/splent_feature_comments/migrations/alembic.ini
+src/splent_io/splent_feature_comments/migrations/env.py
+src/splent_io/splent_feature_comments/migrations/script.py.mako
+src/splent_io/splent_feature_comments/migrations/versions/comments0001_initial.py
+src/splent_io/splent_feature_comments/templates/comments/index.html
+src/splent_io/splent_feature_comments/templates/comments/thread.html
+src/splent_io/splent_feature_comments/templates/comments/admin/list.html

splent_feature_comments-0.1.0/src/splent_feature_comments.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

splent_feature_comments-0.1.0/src/splent_feature_comments.egg-info/top_level.txt

@@ -0,0 +1 @@
+splent_io

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/__init__.py

@@ -0,0 +1,19 @@
+from splent_framework.blueprints.base_blueprint import create_blueprint
+from splent_framework.services.service_locator import register_service
+
+from splent_io.splent_feature_comments.services import CommentsService
+
+comments_bp = create_blueprint(__name__)
+
+
+def init_feature(app):
+    from splent_framework.assets.asset_registry import register_asset
+
+    register_service(app, "CommentsService", CommentsService)
+    register_asset(
+        "css", "comments.assets", order=100, subfolder="css", filename="comments.css"
+    )
+
+
+def inject_context_vars(app):
+    return {}

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/assets/dist/splent_feature_comments.bundle.js

@@ -0,0 +1,20 @@
+/******/ (() => { // webpackBootstrap
+/*!*********************************************************************************************!*\
+  !*** ../splent_feature_comments/src/splent_io/splent_feature_comments/assets/js/scripts.js ***!
+  \*********************************************************************************************/
+// Entry point for splent_feature_comments frontend assets.
+// Add your JavaScript here. Webpack compiles this into assets/dist/splent_feature_comments.bundle.js
+//
+// To load the compiled bundle in the product layout, register it in hooks.py:
+//
+//   from splent_framework.hooks.template_hooks import register_template_hook
+//   from flask import url_for
+//
+//   def comments_scripts():
+//       return '<script src="' + url_for("comments.assets", subfolder="dist", filename="splent_feature_comments.bundle.js") + '"></script>'
+//
+//   register_template_hook("layout.scripts", comments_scripts)
+
+/******/ })()
+;
+//# sourceMappingURL=splent_feature_comments.bundle.js.map

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/assets/dist/splent_feature_comments.bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splent_feature_comments.bundle.js","mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","sources":["webpack://diversolab_app/../splent_feature_comments/src/splent_io/splent_feature_comments/assets/js/scripts.js"],"sourcesContent":["// Entry point for splent_feature_comments frontend assets.\n// Add your JavaScript here. Webpack compiles this into assets/dist/splent_feature_comments.bundle.js\n//\n// To load the compiled bundle in the product layout, register it in hooks.py:\n//\n//   from splent_framework.hooks.template_hooks import register_template_hook\n//   from flask import url_for\n//\n//   def comments_scripts():\n//       return '<script src=\"' + url_for(\"comments.assets\", subfolder=\"dist\", filename=\"splent_feature_comments.bundle.js\") + '\"></script>'\n//\n//   register_template_hook(\"layout.scripts\", comments_scripts)\n"],"names":[],"sourceRoot":""}

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/commands.py

@@ -0,0 +1,21 @@
+"""
+CLI commands contributed by splent_feature_comments.
+
+These commands are auto-discovered by the framework and exposed in the
+SPLENT CLI under the ``feature:comments`` group.
+
+Usage::
+
+    splent feature:comments hello
+"""
+
+import click
+
+
+@click.command("hello")
+def hello():
+    """Example command — replace with your own."""
+    click.echo("  Hello from splent_feature_comments!")
+
+
+cli_commands = [hello]

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/config.py

@@ -0,0 +1,19 @@
+"""
+comments feature configuration.
+
+Injects environment variables into Flask app.config.
+Add your feature's env vars here so the framework can track them.
+
+To regenerate from source code: splent feature:inject-config splent_feature_comments
+"""
+
+import os  # noqa: F401 — used when adding env vars below
+
+
+def inject_config(app):
+    app.config.update(
+        {
+            # Add your feature's env vars here, e.g.:
+            # "MY_VAR": os.getenv("MY_VAR", "default_value"),
+        }
+    )

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/forms.py

@@ -0,0 +1,6 @@
+from flask_wtf import FlaskForm
+from wtforms import SubmitField
+
+
+class SplentFeatureCommentsForm(FlaskForm):
+    submit = SubmitField("Save splent_feature_comments")

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/hooks.py

@@ -0,0 +1,38 @@
+from flask import render_template, request, url_for
+
+from splent_framework.hooks.template_hooks import register_template_hook
+from splent_framework.services.service_locator import service_proxy
+
+
+def post_comments(post):
+    """Rendered into the post detail through the 'post.comments' hook.
+
+    Receives the current post and renders the approved comments plus the
+    submission form (with a Turnstile widget if cloudflare is installed).
+    """
+    comments = service_proxy("CommentsService").approved_for(post.id)
+    return render_template("comments/thread.html", post=post, comments=comments)
+
+
+def comments_sidebar_link():
+    active = (
+        "active"
+        if request.endpoint and request.endpoint.startswith("comments.admin")
+        else ""
+    )
+    pending = 0
+    try:
+        pending = len(service_proxy("CommentsService").pending())
+    except Exception:
+        pass
+    badge = f' <span class="badge bg-danger">{pending}</span>' if pending else ""
+    return (
+        f'<li class="sidebar-item {active}">'
+        f'<a class="sidebar-link" href="{url_for("comments.admin_index")}">'
+        '<i class="align-middle" data-feather="message-square"></i> '
+        f'<span class="align-middle">Comments</span>{badge}</a></li>'
+    )
+
+
+register_template_hook("post.comments", post_comments)
+register_template_hook("layout.authenticated_sidebar", comments_sidebar_link)

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/migrations/alembic.ini

@@ -0,0 +1,36 @@
+[alembic]
+script_location = migrations
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/migrations/env.py

@@ -0,0 +1,9 @@
+"""Alembic migration environment for splent_feature_comments."""
+
+from splent_io.splent_feature_comments import models  # noqa
+from splent_framework.migrations.feature_env import run_feature_migrations
+
+FEATURE_NAME = "splent_feature_comments"
+FEATURE_TABLES = set()
+
+run_feature_migrations(FEATURE_NAME, FEATURE_TABLES)

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/migrations/script.py.mako

@@ -0,0 +1,24 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision = ${repr(up_revision)}
+down_revision = ${repr(down_revision)}
+branch_labels = ${repr(branch_labels)}
+depends_on = ${repr(depends_on)}
+
+
+def upgrade():
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade():
+    ${downgrades if downgrades else "pass"}

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/migrations/versions/comments0001_initial.py

@@ -0,0 +1,40 @@
+"""comment table.
+
+Revision ID: comments0001
+Revises:
+"""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "comments0001"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_table(
+        "comment",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("post_id", sa.Integer(), nullable=False),
+        sa.Column("author_name", sa.String(length=128), nullable=False),
+        sa.Column("author_email", sa.String(length=255), nullable=True),
+        sa.Column("content", sa.Text(), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("approved", sa.Boolean(), nullable=True),
+        sa.ForeignKeyConstraint(["post_id"], ["post.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_comment_post_id"), "comment", ["post_id"], unique=False)
+    op.create_index(
+        op.f("ix_comment_created_at"), "comment", ["created_at"], unique=False
+    )
+    op.create_index(op.f("ix_comment_approved"), "comment", ["approved"], unique=False)
+
+
+def downgrade():
+    op.drop_index(op.f("ix_comment_approved"), table_name="comment")
+    op.drop_index(op.f("ix_comment_created_at"), table_name="comment")
+    op.drop_index(op.f("ix_comment_post_id"), table_name="comment")
+    op.drop_table("comment")

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/models.py

@@ -0,0 +1,25 @@
+from datetime import datetime
+
+from splent_framework.db import db
+
+
+class Comment(db.Model):
+    """A comment on a post. New comments start unapproved (moderation)."""
+
+    __tablename__ = "comment"
+
+    id = db.Column(db.Integer, primary_key=True)
+    post_id = db.Column(
+        db.Integer,
+        db.ForeignKey("post.id", ondelete="CASCADE"),
+        nullable=False,
+        index=True,
+    )
+    author_name = db.Column(db.String(128), nullable=False)
+    author_email = db.Column(db.String(255), default="")
+    content = db.Column(db.Text, nullable=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow, index=True)
+    approved = db.Column(db.Boolean, default=False, index=True)
+
+    def __repr__(self):
+        return f"Comment<{self.id} on post {self.post_id}>"

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/repositories.py

@@ -0,0 +1,7 @@
+from splent_io.splent_feature_comments.models import Comment
+from splent_framework.repositories.BaseRepository import BaseRepository
+
+
+class CommentsRepository(BaseRepository):
+    def __init__(self):
+        super().__init__(Comment)

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/routes.py

@@ -0,0 +1,78 @@
+from flask import flash, redirect, render_template, request, url_for
+from flask_login import login_required
+
+from splent_io.splent_feature_comments import comments_bp
+from splent_io.splent_feature_comments.models import Comment
+from splent_io.splent_feature_comments.signals import (
+    comment_created,
+    comment_submitting,
+)
+from splent_framework.db import db
+from splent_framework.services.service_locator import service_proxy
+
+comments_service = service_proxy("CommentsService")
+
+
+# =====================================================================
+# PUBLIC — submit a comment (rendered into the post via the hook)
+# =====================================================================
+@comments_bp.route("/comments/<int:post_id>", methods=["POST"])
+def create(post_id):
+    # Let any listener (a captcha provider, a spam filter…) veto the submission.
+    # comments knows nothing about captchas — they connect to this signal.
+    results = comment_submitting.send(
+        None, post_id=post_id, form=request.form, remoteip=request.remote_addr
+    )
+    if any(value is False for _, value in results):
+        flash("Spam check failed — please try again.", "danger")
+        return redirect(request.referrer or url_for("post.index"))
+
+    name = (request.form.get("author_name") or "").strip()
+    content = (request.form.get("content") or "").strip()
+    if not (name and content):
+        flash("Name and comment are required.", "danger")
+        return redirect(request.referrer or url_for("post.index"))
+
+    comment = Comment(
+        post_id=post_id,
+        author_name=name,
+        author_email=(request.form.get("author_email") or "").strip(),
+        content=content,
+        approved=False,
+    )
+    db.session.add(comment)
+    db.session.commit()
+    comment_created.send(None, comment=comment)
+    flash("Your comment was submitted and is awaiting moderation.", "success")
+    return redirect(request.referrer or url_for("post.index"))
+
+
+# =====================================================================
+# ADMIN — moderation
+# =====================================================================
+@comments_bp.route("/admin/comments", methods=["GET"])
+@login_required
+def admin_index():
+    return render_template(
+        "comments/admin/list.html", comments=comments_service.all_comments()
+    )
+
+
+@comments_bp.route("/admin/comments/<int:comment_id>/approve", methods=["POST"])
+@login_required
+def admin_approve(comment_id):
+    comment = Comment.query.get_or_404(comment_id)
+    comment.approved = True
+    db.session.commit()
+    flash("Comment approved.", "success")
+    return redirect(url_for("comments.admin_index"))
+
+
+@comments_bp.route("/admin/comments/<int:comment_id>/delete", methods=["POST"])
+@login_required
+def admin_delete(comment_id):
+    comment = Comment.query.get_or_404(comment_id)
+    db.session.delete(comment)
+    db.session.commit()
+    flash("Comment removed.", "success")
+    return redirect(url_for("comments.admin_index"))

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/seeders.py

@@ -0,0 +1,10 @@
+from splent_framework.seeders.BaseSeeder import BaseSeeder
+
+
+class SplentFeatureCommentsSeeder(BaseSeeder):
+    def run(self):
+        data = [
+            # Create any Model object you want to make seed
+        ]
+
+        self.seed(data)

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/services.py

@@ -0,0 +1,25 @@
+from splent_io.splent_feature_comments.models import Comment
+from splent_io.splent_feature_comments.repositories import CommentsRepository
+from splent_framework.services.BaseService import BaseService
+
+
+class CommentsService(BaseService):
+    def __init__(self):
+        super().__init__(CommentsRepository())
+
+    def approved_for(self, post_id):
+        return (
+            Comment.query.filter_by(post_id=post_id, approved=True)
+            .order_by(Comment.created_at.asc())
+            .all()
+        )
+
+    def pending(self):
+        return (
+            Comment.query.filter_by(approved=False)
+            .order_by(Comment.created_at.desc())
+            .all()
+        )
+
+    def all_comments(self):
+        return Comment.query.order_by(Comment.created_at.desc()).all()

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/signals.py

@@ -0,0 +1,12 @@
+"""Signals emitted by the comments feature.
+
+comments stays decoupled from anti-spam: it emits ``comment-submitting`` and any
+listener (a captcha provider, a spam filter…) may return False to veto the
+submission. ``comment-created`` fires after a comment is stored, for things like
+notifications or counters.
+"""
+
+from splent_framework.signals.signal_utils import define_signal
+
+comment_submitting = define_signal("comment-submitting", "splent_feature_comments")
+comment_created = define_signal("comment-created", "splent_feature_comments")

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/templates/comments/admin/list.html

@@ -0,0 +1,83 @@
+{% extends "base_template.html" %}
+
+{% block title %}{{ _('Comments') }}{% endblock %}
+
+{% block content %}
+<div class="container section">
+
+  <header class="page-header">
+    <h1>{{ _('Comments') }}</h1>
+    <p class="text-muted">{{ _('Moderate comments submitted by visitors.') }}</p>
+  </header>
+
+  {# Flash messages #}
+  {% with messages = get_flashed_messages(with_categories=true) %}
+    {% if messages %}
+      <div class="admin-flashes">
+        {% for category, message in messages %}
+          <div class="alert alert-{{ category }}">{{ message }}</div>
+        {% endfor %}
+      </div>
+    {% endif %}
+  {% endwith %}
+
+  <table class="table">
+    <thead>
+      <tr>
+        <th>{{ _('Author') }}</th>
+        <th>{{ _('Comment') }}</th>
+        <th>{{ _('Date') }}</th>
+        <th>{{ _('Status') }}</th>
+        <th>{{ _('Actions') }}</th>
+      </tr>
+    </thead>
+    <tbody>
+      {% for c in comments %}
+        <tr>
+          <td>
+            <strong>{{ c.author_name }}</strong>
+            {% if c.author_email %}
+              <br><span class="text-muted">{{ c.author_email }}</span>
+            {% endif %}
+          </td>
+          <td>{{ c.content|truncate(100, true) }}</td>
+          <td>{{ c.created_at.strftime('%Y-%m-%d %H:%M') }}</td>
+          <td>
+            {% if c.approved %}
+              <span class="badge bg-success">{{ _('approved') }}</span>
+            {% else %}
+              <span class="badge bg-warning text-dark">{{ _('pending') }}</span>
+            {% endif %}
+          </td>
+          <td class="comment-actions">
+            {% if not c.approved %}
+              <form method="POST"
+                    action="{{ url_for('comments.admin_approve', comment_id=c.id) }}"
+                    class="d-inline">
+                <button type="submit" class="btn btn-sm btn-success">
+                  {{ _('Approve') }}
+                </button>
+              </form>
+            {% endif %}
+            <form method="POST"
+                  action="{{ url_for('comments.admin_delete', comment_id=c.id) }}"
+                  class="d-inline"
+                  onsubmit="return confirm('{{ _('Delete this comment?') }}');">
+              <button type="submit" class="btn btn-sm btn-danger">
+                {{ _('Delete') }}
+              </button>
+            </form>
+          </td>
+        </tr>
+      {% else %}
+        <tr>
+          <td colspan="5" class="text-muted text-center">
+            {{ _('No comments yet.') }}
+          </td>
+        </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+
+</div>
+{% endblock %}

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/templates/comments/index.html

@@ -0,0 +1,10 @@
+{% extends "base_template.html" %}
+
+{% block title %}Comments{% endblock %}
+
+{% block content %}
+
+{% endblock %}
+
+{% block scripts %}
+{% endblock %}

splent_feature_comments-0.1.0/src/splent_io/splent_feature_comments/templates/comments/thread.html

@@ -0,0 +1,93 @@
+{# ------------------------------------------------------------------ #}
+{# Comments thread partial.                                            #}
+{# Rendered INTO the post detail page (NOT a full page, no extends).   #}
+{# Context: `post`, `comments` (approved, oldest first).               #}
+{# ------------------------------------------------------------------ #}
+<section class="section comments-thread">
+  <div class="container">
+
+    <h2 class="comments-thread__heading">
+      {{ _('Comments') }} ({{ comments|length }})
+    </h2>
+
+    {# Flash messages #}
+    {% with messages = get_flashed_messages(with_categories=true) %}
+      {% if messages %}
+        <div class="comments-thread__flashes">
+          {% for category, message in messages %}
+            <div class="alert alert-{{ category }}">{{ message }}</div>
+          {% endfor %}
+        </div>
+      {% endif %}
+    {% endwith %}
+
+    {# Comment list #}
+    <ul class="comments-list">
+      {% for c in comments %}
+        <li class="comment">
+          <div class="comment__header">
+            <strong class="comment__author">{{ c.author_name }}</strong>
+            <time class="comment__date text-muted"
+                  datetime="{{ c.created_at.isoformat() }}">
+              {{ c.created_at.strftime('%d %b %Y') }}
+            </time>
+          </div>
+          <p class="comment__content">{{ c.content }}</p>
+        </li>
+      {% else %}
+        <li class="comment comment--empty text-muted">
+          {{ _('No comments yet. Be the first!') }}
+        </li>
+      {% endfor %}
+    </ul>
+
+    {# Comment form — only when the post still accepts comments #}
+    {% if post.comment_status != 'closed' %}
+      <form class="comment-form"
+            method="POST"
+            action="{{ url_for('comments.create', post_id=post.id) }}">
+
+        <div class="form-group">
+          <label for="comment-author-name">{{ _('Name') }}</label>
+          <input type="text"
+                 id="comment-author-name"
+                 name="author_name"
+                 class="form-control"
+                 required>
+        </div>
+
+        <div class="form-group">
+          <label for="comment-author-email">{{ _('Email (optional)') }}</label>
+          <input type="email"
+                 id="comment-author-email"
+                 name="author_email"
+                 class="form-control">
+        </div>
+
+        <div class="form-group">
+          <label for="comment-content">{{ _('Comment') }}</label>
+          <textarea id="comment-content"
+                    name="content"
+                    class="form-control"
+                    rows="4"
+                    required></textarea>
+        </div>
+
+        {# Captcha widget (cloudflare / recaptcha) — empty when none installed #}
+        {% if captcha_widget is defined %}
+          {{ captcha_script() }}
+          {{ captcha_widget() }}
+        {% endif %}
+
+        <button type="submit" class="btn btn-primary">
+          {{ _('Post comment') }}
+        </button>
+
+        <p class="comment-form__note text-muted">
+          {{ _('Comments are moderated before appearing.') }}
+        </p>
+      </form>
+    {% endif %}
+
+  </div>
+</section>