Johan Cwiklinski a écrit (#note-1):
I'm not against a rework of the page, and it's also OK to put creation database in preparation steps (keep a link from its original location).
But I do not agree with repetitive managed/own/windows entries: most of the steps are exactly the same on all platforms, and using XAMPP or not is just a detail.
I totally agree that the finality of the preparation steps are exactly the same on all platforms.
That is the starting point of my suggested modification :)
But the way to achieve them changes significantly from one use case to another.
I also totally agree that using XAMPP or not is just a detail.
But these are the points of views of the experienced and technical users that we are ! :)
From the point of view of an absolutly non technical user using a managed hosting for the first time, or using XAMPP without knowing what is a webserver or a database - and only because it is required to run galette offline on a windows machine (with all the habits that come along : using *.exe files, click and install, etc.) - I don't think these are just details.
The average reader must get lost with all the warnings, notes, references and configuration examples that generally only interest most advanced users in a self hosted configuration.
Otherwise, starting rewriting the page, I quickly realized that the repetitive entries are not very convenient either to follow the process step by step.
So I've splitted each use case on dedicated pages.
Please have a look at my first draw with the patch attached.
The new structure :
*Preparation
- Prepare installation on a managed hosting
- Setup the webserver
- Create the database
- Copy files and set permissions on the webserver
- Serve Galette to the web
- Secure Galette
- Prepare installation on a self hosting
- Setup the webserver
- Create the database
- Copy files and set permissions on the webserver
- Serve Galette to the web or your local network
- Secure Galette
- Prepare installation on XAMPP
- Setup the webserver
- Create the database
- Copy files and set permissions on the webserver
- Serve Galette to your local network
- Secure Galette
- Additional step : configure XAMPP to send emails
What do you plan to can put in "Setup the webserver"?
- managed hosting : mainly, I tell that this part is managed by the hosting providers, and that nothing needs to be done in this case except checking that the hosting plan fits the required PHP version for Galette (and tell the user that the version of PHP can generally be modified from the hosting customer account).
- self hosting : commands to install webserver, database and php
- XAMPP : install XAMPP
Same question for "Secure Galette".
I'll move there the recommandations about the config
and install
directories after install. And :
- managed hosting : enable SSL certificate on the hosting provider customer account, enable https and set apache security headers in .htaccess.
- self hosting : Let's encrypt, https by default and security headers in the vhost conf (apache and nginx).
- XAMPP : use self signed certificate, and tell the readers it is not the most secured and convenient solution to put galette online. If used offline, nothing to be done really.