[Fixed v1.5.1] 1.5 Implementation Guide Suggestions
Forced to be away from normal work, I got to thinking about a recent problem with the installation of ZC. I recalled my volunteering to assist in the maintenance of guides, tutorials, etc and pulled up the pdf guide for 1.5.0 implementation. Looking through the first seven sections, I came up with a few suggestions and clarifications which I submit with full appreciation of the effort already put into this document.
3. Obtaining the current Zen Cart release -- Pg 6
For consistency, this title shoudl be "Obtaining the Current Zen Cart Release".
4. Unpacking snd Uploading the application software files -- Pg 7
For consistency, this title shoudl be "Unpacking and Uploading the Application Software Files".
4.4 Advanced Method--Pg 7
You can optionally save some time by uploading the zip file directly to your server(using FTP etc.), and unpacking it on your site if your hosting company provides you a means of unzipping files on the server side. Talk to your hosting company about this.
5.1 New Installations--Pg 8
2) configure.php files
Is this really necessary or just a way of confusing those who read this after installing? Numerous posts on the forum are a result of someone renaming the dist- files AFTER installation resulting in a non-working cart. Why not just remove 2) and change 3) to 2).
6.1.4 Step 3 System Inspection -- Pg 14
Since we are still in the midst of installation instructions, would it not be better to have a warning box (like on page 9) stating:
WARNING: If you see an "Upgrade CFG Files" or "Database Upgrade" button at this point, there is data in the database. Clicking on the "Install" button with either "Upgrade" button showing will erase any data in the database. For instructions on doing upgrades...
188.8.131.52 Database Username/Password -- Pg 15 last line add "using"
...it is up to you to change it to something strong and secure, using the tools provided by your hosting company.
184.108.40.206 URL to your Zen Cart store -- Pg 17
For consistency, this title should be "URL to your Zen Cart Store".
220.127.116.11 and 18.104.22.168 might need to be moved to page 17 with the image consisting of only the portion applicable to .3 and .4. Then, make a new page with 22.214.171.124, 126.96.36.199, the warning box, and the last half of the existing image on pag 18.
188.8.131.52 Save System Settings -- Pg 19 Needs to be added
If all the System Settings on this page are correct, click on the "Save System Settings" button to add the system settings to your database.
6.1.7 Step 6 Store Setup -- Pg 19
When any of these items are described as "used to" are we not falsely indicating that there is no need to enter this information elsewhere? Store Owner Email, Store Country, and Zone are simply insertions of database content, not the creation of a variable that will be "used". Store Address on Pg 19 does not have the "used" statement, but does have a correct version of a used statement in the figure on Pg 20.
184.108.40.206 Store Demo -- Pg 21
in built is normally spelled inbuilt but even the definition for inbuilt lists built-in as the first answer. Also "You may find it useful load this demo data so that you can get comfortable with the application, before you actually start to build your own store." should be "You may find it useful to load this demo data so that you can get comfortable with the application before you actually start to build your own store." to be more correct.
220.127.116.11 Save Store Settings -- Pg 21 Needs to be added
If all the Store Settings on this page are correct, click on the "Save Store Settings" button to add the system settings to your database.
18.104.22.168 Administrator's User name -- Pg 22
For consistency, this title shoudl be "Administrator's User Name".
22.214.171.124 TEMPORARY Administrator's Password -- Pg 22 Warning Box rewrite
You most likely accessed this installation without using SSL. That means there is an extremely
small possibility that someone could have intercepted your admin username/password. Make sure you enable SSL for your admin page. This will cause your admin password to expire and you'll need to select a new password. This helps ensure that, if someone has stolen your password over an unsecured connection, they'll be unable to use that password any longer.
6.1.10 --Pg 23 Change to Save Admin Settings and renumber existing 6.1.10 to 6.1.11 (text for 6.1.10)
If all the Admin Settings on this page are correct, click on the "Save Admin Settings" button to add the system settings to your database.
6.2.4 Step 3 System Inspection -- Pg 26
This does not address which button to select for what action nor is the result of clicking "Upgrade Cfg Files" addressed. Instead, we're taken directly to the result of clicking on "Database Upgrade".
6.2.5 Step 4 Version-upgrade-checkboxes -- Pg 26
As in Step 3, the various options are not addressed and only the result of clicking "Done with Updates" is addressed.
7. Post Installation activities -- Pg 29
For consistency, this title shoudl be "Post-Installation Activities".
7.1 Changing The Admin Directory Name for Security (By-Obscurity) -- Pg 29
Second paragraph, second sentence needs another comma and wordage change to avoid possible focus on "easy to guess". "Therefore, before you can access the admin panel, you must change the name of that directory to something much more difficult to guess."
7.3 Setting directory and file permissions -- Pg 29
For consistency, this title shoudl be "Setting Directory and File Permissions".
The first sentence should start "As mentioned in Section 5.1,"
Last paragraph on the page. N.B. ??
7.4 Removing the installation directory -- Pg 30
For consistency, this title should be "Removing the Installation Directory".
Using "Once installation is completed, you must remove the INSTALL_DIRECTORY?zc_install folder." might keep someone from deleting zc_install prior to installation completion.
Last sentence could read "Until you remove the zc_install directory, a warning message will appear when you access your storefront.
Did you read the posting tips?!?