Image
2 days ago
Select
2 days ago
Arrays.php
2 days ago
AvailableTranslations.php
2 days ago
Creatable.php
2 days ago
Dashicon.php
2 days ago
Date.php
2 days ago
Html.php
2 days ago
Icon.php
2 days ago
Image.php
2 days ago
LocalFile.php
2 days ago
Mbstring.php
2 days ago
MediaIdResolver.php
2 days ago
Menu.php
2 days ago
Network.php
2 days ago
Post.php
2 days ago
Strings.php
2 days ago
Taxonomy.php
2 days ago
User.php
2 days ago
UserRoles.php
2 days ago
WpDateFormat.php
2 days ago
UserRoles.php
64 lines
| 1 | <?php |
| 2 | |
| 3 | declare(strict_types=1); |
| 4 | |
| 5 | namespace AC\Helper; |
| 6 | |
| 7 | use AC\Type; |
| 8 | use WP_User; |
| 9 | |
| 10 | final class UserRoles extends Creatable |
| 11 | { |
| 12 | /** |
| 13 | * WordPress documents WP_User::$roles as string[], but WP_User::get_role_caps() fills it with the |
| 14 | * raw array keys of the capabilities meta. A purely numeric role slug (e.g. '8888') is therefore |
| 15 | * returned as an integer. Always read a user's roles through this method. |
| 16 | * |
| 17 | * @return string[] |
| 18 | */ |
| 19 | public function find_role_names(WP_User $user): array |
| 20 | { |
| 21 | return array_map('strval', $user->roles); |
| 22 | } |
| 23 | |
| 24 | public function find_all(bool $allow_non_editable_roles = false): Type\UserRoles |
| 25 | { |
| 26 | return $allow_non_editable_roles |
| 27 | ? $this->find_all_roles() |
| 28 | : $this->find_all_editable_roles(); |
| 29 | } |
| 30 | |
| 31 | public function find_all_roles(): Type\UserRoles |
| 32 | { |
| 33 | return function_exists('wp_roles') |
| 34 | ? $this->create_roles(wp_roles()->roles) |
| 35 | : new Type\UserRoles(); |
| 36 | } |
| 37 | |
| 38 | public function find_all_editable_roles(): Type\UserRoles |
| 39 | { |
| 40 | return function_exists('get_editable_roles') |
| 41 | ? $this->create_roles(get_editable_roles()) |
| 42 | : new Type\UserRoles(); |
| 43 | } |
| 44 | |
| 45 | private function create_roles(array $roles_data): Type\UserRoles |
| 46 | { |
| 47 | $roles = new Type\UserRoles(); |
| 48 | |
| 49 | foreach ($roles_data as $role_name => $role) { |
| 50 | $label = is_array($role) ? ($role['name'] ?? $role_name) : $role_name; |
| 51 | |
| 52 | $roles->add( |
| 53 | new Type\UserRole( |
| 54 | (string)$role_name, |
| 55 | (string)$label |
| 56 | ) |
| 57 | ); |
| 58 | } |
| 59 | |
| 60 | return $roles; |
| 61 | } |
| 62 | |
| 63 | } |
| 64 |