BlueWorx Labs | Top Tier Tutors self-updates
Top Tier Tutors — WordPress plugin on the bluegroup_core_foundation guardrails.
by Blueworx · github.com/blueworx-io/blueworx_client_toptiertutors · website
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/blueworx-io/blueworx_client_toptiertutors/releases/download/v0.3.1/blueworx-client-toptiertutors.zipShips its own WordPress updater (Plugin Update Checker), so new versions show up under Dashboard → Updates.
Readme
blueworx_client_toptiertutors
Top Tier Tutors — WordPress plugin, built on the shared
bluegroup_core_foundation
guardrails.
The site is built in code as a plugin — never straight into WordPress core, a loose theme, or a page builder.
Layout
| Path | What it is |
|---|---|
blueworx-client-toptiertutors.php |
Main plugin file — header, constants, update checker |
includes/ |
Feature code, registered from class-plugin.php |
assets/ |
Front-end CSS/JS, enqueued version-stamped from the plugin header |
tests/ |
Playwright specs, run against a real WordPress |
plugin-update-checker/ |
Vendored PUC v5.7 — committed deliberately, upgraded by swapping the folder |
Logo Carousel
A full-bleed strip of logos that steps sideways one tile at a time, pausing to dwell between steps, with items lifting toward the top as they move away from centre. Add it in Elementor from the Top Tier Tutors category, or with the shortcode:
[toptiertutors_logo_carousel ids="12,13,14" size="full" step_ms="600" pause_ms="2000" arc="24"]
| Attribute | Default | Meaning |
|---|---|---|
ids |
— | Comma-separated attachment IDs, in display order |
size |
medium |
Registered image size |
step_ms |
600 |
How long one advance takes, in milliseconds |
pause_ms |
2000 |
Dwell between advances, in milliseconds |
arc |
24 |
Maximum lift in px at the edges; 0 is flat |
direction |
left |
left or right |
pause_on_hover |
yes |
no to keep stepping under the cursor |
full_bleed |
yes |
no to keep it inside the content column |
height |
CSS default (200px) | Logo height in px |
gap |
CSS default (60px) | Space between logos in px |
Elementor 3.5+ is needed for the widget; the shortcode works without Elementor.
Local testing
Tests run against a disposable WordPress the foundation provisions (PHP + SQLite,
no Docker). It expects bluegroup_core_foundation cloned alongside this repo.
npm install
npm run wp:up # provisions + activates the plugin on http://127.0.0.1:8881
WP_ADMIN_USER=admin WP_ADMIN_PASS=wptest-admin-pw npx playwright test
npm run wp:down
A skipped test is not a passing test — CI fails any run that executes zero tests.
CI
Every pull request runs the foundation's WordPress guardrails: lint, build, PHP syntax check, version bump, changelog, approved dependencies, plugin/package version sync, single-zip check, and Playwright against the local WordPress.
Releasing
Updates ship as GitHub Releases; sites install them through the vendored update checker. No zip is uploaded by hand.
- On the branch, bump the
Version:header andpackage.json, and add theCHANGELOG.mdsection. - Merge the green PR.
- When a release is actually wanted:
git tag v0.2.0 && git push origin v0.2.0.
Each site needs BLUEWORX_PLUGIN_UPDATE_TOKEN in wp-config.php (fine-grained
read-only Contents token) — without it a private repo's releases are invisible
and the site silently reports the plugin as up to date. Full detail:
docs/wordpress-auto-updates.md in the foundation.
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| v0.3.1 | Jul 28, 2026 | blueworx-client-toptiertutors.zip | 2 |