Actions:
"Go to path"

This plugin provides sophisticated URL navigation with multiple path modification options and parameter handling.

Path Modification (in order of precedence):

1. Up Level Navigation:
  • Set 'upLevel' to Yes to remove the last path segment
  • Example: /dashboard/settings → /dashboard
  • Overrides all other path modifications

2. Append to Path:
  • Use 'appendPath' to add a segment to current path
  • Won't append if segment already exists at end
  • Example: /dashboard + "settings" → /dashboard/settings

3. Path After First Segment:
  • Use 'pathAfterPage' to replace everything after first segment
  • Example: /dashboard/settings/advanced + "users" → /dashboard/users

4. Basic Path:
  • Direct path to navigate to
  • Used when no other modifiers are set
  • Example: "dashboard/settings"

Parameter Handling:

1. Parameter List:
  • Add [{key: "filter", value: "active"}]
  • Remove parameter by setting value to empty or null
  • Multiple parameters: [{key: "id", value: "123"}, {key: "sort", value: "desc"}]

2. Preserve Parameters:
  • Set 'preserveParams' to Yes to keep existing URL parameters
  • New parameters override existing ones
  • Empty parameters are automatically removed

History Control:
• Set 'replaceState' to Yes to update URL without adding to browser history
• Set to No (default) to create new history entry

Version Handling:
• Automatically detects and preserves version prefixes (/version-xxxx/)
• Works seamlessly with Bubble's versioning system

Examples:

1. Simple Navigation:
  • path: "dashboard"
  • Result: /dashboard

2. Append to Current Path:
  • Current: /dashboard
  • appendPath: "settings"
  • Result: /dashboard/settings

3. Up Level with Parameters:
  • Current: /dashboard/settings?filter=active
  • upLevel: Yes
  • preserveParams: Yes
  • Result: /dashboard?filter=active

4. Change Section:
  • Current: /dashboard/settings/advanced
  • pathAfterPage: "users"
  • Result: /dashboard/users

5. Update Parameters:
  • parameters: [{key: "page", value: "2"}, {key: "sort", value: "desc"}]
  • preserveParams: Yes
  • Adds/updates parameters while keeping others

Element: "URL States and Trigger"
A dynamic URL state tracking element that provides real-time access to path segments and URL parameters.

State Values

Path Segments:
• path1: First path segment after version prefix
• path2: Second path segment
• path3: Third path segment
• Example: /dashboard/settings/advanced → path1: "dashboard", path2: "settings", path3: "advanced"

Paths After Page:
• paths_after_page: Array of all segments after first segment
• Example: /dashboard/settings/advanced → ["settings", "advanced"]

Parameter States:
• param_keys: Array of parameter names
• param_values: Array of parameter values
• params: Array of full "key=value" strings
• Example URL: ?filter=active&sort=desc

param_keys: ["filter", "sort"]

param_values: ["active", "desc"]

params: ["filter=active", "sort=desc"]


Events:

Modify URL Complete:
• Triggered on any URL change
• Works with browser back/forward
• Fires on plugin navigation
• Fires on manual URL changes
Version Handling:
• Automatically removes version prefix from path segments
• Example: /version-test/dashboard → path1: "dashboard"
• Preserves version awareness in navigation