Building Your WordPress App

WP App Creator Guide · Client Onboarding Portal

Welcome to the Mobile App Deployment Portal. This documentation unifies everything you need to connect your WordPress ecosystem to your white-labeled iOS and Android applications. We start with the mandatory Base Engine setup, followed by optional Feature Modules you can enable based on your needs.

Environment Requirements

Before proceeding, ensure your host environment meets the baseline execution standards.

Requirement Supported Version Notes
WordPress 5.0 or higher Core REST API layer must be unblocked by host
PHP 7.2 or higher OpenSSL module enabled for JWT security

Step 1: Install Base Plugins

To securely connect your site to the native app, you must install the fundamental API gateway and authentication layer. (Note: Functional modules like jobs or forums will require their own specific plugins in the modules section.)

Download Companion Plugin

Get the latest production-ready WP Mobile Kit with bbpress REST API plugin (v3.5.0). Complete the short form below to download.

  1. Install WP Mobile Kit Plugin: Upload the wpmk-bbpress-rest-api folder (downloaded above) to your /wp-content/plugins/ directory and activate it. This acts as the master communication hub.
  2. Install JWT Authentication: Install the "JWT Authentication for WP REST API" plugin to secure private actions like logging in and updating profiles.
  3. Define JWT Secret Key: Open your server's wp-config.php file and inject a secure unique string to sign your app user tokens.
// Add this to your wp-config.php file
define('JWT_AUTH_SECRET_KEY', 'your-super-secure-random-phrase-here');
define('JWT_AUTH_CORES_ALLOWED', true);

Step 2: App Branding & Sync

Dynamic Management Enabled All mobile application visuals are now managed directly within your WordPress administration dashboard. No manual JSON files required.

To give the app your custom visual identity, sync your brand assets with our cloud build servers:

  1. Navigate to your WordPress Admin Panel → App Branding.
  2. Define your custom hex primary theme criteria (e.g., #0047AB) and toggle your Light/Dark mode preferences.
  3. Upload your high-resolution assets:
    • App Icon: 1024x1024px (PNG, no transparency).
    • Splash Screen: 2048x2048px (PNG, centered logo layout).
    • Header Logo: Transparent Vector or high-res PNG.

Step 3: Setup Push Notifications

To orchestrate background WP-Cron notification loops across devices, link your setup to Firebase Cloud Messaging (FCM).

  1. Create a project workspace within the Firebase Console.
  2. Register an Android App package and an iOS App bundle ID.
  3. Download your structural credential files (google-services.json and GoogleService-Info.plist).
  4. Navigate to the Push Notifications dashboard tab in WP admin and upload both files.

Feature Modules (Integrations)

Once your base framework is operational, you can plug in additional functional capabilities. If you want a specific feature to appear in the app, you must install and activate its corresponding WordPress plugin.

The system automatically queries active network instances and safely hides unused components to streamline mobile app performance.

bbPress Forums Core System

Provides standardized, paginated REST endpoints to parse forums, topics, and replies directly inside your app layout.

Required Actions:
  1. Ensure the official bbPress plugin is activated.
  2. Verify forum topics and tags are fully assigned to render content structural queries correctly via public interfaces.

Rest Cache Pro Extension

Rest Cache Pro is an extended module of the WP REST Cache API designed specifically to optimize and cache high-traffic bbPress forum data, reducing API latency and preventing database query loops during peak usage.

Required Actions:
  1. Install and activate the caching extension.
  2. Verify endpoint invalidation rules are active on new topic creation.

→ Download & Configure Rest Cache Pro

WP Job Manager Integration Optional

Feeds recent corporate listings, professional roles, and targeted taxonomy search tools straight to your home view dashboards.

Required Actions:
  1. Activate the official WP Job Manager plugin locally on your installation stack.
  2. Ensure metadata profiles are fully completed on individual listings so the REST endpoint can parse taxonomies like _job_location and _company_name.

Eventin Integration Optional

Exposes complete session agendas, maps target coordinate scopes, lists active presenters, and transmits immediate event push criteria.

Required Actions:
  1. Activate your local installation of the Eventin plugin.
  2. Navigate directly to the newly available Eventin Tab within the administration menu.
  3. Input your custom staging details into the Target Event Manager URL field for deep linking.

Event Tickets & RSVPs Module Optional

Lets app subscribers handle check-ins, request passes, and verify gate barcodes inside unified network payloads.

Required Actions:
  1. Activate Event Tickets or Event Tickets Plus across your server ecosystem.
  2. Ensure automated email transmission functions are functioning properly to dispatch check-in codes instantly.

WP Ulike & Profile Skills Engine Optional

Allows real-time interaction capabilities (likes and dislikes) on forum responses while calculating specialized tag metrics across user profiles.

Required Actions:
  1. Install and activate the standard WP Ulike plugin context.
  2. Use the granular admin control toggles to activate or deactivate the custom "Profile Skills" system independently.

Super Socializer (LinkedIn OAuth) Optional

Uses direct client-side runtime handlers to securely process sanitized, collision-safe profile identities via LinkedIn.

Required Actions:
  1. Deploy and configure the Super Socializer framework.
  2. Navigate to Super Socializer → Social Login, activate the LinkedIn connector, and input your verified OIDC Client ID and Secret.
  3. Set your Authorized Redirect URI inside the LinkedIn Developer Dashboard:
https://yourdomain.com/wp-json/bb-forums-api/v1/auth/linkedin/callback

Core API Endpoint Reference

The application uses optimized REST endpoints with built-in metadata preloading to bypass N+1 query loops. Here is a brief look at the endpoints driving the mobile app:

Public Content

  • GET /wp-json/bb-forums-api/v1/forums — Returns available structural sub-forums.
  • GET /wp-json/bb-forums-api/v1/topics — Query active topics. Supports parameters s (search), page, and per_page.

Interactive User Controls

  • POST /wp-json/bb-forums-api/v1/topic/{id}/favorite — Toggles native user favorites.
  • POST /wp-json/bb-forums-api/v1/reply/{id}/like — Evaluates likes using the WP Ulike engine.