Addons: add addons.configs.load_when_embedded in the API response

Add an extra addons config to decide whether or not force the injection of
addons when the page is embedded (eg. iframe). By default, we are not loading
addons if embedded.

Required by readthedocs/addons#415
Closes readthedocs/addons#412

Author: humitos

readthedocs/projects/migrations/0133_addons_load_when_embedded.py

@@ -0,0 +1,25 @@
+# Generated by Django 4.2.16 on 2024-11-13 12:00
+
+from django.db import migrations, models
+from django_safemigrate import Safe
+
+
+class Migration(migrations.Migration):
+    safe = Safe.before_deploy
+
+    dependencies = [
+        ('projects', '0132_addons_linkpreviews_fields'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='addonsconfig',
+            name='load_when_embedded',
+            field=models.BooleanField(default=False, null=True),
+        ),
+        migrations.AddField(
+            model_name='historicaladdonsconfig',
+            name='load_when_embedded',
+            field=models.BooleanField(default=False, null=True),
+        ),
+    ]

readthedocs/projects/migrations/0134_addons_load_when_embedded_notnull.py

@@ -0,0 +1,25 @@
+# Generated by Django 4.2.16 on 2024-11-13 12:01
+
+from django.db import migrations, models
+from django_safemigrate import Safe
+
+
+class Migration(migrations.Migration):
+    safe = Safe.after_deploy
+
+    dependencies = [
+        ('projects', '0133_addons_load_when_embedded'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='addonsconfig',
+            name='load_when_embedded',
+            field=models.BooleanField(default=False),
+        ),
+        migrations.AlterField(
+            model_name='historicaladdonsconfig',
+            name='load_when_embedded',
+            field=models.BooleanField(default=False),
+        ),
+    ]

readthedocs/projects/models.py

@@ -167,6 +167,10 @@ class AddonsConfig(TimeStampedModel):
         help_text="Enable/Disable all the addons on this project",
     )
 
+    # Whether or not load addons library when the requested page is embedded (e.g. inside an iframe)
+    # https://github.com/readthedocs/addons/pull/415
+    load_when_embedded = models.BooleanField(default=False)
+
     # Analytics
 
     # NOTE: we keep analytics disabled by default to save resources.

readthedocs/proxito/middleware.py

@@ -30,7 +30,7 @@
     unresolver,
 )
 from readthedocs.core.utils import get_cache_tag
-from readthedocs.projects.models import Project
+from readthedocs.projects.models import AddonsConfig
 from readthedocs.proxito.cache import add_cache_tags, cache_response, private_response
 from readthedocs.proxito.redirects import redirect_to_https
 
@@ -283,12 +283,11 @@ def add_hosting_integrations_headers(self, request, response):
         project_slug = getattr(request, "path_project_slug", "")
 
         if project_slug:
-            addons = Project.objects.filter(
-                slug=project_slug, addons__enabled=True
-            ).exists()
+            addons = AddonsConfig.objects.filter(project__slug=project_slug).first()
 
             if addons:
-                response["X-RTD-Force-Addons"] = "true"
+                if addons.enabled:
+                    response["X-RTD-Force-Addons"] = "true"
 
     def add_cors_headers(self, request, response):
         """

readthedocs/proxito/views/hosting.py

@@ -454,6 +454,9 @@ def _v1(self, project, version, build, filename, url, request):
             # Mainly, all the fields including a Project, Version or Build will use the exact same
             # serializer than the keys ``project``, ``version`` and ``build`` from the top level.
             "addons": {
+                "configs": {
+                    "load_when_embedded": project.addons.load_when_embedded,
+                },
                 "analytics": {
                     "enabled": project.addons.analytics_enabled,
                     # TODO: consider adding this field into the ProjectSerializer itself.