groups_action_create_group()
Catch and process group creation form submissions.
Description
Return
(bool)
Source
File: bp-groups/actions/create.php
function groups_action_create_group() { // If we're not at domain.org/groups/create/ then return false. if ( !bp_is_groups_component() || !bp_is_current_action( 'create' ) ) return false; if ( !is_user_logged_in() ) return false; if ( !bp_user_can_create_groups() ) { bp_core_add_message( __( 'Sorry, you are not allowed to create groups.', 'buddyboss' ), 'error' ); bp_core_redirect( bp_get_groups_directory_permalink() ); } $bp = buddypress(); // Make sure creation steps are in the right order. groups_action_sort_creation_steps(); // If no current step is set, reset everything so we can start a fresh group creation. $bp->groups->current_create_step = bp_action_variable( 1 ); if ( !bp_get_groups_current_create_step() ) { unset( $bp->groups->current_create_step ); unset( $bp->groups->completed_create_steps ); setcookie( 'bp_new_group_id', false, time() - 1000, COOKIEPATH, COOKIE_DOMAIN, is_ssl() ); setcookie( 'bp_completed_create_steps', false, time() - 1000, COOKIEPATH, COOKIE_DOMAIN, is_ssl() ); $reset_steps = true; $keys = array_keys( $bp->groups->group_creation_steps ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create/step/' . array_shift( $keys ) ) ); } // If this is a creation step that is not recognized, just redirect them back to the first screen. if ( bp_get_groups_current_create_step() && empty( $bp->groups->group_creation_steps[bp_get_groups_current_create_step()] ) ) { bp_core_add_message( __('There was an error saving group details. Please try again.', 'buddyboss'), 'error' ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create' ) ); } // Fetch the currently completed steps variable. if ( isset( $_COOKIE['bp_completed_create_steps'] ) && !isset( $reset_steps ) ) $bp->groups->completed_create_steps = json_decode( base64_decode( stripslashes( $_COOKIE['bp_completed_create_steps'] ) ) ); // Set the ID of the new group, if it has already been created in a previous step. if ( bp_get_new_group_id() ) { $bp->groups->current_group = groups_get_group( $bp->groups->new_group_id ); // Only allow the group creator to continue to edit the new group. if ( ! bp_is_group_creator( $bp->groups->current_group, bp_loggedin_user_id() ) ) { bp_core_add_message( __( 'Only the group organizer may continue editing this group.', 'buddyboss' ), 'error' ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create' ) ); } } // If the save, upload or skip button is hit, lets calculate what we need to save. if ( isset( $_POST['save'] ) ) { // Check the nonce. check_admin_referer( 'groups_create_save_' . bp_get_groups_current_create_step() ); if ( 'group-details' == bp_get_groups_current_create_step() ) { if ( empty( $_POST['group-name'] ) || !strlen( trim( $_POST['group-name'] ) ) ) { bp_core_add_message( __( 'Please fill in all of the required fields', 'buddyboss' ), 'error' ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create/step/' . bp_get_groups_current_create_step() ) ); } $new_group_id = isset( $bp->groups->new_group_id ) ? $bp->groups->new_group_id : 0; if ( !$bp->groups->new_group_id = groups_create_group( array( 'group_id' => $new_group_id, 'name' => $_POST['group-name'], 'description' => $_POST['group-desc'], 'slug' => groups_check_slug( sanitize_title( esc_attr( $_POST['group-name'] ) ) ), 'date_created' => bp_core_current_time(), 'status' => 'public' ) ) ) { bp_core_add_message( __( 'There was an error saving group details. Please try again.', 'buddyboss' ), 'error' ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create/step/' . bp_get_groups_current_create_step() ) ); } } if ( 'group-settings' == bp_get_groups_current_create_step() ) { $group_status = 'public'; $group_enable_forum = 1; if ( !isset($_POST['group-show-forum']) ) { $group_enable_forum = 0; } if ( 'private' == $_POST['group-status'] ) $group_status = 'private'; elseif ( 'hidden' == $_POST['group-status'] ) $group_status = 'hidden'; $parent_id = ( isset( $_POST['bp-groups-parent'] ) ) ? $_POST['bp-groups-parent'] : 0; if ( !$bp->groups->new_group_id = groups_create_group( array( 'group_id' => $bp->groups->new_group_id, 'status' => $group_status, 'enable_forum' => $group_enable_forum, 'parent_id' => $parent_id ) ) ) { bp_core_add_message( __( 'There was an error saving group details. Please try again.', 'buddyboss' ), 'error' ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create/step/' . bp_get_groups_current_create_step() ) ); } // Save group types. if ( ! empty( $_POST['group-types'] ) ) { bp_groups_set_group_type( $bp->groups->new_group_id, $_POST['group-types'] ); } /** * Filters the allowed invite statuses. * * @since BuddyPress 1.5.0 * * @param array $value Array of statuses allowed. * Possible values are 'members, * 'mods', and 'admins'. */ $allowed_invite_status = apply_filters( 'groups_allowed_invite_status', array( 'members', 'mods', 'admins' ) ); $invite_status = !empty( $_POST['group-invite-status'] ) && in_array( $_POST['group-invite-status'], (array) $allowed_invite_status ) ? $_POST['group-invite-status'] : 'members'; groups_update_groupmeta( $bp->groups->new_group_id, 'invite_status', $invite_status ); /** * Filters the allowed activity feed statuses. * * @since BuddyBoss 1.0.0 * * @param array $value Array of statuses allowed. * Possible values are 'members, * 'mods', and 'admins'. */ $allowed_activity_feed_status = apply_filters( 'groups_allowed_activity_feed_status', array( 'members', 'mods', 'admins' ) ); $activity_feed_status = !empty( $_POST['group-activity-feed-status'] ) && in_array( $_POST['group-activity-feed-status'], (array) $allowed_activity_feed_status ) ? $_POST['group-activity-feed-status'] : 'members'; groups_update_groupmeta( $bp->groups->new_group_id, 'activity_feed_status', $activity_feed_status ); /** * Filters the allowed media statuses. * * @since BuddyBoss 1.0.0 * * @param array $value Array of statuses allowed. * Possible values are 'members, * 'mods', and 'admins'. */ $allowed_media_status = apply_filters( 'groups_allowed_media_status', array( 'members', 'mods', 'admins' ) ); $media_status = !empty( $_POST['group-media-status'] ) && in_array( $_POST['group-media-status'], (array) $allowed_media_status ) ? $_POST['group-media-status'] : 'members'; groups_update_groupmeta( $bp->groups->new_group_id, 'media_status', $media_status ); /** * Filters the allowed album statuses. * * @since BuddyBoss 1.0.0 * * @param array $value Array of statuses allowed. * Possible values are 'members, * 'mods', and 'admins'. */ $allowed_album_status = apply_filters( 'groups_allowed_album_status', array( 'members', 'mods', 'admins' ) ); $album_status = !empty( $_POST['group-album-status'] ) && in_array( $_POST['group-album-status'], (array) $allowed_album_status ) ? $_POST['group-album-status'] : 'members'; groups_update_groupmeta( $bp->groups->new_group_id, 'album_status', $album_status ); } if ( 'group-invites' === bp_get_groups_current_create_step() ) { if ( ! empty( $_POST['friends'] ) ) { foreach ( (array) $_POST['friends'] as $friend ) { groups_invite_user( array( 'user_id' => (int) $friend, 'group_id' => $bp->groups->new_group_id, ) ); } } groups_send_invites( bp_loggedin_user_id(), $bp->groups->new_group_id ); } /** * Fires before finalization of group creation and cookies are set. * * This hook is a variable hook dependent on the current step * in the creation process. * * @since BuddyPress 1.1.0 */ do_action( 'groups_create_group_step_save_' . bp_get_groups_current_create_step() ); /** * Fires after the group creation step is completed. * * Mostly for clearing cache on a generic action name. * * @since BuddyPress 1.1.0 */ do_action( 'groups_create_group_step_complete' ); /** * Once we have successfully saved the details for this step of the creation process * we need to add the current step to the array of completed steps, then update the cookies * holding the information */ $completed_create_steps = isset( $bp->groups->completed_create_steps ) ? $bp->groups->completed_create_steps : array(); if ( !in_array( bp_get_groups_current_create_step(), $completed_create_steps ) ) $bp->groups->completed_create_steps[] = bp_get_groups_current_create_step(); // Reset cookie info. setcookie( 'bp_new_group_id', $bp->groups->new_group_id, time()+60*60*24, COOKIEPATH, COOKIE_DOMAIN, is_ssl() ); setcookie( 'bp_completed_create_steps', base64_encode( json_encode( $bp->groups->completed_create_steps ) ), time()+60*60*24, COOKIEPATH, COOKIE_DOMAIN, is_ssl() ); // If we have completed all steps and hit done on the final step we // can redirect to the completed group. $keys = array_keys( $bp->groups->group_creation_steps ); if ( count( $bp->groups->completed_create_steps ) == count( $keys ) && bp_get_groups_current_create_step() == array_pop( $keys ) ) { unset( $bp->groups->current_create_step ); unset( $bp->groups->completed_create_steps ); setcookie( 'bp_new_group_id', false, time() - 3600, COOKIEPATH, COOKIE_DOMAIN, is_ssl() ); setcookie( 'bp_completed_create_steps', false, time() - 3600, COOKIEPATH, COOKIE_DOMAIN, is_ssl() ); // Once we completed all steps, record the group creation in the activity feed. if ( bp_is_active( 'activity' ) ) { groups_record_activity( array( 'type' => 'created_group', 'item_id' => $bp->groups->new_group_id ) ); } /** * Fires after the group has been successfully created. * * @since BuddyPress 1.1.0 * * @param int $new_group_id ID of the newly created group. */ do_action( 'groups_group_create_complete', $bp->groups->new_group_id ); bp_core_redirect( bp_get_group_permalink( $bp->groups->current_group ) ); } else { /** * Since we don't know what the next step is going to be (any plugin can insert steps) * we need to loop the step array and fetch the next step that way. */ foreach ( $keys as $key ) { if ( $key == bp_get_groups_current_create_step() ) { $next = 1; continue; } if ( isset( $next ) ) { $next_step = $key; break; } } bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create/step/' . $next_step ) ); } } // Remove invitations. if ( 'group-invites' === bp_get_groups_current_create_step() && ! empty( $_REQUEST['user_id'] ) && is_numeric( $_REQUEST['user_id'] ) ) { if ( ! check_admin_referer( 'groups_invite_uninvite_user' ) ) { return false; } $message = __( 'Invite successfully withdrawn', 'buddyboss' ); $error = false; if( ! groups_uninvite_user( (int) $_REQUEST['user_id'], $bp->groups->new_group_id ) ) { $message = __( 'There was an error withdrawing the invite', 'buddyboss' ); $error = 'error'; } bp_core_add_message( $message, $error ); bp_core_redirect( trailingslashit( bp_get_groups_directory_permalink() . 'create/step/group-invites' ) ); } // Group avatar is handled separately. if ( 'group-avatar' == bp_get_groups_current_create_step() && isset( $_POST['upload'] ) ) { if ( ! isset( $bp->avatar_admin ) ) { $bp->avatar_admin = new stdClass(); } if ( !empty( $_FILES ) && isset( $_POST['upload'] ) ) { // Normally we would check a nonce here, but the group save nonce is used instead. // Pass the file to the avatar upload handler. if ( bp_core_avatar_handle_upload( $_FILES, 'groups_avatar_upload_dir' ) ) { $bp->avatar_admin->step = 'crop-image'; // Make sure we include the jQuery jCrop file for image cropping. add_action( 'wp_print_scripts', 'bp_core_add_jquery_cropper' ); } } // If the image cropping is done, crop the image and save a full/thumb version. if ( isset( $_POST['avatar-crop-submit'] ) && isset( $_POST['upload'] ) ) { // Normally we would check a nonce here, but the group save nonce is used instead. $args = array( 'object' => 'group', 'avatar_dir' => 'group-avatars', 'item_id' => $bp->groups->current_group->id, 'original_file' => $_POST['image_src'], 'crop_x' => $_POST['x'], 'crop_y' => $_POST['y'], 'crop_w' => $_POST['w'], 'crop_h' => $_POST['h'] ); if ( ! bp_core_avatar_handle_crop( $args ) ) { bp_core_add_message( __( 'There was an error with the group profile photo, please try again.', 'buddyboss' ), 'error' ); } else { /** * Fires after a group avatar is uploaded. * * @since BuddyPress 2.8.0 * * @param int $group_id ID of the group. * @param string $type Avatar type. 'crop' or 'full'. * @param array $args Array of parameters passed to the avatar handler. */ do_action( 'groups_avatar_uploaded', bp_get_current_group_id(), 'crop', $args ); bp_core_add_message( __( 'The group profile photo was uploaded successfully.', 'buddyboss' ) ); } } } /** * Filters the template to load for the group creation screen. * * @since BuddyPress 1.0.0 * * @param string $value Path to the group creation template to load. */ bp_core_load_template( apply_filters( 'groups_template_create_group', 'groups/create' ) ); }
Changelog
Version | Description |
---|---|
BuddyPress 1.2.0 | Introduced. |
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.