uiXpress
Remote Sites

Features

Comprehensive documentation of all remote sites features and capabilities.

Remote Site Configuration

Site Settings

Configuration Fields:

  • Site URL: Full URL of the remote WordPress site
  • Username: WordPress username for authentication
  • Application Password: WordPress application password (not regular password)
  • Site Name: Optional display name for the site

URL Format:

  • Supports http:// and https:// protocols
  • Automatically adds protocol if missing
  • Removes trailing slashes automatically
  • Validates URL format

Authentication:

  • Uses WordPress Application Passwords
  • Secure Basic Auth authentication
  • No plain text passwords stored
  • Encrypted storage in database

Site Management

Adding Sites:

  • Click "Add Remote Site" button
  • Fill in required fields
  • Save configuration
  • Site appears in switcher

Editing Sites:

  • Click edit icon on site
  • Modify configuration
  • Save changes
  • Updates immediately

Removing Sites:

  • Click delete icon
  • Confirm removal
  • Site removed from list
  • Cannot remove active site

Site Switcher Interface

Switcher Location

Menu Integration:

  • Appears in admin sidebar menu
  • Below logo/search area
  • Only visible when sites configured
  • Respects capability settings

Visual Design:

  • Dropdown select component
  • Shows current site selection
  • "Local" option for current site
  • Site name display

Selection Behavior

Switching Sites:

  • Click dropdown
  • Select desired site
  • Page reloads automatically
  • Context switches to selected site

Current Site Indicator:

  • Shows "Local" for current site
  • Shows site URL for remote sites
  • Visual distinction
  • Clear indication

Persistence:

  • Selection saved in localStorage
  • Persists across sessions
  • Per-browser storage
  • Automatic restoration

Remote Site Menu

Filtered Display:

  • Only shows uiXpress app pages
  • Hides WordPress default menus
  • Simplified navigation
  • Focused interface

Available Pages:

  • Modern Media Page (if enabled)
  • Modern Plugins Page (if enabled)
  • Menu Creator
  • Modern Dashboard (if enabled)
  • Activity Log (if enabled)
  • Database Explorer (if enabled)
  • Admin Notices
  • Role Editor (if enabled)
  • Modern Users Page (if enabled)

Settings Menu:

  • uiXpress Settings menu preserved
  • Submenu items filtered
  • Only enabled features shown
  • Respects feature toggles

Top-Level Items:

  • Only uiXpress pages shown
  • All submenus removed
  • Clean navigation
  • Focused experience

Settings Submenu:

  • Menu Creator (always available)
  • Activity Log (if enabled)
  • Database Explorer (if enabled)
  • Admin Notices (always available)
  • Role Editor (if enabled)
  • Settings page itself

Dynamic Updates:

  • Menu updates on site switch
  • Respects enabled features
  • Automatic filtering
  • Real-time updates

API Integration

lmnFetch Function

Unified Fetch:

  • Single function for all requests
  • Automatic site detection
  • Handles local and remote
  • Consistent API

Remote Site Detection:

  • Checks localStorage
  • Reads selected site ID
  • Determines if remote
  • Applies appropriate auth

URL Construction:

  • Local: Uses current site REST base
  • Remote: Constructs remote REST URL
  • Handles protocols
  • Validates URLs

Authentication:

  • Local: WordPress nonce
  • Remote: Basic Auth header
  • Application password auth
  • Secure credentials

Request Handling

Local Requests:

  • Uses WordPress nonce
  • CSRF protection
  • Standard WordPress auth
  • Session-based

Remote Requests:

  • Basic Auth header
  • Application password
  • Base64 encoded credentials
  • Secure transmission

Error Handling:

  • Network errors caught
  • Authentication errors handled
  • User-friendly messages
  • Graceful degradation

Security Features

Capability Control

Visibility Control:

  • Capability-based access
  • Default: manage_options
  • Configurable capability
  • Respects WordPress permissions

Access Control:

  • Checks user capability
  • Hides switcher if no access
  • Prevents unauthorized access
  • Secure by default

Settings Access:

  • Only admins can configure
  • Capability check on save
  • Validates permissions
  • Secure configuration

Password Protection

Frontend Security:

  • Passwords not exposed to frontend
  • Capability check before output
  • Only authorized users see config
  • Prevents password exposure

Storage Security:

  • Encrypted in database
  • Application passwords only
  • No plain text storage
  • Secure handling

Transmission Security:

  • HTTPS recommended
  • Basic Auth over HTTPS
  • Encrypted credentials
  • Secure communication

First-Time Experience

Explanation Dialog

Initial Switch:

  • Shows dialog on first remote switch
  • Explains remote site feature
  • Provides guidance
  • Dismissible

Dialog Content:

  • Feature explanation
  • How it works
  • What to expect
  • Getting started tips

Dismissal:

  • "Got it" button
  • One-time display
  • Stored preference
  • Can be re-enabled

Page Reload Behavior

Automatic Reload

On Site Switch:

  • Page reloads automatically
  • Refreshes app context
  • Updates all data
  • Ensures consistency

Context Refresh:

  • Menu updates
  • Settings reload
  • Data refreshed
  • State reset

User Experience:

  • Smooth transition
  • Clear indication
  • Loading states
  • Progress feedback

Supported Operations

Media Library

Upload Support:

  • Upload to remote sites
  • Uses lmnFetch function
  • Proper authentication
  • Progress tracking

File Operations:

  • View media
  • Edit metadata
  • Delete files
  • Replace files

Bulk Operations:

  • Bulk edit
  • Bulk delete
  • Bulk download
  • All supported

Plugin Management

Plugin Operations:

  • View plugins
  • Activate/deactivate
  • Install plugins
  • Update plugins

Repository Access:

  • WordPress.org repository
  • Plugin search
  • Installation
  • Updates

Content Management

Posts & Pages:

  • View content
  • Edit content
  • Create new
  • Delete content

User Management:

  • View users
  • Edit users
  • Create users
  • Manage roles

Settings Management

Configuration:

  • Access settings
  • Modify options
  • Save changes
  • All settings available

Limitations

Remote Site Restrictions

Menu Limitations:

  • Only uiXpress pages shown
  • WordPress default menus hidden
  • Simplified navigation
  • Focused experience

Feature Availability:

  • Depends on enabled features
  • Respects settings
  • Feature toggles apply
  • Configurable

Network Requirements:

  • Requires network access
  • CORS considerations
  • Firewall rules
  • DNS resolution

Performance Considerations

Request Optimization

Efficient Requests:

  • Single API calls
  • Minimal overhead
  • Fast switching
  • Responsive UI

Caching:

  • Selection cached locally
  • Reduces lookups
  • Faster access
  • Improved performance

Network Impact:

  • Remote requests slower
  • Depends on connection
  • Timeout handling
  • Error recovery

Error Handling

Connection Errors

Network Failures:

  • Clear error messages
  • User-friendly notifications
  • Retry options
  • Graceful handling

Authentication Errors:

  • Invalid credentials
  • Permission denied
  • Clear messaging
  • Guidance provided

Timeout Handling:

  • Request timeouts
  • User notification
  • Retry mechanism
  • Fallback options

Browser Compatibility

Supported Browsers

Modern Browsers:

  • Chrome/Edge (latest)
  • Firefox (latest)
  • Safari (latest)
  • Opera (latest)

Features Used:

  • localStorage API
  • Fetch API
  • Basic Auth
  • Modern JavaScript

Requirements:

  • JavaScript enabled
  • LocalStorage support
  • Fetch API support
  • HTTPS recommended