1 | <?php |
---|
2 | /** |
---|
3 | * Core Avatars attachment class |
---|
4 | * |
---|
5 | * @package BuddyPress |
---|
6 | * @subpackage Core |
---|
7 | */ |
---|
8 | |
---|
9 | // Exit if accessed directly |
---|
10 | defined( 'ABSPATH' ) || exit; |
---|
11 | |
---|
12 | /** |
---|
13 | * BP Attachment Avatar class |
---|
14 | * |
---|
15 | * Extends BP Attachment to manage the avatar uploads |
---|
16 | * |
---|
17 | * @since BuddyPress (2.3.0) |
---|
18 | */ |
---|
19 | class BP_Attachment_Avatar extends BP_Attachment { |
---|
20 | |
---|
21 | /** |
---|
22 | * Construct Upload parameters |
---|
23 | * |
---|
24 | * @since BuddyPress (2.3.0) |
---|
25 | * |
---|
26 | * @see BP_Attachment::__construct() for list of parameters |
---|
27 | * @uses bp_core_avatar_original_max_filesize() |
---|
28 | * @uses BP_Attachment::__construct() |
---|
29 | */ |
---|
30 | public function __construct() { |
---|
31 | // Allowed avatar types |
---|
32 | $allowed_types = bp_core_get_allowed_avatar_types(); |
---|
33 | |
---|
34 | parent::__construct( array( |
---|
35 | 'action' => 'bp_avatar_upload', |
---|
36 | 'file_input' => 'file', |
---|
37 | 'original_max_filesize' => bp_core_avatar_original_max_filesize(), |
---|
38 | |
---|
39 | // Specific errors for avatars |
---|
40 | 'upload_error_strings' => array( |
---|
41 | 9 => sprintf( __( 'That photo is too big. Please upload one smaller than %s', 'buddypress' ), size_format( bp_core_avatar_original_max_filesize() ) ), |
---|
42 | 10 => sprintf( _n( 'Please upload only this file type: %s.', 'Please upload only these file types: %s.', count( $allowed_types ), 'buddypress' ), self::get_avatar_types( $allowed_types ) ), |
---|
43 | ), |
---|
44 | ) ); |
---|
45 | } |
---|
46 | |
---|
47 | /** |
---|
48 | * Gets the available avatar types |
---|
49 | * |
---|
50 | * @since BuddyPress (2.3.0) |
---|
51 | * @return string comma separated list of allowed avatar types |
---|
52 | */ |
---|
53 | public static function get_avatar_types( $allowed_types = array() ) { |
---|
54 | $types = array_map( 'strtoupper', $allowed_types ); |
---|
55 | $comma = _x( ',', 'avatar types separator', 'buddypress' ); |
---|
56 | return join( $comma . ' ', $types ); |
---|
57 | } |
---|
58 | |
---|
59 | /** |
---|
60 | * Set Upload Dir data for avatars |
---|
61 | * |
---|
62 | * @since BuddyPress (2.3.0) |
---|
63 | * |
---|
64 | * @uses bp_core_avatar_upload_path() |
---|
65 | * @uses bp_core_avatar_url() |
---|
66 | * @uses bp_upload_dir() |
---|
67 | * @uses BP_Attachment::set_upload_dir() |
---|
68 | */ |
---|
69 | public function set_upload_dir() { |
---|
70 | if ( bp_core_avatar_upload_path() && bp_core_avatar_url() ) { |
---|
71 | $this->upload_path = bp_core_avatar_upload_path(); |
---|
72 | $this->url = bp_core_avatar_url(); |
---|
73 | $this->upload_dir = bp_upload_dir(); |
---|
74 | } else { |
---|
75 | parent::set_upload_dir(); |
---|
76 | } |
---|
77 | } |
---|
78 | |
---|
79 | /** |
---|
80 | * Avatar specific rules |
---|
81 | * |
---|
82 | * Adds an error if the avatar size or type don't match BuddyPress needs |
---|
83 | * The error code is the index of $upload_error_strings |
---|
84 | * |
---|
85 | * @since BuddyPress (2.3.0) |
---|
86 | * |
---|
87 | * @param array $file the temporary file attributes (before it has been moved) |
---|
88 | * @uses bp_core_check_avatar_size() |
---|
89 | * @uses bp_core_check_avatar_type() |
---|
90 | * @return array the file with extra errors if needed |
---|
91 | */ |
---|
92 | public function validate_upload( $file = array() ) { |
---|
93 | // Bail if already an error |
---|
94 | if ( ! empty( $file['error'] ) ) { |
---|
95 | return $file; |
---|
96 | } |
---|
97 | |
---|
98 | // File size is too big |
---|
99 | if ( ! bp_core_check_avatar_size( array( 'file' => $file ) ) ) { |
---|
100 | $file['error'] = 9; |
---|
101 | |
---|
102 | // File is of invalid type |
---|
103 | } elseif ( ! bp_core_check_avatar_type( array( 'file' => $file ) ) ) { |
---|
104 | $file['error'] = 10; |
---|
105 | } |
---|
106 | |
---|
107 | // Return with error code attached |
---|
108 | return $file; |
---|
109 | } |
---|
110 | |
---|
111 | /** |
---|
112 | * Maybe shrink the attachment to fit maximum allowed width |
---|
113 | * |
---|
114 | * @since BuddyPress (2.3.0) |
---|
115 | * |
---|
116 | * @param string $file the absolute path to the file |
---|
117 | * @uses bp_core_avatar_original_max_width() |
---|
118 | * @uses wp_get_image_editor() |
---|
119 | * @return mixed |
---|
120 | */ |
---|
121 | public static function shrink( $file = '' ) { |
---|
122 | // Get image size |
---|
123 | $size = @getimagesize( $file ); |
---|
124 | $retval = false; |
---|
125 | |
---|
126 | // Check image size and shrink if too large |
---|
127 | if ( $size[0] > bp_core_avatar_original_max_width() ) { |
---|
128 | $editor = wp_get_image_editor( $file ); |
---|
129 | |
---|
130 | if ( ! is_wp_error( $editor ) ) { |
---|
131 | $editor->set_quality( 100 ); |
---|
132 | |
---|
133 | $resized = $editor->resize( bp_core_avatar_original_max_width(), bp_core_avatar_original_max_width(), false ); |
---|
134 | if ( ! is_wp_error( $resized ) ) { |
---|
135 | $thumb = $editor->save( $editor->generate_filename() ); |
---|
136 | } else { |
---|
137 | $retval = $resized; |
---|
138 | } |
---|
139 | |
---|
140 | // Check for thumbnail creation errors |
---|
141 | if ( ( false === $retval ) && is_wp_error( $thumb ) ) { |
---|
142 | $retval = $thumb; |
---|
143 | } |
---|
144 | |
---|
145 | // Thumbnail is good so proceed |
---|
146 | if ( false === $retval ) { |
---|
147 | $retval = $thumb; |
---|
148 | } |
---|
149 | |
---|
150 | } else { |
---|
151 | $retval = $editor; |
---|
152 | } |
---|
153 | } |
---|
154 | |
---|
155 | return $retval; |
---|
156 | } |
---|
157 | |
---|
158 | /** |
---|
159 | * Check if the image dimensions are smaller than full avatar dimensions |
---|
160 | * |
---|
161 | * @since BuddyPress (2.3.0) |
---|
162 | * |
---|
163 | * @param string $file the absolute path to the file |
---|
164 | * @uses bp_core_avatar_full_width() |
---|
165 | * @uses bp_core_avatar_full_height() |
---|
166 | * @return boolean |
---|
167 | */ |
---|
168 | public static function is_too_small( $file = '' ) { |
---|
169 | $uploaded_image = @getimagesize( $file ); |
---|
170 | $full_width = bp_core_avatar_full_width(); |
---|
171 | $full_height = bp_core_avatar_full_height(); |
---|
172 | |
---|
173 | if ( isset( $uploaded_image[0] ) && $uploaded_image[0] < $full_width || $uploaded_image[1] < $full_height ) { |
---|
174 | return true; |
---|
175 | } |
---|
176 | |
---|
177 | return false; |
---|
178 | } |
---|
179 | |
---|
180 | /** |
---|
181 | * Crop the avatar |
---|
182 | * |
---|
183 | * @since BuddyPress (2.3.0) |
---|
184 | * |
---|
185 | * @see BP_Attachment::crop for the list of parameters |
---|
186 | * @param array $args |
---|
187 | * @uses bp_core_fetch_avatar() |
---|
188 | * @uses bp_core_delete_existing_avatar() |
---|
189 | * @uses bp_core_avatar_full_width() |
---|
190 | * @uses bp_core_avatar_full_height() |
---|
191 | * @uses bp_core_avatar_dimension() |
---|
192 | * @uses BP_Attachment::crop |
---|
193 | * @return array the cropped avatars (full and thumb) |
---|
194 | */ |
---|
195 | public function crop( $args = array() ) { |
---|
196 | // Bail if the original file is missing |
---|
197 | if ( empty( $args['original_file'] ) ) { |
---|
198 | return false; |
---|
199 | } |
---|
200 | |
---|
201 | /** |
---|
202 | * Original file is a relative path to the image |
---|
203 | * eg: /avatars/1/avatar.jpg |
---|
204 | */ |
---|
205 | $relative_path = $args['original_file']; |
---|
206 | $absolute_path = $this->upload_path . $relative_path; |
---|
207 | |
---|
208 | // Bail if the avatar is not available |
---|
209 | if ( ! file_exists( $absolute_path ) ) { |
---|
210 | return false; |
---|
211 | } |
---|
212 | |
---|
213 | if ( empty( $args['item_id'] ) ) { |
---|
214 | |
---|
215 | /** This filter is documented in bp-core/bp-core-avatars.php */ |
---|
216 | $avatar_folder_dir = apply_filters( 'bp_core_avatar_folder_dir', dirname( $absolute_path ), $args['item_id'], $args['object'], $args['avatar_dir'] ); |
---|
217 | } else { |
---|
218 | |
---|
219 | /** This filter is documented in bp-core/bp-core-avatars.php */ |
---|
220 | $avatar_folder_dir = apply_filters( 'bp_core_avatar_folder_dir', $this->upload_path . '/' . $args['avatar_dir'] . '/' . $args['item_id'], $args['item_id'], $args['object'], $args['avatar_dir'] ); |
---|
221 | } |
---|
222 | |
---|
223 | // Bail if the avatar folder is missing for this item_id |
---|
224 | if ( ! file_exists( $avatar_folder_dir ) ) { |
---|
225 | return false; |
---|
226 | } |
---|
227 | |
---|
228 | // Delete the existing avatar files for the object |
---|
229 | $existing_avatar = bp_core_fetch_avatar( array( |
---|
230 | 'object' => $args['object'], |
---|
231 | 'item_id' => $args['item_id'], |
---|
232 | 'html' => false, |
---|
233 | ) ); |
---|
234 | |
---|
235 | /** |
---|
236 | * Check that the new avatar doesn't have the same name as the |
---|
237 | * old one before deleting |
---|
238 | */ |
---|
239 | if ( ! empty( $existing_avatar ) && $existing_avatar !== $this->url . $relative_path ) { |
---|
240 | bp_core_delete_existing_avatar( array( 'object' => $args['object'], 'item_id' => $args['item_id'], 'avatar_path' => $avatar_folder_dir ) ); |
---|
241 | } |
---|
242 | |
---|
243 | // Make sure we at least have minimal data for cropping |
---|
244 | if ( empty( $args['crop_w'] ) ) { |
---|
245 | $args['crop_w'] = bp_core_avatar_full_width(); |
---|
246 | } |
---|
247 | |
---|
248 | if ( empty( $args['crop_h'] ) ) { |
---|
249 | $args['crop_h'] = bp_core_avatar_full_height(); |
---|
250 | } |
---|
251 | |
---|
252 | // Get the file extension |
---|
253 | $data = @getimagesize( $absolute_path ); |
---|
254 | $ext = $data['mime'] == 'image/png' ? 'png' : 'jpg'; |
---|
255 | |
---|
256 | $args['original_file'] = $absolute_path; |
---|
257 | $args['src_abs'] = false; |
---|
258 | $avatar_types = array( 'full' => '', 'thumb' => '' ); |
---|
259 | |
---|
260 | foreach ( $avatar_types as $key_type => $type ) { |
---|
261 | $args['dst_w'] = bp_core_avatar_full_width(); |
---|
262 | $args['dst_h'] = bp_core_avatar_full_height(); |
---|
263 | /*BUG FIX start*/ |
---|
264 | if($key_type=='thumb'){ |
---|
265 | $args['dst_w'] = bp_core_avatar_thumb_width(); |
---|
266 | $args['dst_h'] = bp_core_avatar_thumb_height(); |
---|
267 | } |
---|
268 | /*BUG FIX end*/ |
---|
269 | $args['dst_file'] = $avatar_folder_dir . '/' . wp_hash( $absolute_path . time() ) . '-bp' . $key_type . '.' . $ext; |
---|
270 | |
---|
271 | $avatar_types[ $key_type ] = parent::crop( $args ); |
---|
272 | } |
---|
273 | |
---|
274 | // Remove the original |
---|
275 | @unlink( $absolute_path ); |
---|
276 | |
---|
277 | // Return the full and thumb cropped avatars |
---|
278 | return $avatar_types; |
---|
279 | } |
---|
280 | |
---|
281 | /** |
---|
282 | * Get the user id to set its avatar |
---|
283 | * |
---|
284 | * @since BuddyPress (2.3.0) |
---|
285 | * |
---|
286 | * @return integer the user ID |
---|
287 | */ |
---|
288 | private function get_user_id() { |
---|
289 | $bp = buddypress(); |
---|
290 | $user_id = 0; |
---|
291 | |
---|
292 | if ( bp_is_user() ) { |
---|
293 | $user_id = bp_displayed_user_id(); |
---|
294 | } |
---|
295 | |
---|
296 | if ( ! empty( $bp->members->admin->user_id ) ) { |
---|
297 | $user_id = $bp->members->admin->user_id; |
---|
298 | } |
---|
299 | |
---|
300 | return $user_id; |
---|
301 | } |
---|
302 | |
---|
303 | /** |
---|
304 | * Get the group id to set its avatar |
---|
305 | * |
---|
306 | * @since BuddyPress (2.3.0) |
---|
307 | * |
---|
308 | * @return integer the group id |
---|
309 | */ |
---|
310 | private function get_group_id() { |
---|
311 | $group_id = 0; |
---|
312 | |
---|
313 | if ( bp_is_group() ) { |
---|
314 | $group_id = bp_get_current_group_id(); |
---|
315 | } |
---|
316 | |
---|
317 | return $group_id; |
---|
318 | } |
---|
319 | |
---|
320 | /** |
---|
321 | * Build script datas for the Uploader UI |
---|
322 | * |
---|
323 | * @since BuddyPress (2.3.0) |
---|
324 | * |
---|
325 | * @return array the javascript localization data |
---|
326 | */ |
---|
327 | public function script_data() { |
---|
328 | // Get default script data |
---|
329 | $script_data = parent::script_data(); |
---|
330 | |
---|
331 | // Defaults to Avatar Backbone script |
---|
332 | $js_scripts = array( 'bp-avatar' ); |
---|
333 | |
---|
334 | // Default object |
---|
335 | $object = ''; |
---|
336 | |
---|
337 | // Get the possible item ids |
---|
338 | $user_id = $this->get_user_id(); |
---|
339 | $group_id = $this->get_group_id(); |
---|
340 | |
---|
341 | if ( ! empty( $user_id ) ) { |
---|
342 | // Should we load the the Webcam Avatar javascript file |
---|
343 | if ( bp_avatar_use_webcam() ) { |
---|
344 | $js_scripts = array( 'bp-webcam' ); |
---|
345 | } |
---|
346 | |
---|
347 | $script_data['bp_params'] = array( |
---|
348 | 'object' => 'user', |
---|
349 | 'item_id' => $user_id, |
---|
350 | 'has_avatar' => bp_get_user_has_avatar( $user_id ), |
---|
351 | 'nonces' => array( |
---|
352 | 'set' => wp_create_nonce( 'bp_avatar_cropstore' ), |
---|
353 | 'remove' => wp_create_nonce( 'bp_delete_avatar_link' ), |
---|
354 | ), |
---|
355 | ); |
---|
356 | |
---|
357 | // Set feedback messages |
---|
358 | $script_data['feedback_messages'] = array( |
---|
359 | 1 => __( 'There was a problem cropping your profile photo.', 'buddypress' ), |
---|
360 | 2 => __( 'Your new profile photo was uploaded successfully.', 'buddypress' ), |
---|
361 | 3 => __( 'There was a problem deleting your profile photo. Please try again.', 'buddypress' ), |
---|
362 | 4 => __( 'Your profile photo was deleted successfully!', 'buddypress' ), |
---|
363 | ); |
---|
364 | } elseif ( ! empty( $group_id ) ) { |
---|
365 | $script_data['bp_params'] = array( |
---|
366 | 'object' => 'group', |
---|
367 | 'item_id' => $group_id, |
---|
368 | 'has_avatar' => bp_get_group_has_avatar( $group_id ), |
---|
369 | 'nonces' => array( |
---|
370 | 'set' => wp_create_nonce( 'bp_avatar_cropstore' ), |
---|
371 | 'remove' => wp_create_nonce( 'bp_group_avatar_delete' ), |
---|
372 | ), |
---|
373 | ); |
---|
374 | |
---|
375 | // Set feedback messages |
---|
376 | $script_data['feedback_messages'] = array( |
---|
377 | 1 => __( 'There was a problem cropping the group profile photo.', 'buddypress' ), |
---|
378 | 2 => __( 'The group profile photo was uploaded successfully.', 'buddypress' ), |
---|
379 | 3 => __( 'There was a problem deleting the group profile photo. Please try again.', 'buddypress' ), |
---|
380 | 4 => __( 'The group profile photo was deleted successfully!', 'buddypress' ), |
---|
381 | ); |
---|
382 | } else { |
---|
383 | /** |
---|
384 | * Use this filter to include specific BuddyPress params for your object |
---|
385 | * e.g. Blavatar |
---|
386 | * |
---|
387 | * @since BuddyPress (2.3.0) |
---|
388 | * |
---|
389 | * @param array the avatar specific BuddyPress parameters |
---|
390 | */ |
---|
391 | $script_data['bp_params'] = apply_filters( 'bp_attachment_avatar_params', array() ); |
---|
392 | } |
---|
393 | |
---|
394 | // Include the specific css |
---|
395 | $script_data['extra_css'] = array( 'bp-avatar' ); |
---|
396 | |
---|
397 | // Include the specific css |
---|
398 | $script_data['extra_js'] = $js_scripts; |
---|
399 | |
---|
400 | // Set the object to contextualize the filter |
---|
401 | if ( isset( $script_data['bp_params']['object'] ) ) { |
---|
402 | $object = $script_data['bp_params']['object']; |
---|
403 | } |
---|
404 | |
---|
405 | /** |
---|
406 | * Use this filter to override/extend the avatar script data |
---|
407 | * |
---|
408 | * @since BuddyPress (2.3.0) |
---|
409 | * |
---|
410 | * @param array $script_data the avatar script data |
---|
411 | * @param string $object the object the avatar belongs to (eg: user or group) |
---|
412 | */ |
---|
413 | return apply_filters( 'bp_attachment_avatar_script_data', $script_data, $object ); |
---|
414 | } |
---|
415 | } |
---|