From 97721092b38f76e7c7ef510d90476b72ed6aeb60 Mon Sep 17 00:00:00 2001
From: Nikos Roussos <nikos.roussos@greenpeace.org>
Date: Wed, 27 Nov 2024 15:06:00 +0200
Subject: [PATCH] Update Social settings help texts

- Facebook Page ID: Add a help text with a link to FB App dashboard
- Facebook App Access Token: Rename to Meta block and add more clear instructions
- Preconnect Domains: Remove reference to non-existing documentation
---
 src/Settings.php | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/src/Settings.php b/src/Settings.php
index 86498d0aa0..24345f1712 100644
--- a/src/Settings.php
+++ b/src/Settings.php
@@ -367,16 +367,30 @@ public function __construct()
                         'name' => __('Facebook Page ID', 'planet4-master-theme-backend'),
                         'id' => 'facebook_page_id',
                         'type' => 'text',
+                        'desc' => __(
+                            'This is used by Facebook Insights to provide analytics for traffic to your site from Facebook.<br>
+                            Find the app ID in your <a href="https://business.facebook.com/business/loginpage/" target="_blank">App Dashboard</a>.',
+                            'planet4-master-theme-backend'
+                        ),
                     ],
                     [
                         'name' => __('Facebook App Access Token', 'planet4-master-theme-backend'),
                         'id' => 'fb_app_access_token',
                         'type' => 'text',
-                        'desc' => __('FB App Access Token is used to fetch FB & IG oembed in Social Media block.', 'planet4-master-theme-backend') . '<a href="">' . __('Read more', 'planet4-master-theme-backend') . '</a><Br>' . __('Alternatively you could also add FB App ID and App Secret in place of App Access Token.', 'planet4-master-theme-backend') . '<BR>eg. {your-app_id}|{your-app_secret}',
+                        'desc' => __(
+                            'This is used by the Meta block to fetch Facebook & Instagram embed information.<br>
+                            Alternatively you can use your own, if you have created a Business Facebook App
+                            (<a href="https://developers.facebook.com/docs/facebook-login/guides/access-tokens/#apptokens" target="_blank">Read more</a>).<br>
+                            You could add App ID and App Secret separated by a | character, instead of a Token (eg. {your-app_id}|{your-app_secret}).',
+                            'planet4-master-theme-backend'
+                        ),
                     ],
                     [
                         'name' => __('Preconnect Domains', 'planet4-master-theme-backend'),
-                        'desc' => __('Add a list of third-party URLs to "preconnect" (e.g.: https://in.hotjar.com). Look for "preconnect" in the P4 Handbook for details.', 'planet4-master-theme-backend'),
+                        'desc' => __(
+                            'Add a list of frequently used third-party services to "preconnect" (e.g.: https://in.hotjar.com).',
+                            'planet4-master-theme-backend'
+                        ),
                         'id' => 'preconnect_domains',
                         'type' => 'textarea',
                         'attributes' => [