From ed29f65bee5e2f5c595c83c150f5caa4187d0450 Mon Sep 17 00:00:00 2001
From: Francesc Bassas i Bullich <francesc@babu.cat>
Date: Thu, 25 May 2017 10:11:12 +0200
Subject: [PATCH] Add inline help on advanced search form

---
 templates/CRM/Contact/Form/Search/Advanced.hlp            | 8 ++++++++
 .../CRM/Contact/Form/Search/Criteria/Relationship.tpl     | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/templates/CRM/Contact/Form/Search/Advanced.hlp b/templates/CRM/Contact/Form/Search/Advanced.hlp
index 77a0649f6e..d9e25dd5f9 100644
--- a/templates/CRM/Contact/Form/Search/Advanced.hlp
+++ b/templates/CRM/Contact/Form/Search/Advanced.hlp
@@ -82,6 +82,14 @@
     <p>{ts}Use this filter to limit search results to relationships where the related contacts are part of a specific group or groups. For example, you might want to find all individuals who are employees ('Employee of' relationship type) of organizations which are in your 'Corporate Sponsors' group.{/ts}</p>
 {/htxt}
 
+{htxt id="id-relationship-active-period-title"}
+{ts}Active Period{/ts}
+{/htxt}
+{htxt id="id-relationship-active-period"}
+    <p>{ts}Use this filter to limit search results to relationships which were active during the specified time period (e.g. this is useful if you need to search all volunteer relationships that were active during 2014).{/ts}</p>
+    <p>{ts}By definition a relationship is active if any of these conditions occurs: (1) Start Date <= Current Date <= End Date (2) Start Date <= Current Date and End Date is not defined (3) Start Date is not defined and Current Date <= End Date{/ts}</p>
+{/htxt}
+
 {htxt id="id-all-tags-title"}
 {ts}Tags{/ts}
 {/htxt}
diff --git a/templates/CRM/Contact/Form/Search/Criteria/Relationship.tpl b/templates/CRM/Contact/Form/Search/Criteria/Relationship.tpl
index ae47f810a8..f0c3aef3c2 100644
--- a/templates/CRM/Contact/Form/Search/Criteria/Relationship.tpl
+++ b/templates/CRM/Contact/Form/Search/Criteria/Relationship.tpl
@@ -66,7 +66,7 @@
       {include file="CRM/Core/DateRange.tpl" fieldName="relation_end_date" from='_low' to='_high'}
     </tr>
     <tr>
-      <td colspan="2"><label>{ts}Active Period{/ts}</label></td>
+      <td colspan="2"><label>{ts}Active Period{/ts}</label> {help id="id-relationship-active-period" file="CRM/Contact/Form/Search/Advanced.hlp"}<br /></td>
     </tr>
     <tr>
       {include file="CRM/Core/DateRange.tpl" fieldName="relation_active_period_date" from='_low' to='_high'}
-- 
2.25.1