Surface "abandoned" state on projects in UI

readthedocs/projects/admin.py

@@ -11,13 +11,16 @@
 from django.contrib import admin, messages
 from django.contrib.admin.actions import delete_selected
 from django.utils.translation import ugettext_lazy as _
+from django.db.models import F, Value
+from django.db.models.functions import Concat
 from guardian.admin import GuardedModelAdmin
 
 from readthedocs.builds.models import Version
 from readthedocs.core.models import UserProfile
 from readthedocs.core.utils import broadcast
 from readthedocs.notifications.views import SendNotificationView
 from readthedocs.redirects.models import Redirect
+from readthedocs.core.utils import send_email
 
 from .forms import FeatureForm
 from .models import (
@@ -126,7 +129,12 @@ class ProjectAdmin(GuardedModelAdmin):
                VersionInline, DomainInline]
     readonly_fields = ('feature_flags',)
     raw_id_fields = ('users', 'main_language_project')
-    actions = ['send_owner_email', 'ban_owner']
+    actions = [
+        'send_owner_email',
+        'ban_owner',
+        'mark_as_abandoned',
+        'request_namespace',
+    ]
 
     def feature_flags(self, obj):
         return ', '.join([str(f.get_feature_display()) for f in obj.features])
@@ -177,6 +185,40 @@ def delete_selected_and_artifacts(self, request, queryset):
                 broadcast(type='app', task=remove_dir, args=[project.doc_path])
         return delete_selected(self, request, queryset)
 
+    def mark_as_abandoned(self, request, queryset):
+        """
+        Marks selected projects as abandoned.
+
+        It adds '-abandoned' to the slug, marks
+        Project.is_abandoned and sends an email to the user
+        notifying the change and link to the new project/docs
+        page.
+        """
+        queryset.update(
+            slug=Concat('slug', Value('-abandoned')),
+            is_abandoned=True
+        )
+
+    mark_as_abandoned.short_description = 'Mark as abandoned'
+
+    def request_namespace(self, request, queryset):
+        """Notify user that their project's namespace has been requested via email"""
+        qs_iterator = queryset.iterator()
+        for project in qs_iterator:
+            users = project.users.get_queryset()
+            for user in users:
+                send_email(
+                    recipient=user.email,
+                    subject='Rename request for abandoned project',
+                    template='projects/email/abandon_project.txt',
+                    template_html='projects/email/abandon_project.html',
+                    context={'proj_name': project.name}
+                )
+            success_msg = 'Email sent to {}'.format(user.email)
+            self.message_user(request, success_msg, level=messages.SUCCESS)
+
+    request_namespace.short_description = 'Request namespace'
+
     def get_actions(self, request):
         actions = super(ProjectAdmin, self).get_actions(request)
         actions['delete_selected'] = (

readthedocs/projects/migrations/0036_add_is_abandoned_field.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.11.16 on 2018-12-13 10:35
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('projects', '0035_container_time_limit_as_integer'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='project',
+            name='is_abandoned',
+            field=models.BooleanField(default=False, verbose_name='Is abandoned'),
+        ),
+    ]

readthedocs/projects/models.py

@@ -179,6 +179,7 @@ class Project(models.Model):
                     'Leave blank if you want us to find it for you.'))
 
     featured = models.BooleanField(_('Featured'), default=False)
+    is_abandoned = models.BooleanField(_('Is abandoned'), default=False)
     skip = models.BooleanField(_('Skip'), default=False)
     install_project = models.BooleanField(
         _('Install Project'),

readthedocs/templates/projects/email/abandon_project.html

@@ -0,0 +1,19 @@
+{% extends "core/email/common.html" %}
+
+{% block top-right %}
+  {{ proj_name }}
+{% endblock %}
+
+{% block content %}
+  <p>
+    We've had a request from one of our users for the project name {{ proj_name }} on Read the Docs. You are the current owner, and we wanted to reach out to you in accordance with our Abandoned Project policy (<a href="http://docs.readthedocs.io/en/latest/abandoned-projects.html">http://docs.readthedocs.io/en/latest/abandoned-projects.html</a>).
+  </p>
+
+  <p>
+    Since this is a fork of the existing owners project, {{ proj_name }}, you must show us the additional work that has been done in order to keep the new project name, that is different than the existing version of the project.
+  </p>
+
+  <p>
+    Please reply to this email either allowing or disallowing the transfer of the name on Read the Docs within 6 weeks, otherwise we will take the action of *initiating the transfer to a new owner* by default.
+  </p>
+{% endblock %}

readthedocs/templates/projects/email/abandon_project.txt

@@ -0,0 +1,6 @@
+{% extends "core/email/common.txt" %}
+{% block content %}
+We've had a request from one of our users for the project name {name} on Read the Docs. You are the current owner, and we wanted to reach out to you in accordance with our Abandoned Project policy (http://docs.readthedocs.io/en/latest/abandoned-projects.html).
+Since this is a fork of the existing owners project, {name}, you must show us the additional work that has been done in order to keep the new project name, that is different than the existing version of the project.
+Please reply to this email either allowing or disallowing the transfer of the name on Read the Docs within 6 weeks, otherwise we will take the action of *initiating the transfer to a new owner* by default.
+{% endblock %}