WIP: Social media links

Author: GDSNewt

app/models/configurable_content_blocks/array_of_hashes.rb

@@ -0,0 +1,34 @@
+module ConfigurableContentBlocks
+  class ArrayOfHashes
+    def to_partial_path
+      "admin/configurable_content_blocks/array_of_hashes"
+    end
+
+
+    def publishing_api_payload(schema, content)
+      return [] if content.blank?
+
+      social_media_items = content.is_a?(Hash) ? content.values : Array(content)
+      social_media_items.filter_map do |item|
+        next if item["_destroy"] == "1"
+        build_api_output(schema, item)
+      end
+    end
+
+  private
+
+
+    def build_api_output(schema, item)
+      properties = schema.dig("items", "properties") || {}
+      output = {}
+
+      properties.each do |field, field_schema|
+        value = item[field]
+        key = (field_schema["output_key"] || field).to_sym
+        output[key] = value.present? ? value : nil
+      end
+
+      output.compact
+    end
+  end
+end

app/models/configurable_content_blocks/factory.rb

@@ -12,6 +12,7 @@ def build_block(block)
         "image_select" => ->(page) { ConfigurableContentBlocks::ImageSelect.new(page.valid_images) },
         "lead_image_select" => ->(page) { ConfigurableContentBlocks::LeadImageSelect.new(page.valid_lead_images, default_lead_image: page.default_lead_image, placeholder_image_url: page.placeholder_image_url) },
         "default_object" => ->(_page) { ConfigurableContentBlocks::DefaultObject.new(self) },
+        "array_of_hashes" => ->(_page) { ConfigurableContentBlocks::ArrayOfHashes.new },
       }.freeze
 
       raise "Block #{block} is not defined" if blocks[block].nil?
@@ -34,6 +35,9 @@ def blocks
         "object" => {
           "default" => ->(_page) { ConfigurableContentBlocks::DefaultObject.new(self) },
         },
+        "array" => {
+          "hash" => ->(_page) { ConfigurableContentBlocks::ArrayOfHashes.new },
+        },
         "date" => {
           "default" => ->(_page) { ConfigurableContentBlocks::DefaultDate.new },
         },

app/models/configurable_document_types/topical_event.json

@@ -23,6 +23,27 @@
               "block": "default_date"
             }
           }
+        },
+        "social_media_links": {
+          "title": "Social media accounts",
+          "block": "array_of_hashes",
+          "items": {
+            "type": "object",
+            "properties": {
+              "social_media_service_id": {
+                "title": "Service",
+                "type": "integer",
+                "input_type": "social_media_service_select",
+                "output_key": "service_type",
+                "transform": "social_media_service_name"
+              },
+              "url": {
+                "title": "URL",
+                "type": "string",
+                "output_key": "href"
+              }
+            }
+          }
         }
       }
     }
@@ -37,6 +58,9 @@
       },
       "end_date": {
         "type": "date"
+      },
+      "social_media_links": {
+        "type": "array"
       }
     },
     "validations": {
@@ -67,7 +91,8 @@
     "publishing_api": {
       "body": "govspeak",
       "start_date": "rfc3339_date",
-      "end_date": "rfc3339_date"
+      "end_date": "rfc3339_date",
+      "social_media_links": "array_of_hashes"
     }
   },
   "associations": [

app/models/standard_edition/block_content.rb

@@ -74,6 +74,8 @@ def attributes_class_for(attribute_config)
         case property_schema["type"]
         when "object"
           attribute key
+        when "array"
+          attribute key, default: -> { {} }
         else
           attribute key, property_schema["type"].to_sym
         end

app/presenters/publishing_api/payload_builder/block_content.rb

@@ -80,6 +80,35 @@ def lead_image(attribute)
       def string(attribute)
         item.block_content&.public_send(attribute)
       end
+
+      def array_of_hashes(attribute)
+        content = item.block_content&.public_send(attribute)
+        return [] if content.blank?
+
+        content.map { |item| process_social_media_item(item) }.compact
+      end
+
+      def process_social_media_item(item)
+        hash = case item
+               when Hash
+                 item.transform_keys(&:to_sym)
+               when Array
+                 {
+                   social_media_service_id: item[0],
+                   url: item[1],
+                   title: item[2] || ''
+                 }
+               else
+                 return nil
+               end
+
+        service = SocialMediaService.find_by(id: hash[:social_media_service_id])
+        {
+          service_type: service&.name&.downcase || 'other',
+          href: hash[:url].to_s,
+          title: hash[:title] || ''
+        }
+      end
     end
   end
 end

app/views/admin/configurable_content_blocks/_array_of_hashes.html.erb

@@ -0,0 +1,75 @@
+<% required ||= false
+   content ||= []
+   errors ||= []
+   items = content.is_a?(Hash) ? content.values : Array(content)
+   properties = schema.dig("items", "properties") || {}
+   social_media_services = SocialMediaService.all
+
+   render_fields = ->(item, item_path, item_errors) do
+     capture do
+       properties.each do |key, prop|
+         field_path = item_path.push(key)
+         field_errors = item_errors.select { |e| e.attribute.to_s.end_with?(".#{key}") }
+
+         if prop["input_type"] == "social_media_service_select"
+           concat(render("govuk_publishing_components/components/select", {
+             id: field_path.form_control_id,
+             label: prop["title"],
+             name: "#{item_path.form_control_name}[#{key}]",
+             heading_size: "s",
+             options: [{ text: "", value: "" }] +
+               social_media_services.map do |service|
+                 {
+                   text: service.name,
+                   value: service.id,
+                   selected: item[key].to_s == service.id.to_s,
+                 }
+               end,
+             full_width: true,
+             error_items: field_errors.map { |e| { text: e.message } },
+           }))
+         else
+           concat(render("govuk_publishing_components/components/input", {
+             id: field_path.form_control_id,
+             label: { text: prop["title"] },
+             name: "#{item_path.form_control_name}[#{key}]",
+             value: item[key],
+             error_items: field_errors.map { |e| { text: e.message } },
+           }))
+         end
+       end
+     end
+   end %>
+
+<%= render "govuk_publishing_components/components/fieldset", {
+  legend_text: "#{schema['title']}#{required ? ' (required)' : ''}",
+  heading_size: "l",
+} do %>
+  <div class="app-c-array-of-hashes">
+    <%= render "govuk_publishing_components/components/add_another", {
+      fieldset_legend: "Account",
+      add_button_text: "Add account",
+      empty_fields: true,
+      items: items.each_with_index.filter_map do |item, index|
+        next if item["_destroy"] == "1"
+
+        item_path = path.push(index.to_s)
+        item_errors = errors.select { |e| e.attribute.to_s.start_with?(item_path.validation_error_attribute) }
+
+        {
+          fields: render_fields.call(item, item_path, item_errors),
+          destroy_checkbox: render("govuk_publishing_components/components/checkboxes", {
+            name: "#{item_path.form_control_name}[_destroy]",
+            items: [{ label: "Remove", value: "1" }],
+          }),
+        }
+      end,
+      empty: render_fields.call({}, path.push(items.length.to_s), []),
+    } %>
+  </div>
+  <style>
+    .app-c-array-of-hashes .js-add-another__add-button {
+      margin-top: 20px;
+    }
+  </style>
+<% end %>

app/views/admin/configurable_content_blocks/_social_media_account_fields.html.erb

@@ -0,0 +1,43 @@
+<% item ||= {}
+   errors ||= []
+   url_errors = errors.select { |e| e.attribute.to_s.end_with?(".url") }
+   service_errors = errors.select { |e| e.attribute.to_s.end_with?(".social_media_service_id") } %>
+
+<%= render "govuk_publishing_components/components/select", {
+  id: path.push("social_media_service_id").form_control_id,
+  label: "Service (required)",
+  name: "#{path.form_control_name}[social_media_service_id]",
+  heading_size: "s",
+  options: [{ text: "", value: "" }] +
+    social_media_services.map do |service|
+      {
+        text: service.name,
+        value: service.id,
+        selected: item["social_media_service_id"].to_s == service.id.to_s,
+      }
+    end,
+  full_width: true,
+  error_items: service_errors.map { |e| { text: e.message } },
+} %>
+
+<%= render "govuk_publishing_components/components/input", {
+  label: {
+    text: "URL (required)",
+  },
+  name: "#{path.form_control_name}[url]",
+  id: path.push("url").form_control_id,
+  value: item["url"],
+  heading_size: "s",
+  error_items: url_errors.map { |e| { text: e.message } },
+} %>
+
+<%= render "govuk_publishing_components/components/input", {
+  label: {
+    text: "Title (optional)",
+  },
+  hint: "If left blank, the service name will be used",
+  name: "#{path.form_control_name}[title]",
+  id: path.push("title").form_control_id,
+  value: item["title"],
+  heading_size: "s",
+} %>

app/views/admin/configurable_content_blocks/_social_media_accounts.html.erb

@@ -0,0 +1,45 @@
+<% required ||= false
+   content ||= {}
+   errors ||= []
+   items = content.is_a?(Hash) ? content.values : Array(content)
+   items = [{}] if items.empty?
+   social_media_services = SocialMediaService.all %>
+
+<%= render "govuk_publishing_components/components/fieldset", {
+  legend_text: "#{schema['title']}#{required ? ' (required)' : ''}",
+  heading_size: "l",
+} do %>
+  <%= render "govuk_publishing_components/components/add_another", {
+    fieldset_legend: "Account",
+    add_button_text: "Add account",
+    items: items.each_with_index.filter_map do |item, index|
+      next if item["_destroy"] == "1"
+
+      item_path = path.push(index.to_s)
+      item_errors = errors.select { |e| e.attribute.to_s.start_with?(item_path.validation_error_attribute) }
+
+      {
+        fields: render(partial: "admin/configurable_content_blocks/social_media_account_fields", locals: {
+          item: item,
+          path: item_path,
+          social_media_services: social_media_services,
+          errors: item_errors,
+        }),
+        destroy_checkbox: render("govuk_publishing_components/components/checkboxes", {
+          name: "#{item_path.form_control_name}[_destroy]",
+          items: [{ label: "Delete", value: "1" }],
+        }),
+      }
+    end,
+    empty: begin
+      empty_index = items.length
+      empty_path = path.push(empty_index.to_s)
+      render(partial: "admin/configurable_content_blocks/social_media_account_fields", locals: {
+        item: {},
+        path: empty_path,
+        social_media_services: social_media_services,
+        errors: [],
+      })
+    end,
+  } %>
+<% end %>