Update award email and page content

This updates the content of the award email and the page teachers see after they sign in, to clarify some of the next steps and to include a link to the access your teaching qualifications service.
DFE-Digital · Sep 18, 2023 · 40d2de9 · 40d2de9
1 parent cf85669
commit 40d2de9
Show file tree

Hide file tree

Showing 4 changed files with 83 additions and 16 deletions.
diff --git a/app/views/teacher_interface/application_forms/show/_awarded.html.erb b/app/views/teacher_interface/application_forms/show/_awarded.html.erb
@@ -1,24 +1,47 @@
 <h2 class="govuk-heading-l">Your QTS application was successful</h2>
 
-<p class="govuk-body">As someone with qualified teacher status, you’ve been assigned a teacher reference number (TRN).</p>
+<p class="govuk-body">Your application <%= view_object.application_form.reference %> has been reviewed and you have been awarded qualified teacher status.</p>
 
-<p class="govuk-body">Your TRN is:</p>
-<%= govuk_inset_text(text: view_object.teacher.trn) %>
+<h3 class="govuk-heading-m">Your teacher reference number (TRN)</h3>
 
-<h3 class="govuk-heading-m">Next steps</h3>
+<p class="govuk-body">As someone with QTS you’ve been assigned a teacher reference number (TRN). This is a 7-digit number that identifies you in the education sector in England.</p>
 
-<p class="govuk-body">To download a PDF of your QTS certificate and find your date of recognition, visit:</p>
-<p class="govuk-body"><%= govuk_link_to "https://www.gov.uk/guidance/teacher-self-service-portal", "https://www.gov.uk/guidance/teacher-self-service-portal" %></p>
+<p class="govuk-body">Your TRN: <%= view_object.teacher.trn %></p>
+
+<h3 class="govuk-heading-m">Access your QTS certificate</h3>
+
+<p class="govuk-body">You can now get your QTS certificate. You will need this, as well as your TRN, to be recognised in the education sector in England.</p>
+
+<p class="govuk-body">You can access these at <%= govuk_link_to "Access your teaching qualifications", view_object.teacher.access_your_teaching_qualifications_url.presence || "https://access-your-teaching-qualifications.education.gov.uk" %>.</p>
+
+<p class="govuk-body">You will be asked to create a Department for Education (DfE) Identity account to log in.</p>
+
+<h3 class="govuk-heading-m">About DfE Identity accounts</h3>
+
+<p class="govuk-body">You’ll need your name and mobile phone number (for account security only) to create an account. Your DfE Identity account can be used to:</p>
+
+<ul class="govuk-list govuk-list--bullet">
+  <li>access your teaching qualifications, for example your QTS certification (to show employers evidence of your teaching service)</li>
+  <li>sign into different DfE teacher services</li>
+  <li>update your details</li>
+</ul>
 
 <h3 class="govuk-heading-m">Find out more about teaching in England</h3>
 
-<p class="govuk-body">There’s more information about coming to teach in England at <%= govuk_link_to "Get Into Teaching", "https://getintoteaching.education.gov.uk/non-uk-teachers" %>.</p>
+<p class="govuk-body">There is more information available about coming to teach in England at <%= govuk_link_to "Get into Teaching", "https://getintoteaching.education.gov.uk/non-uk-teachers" %>.</p>
+
+<p class="govuk-body">The Get into Teaching website also offers <%= govuk_link_to "help and support", "https://getintoteaching.education.gov.uk/help-and-support" %>.</p>
+
+<p class="govuk-body">You may be eligible to <%= govuk_link_to "receive help from a return to teaching adviser", "https://getintoteaching.education.gov.uk/teacher-training-adviser/sign_up/identity" %>. They can give you one-to-one support with applications and applying for interviews. They cannot provide visa advice or offer you a teaching role in England. To register for support you will need your TRN.</p>
 
-<h3 class="govuk-heading-m">Search for a job in teaching</h3>
+<h3 class="govuk-heading-m">Search for a teaching job in England</h3>
 
-<p class="govuk-body">You can search for a teaching job using <%= govuk_link_to "Teaching Vacancies", "https://teaching-vacancies.service.gov.uk" %>. It’s the official government service that schools use to list their teaching roles. You can also sign up to alerts for the latest jobs matching your key search criteria.</p>
+<p class="govuk-body">You can search for a job in teaching through the government’s official <%= govuk_link_to "Teaching Vacancies service", "https://teaching-vacancies.service.gov.uk" %>.</p>
 
-<h3 class="govuk-heading-m">Get support with your application</h3>
+<p class="govuk-body">The service is free and is used by English schools to list their teaching roles. As well as applying for jobs you can:</p>
 
-<p class="govuk-body">If you’re applying for a secondary school maths, physics or modern foreign languages teaching role in England, use the Get into Teaching service for one-to-one support with your application through <%= govuk_link_to "Get an advisor", "https://adviser-getintoteaching.education.gov.uk" %>.</p>
-<p class="govuk-body">Your adviser can help with writing a personal statement, preparing for an interview and accessing courses to enhance your subject knowledge.</p>
+<ul class="govuk-list govuk-list--bullet">
+  <li>set up job alerts</li>
+  <li>create a profile which allows schools to find and invite you to apply for their jobs</li>
+  <li>read advice for jobseekers</li>
+</ul>
diff --git a/app/views/teacher_mailer/application_awarded.text.erb b/app/views/teacher_mailer/application_awarded.text.erb
@@ -2,14 +2,48 @@ Dear <%= application_form_full_name(@application_form) %>
 
 # Your QTS application was successful
 
-<%= render "shared/teacher_mailer/reference_number" %>
+We are pleased to tell you that your application <%= @application_form.reference %> has been reviewed and you have been awarded qualified teacher status.
+
+## Your teacher reference number (TRN)
+
+As someone with QTS you’ve been assigned a teacher reference number (TRN). This is a 7-digit number that identifies you in the education sector in England.
+
+Your TRN: <%= @application_form.teacher.trn %>
+
+## Access your QTS certificate
+
+You can now get your QTS certificate. You will need this, as well as your TRN, to be recognised in the education sector in England.
+
+You can access these at [Access your teaching qualifications](<%= @application_form.teacher.access_your_teaching_qualifications_url.presence || "https://access-your-teaching-qualifications.education.gov.uk" %>).
+
+You will be asked to create a Department for Education (DfE) Identity account to log in.
+
+## About DfE Identity accounts
+
+You’ll need your name and mobile phone number (for account security only) to create an account. Your DfE Identity account can be used to:
+
+- access your teaching qualifications, for example your QTS certificate (to show employers evidence of your teaching service)
+- sign into different DfE teacher services
+- update your details
 
 We’re pleased to tell you that the assessor has now completed their review of your application and you’ve been awarded qualified teacher status (QTS).
 
-# What happens next
+## Find out more about teaching in England
+
+There is more information available about coming to teach in England at [Get into Teaching](https://getintoteaching.education.gov.uk/non-uk-teachers).
+
+The Get into Teaching website also offers [help and support](https://getintoteaching.education.gov.uk/help-and-support).
+
+You may be eligible to [receive help from a return to teaching adviser](https://getintoteaching.education.gov.uk/teacher-training-adviser/sign_up/identity). They can give you one-to-one support with applications and applying for interviews. They cannot provide visa advice or offer you a teaching role in England. To register for support you will need your TRN.
+
+## Search for a teaching job in England
+
+You can search for a job in teaching through the government’s official [Teaching Vacancies service](https://teaching-vacancies.service.gov.uk).
 
-You can sign in to get your Teacher Reference Number (TRN) and get some guidance about your next steps:
+The service is free and is used by English schools to list their teaching roles. As well as applying for jobs you can:
 
-<%= new_teacher_session_url %>
+- set up job alerts
+- create a profile which allows schools to find and invite you to apply for their jobs
+- read advice for jobseekers
 
 <%= render "shared/teacher_mailer/footer" %>
diff --git a/spec/mailers/teacher_mailer_spec.rb b/spec/mailers/teacher_mailer_spec.rb
@@ -21,6 +21,13 @@
   describe "#application_awarded" do
     subject(:mail) { described_class.with(teacher:).application_awarded }
 
+    before do
+      teacher.update!(
+        trn: "ABCDEF",
+        access_your_teaching_qualifications_url: "https://aytq.com",
+      )
+    end
+
     describe "#subject" do
       subject(:subject) { mail.subject }
 
@@ -38,6 +45,8 @@
 
       it { is_expected.to include("Dear First Last") }
       it { is_expected.to include("abc") }
+      it { is_expected.to include("ABCDEF") }
+      it { is_expected.to include("https://aytq.com") }
     end
 
     it_behaves_like "an observable mailer", "application_awarded"

diff --git a/spec/views/teacher_interface/application_forms_show_spec.rb b/spec/views/teacher_interface/application_forms_show_spec.rb
@@ -28,6 +28,7 @@
 
     it { is_expected.to match(/Your QTS application was successful/) }
     it { is_expected.to match(/ABCDEF/) }
+    it { is_expected.to match(/Access your teaching qualifications/) }
   end
 
   context "when declined" do