From f2a9ffd50fc8475c32bce8e80e9b85844273de38 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <jmiller-moko@noreply.git.mokoconsulting.tech>
Date: Sat, 20 Jun 2026 15:48:30 -0500
Subject: [PATCH] fix: show social style/URL fields only when a display
 position is enabled

Added showon conditions to style options and platform URL section so
they only appear when topbar, footer, or floating social is enabled.
Updated note to indicate at least one URL is required.
---
 source/language/en-GB/tpl_mokoonyx.ini |  2 +-
 source/language/en-US/tpl_mokoonyx.ini |  2 +-
 source/templateDetails.xml             | 18 ++++++++++++------
 3 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/source/language/en-GB/tpl_mokoonyx.ini b/source/language/en-GB/tpl_mokoonyx.ini
index 7676fa5..25e16e9 100644
--- a/source/language/en-GB/tpl_mokoonyx.ini
+++ b/source/language/en-GB/tpl_mokoonyx.ini
@@ -292,7 +292,7 @@ TPL_MOKOONYX_SOCIAL_COLOR_THEME="Theme (CSS variables)"
 TPL_MOKOONYX_SOCIAL_COLOR_BRAND="Brand colours"
 TPL_MOKOONYX_SOCIAL_COLOR_BLACK="Black"
 TPL_MOKOONYX_SOCIAL_COLOR_WHITE="White"
-TPL_MOKOONYX_SOCIAL_URLS_NOTE="<p>Enter the full URL for each platform. Leave blank to hide that icon.</p>"
+TPL_MOKOONYX_SOCIAL_URLS_NOTE="<p>At least one URL is required when a social display position is enabled. Leave unused platforms blank to hide their icons.</p>"
 TPL_MOKOONYX_SOCIAL_MAIL_DESC="Use a mailto: link (e.g. mailto:hello@example.com) or a contact page URL."
 TPL_MOKOONYX_SOCIAL_NAV_LABEL="Social media links"
 TPL_MOKOONYX_SOCIAL_FACEBOOK="Follow us on Facebook"
diff --git a/source/language/en-US/tpl_mokoonyx.ini b/source/language/en-US/tpl_mokoonyx.ini
index 86f586d..3e60211 100644
--- a/source/language/en-US/tpl_mokoonyx.ini
+++ b/source/language/en-US/tpl_mokoonyx.ini
@@ -292,7 +292,7 @@ TPL_MOKOONYX_SOCIAL_COLOR_THEME="Theme (CSS variables)"
 TPL_MOKOONYX_SOCIAL_COLOR_BRAND="Brand colors"
 TPL_MOKOONYX_SOCIAL_COLOR_BLACK="Black"
 TPL_MOKOONYX_SOCIAL_COLOR_WHITE="White"
-TPL_MOKOONYX_SOCIAL_URLS_NOTE="<p>Enter the full URL for each platform. Leave blank to hide that icon.</p>"
+TPL_MOKOONYX_SOCIAL_URLS_NOTE="<p>At least one URL is required when a social display position is enabled. Leave unused platforms blank to hide their icons.</p>"
 TPL_MOKOONYX_SOCIAL_MAIL_DESC="Use a mailto: link (e.g. mailto:hello@example.com) or a contact page URL."
 TPL_MOKOONYX_SOCIAL_NAV_LABEL="Social media links"
 TPL_MOKOONYX_SOCIAL_FACEBOOK="Follow us on Facebook"
diff --git a/source/templateDetails.xml b/source/templateDetails.xml
index 8a15b21..441f3c9 100644
--- a/source/templateDetails.xml
+++ b/source/templateDetails.xml
@@ -356,22 +356,26 @@
 				</field>
 
 				<!-- Style options -->
-				<field name="social_sep_style" type="spacer" label="Style" hr="false" class="text fw-bold" />
+				<field name="social_sep_style" type="spacer" label="Style" hr="false" class="text fw-bold"
+							 showon="social_topbar:1[OR]social_footer:1[OR]social_floating:1" />
 				<field name="social_icon_style" type="list" default="plain"
-							 label="TPL_MOKOONYX_SOCIAL_STYLE_LABEL" description="TPL_MOKOONYX_SOCIAL_STYLE_DESC">
+							 label="TPL_MOKOONYX_SOCIAL_STYLE_LABEL" description="TPL_MOKOONYX_SOCIAL_STYLE_DESC"
+							 showon="social_topbar:1[OR]social_footer:1[OR]social_floating:1">
 					<option value="plain">TPL_MOKOONYX_SOCIAL_STYLE_PLAIN</option>
 					<option value="square">TPL_MOKOONYX_SOCIAL_STYLE_SQUARE</option>
 					<option value="circle">TPL_MOKOONYX_SOCIAL_STYLE_CIRCLE</option>
 					<option value="rounded">TPL_MOKOONYX_SOCIAL_STYLE_ROUNDED</option>
 				</field>
 				<field name="social_icon_size" type="list" default="md"
-							 label="TPL_MOKOONYX_SOCIAL_SIZE_LABEL" description="TPL_MOKOONYX_SOCIAL_SIZE_DESC">
+							 label="TPL_MOKOONYX_SOCIAL_SIZE_LABEL" description="TPL_MOKOONYX_SOCIAL_SIZE_DESC"
+							 showon="social_topbar:1[OR]social_footer:1[OR]social_floating:1">
 					<option value="sm">TPL_MOKOONYX_SOCIAL_SIZE_SM</option>
 					<option value="md">TPL_MOKOONYX_SOCIAL_SIZE_MD</option>
 					<option value="lg">TPL_MOKOONYX_SOCIAL_SIZE_LG</option>
 				</field>
 				<field name="social_icon_color" type="list" default="theme"
-							 label="TPL_MOKOONYX_SOCIAL_COLOR_LABEL" description="TPL_MOKOONYX_SOCIAL_COLOR_DESC">
+							 label="TPL_MOKOONYX_SOCIAL_COLOR_LABEL" description="TPL_MOKOONYX_SOCIAL_COLOR_DESC"
+							 showon="social_topbar:1[OR]social_footer:1[OR]social_floating:1">
 					<option value="theme">TPL_MOKOONYX_SOCIAL_COLOR_THEME</option>
 					<option value="brand">TPL_MOKOONYX_SOCIAL_COLOR_BRAND</option>
 					<option value="black">TPL_MOKOONYX_SOCIAL_COLOR_BLACK</option>
@@ -379,8 +383,10 @@
 				</field>
 
 				<!-- Platform URLs -->
-				<field name="social_sep_urls" type="spacer" label="Platform URLs" hr="false" class="text fw-bold" />
-				<field name="social_urls_note" type="note" description="TPL_MOKOONYX_SOCIAL_URLS_NOTE" />
+				<field name="social_sep_urls" type="spacer" label="Platform URLs" hr="false" class="text fw-bold"
+							 showon="social_topbar:1[OR]social_footer:1[OR]social_floating:1" />
+				<field name="social_urls_note" type="note" description="TPL_MOKOONYX_SOCIAL_URLS_NOTE"
+							 showon="social_topbar:1[OR]social_footer:1[OR]social_floating:1" />
 				<field name="social_facebook_url" type="url" default="" label="Facebook" filter="url" />
 				<field name="social_twitter_url" type="url" default="" label="X / Twitter" filter="url" />
 				<field name="social_instagram_url" type="url" default="" label="Instagram" filter="url" />
-- 
2.52.0