✅ Prerequisites
Before starting, ensure:
-
Your store runs Magento 2.3.x or higher.
-
You’re comfortable using the command line.
-
The environment is in developer mode (or work on a staging/dev clone before production)
1. Get the Updated Version
🔁 Via Composer (Recommended)
-
Ensure you've configured your private repository/authentication as in this configuration guide.
-
Run:
composer update blackbird/module-extension-name
Replace
module-extension-name
with the correct package identifier (e.g.blackbird/monetico
).
🗜️ Manual ZIP Upgrade
-
Download the new version ZIP from your Bird customer account.
-
Overwrite the existing folder at:
app/code/Blackbird/ExtensionName
maintaining correct structure (
registration.php
, etc.). -
Ensure any dependencies listed under
require
(e.g.,blackbird/extensions-core
) are also updated accordingly.
2. Enable & Reinstall Module
Once the updated code is in place, from your Magento root:
bin/magento setup:upgrade
Note: If new dependencies or code changes were introduced:
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
Replace Blackbird_ExtensionName
with your actual module name.
3. Clear & Refresh Caches
Run to prevent stale code:
bin/magento cache:clean bin/magento cache:flush
Confidence that the update took effect is critical.
4. Troubleshooting & Support
Monitor logs for any errors:
var/log/system.log
var/log/exception.log
✅ Summary
Updating a Blackbird extension is a matter of:
-
Fetching the new version (via Composer or ZIP upload),
-
Re-running Magento’s module enablement and upgrade commands,
-
Clearing caches,
-
Reviewing for errors.
Always run tests in a development environment first and monitor logs after updating.