aboutsummaryrefslogtreecommitdiff
path: root/webmentions_ssg/forms
diff options
context:
space:
mode:
authorDennis Fink2026-11-16 17:58:36 +0100
committerDennis Fink2026-11-16 17:58:36 +0100
commitf7d846b66ae4286518ecc20537ba19c5afadf7f4 (patch)
treeb72e509875dccf21b43f83b92c4aa017df0de37b /webmentions_ssg/forms
parent09353e2fd7a66987076f33f65ac4f0fc8831e887 (diff)
downloadwebmentions-ssg-f7d846b66ae4286518ecc20537ba19c5afadf7f4.tar.gz
webmentions-ssg-f7d846b66ae4286518ecc20537ba19c5afadf7f4.zip
feat(receiver): add received Webmention filters
Add status, URL search, and updated-date filters to the received Webmention list with strict query validation and inclusive UTC date ranges. Preserve active filters across pagination, delete, and reverify actions.
Diffstat (limited to '')
-rw-r--r--webmentions_ssg/forms.py55
1 files changed, 53 insertions, 2 deletions
diff --git a/webmentions_ssg/forms.py b/webmentions_ssg/forms.py
index 1ce591d..d97cc69 100644
--- a/webmentions_ssg/forms.py
+++ b/webmentions_ssg/forms.py
@@ -9,9 +9,18 @@ import ipaddress
import httpx
from flask import current_app
from flask_wtf import FlaskForm
-from wtforms import Field, PasswordField, StringField, SubmitField, ValidationError
+from wtforms import (
+ DateField,
+ Field,
+ PasswordField,
+ SearchField,
+ SelectField,
+ StringField,
+ SubmitField,
+ ValidationError,
+)
from wtforms.form import BaseForm
-from wtforms.validators import InputRequired, StopValidation
+from wtforms.validators import InputRequired, Optional, StopValidation
from .net import is_public_address, normalized_hostname
from .validation import is_control_character
@@ -165,6 +174,48 @@ class WebmentionSubmissionForm(FlaskForm):
raise ValidationError(field.gettext("Field must not be equal to target."))
+class CanonicalDate:
+ """Require HTML date inputs to use the canonical YYYY-MM-DD format."""
+
+ def __call__(self, form: BaseForm, field: DateField) -> None:
+ if (
+ field.data is not None
+ and field.raw_data
+ and field.raw_data[0] != field.data.isoformat()
+ ):
+ raise ValidationError(field.gettext("Invalid date."))
+
+
+class ReceivedWebmentionFilterForm(FlaskForm):
+ """GET filters for the received Webmention list."""
+
+ status = SelectField(
+ "Status",
+ choices={
+ "": "All statuses",
+ "pending": "Pending",
+ "verifying": "Verifying",
+ "verified": "Verified",
+ "declined": "Declined",
+ },
+ default="",
+ )
+ q = SearchField("Source or target")
+ date_from = DateField(
+ "Updated from (UTC)", validators=[Optional(), CanonicalDate()]
+ )
+ date_to = DateField("Updated to (UTC)", validators=[Optional(), CanonicalDate()])
+
+ def validate_date_to(self, field: DateField) -> None:
+ """Require the end date to be on or after the start date."""
+ if (
+ self.date_from.data is not None
+ and field.data is not None
+ and field.data < self.date_from.data
+ ):
+ raise ValidationError("End date must be on or after start date.")
+
+
class ConfirmActionForm(FlaskForm):
"""Form for confirming an administrative action."""