From 795642e8f9c461259f8114f9a345d76adad10886 Mon Sep 17 00:00:00 2001
From: Awilum <awilum@msn.com>
Date: Wed, 6 Nov 2019 20:32:31 +0300
Subject: [PATCH] feat(admin-panel): add help text for common form controls
 #280

---
 site/plugins/admin/lang/en_US.yaml                         | 4 ++++
 .../admin/views/templates/extends/fieldsets/add.html       | 7 +++++++
 .../admin/views/templates/extends/fieldsets/rename.html    | 1 +
 3 files changed, 12 insertions(+)

diff --git a/site/plugins/admin/lang/en_US.yaml b/site/plugins/admin/lang/en_US.yaml
index eb838b73..33225068 100755
--- a/site/plugins/admin/lang/en_US.yaml
+++ b/site/plugins/admin/lang/en_US.yaml
@@ -199,6 +199,10 @@ admin_sqlite3_database: "SQLite3 Database"
 admin_sqlite3_table: "SQLite3 Table"
 admin_error_name_empty_input: "Name has to be an alphanumeric value (from 1 chars)"
 admin_error_title_empty_input: "Title has to be an alphanumeric value (from 1 chars)"
+admin_error_icon_empty_input: "Icon has to be an alphanumeric value (from 1 chars)"
+admin_help_text_for_label: "The fieldsets label shown in the Admin Panel."
+admin_help_text_for_name: "The fieldsets unique name in lowercase chars only."
+admin_help_text_for_icon: "The fieldsets valid :link icon class."
 admin_entries_visible: "Visible"
 admin_entries_draft: "Draft"
 admin_entries_hidden: "Hidden"
diff --git a/site/plugins/admin/views/templates/extends/fieldsets/add.html b/site/plugins/admin/views/templates/extends/fieldsets/add.html
index fd53c91d..f9f8bfa2 100644
--- a/site/plugins/admin/views/templates/extends/fieldsets/add.html
+++ b/site/plugins/admin/views/templates/extends/fieldsets/add.html
@@ -8,10 +8,17 @@
             <div class="form-group">
                 <label for="title">{{ tr('admin_title') }}</label>
                 <input type="text" id="fieldsetTitle" name="title" value="" class="form-control" required="required" data-validation="length required" data-validation-length="min1" data-validation-error-msg="{{ tr('admin_error_title_empty_input') }}">
+                <small class="form-text text-muted">{{ tr('admin_help_text_for_label') }}</small>
             </div>
             <div class="form-group">
                 <label for="id">{{ tr('admin_name') }}</label>
                 <input type="text" id="fieldsetId" name="id" value="" class="form-control" required="required" data-validation="length required" data-validation-length="min1" data-validation-error-msg="{{ tr('admin_error_name_empty_input') }}">
+                <small class="form-text text-muted">{{ tr('admin_help_text_for_name') }}</small>
+            </div>
+            <div class="form-group">
+                <label for="icon">{{ tr('admin_icon') }}</label>
+                <input type="text" id="fieldsetIcon" name="icon" value="far fa-file-alt" class="form-control" required="required" data-validation="length required" data-validation-length="min1" data-validation-error-msg="{{ tr('admin_error_icon_empty_input') }}">
+                <small class="form-text text-muted">{{ tr('admin_help_text_for_icon', {':link': '<a href="https://fontawesome.com/icons?d=gallery&m=free" target="_blank">fontawesome</a>'})|raw }}</small>
             </div>
             <div class="form-group">
                 <input type="submit" id="createFieldset" name="create_fieldset" value="{{ tr('admin_create') }}" class="btn btn-black">
diff --git a/site/plugins/admin/views/templates/extends/fieldsets/rename.html b/site/plugins/admin/views/templates/extends/fieldsets/rename.html
index 0c3dc044..6d76bc05 100644
--- a/site/plugins/admin/views/templates/extends/fieldsets/rename.html
+++ b/site/plugins/admin/views/templates/extends/fieldsets/rename.html
@@ -9,6 +9,7 @@
             <div class="form-group">
                 <label for="id">{{ tr('admin_name') }}</label>
                 <input type="text" id="fieldsetId" name="id" value="{{ id }}" class="form-control" required="required" data-validation="length required" data-validation-length="min1" data-validation-error-msg="{{ tr('admin_error_name_empty_input') }}">
+                <small class="form-text text-muted">{{ tr('admin_help_text_for_name') }}</small>
             </div>
             <div class="form-group">
                 <input type="submit" id="renameFieldset" name="rename_fieldset" value="{{ tr('admin_save') }}" class="btn btn-black">