Why it's needed
A package repo keeps source as src/packages/com_x/admin/…, but Joomla installs that to administrator/components/com_x/…. A flat upload would land files in the wrong place. MokoJoomla reads the nearest manifest, works out the real install path, and uploads there.
One-time setup
- Run MokoJoomla: Init Deploy Config to drop a starter
remote-sync-config.jsonat the repo root. - Fill in
host,user,ssh_key_file, and setremote_pathto the site's Joomla webroot.
Hotfix
- Edit a file, then right-click it → MokoJoomla ▸ Hotfix Current File to Live Site (or run Hotfix Changed Files for the whole git-dirty set).
- MokoJoomla shows a confirm dialog listing each
source → destination. Review it. - Confirm to upload (over SFTP, key auth). Use Preview Hotfix Mapping first for a dry run with no upload.
Secrets and configuration.php are never uploaded (they match the ignore rules). Part of the Moko VS Code suite.