Required Template Fields

app/controllers/admin/form_templates_controller.rb

@@ -60,7 +60,7 @@ def find_template
   end
 
   def form_template_params
-    params.require(:form_template).permit(:title, {:properties_attributes => [:id, :name, :visible]})
+    params.require(:form_template).permit(:title, {:properties_attributes => [:id, :name, :visible, :required]})
   end
 
   def template_class

app/forms/generic_asset_form.rb

@@ -26,12 +26,22 @@ def template
   end
 
   def template_terms
-    template.visible_property_names
+    template.visible_property_names.map(&:to_sym)
   end
 
   def hidden_terms
     self.class.terms - template_terms.map(&:to_sym)
   end
+
+  def required_fields
+    self.class.required_fields | template_required_property_names
+  end
+
+  private
+
+  def template_required_property_names
+    template.required_property_names.map(&:to_sym)
+  end
 end
 
 # Provides a compatible API for using forms that have no template
@@ -45,4 +55,8 @@ def id
   def visible_property_names
     property_names
   end
+
+  def required_property_names
+    []
+  end
 end

app/models/form_template.rb

@@ -21,6 +21,10 @@ def visible_property_names
     properties.select {|property| property.visible?}.collect(&:name)
   end
 
+  def required_property_names
+    properties.select {|property| property.required?}.collect(&:name)
+  end
+
   def property_map
     @property_map || rebuild_property_map
   end

app/views/admin/form_templates/_form.html.erb

@@ -3,8 +3,18 @@
   <%= f.input :title %>
 
   <%= f.simple_fields_for :properties do |p| %>
-    <%= p.input :visible, :label => "Show #{p.object.name}" %>
-    <%= p.input :name, :as => :hidden %>
+    <div id="<%= p.object.name %>" class="panel panel-default template-property">
+      <div class="panel-heading">
+        <div class="panel-title">
+          <%= p.object.name %>
+        </div>
+      </div>
+      <div class="panel-body">
+        <%= p.input :visible, :label => "Show" %>
+        <%= p.input :required %>
+        <%= p.input :name, :as => :hidden %>
+      </div>
+    </div>
   <% end %>
 
   <%= f.submit "Save Template" %>

db/migrate/20150814174059_add_required_to_form_template_properties.rb

@@ -0,0 +1,5 @@
+class AddRequiredToFormTemplateProperties < ActiveRecord::Migration
+  def change
+    add_column :form_template_properties, :required, :boolean
+  end
+end

db/schema.rb

@@ -11,7 +11,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema.define(version: 20150803175310) do
+ActiveRecord::Schema.define(version: 20150814174059) do
 
   create_table "bookmarks", force: :cascade do |t|
     t.integer  "user_id",       null: false
@@ -38,6 +38,7 @@
     t.integer "form_template_id"
     t.string  "name",                             null: false
     t.boolean "visible",          default: false
+    t.boolean "required"
   end
 
   create_table "form_templates", force: :cascade do |t|

spec/factories/form_templates.rb

@@ -8,6 +8,12 @@
       end
     end
 
+    trait :with_required_title do
+      after(:build) do |obj|
+        obj.properties << build(:form_template_property, :name => "title", :required => true)
+      end
+    end
+
     trait :with_desc do
       after(:build) do |obj|
         obj.properties << build(:form_template_property, :name => "description")

spec/features/template_management_spec.rb

@@ -29,7 +29,8 @@
 
       before do
         fill_in "form_template_title", :with => template_name
-        check_fields.each {|field| check "Show %s" % field}
+        check_fields.each {|field| show_field field}
+        require_field :title
         click_button "Save Template"
       end
 
@@ -53,14 +54,17 @@
           (GenericAssetForm.terms - check_fields).each do |t|
             expect(checkboxes[t]).not_to be_checked
           end
+          within "#title .form_template_properties_required" do
+            expect(find("input[type=checkbox]")).to be_checked
+          end
         end
 
         context "when submitting changes" do
           let(:updated_template_name) { "Updated test template %d" % Random.rand(99999) }
           before do
             fill_in "form_template_title", :with => updated_template_name
-            check "Show creator"
-            uncheck "Show title"
+            show_field "creator"
+            hide_field "title"
             click_button "Save Template"
           end
 
@@ -101,9 +105,28 @@ def navigate_to_template_admin_path
 
 def checkbox_states
   checkboxes = HashWithIndifferentAccess.new
-  all('.form_template_properties_visible').each do |el|
-    checkboxes[el.find("label").text.sub("Show ", "")] = el.find("input[type=checkbox]")
+  all('.template-property').each do |el|
+    checkboxes[el.find(".panel-title").text] = el.find(".form_template_properties_visible input[type=checkbox]")
   end
 
   checkboxes
 end
+
+def show_field(field)
+  within "##{field}" do
+    check "Show"
+  end
+end
+
+def hide_field(field)
+  within "##{field}" do
+    uncheck "Show"
+  end
+end
+
+def require_field(field)
+  within "##{field}" do
+    check "Required"
+  end
+end
+

spec/forms/generic_asset_form_spec.rb

@@ -42,7 +42,7 @@
       end
     end
     context "when there is a template" do
-      let(:template) { instance_double("FormTemplate") }
+      let(:template) { instance_double(FormTemplate) }
       before do
         generic_form.template = template
         allow(described_class).to receive(:terms).and_return([:foo, :banana])
@@ -63,14 +63,37 @@
     end
 
     context "when there is a template" do
-      let(:template) { instance_double("FormTemplate") }
+      let(:template) { instance_double(FormTemplate) }
       before do
         generic_form.template = template
         allow(template).to receive(:visible_property_names).and_return(["foo", "bar"])
       end
 
       it "should return template.visible_property_names" do
-        expect(generic_form.template_terms).to eq(["foo", "bar"])
+        expect(generic_form.template_terms).to eq([:foo, :bar])
+      end
+    end
+  end
+
+  describe "#required_fields" do
+    context "when there is no template" do
+      it "should fall back to class-level required fields" do
+        expect(generic_form.required_fields).to eq GenericAssetForm.required_fields
+      end
+    end
+    context "when there is a template" do
+      let(:template) { instance_double(FormTemplate) }
+      before do
+        generic_form.template = template
+        allow(template).to receive(:required_property_names).and_return(["foo"])
+      end
+      it "should return the template's required properties" do
+        expect(generic_form.required_fields).to eq [:foo]
+        expect(generic_form.required?(:foo)).to eq true
+      end
+      it "should not lose the class' required fields" do
+        allow(generic_form.class).to receive(:required_fields).and_return([:bar])
+        expect(generic_form.required_fields).to eq [:bar, :foo]
       end
     end
   end

spec/models/form_template_spec.rb

@@ -24,6 +24,13 @@
     end
   end
 
+  describe "#required_property_names" do
+    it "should return names of properties which are required" do
+      template = FactoryGirl.build(:form_template, :with_required_title, :with_desc)
+      expect(template.required_property_names).to contain_exactly("title")
+    end
+  end
+
   describe "#property_names=" do
     it "should build hidden properties" do
       template.property_names = ["foo", "bar"]