Description of the need
When visiting the "Install new module" page, if your server does not have the PHP Zip extension installed, you are presented the following message:
It does not tell the user how to install the PHP Zip extension, nor does it tell them that they must Flush all caches after doing so for the system to recognize it.
Proposed solution
This message should include a link to a backdropcms documentation page which explains in full how to install the extension and enable it on a variety of common systems (eg, Ubuntu/Debian, Redhat-based, Windows).
The message should also include the instructions, with a link, to flush cache once the extension has been enabled.
Ex:
The Zip PHP extension is not loaded on your server. You will not be able to download any projects using Project Installer until this is fixed and the site cache is flushed. (link)View full PHP Zip installation instructions here.
Alternatives that have been considered
Until a documentation page can be created, a possible alternative message to display might be:
The Zip PHP extension is not loaded on your server. You will not be able to download any projects using Project Installer until this is fixed and the site cache is flushed.
--Collapsible Fieldset--
Basic installation instructions for Linux:
- (Debian/Ubuntu-Based) sudo apt install php-zip
- (Redhat-Based) sudo dnf install php-zip
You may need to edit your php.ini file and add: extension=zip
Remember to restart Apache2 / Nginx after install, and flush Backdrop cache.
Once a "real" documentation page is created on backdropcms, this extra bit would be replaced with that.
Draft of feature description for Press Release (1 paragraph at most)
Backdrop now includes extra instructions for installing the Zip PHP extension if it is missing from the server's PHP configuration.
Description of the need
When visiting the "Install new module" page, if your server does not have the PHP Zip extension installed, you are presented the following message:
It does not tell the user how to install the PHP Zip extension, nor does it tell them that they must Flush all caches after doing so for the system to recognize it.
Proposed solution
This message should include a link to a backdropcms documentation page which explains in full how to install the extension and enable it on a variety of common systems (eg, Ubuntu/Debian, Redhat-based, Windows).
The message should also include the instructions, with a link, to flush cache once the extension has been enabled.
Ex:
The Zip PHP extension is not loaded on your server. You will not be able to download any projects using Project Installer until this is fixed and the site cache is flushed. (link)View full PHP Zip installation instructions here.Alternatives that have been considered
Until a documentation page can be created, a possible alternative message to display might be:
Once a "real" documentation page is created on backdropcms, this extra bit would be replaced with that.
Draft of feature description for Press Release (1 paragraph at most)
Backdrop now includes extra instructions for installing the Zip PHP extension if it is missing from the server's PHP configuration.