Add documentation for creating a new field

app/commands/concerns/decidim/extra_user_fields/commands_overrides.rb

@@ -36,14 +36,18 @@ def update_personal_data
         @user.extended_data = extended_data
       end
 
+      # rubocop:disable Style/TrailingCommaInArguments
       def extended_data
         @extended_data ||= (@user&.extended_data || {}).merge(
           country: @form.country,
           postal_code: @form.postal_code,
           date_of_birth: @form.date_of_birth,
-          gender: @form.gender
+          gender: @form.gender,
+          # Block ExtraUserFields SaveInExtendedData
+          # EndBlock
         )
       end
+      # rubocop:enable Style/TrailingCommaInArguments
     end
   end
 end

app/commands/concerns/decidim/extra_user_fields/omniauth_commands_overrides.rb

@@ -40,14 +40,19 @@ def create_or_find_user
         @user.save!
       end
 
+      # rubocop:disable Style/TrailingCommaInArguments
       def extended_data
         @extended_data ||= (@user&.extended_data || {}).merge(
-          country: form.country,
-          postal_code: form.postal_code,
-          date_of_birth: form.date_of_birth,
-          gender: form.gender
+          country: @form.country,
+          postal_code: @form.postal_code,
+          date_of_birth: @form.date_of_birth,
+          gender: @form.gender,
+          # Block ExtraUserFields SaveInExtendedData
+
+          # EndBlock
         )
       end
+      # rubocop:enable Style/TrailingCommaInArguments
     end
   end
 end

app/commands/decidim/extra_user_fields/admin/update_extra_user_fields.rb

@@ -38,15 +38,20 @@ def update_extra_user_fields!
           )
         end
 
+        # rubocop:disable Style/TrailingCommaInHashLiteral
         def extra_user_fields
           {
             "enabled" => form.enabled.presence || false,
             "date_of_birth" => { "enabled" => form.date_of_birth.presence || false },
             "country" => { "enabled" => form.country.presence || false },
             "postal_code" => { "enabled" => form.postal_code.presence || false },
-            "gender" => { "enabled" => form.gender.presence || false }
+            "gender" => { "enabled" => form.gender.presence || false },
+            # Block ExtraUserFields SaveFieldInConfig
+
+            # EndBlock
           }
         end
+        # rubocop:enable Style/TrailingCommaInHashLiteral
       end
     end
   end

app/forms/concerns/decidim/extra_user_fields/forms_definitions.rb

@@ -16,10 +16,18 @@ module FormsDefinitions
         attribute :date_of_birth, Decidim::Attributes::LocalizedDate
         attribute :gender, String
 
+        # Block ExtraUserFields Attributes
+
+        # EndBlock
+
         validates :country, presence: true, if: :country?
         validates :postal_code, presence: true, if: :postal_code?
         validates :date_of_birth, presence: true, if: :date_of_birth?
         validates :gender, presence: true, inclusion: { in: Decidim::ExtraUserFields::Engine::DEFAULT_GENDER_OPTIONS.map(&:to_s) }, if: :gender?
+
+        # Block ExtraUserFields Validations
+
+        # EndBlock
       end
 
       def map_model(model)
@@ -29,6 +37,10 @@ def map_model(model)
         self.postal_code = extended_data[:postal_code]
         self.date_of_birth = Date.parse(extended_data[:date_of_birth]) if extended_data[:date_of_birth].present?
         self.gender = extended_data[:gender]
+
+        # Block ExtraUserFields MapModel
+
+        # EndBlock
       end
 
       private
@@ -49,6 +61,10 @@ def postal_code?
         extra_user_fields_enabled && current_organization.activated_extra_field?(:postal_code)
       end
 
+      # Block ExtraUserFields EnableFieldMethod
+
+      # EndBlock
+
       def extra_user_fields_enabled
         @extra_user_fields_enabled ||= current_organization.extra_user_fields_enabled?
       end

app/forms/decidim/extra_user_fields/admin/extra_user_fields_form.rb

@@ -11,13 +11,19 @@ class ExtraUserFieldsForm < Decidim::Form
         attribute :postal_code, Virtus::Attribute::Boolean
         attribute :date_of_birth, Virtus::Attribute::Boolean
         attribute :gender, Virtus::Attribute::Boolean
+        # Block ExtraUserFields Attributes
+
+        # EndBlock
 
         def map_model(model)
           self.enabled = model.extra_user_fields["enabled"]
           self.country = model.extra_user_fields.dig("country", "enabled")
           self.postal_code = model.extra_user_fields.dig("postal_code", "enabled")
           self.date_of_birth = model.extra_user_fields.dig("date_of_birth", "enabled")
           self.gender = model.extra_user_fields.dig("gender", "enabled")
+          # Block ExtraUserFields MapModel
+
+          # EndBlock
         end
       end
     end

app/serializers/decidim/extra_user_fields/user_export_serializer.rb

@@ -13,10 +13,24 @@ def serialize
       def extra_user_fields
         extended_data = resource.extended_data.symbolize_keys
 
-        [:gender, :country, :postal_code, :date_of_birth].index_with do |key|
+        extra_fields.index_with do |key|
           extended_data[key]
         end
       end
+
+      # rubocop:disable Style/TrailingCommaInArrayLiteral
+      def extra_fields
+        [
+          :gender,
+          :country,
+          :postal_code,
+          :date_of_birth,
+          # Block ExtraUserFields AddExtraField
+
+          # EndBlock
+        ]
+      end
+      # rubocop:enable Style/TrailingCommaInArrayLiteral
     end
   end
 end

app/views/decidim/extra_user_fields/_profile_form.html.erb

@@ -12,3 +12,7 @@
 <% if current_organization.activated_extra_field?(:postal_code) %>
   <%= f.text_field :postal_code %>
 <% end %>
+
+<%# Block ExtraUserFields AccountFormFields %>
+
+<%# EndBlock %>

app/views/decidim/extra_user_fields/_registration_form.html.erb

@@ -28,6 +28,10 @@
           <%= f.text_field :postal_code %>
         </div>
       <% end %>
+
+      <%# Block ExtraUserFields SignUpFormFields %>
+
+      <%# EndBlock %>
     </div>
   </div>
 <% end %>

app/views/decidim/extra_user_fields/admin/extra_user_fields/_form.html.erb

@@ -20,5 +20,8 @@
     <%= render partial: "decidim/extra_user_fields/admin/extra_user_fields/fields/country", locals: { form: form } %>
     <%= render partial: "decidim/extra_user_fields/admin/extra_user_fields/fields/postal_code", locals: { form: form } %>
     <%= render partial: "decidim/extra_user_fields/admin/extra_user_fields/fields/gender", locals: { form: form } %>
+    <%# Block ExtraUserFields ExtraFields %>
+
+    <%# EndBlock %>
   </div>
 </div>