YCP · VERSION 19.69.03
CGY-Uploader
Validate module ZIPs, detect installed versions, confirm rollback-protected replacements, review custom modules, and remove disabled module files after creating a safety backup.
01
STEP 1
Add the management module using HumHub’s standard module workflow.
- Upload or extract
cgy-uploaderunderprotected/modules. - Confirm the folder contains
module.json,config.php, andModule.php. - Enable CGY-Uploader and select Configure.
YCP tipCGY-Uploader cannot upload or delete itself; use HumHub or the hosting file manager for its own lifecycle.
02
STEP 2
Use a predictable HumHub package structure.
- Place every file inside one lowercase root folder.
- Match the root folder to the ID in
module.json. - Use letters, numbers, and hyphens in the ID.
- Keep the ZIP under 20 MB and upload only code you trust.
YCP tipThe archive should open directly to one module folder, never loose files or an extra version directory.
03
STEP 3
Let CGY-Uploader inspect the archive before changing module files.
- Open Upload Module.
- Choose the ZIP and select Validate and upload module.
- For a new ID, complete the normal installation.
- For an existing ID, compare versions, type exact lowercase
kan, and choose Replace existing module.
YCP tipReplacement creates a timestamped backup and protects the installed folder with rollback handling before swapping files.
04
STEP 4
Keep installation lifecycle work in HumHub’s native module manager.
- Open Administration → Modules.
- Find the newly uploaded module.
- Select Enable, then run any installation action HumHub presents.
- Open Configure and test the module.
YCP tipA successful file upload does not automatically enable executable code.
05
STEP 5
Uninstall first so the module can clean up its own data.
- Disable and uninstall the target in HumHub.
- Open CGY-Uploader → Custom Modules.
- Select Delete files for the disabled module.
- Type exact lowercase
kan, confirm, and review the backup path.
YCP tipEnabled modules and CGY-Uploader itself remain locked against deletion.
06
STEP 6
Use the automatic safety copy if deleted files are needed again.
- Locate the timestamped ZIP under
protected/runtime/cgy-uploader-backups. - Upload it again or extract it under
protected/modules. - Clear HumHub’s module cache if necessary.
- Restore a matching database backup if uninstall removed database data.
YCP tipThe automatic archive protects files only; it does not replace a full database backup.
MISSION COMPLETE
Your module workspace is ready.
You can now add trusted custom modules and clean up disabled module folders without using a hosting file manager for every release.