Changeset 10557 for trunk/src/bp-xprofile/classes/class-bp-xprofile-field.php

Timestamp:

02/08/2016 04:52:44 PM (10 years ago)

Author:

boonebgorges

Message:

Introduced 'Autolink' setting for XProfile fields.

Since BP 1.1, XProfile fields have been "autolinked". This means that a user's
entry for profile fields is linked to a search of the Members directory, using
that field's value as a search term. For short values - say, "Wichita, KS" for
the field "City" - the entire field value would be a link to a member search
on the phrase "Wichita, KS". For longer values, as in a multiline text field,
an algorithm detects "lists" (words between commas) and creates links
from them.

This feature was intended to aid in user discovery and serendipity. Sometimes
it works. But sometimes it makes very little sense.

This changeset introduces the ability for administrators to configure this
setting, on a per-field basis.

• The new Autolink metabox on the XProfile Field Admin panel lets admin enable or disable the feature.
• Smart defaults are pre-selected for new fields, or fields for which no value has yet to be saved. Namely: "multi fields" like checkboxes and radio buttons have Autolink enabled by default, while "single fields" have it disabled.

Props LenLay, sooskriszta, jeffsayre, boonebgorges.
Fixes #787.

File:

• trunk/src/bp-xprofile/classes/class-bp-xprofile-field.php (modified) (4 diffs)

trunk/src/bp-xprofile/classes/class-bp-xprofile-field.php

@@ -129 +129 @@
      */
     protected $allow_custom_visibility;
+
+    /**
+     * Whether values from this field are autolinked to directory searches.
+     *
+     * @since 2.5.0
+     *
+     * @var bool
+     */
+    public $do_autolink;
 
     /**
@@ -793 +802 @@
     }
 
+    /**
+     * Get whether the field values should be auto-linked to a directory search.
+     *
+     * Lazy-loaded to reduce overhead.
+     *
+     * Defaults to true for multi and default fields, false for single fields.
+     *
+     * @since 2.5.0
+     *
+     * @return bool
+     */
+    public function get_do_autolink() {
+        if ( ! isset( $this->do_autolink ) ) {
+            $do_autolink = bp_xprofile_get_meta( $this->id, 'field', 'do_autolink' );
+
+            if ( '' === $do_autolink ) {
+                $this->do_autolink = $this->is_default_field() || $this->type_obj->supports_options;
+            } else {
+                $this->do_autolink = 'on' === $do_autolink;
+            }
+        }
+
+        return $this->do_autolink;
+    }
+
     /* Static Methods ********************************************************/
 
@@ -1138 +1172 @@
                             // Output the field visibility metaboxes.
                             $this->visibility_metabox();
+
+                            // Output the autolink metabox.
+                            $this->autolink_metabox();
+
 
                             /**
@@ -1412 +1450 @@
 
     /**
+     * Private method used to output autolink metabox.
+     *
+     * @since 2.5.0
+     *
+     * @return void If default field id 1.
+     */
+    private function autolink_metabox() {
+
+        // Default field cannot have custom visibility.
+        if ( true === $this->is_default_field() ) {
+            return;
+        }
+
+        ?>
+
+        <div class="postbox">
+            <h2><label for="do-autolink"><?php esc_html_e( 'Autolink', 'buddypress' ); ?></label></h2>
+            <div class="inside">
+                <p class="description"><?php esc_html_e( 'On user profiles, link this field to a search of the Members directory, using the field value as a search term:', 'buddypress' ); ?></p>
+
+                <p>
+                    <label>
+                        <select name="do_autolink" id="do-autolink">
+                            <option value="on" <?php selected( $this->get_do_autolink() ); ?>><?php esc_html_e( 'Enabled', 'buddypress' ); ?></option>
+                            <option value="" <?php selected( $this->get_do_autolink(), false ); ?>><?php esc_html_e( 'Disabled', 'buddypress' ); ?></option>
+                        </select>
+                    </label>
+                </p>
+            </div>
+        </div>
+
+        <?php
+    }
+
+    /**
      * Output the metabox for setting what type of field this is.
      *