add open311 hints

Also changed 'extended status' label to be inline to match the others

1 files changed, 76 insertions, 4 deletions

diff --git a/templates/web/default/admin/body-form.html b/templates/web/default/admin/body-form.html
index 51b15e0fa..6a3018a84 100644
--- a/templates/web/default/admin/body-form.html
+++ b/templates/web/default/admin/body-form.html
@@ -91,49 +91,121 @@
         <p class="fms-admin-info">
           [% loc(
             "These settings are for bodies that use Open311 (or other back-end integration) to receive problem reports.<br>
-             You don't need to set them if the Send Method is email."
+             <strong>You don't need to set them if the Send Method is email.</strong>.
+             For more information on Open311, see 
+             <a href='http://www.mysociety.org/2013/01/17/open311-explained//'>this article</a>.
+             "
           ) %]
         </p>
       [% END %]
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "The <strong>endpoint</strong> is the URL of the service that FixMyStreet will connect to 
+              when sending reports to this body."
+            ) %]
+          </p>
+        </div>
         <label for="endpoint">[% loc('Endpoint') %]</label>
         <input type="text" name="endpoint" id="endpoint" value="[% body.endpoint %]" size="50">
     </p>
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "The <strong>jurisdiction</strong> is only needed if the endpoint is serving more
+              than one. If the body is running its own endpoint, you can usually leave this blank."
+            ) %]
+          </p>
+        </div>
         <label for="jurisdiction">Open311 Jurisdiction</label>
         <input type="text" name="jurisdiction" id="jurisdiction" value="[% body.jurisdiction %]" size="50">
     </p>
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "Some endpoints require an <strong>API key</strong> to indicate that the reports are being
+              sent from your FixMyStreet installation."
+            ) %]
+          </p>
+        </div>
         <label for="api_key">Open311 API Key</label>
         <input type="text" name="api_key" id="api_key" value="[% body.api_key %]" size="25">
     </p>
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "Enable <strong>Open311 update-sending</strong> if the endpoint will send and receive
+              updates to existing reports. If you're not sure, it probably does not, so leave this unchecked.
+              For more information, see 
+              <a href='http://www.mysociety.org/2013/02/20/open311-extended/'>this article</a>."
+            ) %]
+          </p>
+        </div>
         <input type="checkbox" id="send_comments" name="send_comments"[% ' checked' IF body.send_comments %]>
-        <label for="send_comments" class="inline">Use Open311 comment sending extension</label>
+        <label for="send_comments" class="inline">Use Open311 update-sending extension</label>
     </p>
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "If you've enabled Open311 update-sending above, you must identify which 
+              FixMyStreet <strong>user</strong> will be attributed as the creator of those updates
+              when they are shown on the site. Enter the ID (number) of that user."
+            ) %]
+          </p>
+        </div>
         <label for"comment_user_id">User ID to attribute fetched comments to</label>
         <input type="text" name="comment_user_id" value="[% body.comment_user_id %]">
     </p>
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "If you've enabled Open311 update-sending above, enable <strong>suppression of alerts</strong> 
+              if you do <strong>not</strong> want that user to be notified whenever these updates are created."
+            ) %]
+          </p>
+        </div>
         <input type="checkbox" id="suppress_alerts" name="suppress_alerts"[% ' checked' IF body.suppress_alerts %]>
         <label for="suppress_alerts" class="inline">Do not send email alerts on fetched comments to problem creator</label>
     </p>
 
     <p>
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "Enable this <strong>contact can override</strong> setting if one or more contacts have a 
+              different endpoint (and send method) from the body's. For example, if reports for some categories of
+              problem must be emailed, while others can be sent over Open311."
+            ) %]
+          </p>
+        </div>
         <input type="checkbox" id="can_be_devolved" name="can_be_devolved"[% ' checked' IF body.can_be_devolved %]>
-        <label for="can_be_devolved" class="inline">Endpoint lookup can be devolved to contacts</label>
+        <label for="can_be_devolved" class="inline">Contacts' own endpoint can override the body's endpoint</label>
     </p>
 
     <p>
-        <label for="send_extended_statuses">Send extended open311 statuses with service request updates</label>:
+        <div class="admin-hint">
+          <p>
+            [% loc(
+              "If you've enabled Open311 update-sending above, Open311 usually only accepts OPEN or CLOSED status in 
+              its updates. Enable <strong>extended Open311 stauses</strong> if you want to allow extra states to be passed.
+              Check that your cobrand supports this feature before switching it on."
+            ) %]
+          </p>
+        </div>
         <input type="checkbox" id="send_extended_statuses" name="send_extended_statuses"[% ' checked' IF conf.send_extended_statuses %]>
+        <label for="send_extended_statuses" class="inline">Send extended Open311 statuses with service request updates</label>
     </p>
     </div>