From 10ede6e592a01893d74b43d016031f64c9b34de4 Mon Sep 17 00:00:00 2001
From: Coleman Watts <coleman@civicrm.org>
Date: Fri, 10 Oct 2014 10:44:55 -0400
Subject: [PATCH] Document deprecation of AdvMultiSelect widget

---
 CRM/Custom/Form/Field.php           |  2 +-
 templates/CRM/Custom/Form/Field.tpl | 14 ++++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/CRM/Custom/Form/Field.php b/CRM/Custom/Form/Field.php
index e45f7fcca3..6c95748674 100644
--- a/CRM/Custom/Form/Field.php
+++ b/CRM/Custom/Form/Field.php
@@ -138,7 +138,7 @@ class CRM_Custom_Form_Field extends CRM_Core_Form {
       self::$_dataToLabels = array(
         array('Text' => ts('Text'), 'Select' => ts('Select'),
           'Radio' => ts('Radio'), 'CheckBox' => ts('CheckBox'), 'Multi-Select' => ts('Multi-Select'),
-          'AdvMulti-Select' => ts('Advanced Multi-Select'),
+          'AdvMulti-Select' => ts('Adv Multi-Select (obsolete)'),
           'Autocomplete-Select' => ts('Autocomplete Select'),
         ),
         array('Text' => ts('Text'), 'Select' => ts('Select'),
diff --git a/templates/CRM/Custom/Form/Field.tpl b/templates/CRM/Custom/Form/Field.tpl
index 2154128789..355b4b6bb3 100644
--- a/templates/CRM/Custom/Form/Field.tpl
+++ b/templates/CRM/Custom/Form/Field.tpl
@@ -289,6 +289,20 @@ function custom_option_html_type( ) {
     </div>
 {literal}
 <script type="text/javascript">
+  CRM.$(function($) {
+    var $form = $('form.{/literal}{$form.formClass}{literal}'),
+      deprecatedNotice;
+    function deprecatedWidgets() {
+      deprecatedNotice && deprecatedNotice.close && deprecatedNotice.close();
+      switch ($('#data_type_1', $form).val()) {
+        case 'AdvMulti-Select':
+          deprecatedNotice = CRM.alert({/literal}'{ts escape="js"}The old "Advance Multi-Select" widget is being phased out and will be removed in a future version of CiviCRM. "Multi-Select" is the recommended substitute.{/ts}', '{ts escape="js"}Obsolete widget{/ts}'{literal}, 'alert', {expires: 0});
+          break;
+      }
+    }
+    $('#data_type_1', $form).each(deprecatedWidgets).change(deprecatedWidgets);
+  });
+
     //when page is reload, build show hide boxes
     //as per data type and html type selected.
     custom_option_html_type( );
-- 
2.25.1