Changeset 9757 for trunk/src/bp-core/bp-core-avatars.php

Timestamp:

04/16/2015 10:36:38 PM (10 years ago)

Author:

imath

Message:

Avatar UI: Add Backbone templates and adapt the legacy avatar templates.

The Backone templates will be in a new "assets" sub directory of bp-templates\bp-legacy\buddypress. For the introduction of the feature we are advising you *to not override* these specific templates from your theme. The underscore in each sub folder names of this "assets" directory is informing we wish to restrict the content of the sub folder to Core use only.

We are introducing a new template tag to load these Backbone templates : bp_avatar_get_templates(). We recommand that you update the avatar templates of your theme if you are overriding groups/create, groups/single/admin or members/single/profile/change-avatar once 2.3 will be released. If this new template tag is not into the template, then bp_avatar_template_check() will try to load them using template hooks.

Props johnjamesjacoby, hnla, r-a-y.

See #6290

File:

• trunk/src/bp-core/bp-core-avatars.php (modified) (1 diff)

trunk/src/bp-core/bp-core-avatars.php

@@ -1438 +1438 @@
     return apply_filters( 'bp_avatar_use_webcam', true );
 }
+
+/**
+ * Template function to load the Avatar UI javascript templates
+ *
+ * @since  BuddyPress (2.3.0)
+ */
+function bp_avatar_get_templates() {
+    if ( ! bp_avatar_is_front_edit() ) {
+        return;
+    }
+
+    bp_attachments_get_template_part( 'avatars/index' );
+}
+
+/**
+ * Trick to check if the theme's BuddyPress templates are up to date
+ *
+ * If the "avatar templates" are not including the new template tag, this will
+ * help users to get the avatar UI and inform the most curious that their
+ * templates are out of date.
+ *
+ * @since  BuddyPress (2.3.0)
+ */
+function bp_avatar_template_check() {
+    if ( ! bp_avatar_is_front_edit() ) {
+        return;
+    }
+
+    if ( ! did_action( 'bp_attachments_avatar_check_template' ) ) {
+        bp_attachments_get_template_part( 'avatars/index' );
+    }
+}