[5.x] Multi site config help text (#9986)

statamic · May 2, 2024 · fce280c · fce280c
1 parent 1ae7911
commit fce280c
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 2 deletions.
diff --git a/resources/lang/en/messages.php b/resources/lang/en/messages.php
@@ -199,6 +199,12 @@
     'session_expiry_logging_out_in_seconds' => 'You have been inactive for a while and will be logged out in :seconds seconds. Click to extend your session.',
     'session_expiry_new_window' => 'Opens in a new window. Come back once you\'ve logged in.',
     'show_slugs_instructions' => 'Whether to display slugs in the tree view.',
+    'site_configure_attributes_instructions' => 'Add arbitrary attributes to your site\'s config which can be accessed in your templates. [Learn more](https://statamic.dev/multi-site#additional-attributes).',
+    'site_configure_handle_instructions' => 'A unique reference to this site. Non-trivial to change later.',
+    'site_configure_lang_instructions' => 'Learn about [Languages](https://statamic.dev/multi-site#language).',
+    'site_configure_locale_instructions' => 'Learn about [Locales](https://statamic.dev/multi-site#locale).',
+    'site_configure_name_instructions' => 'User-facing name shown throughout the control panel.',
+    'site_configure_url_instructions' => 'Learn about [Site URLs](https://statamic.dev/multi-site#urlhttps://statamic.dev/multi-site#url).',
     'status_expired_with_date' => 'Expired on :date',
     'status_published_with_date' => 'Published on :date',
     'status_scheduled_with_date' => 'Scheduled to be published on :date',

diff --git a/src/Sites/Sites.php b/src/Sites/Sites.php
@@ -148,6 +148,7 @@ public function blueprint()
                 'handle' => 'name',
                 'field' => [
                     'type' => 'text',
+                    'instructions' => __('statamic::messages.site_configure_name_instructions'),
                     'required' => true,
                     'width' => 50,
                 ],
@@ -158,6 +159,7 @@ public function blueprint()
                     'type' => 'slug',
                     'separator' => '_',
                     'generate' => true,
+                    'instructions' => __('statamic::messages.site_configure_handle_instructions'),
                     'show_regenerate' => true,
                     'from' => 'name',
                     'required' => true,
@@ -168,28 +170,35 @@ public function blueprint()
                 'handle' => 'url',
                 'field' => [
                     'type' => 'text',
+                    'instructions' => __('statamic::messages.site_configure_url_instructions'),
                     'required' => true,
+                    'width' => 33,
                 ],
             ],
             [
                 'handle' => 'locale',
                 'field' => [
                     'type' => 'text',
+                    'instructions' => __('statamic::messages.site_configure_locale_instructions'),
                     'required' => true,
-                    'width' => 50,
+                    'width' => 33,
                 ],
             ],
             [
                 'handle' => 'lang',
                 'field' => [
                     'type' => 'text',
-                    'width' => 50,
+                    'instructions' => __('statamic::messages.site_configure_lang_instructions'),
+                    'width' => 33,
                 ],
             ],
             [
                 'handle' => 'attributes',
                 'field' => [
+                    'display' => __('Custom Attributes'),
+                    'instructions' => __('statamic::messages.site_configure_attributes_instructions'),
                     'type' => 'array',
+                    'add_button' => __('Add Attribute'),
                 ],
             ],
         ];