Plots2: Update/modernize form error display for Map forms

Created on 12 Oct 2020  ยท  4Comments  ยท  Source: publiclab/plots2

Hi, this is a first-timers-only issue. This means we've worked to make it more legible to folks who either haven't contributed to our codebase before, or even folks who haven't contributed to open source before.

If that's you, we're interested in helping you take the first step and can answer questions and help you out as you do. Note that we're especially interested in contributions from people from groups underrepresented in free and open source software!

We know that the process of creating a pull request is the biggest barrier for new contributors. This issue is for you ๐Ÿ’

If you have contributed before, consider leaving this one for someone new, and looking through our general help wanted issues. Thanks!

๐Ÿค” What you will need to know.

Nothing. This issue is meant to welcome you to Open Source :) We are happy to walk you through the process.

๐Ÿ“‹ Step by Step

  • [ ] ๐Ÿ™‹ Claim this issue: Comment below. If someone else has claimed it, ask if they've opened a pull request already and if they're stuck -- maybe you can help them solve a problem or move it along!

  • [ ] ๐Ÿ“ Update the file app/views/map/edit.html.erb in the plots2 repository (press the little pen Icon) and edit the line as shown below.

See this page for some help in taking your first steps!

Here, we will be modernizing a form template, building on #8545 -- read there for more background!

Below is a "diff" showing in red (and a -) which lines to remove, and in green (and a +) which lines to add:

@@ -16,14 +16,30 @@
   %>

   <%= form_for @revision, :as => :revision, :url => url, :html => {:class => "form"} do |f| %>
-
-    <% if f.error_messages != "" %><div class="alert alert-danger"><%= f.error_messages :header_message => "Your map couldn't be saved." %></div><% end %>
-
+    <% if @revision.errors.any? %>
+      <div class="alert alert-danger">
+        <h2><%= pluralize(@revision.errors.count, "error") %> prohibited this map from being saved:</h2>
+        <ul>
+        <% @revision.errors.full_messages.each do |msg| %>
+          <li><%= msg %></li>
+        <% end %>
+        </ul>
+      </div>
+    <% end %>
   <% end %>

   <%= form_for @node, :as => :drupal_node, :url => url, :html => {:class => "form well"} do |f| %>

-    <% if f.error_messages != "" %><div class="alert alert-danger"><%= f.error_messages :header_message => "Your map couldn't be saved." %></div><% end %>
+    <% if @node.errors.any? %>
+      <div class="alert alert-danger">
+        <h2><%= pluralize(@node.errors.count, "error") %> prohibited this map from being saved:</h2>
+        <ul>
+        <% @node.errors.full_messages.each do |msg| %>
+          <li><%= msg %></li>
+        <% end %>
+        </ul>
+      </div>
+    <% end %>

     <%= render :partial => "editor/main_image" %>

  • [ ] ๐Ÿ’พ Commit your changes

  • [ ] ๐Ÿ”€ Start a Pull Request. There are two ways how you can start a pull request:

  • If you are not familiar with GitHub or the pull request model, here is a guide you can follow on how GitHub works.
  • If you are familiar with the terminal or would like to learn to use it, here is a great tutorial on how to send a pull request using the terminal.
  1. You can also edit files directly in your browser and open a pull request from there.
  • [ ] ๐Ÿ Done Ask in comments for a review :)

Please keep us updated

๐Ÿ’ฌโฐ - We encourage contributors to be respectful to the community and provide an update within a week of claiming a first-timers-only issue. We're happy to keep it assigned to you as long as you need if you update us with a request for more time or help, but if we don't see any activity a week after you claim it we may reassign it to give someone else a chance. Thank you in advance!

If this happens to you, don't sweat it! Grab another open issue.

Is someone else already working on this?

๐Ÿ”—- We encourage contributors to link to the original issue in their pull request so all users can easily see if someone's already started on it.

๐Ÿ‘ฅ- If someone seems stuck, offer them some help! Otherwise, take a look at some other issues you can help with. Thanks!

๐Ÿค”โ“ Questions?

Leave a comment below!

first-timers-only help wanted

Most helpful comment

Hi, this is reserved for @Asu1996 to claim if wanted! If it is not claimed in 48 hours, others are welcome to claim it by leaving a comment here and linking to their pull request. Thank you!

All 4 comments

Hi, this is reserved for @Asu1996 to claim if wanted! If it is not claimed in 48 hours, others are welcome to claim it by leaving a comment here and linking to their pull request. Thank you!

Hi, can I work on this?

Hi @Asu1996 , hope all is well ๐ŸŒณ. Are you on deck to do this issue? Please reply today to meet the 48 hours offer ๐Ÿ’š from @jywarren 2 days ago ๐Ÿ˜Š

Hello, first-time contributor here, can I work on this? Thanks!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

milaaraujo picture milaaraujo  ยท  3Comments

RuthNjeri picture RuthNjeri  ยท  3Comments

ebarry picture ebarry  ยท  3Comments

jywarren picture jywarren  ยท  3Comments

bronwen9 picture bronwen9  ยท  3Comments