delete_roles(); } } // init /** * Display admin notices to the user */ public function messages() { if ( ! isset( $_GET['page'] ) || $_GET['page'] != 'mdjm-employees' || empty( $_GET['role_action'] ) || empty( $_GET['message'] ) ) { return; } $messages = array( 1 => array( 'updated', __( 'Roles deleted.', 'mobile-dj-manager' ) ), 2 => array( 'updated', __( '', 'mobile-dj-manager' ) ), 3 => array( 'updated', __( '', 'mobile-dj-manager' ) ), 4 => array( 'updated', __( 'Permissions updated.', 'mobile-dj-manager' ) ), 5 => array( 'error', __( 'No roles selected for deletion.', 'mobile-dj-manager' ) ), 6 => array( 'error', __( 'Not all roles could be deleted. Do you still have users assigned?', 'mobile-dj-manager' ) ), 7 => array( 'updated', __( '', 'mobile-dj-manager' ) ), ); mdjm_update_notice( $messages[ absint( wp_unslash( $_GET['message'] ) ) ][0], $messages[ absint( wp_unslash( $_GET['message'] ) ) ][1], true ); } // messages /** * Add the default roles to MDJM * * @since 1.3 * @param * @return void */ public function add_roles() { add_role( 'inactive_client', __( 'Inactive Client', 'mobile-dj-manager' ), array( 'read' => true ) ); add_role( 'client', __( 'Client', 'mobile-dj-manager' ), array( 'read' => true ) ); add_role( 'inactive_dj', __( 'Inactive DJ', 'mobile-dj-manager' ), array( 'read' => true, 'create_users' => false, 'edit_users' => false, 'delete_users' => false, 'edit_posts' => false, 'delete_posts' => false, 'publish_posts' => false, 'upload_files' => false, ) ); add_role( 'dj', __( 'DJ', 'mobile-dj-manager' ), array( 'read' => true, 'edit_posts' => true, 'delete_posts' => true, ) ); } // add_roles /** * Retrieve all MDJM user roles by filtering through the registered WP roles * * @params * * @return arr $mdjm_roles An array of all MDJM roles */ public function get_roles() { global $wp_roles; // Retrieve all roles within this WP instance $raw_roles = $wp_roles->get_names(); // Loop through the $raw_roles and filter for mdjm specific roles foreach ( $raw_roles as $role_id => $role_name ) { if ( $role_id == 'dj' || strpos( $role_id, 'mdjm-' ) !== false ) { $mdjm_roles[ $role_id ] = $role_name; } } // Filter the roles $mdjm_roles = apply_filters( 'mdjm_user_roles', $mdjm_roles ); return $mdjm_roles; } // get_roles /** * Retrieve all MDJM user roles and display return them as * * @params arr $args Arguments to pass to the select list. See $defaults. * * @return str $output HTML code for the */ public function roles_dropdown( $args = '' ) { $defaults = array( 'selected' => '', 'disable_default' => false, 'first_entry' => '', 'first_entry_val' => 0, ); $args = wp_parse_args( $args, $defaults ); $mdjm_roles = $this->get_roles(); // Filter the roles $mdjm_roles = apply_filters( 'mdjm_user_roles', $mdjm_roles ); if ( empty( $mdjm_roles ) ) { $output = '' . __( 'No roles defined', 'mobile-dj-manager' ) . '' . "\r\n"; } else { $output = ''; if ( ! empty( $args['first_entry'] ) ) { $output .= '' . $args['first_entry'] . '' . "\r\n"; } foreach ( $mdjm_roles as $role_id => $role ) { $output .= '' . "\r\n"; } } return $output; } // roles_dropdown /** * Add new MDJM user role. * Call from employee management form via Ajax * * @param str $role The requested name of the role * * @return arr $result JSON encoded array */ public function add_role() { if ( empty( $_POST['role_name'] ) ) { $return['type'] = 'error'; $return['msg'] = __( 'Ooops! You need to add a role name', 'mobile-dj-manager' ); } else { $result = add_role( 'mdjm-' . sanitize_title_with_dashes( strtolower( str_replace( '_', '-', sanitize_text_field( wp_unslash( $_POST['role_name'] ) ) ) ) ), ucwords( sanitize_text_field( wp_unslash( $_POST['role_name'] ) ) ) ); if ( null !== $result ) { $return['type'] = 'success'; $updated_roles = $this->roles_dropdown(); $return['options'] = $updated_roles; $result->add_cap( 'mdjm_employee' ); $result->add_cap( 'read' ); } else { $return['type'] = 'error'; $return['msg'] = __( 'Ooops! An error occured. Does the role already exist?', 'mobile-dj-manager' ); } } echo json_encode( $return ); exit; } // add_role /** * Delete MDJM user role(s). * If any users are still assigned to the role, do not delete but report an error * * @param str|arr $roles Required: The role name to delete. $_POST['all_roles'] takes priority if exists * * @return arr $result JSON encoded array */ public function delete_roles( $roles = '' ) { if ( isset( $_POST['delete-roles'] ) && ! empty( $_POST['all_roles'] ) ) { $roles = wp_unslash( $_POST['all_roles'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized } // No roles if ( empty( $roles ) ) { wp_safe_redirect( wp_unslash( $_SERVER['HTTP_REFERER'] ) . '&role_action=1&message=5' ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated exit; } // $roles must be an array so let's ensure it is if ( ! is_array( $roles ) ) { $roles = array( $roles ); } // Make sure there are no employees assigned to the roles marked for deletion $employees = mdjm_get_employees( $roles ); if ( ! empty( $employees ) ) { wp_safe_redirect( wp_unslash( $_SERVER['HTTP_REFERER'] ) . '&role_action=1&message=6' ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated exit; } // Loop through the roles and remove after ensuring there are no users assigned foreach ( $roles as $role ) { remove_role( $role ); } wp_safe_redirect( wp_unslash( $_SERVER['HTTP_REFERER'] ) . '&role_action=1&message=1' ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated exit; } // delete_roles /** * Rename the DJ role display name when admin saves the event settings from the settings page. * Include both the standard and inactive role. * * Called by: update_option_mdjm_event_settings hook * * @param arr $old_value Old settings values * arr $new_value New settings values */ public function rename_dj_role( $old_value, $new_value ) { global $wpdb; // If the artist setting has not been updated, we can return and do nothing if ( $new_value['artist'] == $old_value['artist'] ) { return; } $user_roles = get_option( $wpdb->prefix . 'user_roles' ); if ( empty( $user_roles ) ) { if ( MDJM_DEBUG == true ) { MDJM()->debug->log_it( 'ERROR: Could not retrieve user roles from DB', true ); } return; } $user_roles['inactive_dj']['name'] = __( 'Inactive', 'mobile-dj-manager' ) . ' ' . $new_value['artist']; $user_roles['dj']['name'] = $new_value['artist']; if ( update_option( $wpdb->prefix . 'user_roles', $user_roles ) ) { if ( MDJM_DEBUG == true ) { MDJM()->debug->log_it( 'Updated DJ role name to ' . $new_value['artist'], true ); } return; } else { if ( MDJM_DEBUG == true ) { MDJM()->debug->log_it( 'ERROR: Could not update DJ role name to ' . $new_value['artist'], true ); } } } // rename_dj_role /** * Runs against the mdjm_user_roles filter to modify the results removing the Administrator option. * * @params arr $mdjm_roles The list of MDJM roles * * @return arr $mdjm_roles Filtered list of MDJM roles */ public static function no_admin_role( $mdjm_roles ) { if ( isset( $mdjm_roles['administrator'] ) ) { unset( $mdjm_roles['administrator'] ); } return $mdjm_roles; } // no_admin_role } // MDJM_Roles endif;