1 | <?php |
||||
2 | /* |
||||
3 | Plugin Name: WP-REST-API V2 Menus |
||||
4 | Version: 0.7.7 |
||||
5 | Description: Adding menus endpoints on WP REST API v2 |
||||
6 | Author: Claudio La Barbera |
||||
7 | Author URI: https://thebatclaud.io |
||||
8 | */ |
||||
9 | |||||
10 | /** |
||||
11 | * Get all registered menus |
||||
12 | * @return array List of menus with slug and description |
||||
13 | */ |
||||
14 | function wp_api_v2_menus_get_all_menus() { |
||||
15 | $menus = get_terms( 'nav_menu', array( 'hide_empty' => true ) ); |
||||
16 | |||||
17 | foreach ( $menus as $key => $menu ) { |
||||
18 | // check if there is acf installed |
||||
19 | if ( class_exists( 'acf' ) ) { |
||||
20 | $fields = get_fields( $menu ); |
||||
21 | if ( ! empty( $fields ) ) { |
||||
22 | foreach ( $fields as $field_key => $item ) { |
||||
23 | // add all acf custom fields |
||||
24 | $menus[ $key ]->$field_key = $item; |
||||
25 | } |
||||
26 | } |
||||
27 | } |
||||
28 | } |
||||
29 | |||||
30 | return apply_filters('wp_api_v2_menus__menus', $menus); |
||||
0 ignored issues
–
show
Bug
introduced
by
![]() |
|||||
31 | } |
||||
32 | |||||
33 | /** |
||||
34 | * Get all locations |
||||
35 | * @return array List of locations |
||||
36 | **/ |
||||
37 | |||||
38 | function wp_api_v2_menu_get_all_locations() { |
||||
39 | $nav_menu_locations = get_nav_menu_locations(); |
||||
40 | $locations = new stdClass; |
||||
41 | foreach ( $nav_menu_locations as $location_slug => $menu_id ) { |
||||
42 | if ( get_term( $location_slug ) !== null ) { |
||||
43 | $locations->{$location_slug} = get_term( $location_slug ); |
||||
44 | } else { |
||||
45 | $locations->{$location_slug} = new stdClass; |
||||
46 | } |
||||
47 | $locations->{$location_slug}->slug = $location_slug; |
||||
48 | $locations->{$location_slug}->menu = get_term( $menu_id ); |
||||
49 | } |
||||
50 | |||||
51 | return apply_filters('wp_api_v2_menus__locations', $locations); |
||||
0 ignored issues
–
show
The function
apply_filters was not found. Maybe you did not declare it correctly or list all dependencies?
(
Ignorable by Annotation
)
If this is a false-positive, you can also ignore this issue in your code via the
![]() |
|||||
52 | } |
||||
53 | |||||
54 | /** |
||||
55 | * Get menu's data from his id |
||||
56 | * |
||||
57 | * @param array $data WP REST API data variable |
||||
58 | * |
||||
59 | * @return object Menu's data with his items |
||||
60 | */ |
||||
61 | function wp_api_v2_locations_get_menu_data( $data ) { |
||||
62 | // Create default empty object |
||||
63 | $menu = new stdClass; |
||||
64 | |||||
65 | // this could be replaced with `if (has_nav_menu($data['id']))` |
||||
66 | if ( ( $locations = get_nav_menu_locations() ) && isset( $locations[ $data['id'] ] ) ) { |
||||
67 | // Replace default empty object with the location object |
||||
68 | $menu = get_term( $locations[ $data['id'] ] ); |
||||
69 | $menu->items = wp_api_v2_menus_get_menu_items( $locations[ $data['id'] ] ); |
||||
70 | } else { |
||||
71 | return new WP_Error( 'not_found', 'No location has been found with this id or slug: `' . $data['id'] . '`. Please ensure you passed an existing location ID or location slug.', array( 'status' => 404 ) ); |
||||
72 | } |
||||
73 | |||||
74 | // check if there is acf installed |
||||
75 | if ( class_exists( 'acf' ) ) { |
||||
76 | $fields = get_fields( $menu ); |
||||
77 | if ( ! empty( $fields ) ) { |
||||
78 | foreach ( $fields as $field_key => $item ) { |
||||
79 | // add all acf custom fields |
||||
80 | $menu->$field_key = $item; |
||||
81 | } |
||||
82 | } |
||||
83 | } |
||||
84 | |||||
85 | return apply_filters('wp_api_v2_menus__menu', $menu); |
||||
0 ignored issues
–
show
The function
apply_filters was not found. Maybe you did not declare it correctly or list all dependencies?
(
Ignorable by Annotation
)
If this is a false-positive, you can also ignore this issue in your code via the
![]() |
|||||
86 | } |
||||
87 | |||||
88 | /** |
||||
89 | * Check if a menu item is child of one of the menu's element passed as reference |
||||
90 | * |
||||
91 | * @param $parents Menu's items |
||||
92 | * @param $child Menu's item to check |
||||
93 | * |
||||
94 | * @return bool True if the parent is found, false otherwise |
||||
95 | */ |
||||
96 | function wp_api_v2_menus_dna_test( &$parents, $child ) { |
||||
97 | foreach ( $parents as $key => $item ) { |
||||
98 | if ( $child->menu_item_parent == $item->ID ) { |
||||
99 | if ( ! $item->child_items ) { |
||||
100 | $item->child_items = []; |
||||
101 | } |
||||
102 | array_push( $item->child_items, $child ); |
||||
103 | return true; |
||||
104 | } |
||||
105 | |||||
106 | if($item->child_items) { |
||||
107 | if(wp_api_v2_menus_dna_test($item->child_items, $child)) { |
||||
108 | return true; |
||||
109 | } |
||||
110 | } |
||||
111 | } |
||||
112 | |||||
113 | return false; |
||||
114 | } |
||||
115 | |||||
116 | /** |
||||
117 | * Retrieve items for a specific menu |
||||
118 | * |
||||
119 | * @param $id Menu id |
||||
120 | * |
||||
121 | * @return array List of menu items |
||||
122 | */ |
||||
123 | function wp_api_v2_menus_get_menu_items( $id ) { |
||||
124 | $menu_items = wp_get_nav_menu_items( $id ); |
||||
125 | |||||
126 | // check if there is acf installed |
||||
127 | if ( class_exists( 'acf' ) ) { |
||||
128 | foreach ( $menu_items as $menu_key => $menu_item ) { |
||||
129 | $fields = get_fields( $menu_item->ID ); |
||||
130 | if ( ! empty( $fields ) ) { |
||||
131 | foreach ( $fields as $field_key => $item ) { |
||||
132 | // add all acf custom fields |
||||
133 | $menu_items[ $menu_key ]->$field_key = $item; |
||||
134 | } |
||||
135 | } |
||||
136 | } |
||||
137 | } |
||||
138 | |||||
139 | // wordpress does not group child menu items with parent menu items |
||||
140 | $child_items = []; |
||||
141 | // pull all child menu items into separate object |
||||
142 | foreach ( $menu_items as $key => $item ) { |
||||
143 | |||||
144 | if($item->type == 'post_type') { |
||||
145 | // add slug to menu items |
||||
146 | $slug = basename( get_permalink($item->object_id) ); |
||||
147 | $item->slug = $slug; |
||||
148 | } else if($item->type == 'taxonomy') { |
||||
149 | $cat = get_term($item->object_id); |
||||
150 | $item->slug = $cat->slug; |
||||
151 | } else if($item->type == 'post_type_archive') { |
||||
152 | $post_type_data = get_post_type_object($item->object); |
||||
153 | |||||
154 | if ($post_type_data->has_archive) { |
||||
155 | $item->slug = $post_type_data->rewrite['slug']; |
||||
156 | } |
||||
157 | } |
||||
158 | |||||
159 | if (isset($item->thumbnail_id) && $item->thumbnail_id) { |
||||
160 | $item->thumbnail_src = wp_get_attachment_image_url(intval($item->thumbnail_id), 'post-thumbnail'); |
||||
161 | } |
||||
162 | if (isset($item->thumbnail_hover_id) && $item->thumbnail_hover_id) { |
||||
163 | $item->thumbnail_hover_src = wp_get_attachment_image_url(intval($item->thumbnail_hover_id), 'post-thumbnail'); |
||||
164 | } |
||||
165 | |||||
166 | if ( $item->menu_item_parent ) { |
||||
167 | array_push( $child_items, $item ); |
||||
168 | unset( $menu_items[ $key ] ); |
||||
169 | } |
||||
170 | |||||
171 | } |
||||
172 | |||||
173 | // push child items into their parent item in the original object |
||||
174 | do { |
||||
175 | foreach($child_items as $key => $child_item) { |
||||
176 | if(wp_api_v2_menus_dna_test($menu_items, $child_item)) { |
||||
177 | unset($child_items[$key]); |
||||
178 | } |
||||
179 | } |
||||
180 | } while(count($child_items)); |
||||
181 | |||||
182 | return apply_filters('wp_api_v2_menus__menu_items', array_values($menu_items)); |
||||
0 ignored issues
–
show
The function
apply_filters was not found. Maybe you did not declare it correctly or list all dependencies?
(
Ignorable by Annotation
)
If this is a false-positive, you can also ignore this issue in your code via the
![]() |
|||||
183 | } |
||||
184 | |||||
185 | /** |
||||
186 | * Get menu's data from his id. |
||||
187 | * It ensures compatibility for previous versions when this endpoint |
||||
188 | * was allowing locations id in place of menus id) |
||||
189 | * |
||||
190 | * @param array $data WP REST API data variable |
||||
191 | * |
||||
192 | * @return object Menu's data with his items |
||||
193 | */ |
||||
194 | function wp_api_v2_menus_get_menu_data( $data ) { |
||||
195 | // This ensure retro compatibility with versions `<= 0.5` when this endpoint |
||||
196 | // was allowing locations id in place of menus id |
||||
197 | if ( has_nav_menu( $data['id'] ) ) { |
||||
198 | $menu = wp_api_v2_locations_get_menu_data( $data ); |
||||
199 | } else if ( is_nav_menu( $data['id'] ) ) { |
||||
200 | if ( is_int( $data['id'] ) ) { |
||||
201 | $id = $data['id']; |
||||
202 | } else { |
||||
203 | $id = wp_get_nav_menu_object( $data['id'] ); |
||||
204 | } |
||||
205 | $menu = get_term( $id ); |
||||
206 | $menu->items = wp_api_v2_menus_get_menu_items( $id ); |
||||
207 | } else { |
||||
208 | return new WP_Error( 'not_found', 'No menu has been found with this id or slug: `' . $data['id'] . '`. Please ensure you passed an existing menu ID, menu slug, location ID or location slug.', array( 'status' => 404 ) ); |
||||
209 | } |
||||
210 | |||||
211 | // check if there is acf installed |
||||
212 | if ( class_exists( 'acf' ) ) { |
||||
213 | $fields = get_fields( $menu ); |
||||
214 | if ( ! empty( $fields ) ) { |
||||
215 | foreach ( $fields as $field_key => $item ) { |
||||
216 | // add all acf custom fields |
||||
217 | $menu->$field_key = $item; |
||||
218 | } |
||||
219 | } |
||||
220 | } |
||||
221 | |||||
222 | return apply_filters('wp_api_v2_menus__menu', $menu); |
||||
0 ignored issues
–
show
The function
apply_filters was not found. Maybe you did not declare it correctly or list all dependencies?
(
Ignorable by Annotation
)
If this is a false-positive, you can also ignore this issue in your code via the
![]() |
|||||
223 | } |
||||
224 | |||||
225 | add_action( 'rest_api_init', function () { |
||||
226 | register_rest_route( 'menus/v1', '/menus', array( |
||||
227 | 'methods' => 'GET', |
||||
228 | 'callback' => 'wp_api_v2_menus_get_all_menus', |
||||
229 | ) ); |
||||
230 | |||||
231 | register_rest_route( 'menus/v1', '/menus/(?P<id>[a-zA-Z0-9_-]+)', array( |
||||
232 | 'methods' => 'GET', |
||||
233 | 'callback' => 'wp_api_v2_menus_get_menu_data', |
||||
234 | ) ); |
||||
235 | |||||
236 | register_rest_route( 'menus/v1', '/locations/(?P<id>[a-zA-Z0-9_-]+)', array( |
||||
237 | 'methods' => 'GET', |
||||
238 | 'callback' => 'wp_api_v2_locations_get_menu_data', |
||||
239 | ) ); |
||||
240 | |||||
241 | register_rest_route( 'menus/v1', '/locations', array( |
||||
242 | 'methods' => 'GET', |
||||
243 | 'callback' => 'wp_api_v2_menu_get_all_locations', |
||||
244 | ) ); |
||||
245 | } ); |
||||
246 |