diff --git a/README.md b/README.md index 5d68c2ef..167a9a2c 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,8 @@ This plugin was formerly known as WP Ultimo and is now community maintained. ## 🔧 Installation +> **Important:** Do not use GitHub's green **"Code → Download ZIP"** button on this page. That archive is the raw source code and is missing the compiled dependencies — installing it will produce errors such as `Failed opening required .../vendor/autoload_packages.php`. Always download from the [**Releases page**](https://github.com/Multisite-Ultimate/ultimate-multisite/releases) instead. + There are two recommended ways to install Ultimate Multisite: ### Method 1: Using the pre-packaged release (Recommended) diff --git a/ultimate-multisite.php b/ultimate-multisite.php index c2b49ded..3b7cf309 100644 --- a/ultimate-multisite.php +++ b/ultimate-multisite.php @@ -89,7 +89,7 @@ class_exists( 'WP_Ultimo', false ); if ( defined('WP_DEBUG') && WP_DEBUG ) { // This message is not translated as at this point it's too early to load translations. error_log( // phpcs:ignore - esc_html('Your installation of Ultimate Multisite is incomplete. If you installed Ultimate Multisite from GitHub, please refer to this document to set up your development environment: https://github.com/superdav42/wp-multisite-waas?tab=readme-ov-file#method-2-using-git-and-composer-for-developers') + esc_html('Your installation of Ultimate Multisite is incomplete. You may have downloaded the source code ZIP from GitHub instead of the pre-packaged release. Please download the latest release from https://github.com/Ultimate-Multisite/ultimate-multisite/releases or run composer install in the plugin directory.') ); } add_action( @@ -97,12 +97,17 @@ class_exists( 'WP_Ultimo', false ); function () { ?>
+

+ +

', + /* translators: 1: opening anchor tag linking to the Releases page. 2: closing anchor tag. 3: opening anchor tag linking to developer setup docs. 4: closing anchor tag. */ + esc_html__( 'The required vendor files are missing. This usually means the source code ZIP was downloaded from GitHub instead of the pre-packaged release. %1$sDownload the latest release ZIP%2$s and upload it via Plugins > Add New > Upload Plugin. If you are a developer, %3$sset up the development environment%4$s by running composer install.', 'ultimate-multisite' ), + '', + '', + '', '' ); ?>