WIP: Social media links

Author: GDSNewt

app/models/concerns/standard_edition/has_block_content.rb

@@ -7,7 +7,12 @@ module StandardEdition::HasBlockContent
   def block_content=(value)
     value_to_merge = (value || {}).to_h.deep_stringify_keys
     merged_value = (self[:block_content] || {}).deep_merge(value_to_merge)
-    super(merged_value)
+
+    normalised = StandardEdition::BlockContent.new(type_instance.schema)
+    normalised.assign_attributes(merged_value)
+
+    @block_content = normalised # keep the memoized object in sync (optional but nice)
+    super(normalised.to_h)
   end
 
   def block_content

app/models/configurable_content_blocks/default_array.rb

@@ -0,0 +1,13 @@
+module ConfigurableContentBlocks
+  class DefaultArray
+    attr_reader :block_factory
+
+    def initialize(block_factory)
+      @block_factory = block_factory
+    end
+
+    def to_partial_path
+      "admin/configurable_content_blocks/default_array"
+    end
+  end
+end

app/models/configurable_content_blocks/factory.rb

@@ -9,9 +9,11 @@ def build_block(block)
         "default_string" => ->(_page) { ConfigurableContentBlocks::DefaultString.new },
         "govspeak" => ->(page) { ConfigurableContentBlocks::Govspeak.new(page.images, page.attachments) },
         "default_date" => ->(_page) { ConfigurableContentBlocks::DefaultDate.new },
+        "social_media_service_select" => ->(_page) { ConfigurableContentBlocks::SocialMediaServiceSelect.new },
         "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) },
+        "default_array" => ->(_page) { ConfigurableContentBlocks::DefaultArray.new(self) },
       }.freeze
 
       raise "Block #{block} is not defined" if blocks[block].nil?

app/models/configurable_content_blocks/social_media_service_select.rb

@@ -0,0 +1,13 @@
+module ConfigurableContentBlocks
+  class SocialMediaServiceSelect
+    attr_reader :services
+
+    def initialize
+      @services = SocialMediaService.all
+    end
+
+    def to_partial_path
+      "admin/configurable_content_blocks/social_media_service_select"
+    end
+  end
+end

app/models/configurable_document_types/topical_event.json

@@ -23,6 +23,20 @@
               "block": "default_date"
             }
           }
+        },
+        "social_media_links": {
+          "title": "Social media accounts",
+          "block": "default_array",
+          "fields": {
+            "social_media_service_id": {
+              "title": "Service",
+              "block": "social_media_service_select"
+            },
+            "url": {
+              "title": "URL",
+              "block": "default_string"
+            }
+          }
         }
       }
     }
@@ -37,6 +51,17 @@
       },
       "end_date": {
         "type": "date"
+      },
+      "social_media_links": {
+        "type": "array",
+        "attributes": {
+          "social_media_service_id": {
+            "type": "integer"
+          },
+          "url": {
+            "type": "string"
+          }
+        }
       }
     },
     "validations": {
@@ -67,7 +92,8 @@
     "publishing_api": {
       "body": "govspeak",
       "start_date": "rfc3339_date",
-      "end_date": "rfc3339_date"
+      "end_date": "rfc3339_date",
+      "social_media_links": "social_media_links"
     }
   },
   "associations": [

app/models/standard_edition/block_content.rb

@@ -27,6 +27,13 @@ def attributes=(values)
       setter = "#{key}="
       if nested_schema["type"] == "date"
         public_send(setter, pre_validate_date_attribute(key, values[key]))
+      elsif nested_schema["type"] == "array"
+        #  Convert
+        # { "0" => { "foo" => "bar" }, "1" => { "delete_me" => "something", "_destroy" => "1" } }
+        # to
+        # [ { "foo" => "bar" } ]
+        vals = values[key].is_a?(Hash) ? values[key].values : values[key]
+        public_send(setter, vals.reject { |h| h["_destroy"] == "1" })
       else
         public_send(setter, values[key])
       end
@@ -74,6 +81,8 @@ def attributes_class_for(attribute_config)
         case property_schema["type"]
         when "object"
           attribute key
+        when "array"
+          attribute key
         else
           attribute key, property_schema["type"].to_sym
         end

app/presenters/publishing_api/payload_builder/block_content.rb

@@ -80,6 +80,21 @@ def lead_image(attribute)
           url: item.placeholder_image_url,
         }
       end
+
+      def social_media_links(attribute)
+        content = item.block_content&.public_send(attribute)
+        return [] if content.blank?
+
+        content.map do |item|
+          # `item` looks something like `{"url"=>"foo", "social_media_service_id"=>"3"}`
+          service = SocialMediaService.find(item["social_media_service_id"].to_i)
+          {
+            title: service.name,
+            service_type: service.name.parameterize, # "Google Plus" => "google-plus"
+            href: item["url"],
+          }
+        end
+      end
     end
   end
 end

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

@@ -0,0 +1,57 @@
+<% required ||= false
+   content ||= {}
+   translated_content ||= {}
+   right_to_left ||= false
+   errors ||= []
+   required_attributes ||= []
+   element_properties = schema.fetch("fields") %>
+
+<%
+  render_fields = ->(social_media_link, index) do
+    element_fields = capture do
+      element_properties.each do |property_key, property_schema|
+        block = default_array.block_factory.build_block(property_schema["block"])
+%>
+  <%= render block, {
+    schema: property_schema,
+    content: social_media_link[property_key],
+    # TODO: support translations
+    # translated_content: social_media_link[property_key],
+    path: ConfigurableContentBlocks::Path.new(["social_media_links", index, property_key]),
+    required: required_attributes.include?(property_key),
+    required_attributes: property_schema["block"] == "default_array" ? required_attributes : [],
+    right_to_left: right_to_left,
+    errors: errors,
+  } %>
+<%
+      end # element_properties.each loop
+    end # element_fields = capture
+  end # render_fields definition
+%>
+
+<%= render "govuk_publishing_components/components/fieldset",
+            { legend_text: "#{schema['title']}#{required ? ' (required)' : ''}",
+              heading_size: "l",
+              id: path.form_control_id } do %>
+  <%
+    # TODO: make the array key (`social_media_links`) dynamic
+    items = content["social_media_links"].map.with_index do |social_media_link, index|
+      # raise path.form_control_name.inspect # "edition[block_content][social_media_links]"
+      {
+        fields: render_fields.call(social_media_link, index),
+        destroy_checkbox: render("govuk_publishing_components/components/checkboxes", {
+          name: "#{path.form_control_name}[#{index}][_destroy]",
+          items: [{ label: "Remove", value: "1" }],
+        }),
+      }
+    end
+  %>
+
+  <%= render "govuk_publishing_components/components/add_another", {
+    fieldset_legend: schema["title"],
+    add_button_text: "Add another",
+    empty_fields: true,
+    items: items,
+    empty: render_fields.call({}, items.length),
+  } %>
+<% end %>

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

@@ -0,0 +1,23 @@
+<% required = required || false %>
+<% translated_content = translated_content || nil %>
+<% select_options = [
+     {
+       text: "No social media service selected",
+       value: "",
+     },
+   ] + social_media_service_select.services.map do |service|
+  {
+    text: service.name,
+    value: service.id,
+    selected: service.id == (translated_content || content).to_i,
+  }
+end %>
+<% errors = errors || [] %>
+<%= render "govuk_publishing_components/components/select", {
+  id: path.form_control_id,
+  label: schema["title"] + (required ? " (required)" : ""),
+  name: path.form_control_name,
+  options: select_options,
+  hint: schema["description"],
+  error_items: errors_for(errors, path.validation_error_attribute.to_sym),
+} %>