feat: disable broken website alerts

docs/admin/config.rst

@@ -2348,6 +2348,29 @@ On by default, as that suits public server setups.
 
 .. _settings-credentials:
 
+.. setting:: WEBSITE_ALERTS_ENABLED
+
+WEBSITE_ALERTS_ENABLED
+----------------------
+
+.. versionadded:: 5.16.1
+
+Default: ``True``
+
+Defines whether Weblate should check website availability and show alerts
+for broken project or component websites.
+
+When set to ``False``, Weblate will skip website availability checks and
+will not generate alerts for unreachable websites. This is useful when:
+
+- Your websites are behind firewalls that block Weblate's requests
+- You want to avoid 403/503-type errors from bot protection
+- Website availability is not a concern for your installation
+
+.. seealso::
+
+   :setting:`WEBSITE_REQUIRED`
+
 Configuring version control credentials
 ---------------------------------------
 

docs/admin/install/docker.rst

@@ -1103,6 +1103,9 @@ Generic settings
 
       Allows CORS requests to API from all origins.
 
+.. envvar:: WEBLATE_WEBSITE_ALERTS_ENABLED
+
+   Configures :setting:`WEBSITE_ALERTS_ENABLED`.
 
 .. envvar:: CLIENT_MAX_BODY_SIZE
 

docs/changes.rst

@@ -5,6 +5,7 @@ Weblate 5.16.1
 
 .. rubric:: New features
 
+* Added :setting:`WEBSITE_ALERTS_ENABLED` setting to allow disabling website availability checks and alerts.
 * :doc:`/formats/asciidoc` is now a supported file format.
 
 .. rubric:: Improvements

weblate/settings_docker.py

@@ -42,6 +42,9 @@
 # Whether site uses https
 ENABLE_HTTPS = get_env_bool("WEBLATE_ENABLE_HTTPS")
 
+# Support for env variable
+WEBSITE_ALERTS_ENABLED = get_env_bool("WEBLATE_WEBSITE_ALERTS_ENABLED", True)
+
 # Site URL
 SITE_URL = f"{'https' if ENABLE_HTTPS else 'http'}://{SITE_DOMAIN}"
 

weblate/settings_example.py

@@ -944,6 +944,10 @@
 # PGP commits signing
 WEBLATE_GPG_IDENTITY = None
 
+# Website availability checks
+# Set to False to disable broken website alerts
+WEBSITE_ALERTS_ENABLED = True
+
 # Third party services integration
 MATOMO_SITE_ID = None
 MATOMO_URL = None

weblate/trans/models/_conf.py

@@ -184,6 +184,9 @@ class WeblateConf(AppConf):
     LICENSE_FILTER = None
     LICENSE_REQUIRED = False
     WEBSITE_REQUIRED = True
+    # Enable or disable website availability checks and alerts
+    # Set to False to disable broken website alerts
+    WEBSITE_ALERTS_ENABLED = True
     FONTS_CDN_URL = None
     PROJECT_BACKUP_KEEP_DAYS = 30
     PROJECT_BACKUP_KEEP_COUNT = 3

weblate/trans/models/alert.py

@@ -564,6 +564,9 @@ def __init__(self, instance: Alert, error: str | None = None) -> None:
 
     @staticmethod
     def check_component(component: Component) -> bool | dict | None:
+        if not settings.WEBSITE_ALERTS_ENABLED:
+            return False
+
         if component.project.web:
             location_error = get_uri_error(component.project.web)
             if location_error is not None:

weblate/trans/tests/test_alert.py

@@ -4,14 +4,52 @@
 
 """Test for alerts."""
 
-from django.test.utils import override_settings
+from django.test import TestCase, override_settings
 from django.urls import reverse
 
 from weblate.lang.models import Language
-from weblate.trans.models import Unit
+from weblate.trans.models import Component, Project, Unit
 from weblate.trans.tests.test_views import ViewTestCase
 
 
+class WebsiteAlertSettingTest(TestCase):
+    """Test WEBSITE_ALERTS_ENABLED setting."""
+
+    def setUp(self):
+        # Create a test project with a broken website URL
+        self.project = Project.objects.create(
+            name="Test Project",
+            slug="test-project",
+            web="https://this-website-does-not-exist-404.com",
+        )
+        self.component = Component.objects.create(
+            project=self.project,
+            name="Test Component",
+            slug="test-component",
+            # ... other required fields ...
+        )
+
+    @override_settings(WEBSITE_ALERTS_ENABLED=False)
+    def test_website_alerts_disabled(self):
+        """Test that website alerts are not created when setting is False."""
+        # Run alert check
+        # ... code to trigger alert check ...
+
+        # Assert no broken website alert was created
+        alerts = self.component.alert_set.filter(name="BrokenProjectWebsite")
+        self.assertEqual(alerts.count(), 0)
+
+    @override_settings(WEBSITE_ALERTS_ENABLED=True)
+    def test_website_alerts_enabled(self):
+        """Test that website alerts are created when setting is True."""
+        # Run alert check
+        # ... code to trigger alert check ...
+
+        # Assert broken website alert was created
+        alerts = self.component.alert_set.filter(name="BrokenProjectWebsite")
+        self.assertGreater(alerts.count(), 0)
+
+
 class AlertTest(ViewTestCase):
     def create_component(self):
         return self._create_component("po", "po-duplicates/*.dpo", manage_units=True)