/navigation endpoint

Author: oguzkocer

CLAUDE.md

@@ -97,26 +97,21 @@ WordPress REST API returns different fields depending on the `context` parameter
 
 3. **Define parameter types** for list/create/update operations:
    ```rust
-   #[derive(Debug, Default, PartialEq, Eq, uniffi::Record)]
+   #[derive(Debug, Default, PartialEq, Eq, uniffi::Record, WpDeriveParamsField)]
+   #[supports_pagination(true)]  // or false if endpoint doesn't support pagination
    pub struct UserListParams {
        #[uniffi(default = None)]
        pub page: Option<u32>,
+       #[uniffi(default = [])]
+       pub exclude: Vec<UserId>,
        // ... other fields
    }
    ```
-
-4. **Implement query parameter handling**:
-   - Create a `{Type}ListParamsField` enum:
-     ```rust
-     #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, IntoStaticStr)]
-     enum UserListParamsField {
-         #[strum(serialize = "page")]
-         Page,
-         // ... other fields
-     }
-     ```
-   - Implement `AppendUrlQueryPairs` and `FromUrlQueryPairs` traits
-   - Import helpers: `crate::url_query::{AppendUrlQueryPairs, FromUrlQueryPairs, QueryPairs, QueryPairsExtension, UrlQueryPairsMap}`
+   - Use `WpDeriveParamsField` macro to automatically generate field enum and query parameter handling
+   - Add `#[supports_pagination(true/false)]` attribute to indicate pagination support
+   - Use `#[field_name("custom_name")]` attribute if the API field name differs from the struct field name
+   - **IMPORTANT**: For array/list parameters, use `Vec<T>` with `#[uniffi(default = [])]`, NOT `Option<Vec<T>>` with `#[uniffi(default = None)]`
+   - Import: `use wp_derive::WpDeriveParamsField;`
 
 **Special parameter types:**
 

scripts/setup-test-site.sh

@@ -237,6 +237,10 @@ create_test_credentials () {
   NAV_MENU_ITEM_AUTOSAVE_RESPONSE="$(create_nav_menu_item_autosave "1" "$NAV_MENU_ITEM_ID")"
   AUTOSAVE_ID_FOR_NAV_MENU_ITEM_ID="$(echo "$NAV_MENU_ITEM_AUTOSAVE_RESPONSE" | jq -r '.id')"
 
+  echo "Creating a navigation for integration tests.."
+  NAVIGATION_RESPONSE="$(curl --silent --user "$ADMIN_USERNAME":"$ADMIN_PASSWORD" -H "Content-Type: application/json" -d '{"title":"Integration Test Navigation","content":"<!-- wp:navigation --><!-- /wp:navigation -->","status":"publish"}' http://localhost/wp-json/wp/v2/navigation)"
+  NAVIGATION_ID="$(echo "$NAVIGATION_RESPONSE" | jq -r '.id')"
+
   rm -rf /app/test_credentials.json
   jo -p \
     site_url="$SITE_URL" \
@@ -274,6 +278,7 @@ create_test_credentials () {
     footer_menu_location="$FOOTER_MENU_LOCATION" \
     nav_menu_item_id="$NAV_MENU_ITEM_ID" \
     autosave_id_for_nav_menu_item_id="$AUTOSAVE_ID_FOR_NAV_MENU_ITEM_ID" \
+    navigation_id="$NAVIGATION_ID" \
     > /app/test_credentials.json
 }
 create_test_credentials

wp_api/src/api_client.rs

@@ -19,6 +19,7 @@ use crate::{
             },
             nav_menu_items_endpoint::{NavMenuItemsRequestBuilder, NavMenuItemsRequestExecutor},
             nav_menus_endpoint::{NavMenusRequestBuilder, NavMenusRequestExecutor},
+            navigations_endpoint::{NavigationsRequestBuilder, NavigationsRequestExecutor},
             plugins_endpoint::{PluginsRequestBuilder, PluginsRequestExecutor},
             post_autosaves_endpoint::{AutosavesRequestBuilder, AutosavesRequestExecutor},
             post_revisions_endpoint::{PostRevisionsRequestBuilder, PostRevisionsRequestExecutor},
@@ -58,6 +59,7 @@ pub struct WpApiRequestBuilder {
     nav_menu_item_autosaves: Arc<NavMenuItemAutosavesRequestBuilder>,
     nav_menu_items: Arc<NavMenuItemsRequestBuilder>,
     nav_menus: Arc<NavMenusRequestBuilder>,
+    navigations: Arc<NavigationsRequestBuilder>,
     plugins: Arc<PluginsRequestBuilder>,
     post_revisions: Arc<PostRevisionsRequestBuilder>,
     post_statuses: Arc<PostStatusesRequestBuilder>,
@@ -93,6 +95,7 @@ impl WpApiRequestBuilder {
             nav_menu_item_autosaves,
             nav_menu_items,
             nav_menus,
+            navigations,
             plugins,
             post_revisions,
             post_statuses,
@@ -138,6 +141,7 @@ pub struct WpApiClient {
     nav_menu_item_autosaves: Arc<NavMenuItemAutosavesRequestExecutor>,
     nav_menu_items: Arc<NavMenuItemsRequestExecutor>,
     nav_menus: Arc<NavMenusRequestExecutor>,
+    navigations: Arc<NavigationsRequestExecutor>,
     plugins: Arc<PluginsRequestExecutor>,
     post_revisions: Arc<PostRevisionsRequestExecutor>,
     post_statuses: Arc<PostStatusesRequestExecutor>,
@@ -170,6 +174,7 @@ impl WpApiClient {
             nav_menu_item_autosaves,
             nav_menu_items,
             nav_menus,
+            navigations,
             plugins,
             post_revisions,
             post_statuses,
@@ -212,6 +217,7 @@ api_client_generate_endpoint_impl!(WpApi, menu_locations);
 api_client_generate_endpoint_impl!(WpApi, nav_menu_item_autosaves);
 api_client_generate_endpoint_impl!(WpApi, nav_menu_items);
 api_client_generate_endpoint_impl!(WpApi, nav_menus);
+api_client_generate_endpoint_impl!(WpApi, navigations);
 api_client_generate_endpoint_impl!(WpApi, plugins);
 api_client_generate_endpoint_impl!(WpApi, post_revisions);
 api_client_generate_endpoint_impl!(WpApi, post_statuses);

wp_api/src/lib.rs

@@ -22,6 +22,7 @@ pub mod middleware;
 pub mod nav_menu_item_revisions;
 pub mod nav_menu_items;
 pub mod nav_menus;
+pub mod navigations;
 pub mod parsed_url;
 pub mod plugins;
 pub mod post_revisions;