Experimental project aimed at implementing Aspire Cloud as a Wordpress plugin
Find a file
Namith Jawahar b22ec865b0
CSV Import (#6)
* Assets Model and Custom Post Types defined

Assets Model and Custom Post Types defined

* Plugin Bulk Import and Clear

Plugin Bulk Import and Clear

* Dynamic Scaling and Retries for Failed Import Cases

Dynamic Scaling and Retries for Failed Import Cases - Significant performance boost and Resilience

* Remove Unused Files

Remove Unused Files

* Further Optimized Importer and Ability to sync or import individual plugins

Further Optimized Importer and Ability to sync or import individual plugins

* CSV Import

CSV Import

---------

Signed-off-by: Namith Jawahar <48271037+namithj@users.noreply.github.com>
2025-08-10 02:04:35 +05:30
assets CSV Import (#6) 2025-08-10 02:04:35 +05:30
bin Initial Scaffolding 2025-07-18 01:09:39 +05:30
includes CSV Import (#6) 2025-08-10 02:04:35 +05:30
languages Initial Scaffolding 2025-07-18 01:09:39 +05:30
tests/phpunit Initial Scaffolding 2025-07-18 01:09:39 +05:30
.editorconfig Initial Scaffolding 2025-07-18 01:09:39 +05:30
.gitattributes Initial Scaffolding 2025-07-18 01:09:39 +05:30
.gitignore Initial Scaffolding 2025-07-18 01:09:39 +05:30
.wp-env.json Initial Scaffolding 2025-07-18 01:09:39 +05:30
aspire-cloud.php Further Optimized Importer and Ability to sync or import individual plugins (#5) 2025-08-09 20:41:10 +05:30
CHANGES.md Initial Scaffolding 2025-07-18 01:09:39 +05:30
composer.json Initial Data Population (#3) 2025-07-22 23:13:09 +05:30
composer.lock CSV Import (#6) 2025-08-10 02:04:35 +05:30
LICENSE.md Create LICENSE.md 2025-07-18 00:28:25 +05:30
package-lock.json Initial Data Population (#3) 2025-07-22 23:13:09 +05:30
package.json Initial Data Population (#3) 2025-07-22 23:13:09 +05:30
phpcs.xml.dist Initial Scaffolding 2025-07-18 01:09:39 +05:30
phpunit.xml.dist Initial Scaffolding 2025-07-18 01:09:39 +05:30
README.md Initial Data Population (#3) 2025-07-22 23:13:09 +05:30
readme.txt Initial Scaffolding 2025-07-18 01:09:39 +05:30

AspireCloud

Contributors: AspirePress Tags: wordpress, api, headless, passthrough, wordpress-api Requires at least: 5.3 Tested up to: 6.8.1 Requires PHP: 7.4 Stable tag: 0.0.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Description

AspireCloud transforms your WordPress site into a headless installation with source API passthrough functionality. All requests to your site root are automatically passed through to source, while maintaining full WordPress admin functionality.

Features

Root-Level API Passthrough

  • Direct passthrough from https://yoursite.com/{path} to https://apisourcesite.com/{path}
  • GET requests only
  • Query parameters preserved
  • Error handling and response proxying

Headless WordPress

  • Frontend disabled for regular visitors
  • Admin interface fully functional
  • WordPress core paths protected
  • Static assets served normally

WordPress Integration

  • Seamless integration with WordPress rewrite system
  • Automatic activation/deactivation handling
  • WordPress coding standards compliant
  • Comprehensive error handling

Quick Start

  1. Install & Activate the plugin
  2. Visit Settings → Permalinks and click "Save Changes" to flush rewrite rules
  3. Test by visiting your site root - you should see the api welcome page content

Protected WordPress Paths

These paths continue to work normally:

  • /wp-admin/ - WordPress admin
  • /wp-login.php - Login page
  • /wp-content/ - Static assets
  • /wp-json/ - REST API

Requirements

  • WordPress: 5.3 or higher
  • PHP: 7.4 or higher
  • Server: Must support WordPress rewrite rules

Development

This plugin follows WordPress coding standards and includes:

  • PSR-4 autoloading
  • PHPUnit tests
  • PHPCS integration
  • SCSS compilation for admin styles
  • Comprehensive documentation

Building Assets

Prerequisites

  • Node.js 16+ and npm 8+
  • Composer

Install Dependencies

npm install
composer install

Build Commands

Production Build (compressed CSS):

# Using npm
npm run build:css

# Using composer
composer build:css

Development Build (expanded CSS with source maps):

# Using npm
npm run build:css:dev

# Using composer
composer build:css:dev

Watch Mode (auto-compile on changes):

# Note: Watch mode may have issues on Windows. Use manual builds instead.
# Using npm
npm run watch:css

# Using composer
composer watch:css

# Alternative for Windows - direct command:
npx sass assets/css/admin.scss assets/css/admin.css --watch --style=expanded --source-map

Full Build:

# Using npm
npm run build

# Using composer
composer build

Available Build Scripts

Script Description
build:css Compile SCSS to compressed CSS
build:css:dev Compile SCSS to expanded CSS with source maps
watch:css Watch SCSS files and auto-compile on changes
build Run all build tasks

Support

For support and documentation, visit AspirePress Documentation.

Changelog

0.0.1

  • Initial release
  • Root-level api.wordpress.org API passthrough
  • Headless WordPress functionality
  • WordPress admin preservation